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