Class MSDFFontLoader

packages/fairygui/src/text/MSDFFontLoader.ts:49–143

 * MSDF 字体加载器
 */
export class MSDFFontLoader {
    private _textureService: ITextureService;
    private _fontCache: Map<string, MSDFFont> = new Map();

    constructor(textureService: ITextureService) {
        this._textureService = textureService;
    }

    /**
     * Load MSDF font from JSON and texture URLs
     * 从 JSON 和纹理 URL 加载 MSDF 字体
     *
     * @param name Font name for registration | 注册用的字体名称
     * @param jsonUrl URL to font JSON file | 字体 JSON 文件 URL
     * @param textureUrl URL to font atlas texture | 字体图集纹理 URL
     * @param bRegisterGlobal Register to global font manager | 是否注册到全局字体管理器
     */
    public async load(
        name: string,
        jsonUrl: string,
        textureUrl: string,
        bRegisterGlobal: boolean = true
    ): Promise<IFontLoadResult> {
        // Check cache
        const cached = this._fontCache.get(name);
        if (cached) {
            return {
                font: cached,
                textureId: cached.textureId,
                name
            };
        }

        // Load JSON first
        const fontData = await this.loadFontData(jsonUrl);

        // Load texture (synchronous API - returns ID immediately, loading happens async internally)
        const textureId = this._textureService.loadTextureByPath(textureUrl);

        // Create font
        const font = new MSDFFont(name, fontData);
        font.textureId = textureId;

        // Cache
        this._fontCache.set(name, font);

        // Register to global manager
        if (bRegisterGlobal) {
            const manager = getMSDFFontManager();
            manager.registerFont(font);
        }

        return { font, textureId, name };
    }

    /**
     * Load font data from JSON URL
     * 从 JSON URL 加载字体数据