API 参考
正在准备搜索索引…

将经过检查的重载转发给原生字体引擎。

source - 文件路径或字体字节。

familyOrFallback - 显式字体族或文件后备字体标记。

styleOrWeight - 命名字体样式或文件字重。

weightOrIndex - 命名字体字重或文件字体集合索引。

fallback - 命名字体的后备字体标记。

faceIndex - 命名字体的字体集合索引。

原生字体加载结果。

  • 从文件调用 Rml::LoadFontFace,使用字体内部的字体族和样式。

    参数

    filePath
    string

    由当前文件接口解析的路径。

    fallback可选
    boolean

    用于补齐其他字体缺失的字形,默认 false。

    weight可选
    number

    Auto(0)或 1–1000 的整数,默认 Auto。

    faceIndex可选
    number

    非负 int32 字体集合索引,默认 0。

    返回值

    boolean

    原生成功标记;字体或字形面不存在、无效时返回 false。

    同步操作。先初始化,再在文档加载前加载字体。RCSS 使用内部字体族名称。 运行时字体操作不允许在事件回调内调用。

    源码与继承
  • 以显式字体族、样式及可选字重加载文件或字节视图。

    参数

    source
    string | Uint8Array

    文件路径、Buffer 或未共享且未分离的 Uint8Array。

    family
    string

    注册供 RCSS 使用的字体族名称;空字符串使用字体元数据。

    style

    Normal 或 Italic。

    weight可选
    number

    Auto(0)或 1–1000 的整数,默认 Auto。

    fallback可选
    boolean

    是否注册为后备字体,默认 false。

    faceIndex可选
    number

    非负 int32 字体集合索引,默认 0。

    返回值

    boolean

    原生成功标记,数据或索引无效时返回 false。

    同步调用 Rml::LoadFontFace。原生运行时复制视图范围内的字节并持有至关闭; 加载失败时也保留,因为字体集合可能已部分注册。返回后调用方可以修改、转移或 回收输入。releaseFontResources 保留这些字节。必须先初始化,不能在事件回调中 调用字体操作。空字体族还会恢复元数据中的样式。

    源码与继承

Icons made by Lorc, Delapouite & Skoll · game-icons.net · CC BY 3.0