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

FontEngineInterface

原生 Rml::FontEngineInterface,提供共享值及可选宿主虚函数。

只有选中引擎可执行字体操作。Core 管理 Initialize/Shutdown 生命周期, 构造不会启动字体 provider。默认字形和图集处理在 C++ 执行, 自定义虚函数进入同步宿主回调;自定义宽度表在 Native 中计算宽度。

源码与继承
成员目录13

构造函数

访问器

方法

构造函数

访问器

方法

  • 获取字体句柄,字体族在原生边界转为小写。

    参数

    family
    string

    已注册字体族。

    style

    Normal 或 Italic。

    weight
    number

    1–1000 的整数字重。

    size
    number

    1–33554431 像素,符合 FreeType 26.6 单位范围。

    返回值

    代次校验令牌,无匹配字体时为 null。

    源码与继承
  • 计算字符串宽度。

    参数

    face

    有效字体令牌。

    string
    string

    待测量文本。

    shaping可选

    持有存储的排版参数,省略使用默认值。

    priorCharacter
    number = 0

    前一个 Unicode 码点,默认零。

    返回值

    number

    原生整数像素宽度。

    源码与继承
  • 一次进入原生,按输入顺序测量多个字符串。

    参数

    face

    有效字体令牌。

    strings
    readonly string[]

    使用相同字体及排版参数的字符串。

    shaping可选

    持有存储的排版参数,省略使用默认值。

    priorCharacter
    number = 0

    每个字符串前的码点,默认零。

    返回值

    Int32Array

    原生持有的共享 int32 宽度,回收和关闭后仍有效。

    源码与继承
  • 将打包 UTF-8 片段测量到已有原生宽度存储。

    参数

    face

    有效字体令牌。

    buffer

    可复用原生输入和输出。

    shaping可选

    排版参数;省略使用默认值。

    priorCharacter
    number = 0

    每行的前置码点;默认零。

    count可选
    number

    有效行数;默认使用追加长度。

    返回值

    Int32Array

    就地更新的原始完整宽度视图。

    此入口不分配或拷贝输入及结果缓冲。冷字形加载和自定义字体引擎 可能分配自己的存储。

    源码与继承
  • 初始化前注册上游 HarfBuzz 语言元数据。

    参数

    language
    string

    TextShapingContext.language 使用的 BCP47 语言标签。

    script
    string

    四字母 ISO15924 文字代码,如 Arab 或 Latn。

    direction
    "ltr" | "rtl"

    排版上下文选择 Auto 时使用的文字方向。

    返回值

    void
    源码与继承
  • 通过 Core 释放字体,使字体、特效和图集令牌失效。

    返回值

    void

    释放前先挂回或回收脱离的树。已注册字体数据和数值快照保持可用。

    源码与继承

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