技术文章

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 特性变体中的变化数据则在选定位置上完成解析

连描述性元数据也要动。OS/2 的 usWeightClass 取 wght 的值,所以字重 620 就记录为 620;usWidthClass 从 wdth 百分比映射而来,87.5 正好落在 class 4,即 semi-condensed;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-keyed CFF 的嵌入方式见CFF2 可变字体嵌入

幻影点与重复应用的陷阱

最微妙的一条规则关乎度量,而 OpenType 规范让它特别容易踩坑。在 gvar 中,一个字形的点数等于它的轮廓点数(复合字形则是组件点数)加上四个幻影点,这些幻影点编码左侧位移、前进宽度及其垂直方向的对应值。幻影点和其他点一样会收到增量

带 gvar 的字体十有八九也带 HVAR,因为 HVAR 让渲染器不必解码轮廓就能拿到前进宽度。两者都应用的话,每个前进宽度都会移动两次,两端对齐的文本会随字形一个个向右漂移。当 gvar 存在时,HotPDF 从插值后的幻影点推导水平与垂直度量,并忽略 HVAR 和 VVAR;只有不带 gvar 的字体才会把度量变化数据直接烘焙进 hmtx 和 vmtx。这个优先级是更安全的一个:gvar 是唯一在同一步操作里同时移动轮廓和度量的表,它的答案不可能与自己描述的字形相矛盾

还有两条规则保证几何不出错。稀疏增量集中未列出的点按轮廓用 IUP(插值未触及的点)推断,幻影点从不参与这种插值。复合字形的增量只在组件以 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,所以这个检查应该放在你的界面层——滑块的上下限可以直接取自 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 风格替代字形里描述的那些替代字形继续可用,用特性变体在超过某个字重时替换字形的字体也会得到与 620 匹配的替换。定位才是布局代码容易出错的地方。半窄体实例的前进量比默认实例窄,而 GetWideTextWidth 用的是实际注册字体的前进量来测量。把测量放在 RegisterUnicodeTTF 之后,你算出来的断行就是最终印出来的断行

可变字体实例化与嵌入、子集化、塑形位于同一条字体流水线,Delphi 和 C++Builder 的完整排版特性集合列在HotPDF Delphi PDF 组件页面