CreateOpenTypeFontVariation
文本、字体、可变字体
描述
按请求的设计轴坐标实例化 OpenType CFF2 可变字体,并将生成的静态 CFF 字体添加至当前文档
语法
Delphi
Function TPDFlib.CreateOpenTypeFontVariation(FontID: Integer; Const AxisCoordinates: WideString): Integer;参数
| FontID | 由 OpenType 字体创建或加载 API 返回的 CFF2 可变字体句柄 |
|---|---|
| AxisCoordinates | 以逗号或分号分隔的 tag=value 对,例如 wght=700,wdth=75;省略的轴使用默认值,超出声明范围的值将被钳制 |
返回值
成功时返回正字体句柄并选择它;句柄无效、非 CFF2 字体、坐标未知或格式错误、CFF2 结构不受支持或变体数据格式错误时返回 0
备注
实例化器会根据 CFF2 变体存储计算 vsindex 和 blend,展开局部和全局子例程,应用 HVAR 水平度量和受支持的 MVAR 全局度量,并同步通用样式轴
输出是校验和正确的 CID 键控 CFF1 OpenType 字体,具有静态 charstring 和度量,已移除过期的变体、提示程序和签名表
在分配前限制 CharString 递归、操作数栈使用量、操作计数、INDEX 大小和输出大小,因此格式错误的输入会失败且不会返回部分字体
返回的字体可用于绘制、嵌入、CFF 子集化和 SaveFontToFile;GetFontVariationAxes 对其返回 0
直接加载 CFF2 字体会选择其默认静态实例,同时保留原始可变程序供后续调用此 API
请使用 CreateTrueTypeFontVariation 来处理使用 glyf 轮廓的可变字体
另请参阅
GetFontVariationAxes、CreateTrueTypeFontVariation、AddOpenTypeFontFromFile、SaveFontToFile