設計團隊為報表標題指定 Inter 字重 620、字寬 87.5,報表產生器內嵌了字型檔,PDF 打開時標題卻是最普通的 Regular。到檔案裡搜尋 620,哪裡都找不到。這是正常現象:PDF 字型字典(ISO 32000-1 §9.6 與 §9.8)描述的是一組固定外框配固定寬度的固定字符程式,裡面沒有任何欄位放得下座標軸座標,因此收到可變字型的閱讀器畫出的是檔案裡儲存的外框,也就是預設實例。要讓字重 620 落到紙上,得在字型進到 PDF 之前就把座標烘焙進外框
烘焙不只是把一個數字寫進標頭,而是產出一個全新的、自成一體的靜態字型,讓它的外框、前進寬度、邊界框與版面資料表全都和設計空間裡選定的位置一致,然後內嵌這個字型而不是原字型
靜態實例必須重建哪些東西
HotPDF 在字型註冊時建出這個靜態實例,對 TrueType 體質的可變字型來說,這件工作幾乎會碰到檔案裡每一張資料表。OpenType 可變字型為每個字符儲存一份預設外框,再外加 gvar 資料表裡的差異值,每一組差異值綁定設計空間裡的一個區域。對每個字符,函式庫會算出每個區域在你選定座標上的作用強度,把加權後的差異值以浮點數跨所有元組累加,最後才對每個控制點做一次捨入。若改成逐元組捨入,誤差會在橫跨多個重疊區域的字符上不斷累積
接著所有由移動後控制點衍生的東西全部重算:glyf 資料表重寫,loca 以長版位移格式輸出;hmtx(有 vmtx 時一併處理)為每個字符寫入完整一筆;head 裡的整體邊界框與 hhea、vhea 裡的摘要欄位——最大前進寬度、最小側邊距、最大延伸——都從最終量度重算;sfnt 檢查碼也重建。整個字型層級的數值跟著走:cvar 的差異值進到 cvt 資料表,MVAR 調整 ascender、descender 等量度,GDEF、GPOS 與 GSUB feature variations 裡的變化資料則在選定位置上解出結果
連描述性中繼資料也跟著動。OS/2 的 usWeightClass 取 wght 的值,字重 620 就記錄為 620;usWidthClass 由 wdth 百分比映射而來,87.5 正好落在 class 4,也就是半窄縮;slnt 座標軸把角度寫進 post.italicAngle。最後變化資料表全部移除:fvar、avar、gvar、HVAR、VVAR、MVAR、STAT、cvar,外加 DSIG——它簽署的位元組已經不存在了。外框都移動之後還留著 fvar 的字型,等於邀請任何認得變化的消費端把同一批差異值再套一次
CFF2 體質的可變字型走另一條路。它的 charstring 帶有靜態字型程式無法表達的 blend 運算子,因此 HotPDF 每次註冊 CFF2 字型時都會把它轉成靜態實例,即使所有座標軸都停在預設值也一樣。這項轉換與其以 CID 為鍵值的 CFF 內嵌,說明見 CFF2 可變字型內嵌 一文
虛擬控制點與重複套用的陷阱
最隱微的規則跟量度有關,而 OpenType 規範本身也讓它很容易被做錯。在 gvar 裡,一個字符的控制點數等於它的外框控制點(複合字符則是元件控制點),再加上四個編碼左側邊距與前進寬度及其垂直對應值的虛擬控制點。這些虛擬控制點跟其他控制點一樣會收到差異值
帶 gvar 的字型多半也會附上 HVAR,因為 HVAR 讓轉譯器不必解出外框就能取得前進寬度。兩邊都套,每個前進寬度就會移動兩次;對齊排版的文字便逐字符往右漂移。gvar 存在時,HotPDF 從內插後的虛擬控制點推導水平與垂直量度,忽略 HVAR 與 VVAR。只有沒有 gvar 的字型,其量度變化資料才會直接烘焙進 hmtx 與 vmtx。這個優先序是較保險的一邊:gvar 是唯一在同一個操作裡同時移動外框與量度的資料表,它的答案不可能跟它所描述的字符相矛盾
還有兩條規則守住幾何正確性。稀疏差異集裡未列出的控制點,按輪廓以 IUP(interpolate untouched points,內插未觸及的控制點)推算,而虛擬控制點從不參與這種內插。複合字符的差異值只在元件以 XY 數值定位時移動其偏移量;以控制點配對定位的元件,位置改由附著點決定。子項邊界接著遞迴重算,巢狀上限 64 層,指回自身的畸形元件圖會以拒絕該字型收場,而不是無止盡遞迴
用 InspectVariableFont 讀出設計空間
InspectVariableFont 是該第一個呼叫的函式,它會告訴你有哪些座標軸、每個軸接受什麼範圍。檔案不存在或字型沒有 fvar 時回傳 False;遇到 .ttc 集合則讀第一個成員。每筆 THPDFVariableFontAxis 記錄帶有四位元組 Tag、MinimumValue、DefaultValue、MaximumValue、Flags 與一個 NameID。每個具名實例帶有 SubfamilyNameID、Flags、一個 PostScriptNameID,以及按座標軸順序、每軸一筆的 Coordinates
// ClampToAxis 是你自己加的輔助函式;HotPDF 不會替你做範圍夾限
function ClampToAxis(const Axis: THPDFVariableFontAxis; Value: Single): Single;
begin
Result := Value;
if Result < Axis.MinimumValue then Result := Axis.MinimumValue;
if Result > Axis.MaximumValue then Result := Axis.MaximumValue;
end;
procedure ListDesignSpace(Pdf: THotPDF; const FontPath: string);
var
Axes: THPDFVariableFontAxisArray;
Instances: THPDFVariableFontNamedInstanceArray;
I, J: Integer;
Coords: string;
begin
if not Pdf.InspectVariableFont(FontPath, Axes, Instances) then
begin
Writeln('static font: register it without axis selections');
Exit;
end;
for I := 0 to High(Axes) do
Writeln(Format('%s min=%.1f default=%.1f max=%.1f',
[string(Axes[I].Tag), Axes[I].MinimumValue,
Axes[I].DefaultValue, Axes[I].MaximumValue]));
for I := 0 to High(Instances) do
begin
Coords := '';
for J := 0 to High(Instances[I].Coordinates) do
Coords := Coords + Format('%s=%g ',
[string(Axes[J].Tag), Instances[I].Coordinates[J]]);
Writeln(Format('named instance %d: %s', [I, Coords]));
end;
end;
範圍之所以重要,是因為 HotPDF 拒絕超出範圍的值。對 wght 軸只到 900 的字型選字重 1000,註冊會拋出例外,訊息點名座標軸、要求的值與允許範圍。默默夾限會產出與畫面預覽不一致的 PDF,所以這個檢查該放在你的 UI 裡,滑桿上限直接取 MinimumValue 與 MaximumValue
為什麼座標軸選定必須先於 RegisterUnicodeTTF
座標軸選定只在 RegisterUnicodeTTF 載入字型檔那一刻讀取一次,所以必須事先設定。SetVariableFontAxis 接受四位元組可列印 ASCII 標籤與一個有限數值;其他輸入立即拋出例外,同一標籤再設定則覆蓋先前的值。GetVariableFontAxisSelections 回傳目前待處理的選定,ClearVariableFontAxes 清空清單。註冊之後,GetRegisteredVariableFontAxes 回報凍進最近註冊字面的完整座標組,未選定的軸以預設值補齊
var
Pdf: THotPDF;
Frozen: THPDFVariableFontAxisValueArray;
I: Integer;
begin
Pdf := THotPDF.Create(nil);
try
Pdf.FileName := 'quarterly.pdf';
Pdf.BeginDoc;
Pdf.SetVariableFontAxis('wght', 620); // 半粗體,不是具名實例
Pdf.SetVariableFontAxis('wdth', 87.5); // 半窄縮
Pdf.RegisterUnicodeTTF('C:\Fonts\Inter.ttf');
Pdf.ClearVariableFontAxes; // 不留任何待處理選定給下一個字型
Frozen := Pdf.GetRegisteredVariableFontAxes;
for I := 0 to High(Frozen) do
Writeln(Format('%s = %g', [string(Frozen[I].Tag), Frozen[I].Value]));
Pdf.CurrentPage.SetFont('Inter', [], 14, DEFAULT_CHARSET);
Pdf.CurrentPage.UnicodeTextOut(60, 70, 0, 'Quarterly results');
Pdf.EndDoc;
finally
Pdf.Free;
end;
end;
註冊後緊接著的 ClearVariableFontAxes 呼叫,正是大家會漏掉的那一行。選定會一直掛著直到被清掉,所以下一個 RegisterUnicodeTTF 若載入靜態字型,會因為對非可變字型供給了座標軸選定而拋出例外;若載入另一個沒有 wdth 軸的可變字族,也會因為該軸不存在而拋出。兩種失敗都爆在離設定座標軸很遠的地方。每次註冊後都清掉,選定就只會綁在它原本針對的那個字型上
當每個解出的值都等於該軸預設值時,TrueType 可變字型會照原樣註冊,因為它儲存的外框本來就是預設實例。前述重建只在非預設座標或 CFF2 外框時才會執行
透過 OnVariableFontInstance 供給你自己的實例器
只要至少一個座標軸偏離預設,OnVariableFontInstance 就會在註冊過程中觸發,並帶來原始字型位元組與解出的座標。處理常式可以讓 Handled 維持 False、交給內建實例器繼續,也可以設成 True、把自己的靜態字型放進 InstanceFontBytes 回傳。HotPDF 使用回傳字型前會先檢查:少於 12 位元組,或仍含有 fvar 的字型,都會拋出例外而不是被內嵌
procedure TReportBuilder.VariableFontInstance(Sender: TObject;
const SourceFontBytes: TBytes;
const AxisValues: THPDFVariableFontAxisValueArray;
out InstanceFontBytes: TBytes; out Handled: Boolean);
var
I: Integer;
Coords: string;
begin
InstanceFontBytes := nil;
Handled := False; // 繼續使用內建實例器
Coords := '';
for I := 0 to High(AxisValues) do
Coords := Coords + Format('%s=%g ',
[string(AxisValues[I].Tag), AxisValues[I].Value]);
// FLog 是你自己的記錄器;記下這份 PDF 將含有的內容
FLog.Add(Format('instancing %d-byte font at %s',
[Length(SourceFontBytes), Coords]));
end;
// 接線:Pdf.OnVariableFontInstance := VariableFontInstance;
多數應用程式應該只把這個處理常式拿來記日誌,如上例。另外換掉實例器只在一種情境下合理:應用程式之外的字型管線已經在產出經核可的靜態實例,而 PDF 必須與它們逐位元組一致;否則內建路徑能讓量度、版面資料表與中繼資料彼此一致,而這種一致性正是實例化的全部意義
實例化如何與子集化及塑形互動
實例化在子集化之前執行,子集器看到的是普通的靜態字型:它計算字符封閉集合,保留文件用到的字符、丟掉其餘,如 字型子集封閉集合與已塑形字符 一文所述。HotPDF 快取用的識別碼由實例位元組衍生,所以同一字族的兩組座標永遠不會共用同一筆快取
塑形讀的是實例化後的版面資料表。GSUB 與 GPOS 在實例化後保留,變化資料已經解完,所以連字與 OpenType GSUB 風格替代字符 一文描述的替代字形繼續可用,而用 feature variations 在超過某個字重時換字符的字型,也會換到符合 620 的那一個。定位才是版面程式碼出錯的地方:半窄縮實例的前進寬度比預設窄,而 GetWideTextWidth 用實際註冊字面的前進寬度來量。在 RegisterUnicodeTTF 之後量測,你算出來的斷行才會是實際印出來的斷行
可變字型實例化與內嵌、子集化、塑形共用同一條管線,適用 Delphi 與 C++Builder 的完整字體排印功能清單列於 HotPDF Delphi PDF 元件頁面