CreateOpenTypeFontVariation

文字、字型、可變字型

描述

在要求的設計軸座標上實例化 OpenType CFF2 可變字型，並把產生的靜態 CFF 字型加入目前文件

Function TPDFlib.CreateOpenTypeFontVariation(FontID: Integer; Const AxisCoordinates: WideString): Integer;

FontID	由 OpenType 字型建立或載入 API 傳回的 CFF2 可變字型控制代碼
AxisCoordinates	以逗號或分號分隔的 tag=value 配對，例如 wght=700,wdth=75；省略的軸使用預設值，超出宣告範圍的值會被夾限

成功時傳回正數的字型控制代碼並選用它；控制代碼無效、非 CFF2 字型、座標未知或格式錯誤、CFF2 結構不受支援或變體資料格式錯誤則傳回 0

實例化器會對照 CFF2 variation store 求值 vsindex 與 blend，展開局部與全域子常式，套用 HVAR 水平度量與受支援的 MVAR 全域度量，並同步共同的樣式軸

輸出是校驗和正確的 CID-keyed CFF1 OpenType 字型，帶靜態 charstring 與度量；過期的 variation、hint 程式與簽章表會被移除

CharString 遞迴、運算元堆疊用量、運算數、INDEX 大小與輸出大小都會在配置前設限，因此格式錯誤的輸入會直接失敗，不會回傳部分字型

傳回的字型可用於繪圖、內嵌、CFF 子集化與 SaveFontToFile；對它呼叫 GetFontVariationAxes 會傳回 0

直接載入 CFF2 字型會選取其預設靜態實例，同時保留原始可變程式，供後續呼叫此 API 使用

使用 glyf 輪廓的可變字型請改用 CreateTrueTypeFontVariation