110 lines
3.0 KiB
Go
110 lines
3.0 KiB
Go
package assets
|
||
|
||
import (
|
||
"encoding/json"
|
||
"fmt"
|
||
"os"
|
||
"strings"
|
||
)
|
||
|
||
// FontProvider 字体 provider（font/*.json，原版结构，设计.md §1.3）。
|
||
// 支持 type：bitmap（位图字形）与 reference（引用其他 provider 文件）。
|
||
type FontProvider struct {
|
||
Type string `json:"type"`
|
||
File string `json:"file"` // bitmap：相对 textures/ 的位图路径（无扩展名）
|
||
Chars []string `json:"chars"`
|
||
Height int `json:"height"`
|
||
Ascent int `json:"ascent"`
|
||
ID string `json:"id"` // reference：目标 provider 文件（minecraft:include/default 等）
|
||
}
|
||
|
||
// Font 字体定义（reference 已递归展开）。
|
||
type Font struct {
|
||
Providers []FontProvider
|
||
}
|
||
|
||
// Glyph 一个字符的字形定位信息。
|
||
type Glyph struct {
|
||
File string // 位图资源键（相对 textures/，如 font/ascii）
|
||
Index int // 在 chars 拼接串中的索引
|
||
Height int // 字形高度（px）
|
||
Ascent int // 基线偏移
|
||
}
|
||
|
||
// LoadFont 解析 font/<name>.json 并展开 reference provider（防环）。
|
||
func (m *Manager) LoadFont(name string) (*Font, error) {
|
||
providers, err := m.loadFontProviders(name, map[string]bool{})
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
return &Font{Providers: providers}, nil
|
||
}
|
||
|
||
// loadFontProviders 递归加载 provider 文件；stack 用于循环引用检测。
|
||
func (m *Manager) loadFontProviders(name string, stack map[string]bool) ([]FontProvider, error) {
|
||
path, ok := m.find("font", name, ".json")
|
||
if !ok {
|
||
return nil, fmt.Errorf("assets.loadFontProviders: 字体 %q 不存在", name)
|
||
}
|
||
if stack[name] {
|
||
return nil, fmt.Errorf("assets.loadFontProviders: 字体引用循环 %q", name)
|
||
}
|
||
stack[name] = true
|
||
defer delete(stack, name)
|
||
|
||
b, err := os.ReadFile(path)
|
||
if err != nil {
|
||
return nil, fmt.Errorf("assets.loadFontProviders %s: %w", name, err)
|
||
}
|
||
var def struct {
|
||
Providers []FontProvider `json:"providers"`
|
||
}
|
||
if err := json.Unmarshal(b, &def); err != nil {
|
||
return nil, fmt.Errorf("assets.loadFontProviders %s: %w", name, err)
|
||
}
|
||
|
||
var out []FontProvider
|
||
for _, p := range def.Providers {
|
||
if p.Type == "reference" {
|
||
// 展开引用：minecraft:include/default → font/include/default.json
|
||
refName := strings.TrimPrefix(p.ID, "minecraft:")
|
||
sub, err := m.loadFontProviders(refName, stack)
|
||
if err != nil {
|
||
return nil, err
|
||
}
|
||
out = append(out, sub...)
|
||
continue
|
||
}
|
||
out = append(out, p)
|
||
}
|
||
return out, nil
|
||
}
|
||
|
||
// Glyph 查找字符字形（按 providers 顺序，首个命中优先）。
|
||
func (f *Font) Glyph(ch rune) (Glyph, bool) {
|
||
for _, p := range f.Providers {
|
||
if p.Type != "bitmap" {
|
||
continue
|
||
}
|
||
idx := charIndex(p.Chars, ch)
|
||
if idx >= 0 {
|
||
return Glyph{File: p.File, Index: idx, Height: p.Height, Ascent: p.Ascent}, true
|
||
}
|
||
}
|
||
return Glyph{}, false
|
||
}
|
||
|
||
// charIndex 返回 rune 在 chars 拼接串中的索引；未找到返回 -1。
|
||
func charIndex(chars []string, ch rune) int {
|
||
offset := 0
|
||
for _, s := range chars {
|
||
for i, r := range s {
|
||
if r == ch {
|
||
return offset + i
|
||
}
|
||
}
|
||
offset += len([]rune(s))
|
||
}
|
||
return -1
|
||
}
|