技術文章

PDF 中的可變字型:Delphi 靜態實例化

設計團隊為報表標題指定 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 的字型,等於邀請任何認得變化的消費端把同一批差異值再套一次

HotPDF 可變字型實例化管線圖解:在選定的 wght 與 wdth 座標上內插 gvar 差異值,重建量度與資料表,剝除變化資料表後成為可內嵌的靜態實例
HotPDF 在你選定的座標上內插 gvar 差異值,重建外框與量度,並剝除每一張變化資料表,讓內嵌字面讀起來就是普通的靜態 TrueType 字型

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 層,指回自身的畸形元件圖會以拒絕該字型收場,而不是無止盡遞迴

HotPDF 圖解:gvar 虛擬控制點承載左側邊距與前進寬度,以及在虛擬控制點推導的量度之上再套 HVAR、令每個前進寬度變寬的重複套用陷阱
有 gvar 時量度來自內插後的虛擬控制點,再疊用 HVAR 或 VVAR 等於同一份變化算兩次,整行文字逐漸向右漂移

用 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 元件頁面