pdf.js 标准字体资源探秘:external/standard_fonts 目录的 Foxit 与 Liberation 字体体系详解

原创2026-09-17 17:21:001,430 阅读
文章标签:前端图像处理

pdf.js 标准字体资源探秘:external/standard_fonts 目录的 Foxit 与 Liberation 字体体系详解

本文以 pdf.js 仓库 external/standard_fonts/README.md 为线索,系统梳理 pdf.js 内置标准字体资源(Foxit 系列 PFB 字体与 Liberation Sans 系列 TTF 字体)的来源、许可证约定及其与 src/core 层字体引擎的深层耦合关系,帮助读者理解 PDF 的"标准 14 字体"在浏览器端是如何被精确复刻与替换的。

一、为什么 pdf.js 需要自带字体文件

PDF 规范定义了 14 种"标准字体"(Standard 14 Fonts):Times(4 个变体)、Helvetica(4 个变体)、Courier(4 个变体)、Symbol 与 ZapfDingbats。理论上,任何 PDF 阅读器都应无条件支持这些字体,PDF 文档内可以完全不嵌入这些字体的字形数据,仅靠字体名称引用它们。

这就给纯 JavaScript 的 PDF 渲染器 pdf.js 提出了一个难题:浏览器本地并不保证安装 Times、Helvetica、Courier 等字体,且各操作系统提供的同名字体字形与度量(metrics)并不一致。为了让不同平台上渲染出的 PDF 页面效果一致,pdf.js 必须在代码仓库内自带这些标准字体的二进制文件,并在渲染时用它们精确替代文档中引用的标准字体名。

这些字体文件正是存放在 external/standard_fonts 目录下,而 external/standard_fonts/README.md 则是这一目录的"身份说明书",明确了每个字体的来源与许可条款。

二、Foxit 字体:PDFium 的 PFB 文件

2.1 来源与版权

README 明确记载:目录中的 .pfb 文件是从 PDFium(Chromium 的 PDF 引擎)中提取的:

The pfb files in this directory were extracted from Pdfium.

其原始版权声明为:

Copyright 2014 PDFium Authors. All rights reserved.
 Use of this source code is governed by a BSD-style license that can be
 found in the LICENSE file.

Original code copyright 2014 Foxit Software Inc. http://www.foxitsoftware.com

即:这些字形的原始实现版权属于 Foxit Software Inc.(2014),由 PDFium 项目按 BSD 风格许可证(见 LICENSE_FOXIT)再分发,pdf.js 从 PDFium 提取后纳入本仓库。

2.2 目录中的 10 个 PFB 文件

external/standard_fonts 目录下共有 10 个 Type 1(PFB 格式)字体文件:

文件 对应 PDF 标准字体
FoxitFixed.pfb Courier
FoxitFixedBold.pfb Courier-Bold
FoxitFixedItalic.pfb Courier-Oblique
FoxitFixedBoldItalic.pfb Courier-BoldOblique
FoxitSerif.pfb Times-Roman
FoxitSerifBold.pfb Times-Bold
FoxitSerifItalic.pfb Times-Italic
FoxitSerifBoldItalic.pfb Times-BoldItalic
FoxitSymbol.pfb Symbol
FoxitDingbats.pfb ZapfDingbats

PFB(Printer Font Binary)是 Adobe 的 Type 1 字体二进制封装格式。这 10 个文件恰好覆盖了标准 14 字体中的 10 个:Courier 家族 4 个、Times 家族 4 个,以及 Symbol、ZapfDingbats 各 1 个。

2.3 许可证要点

LICENSE_FOXIT 是完整的 BSD 3-Clause 风格许可证文本,核心条款包括:

  • 允许源码与二进制形式的再分发,但必须保留上述版权声明、条件列表和免责声明;
  • 二进制形式再分发时,必须在文档或其他材料中复现版权声明;
  • 未经事先书面许可,不得使用 Google Inc. 或贡献者的名字为衍生产品背书。

这意味着任何基于 pdf.js 的再分发,都应在分发物中保留 Foxit/PDFium 的版权声明(即本目录中的 LICENSE_FOXIT 文件)。

三、Liberation Sans:GPLv2 + Liberation 字体例外

3.1 版本与许可证

Helvetica 家族(4 个变体)在 pdf.js 中并不是用 Foxit 的 PFB 实现,而是使用 Liberation Sans 的 TTF 文件。README 特别强调:

The LiberationSans-*.ttf files are the unmodified upstream release of Liberation Sans 1.07.4

即目录中的 4 个 TTF 是 Liberation Sans 1.07.4 上游原版发布文件,未做任何修改,其许可证为 GNU General Public License v2 + Liberation 字体例外条款(见 LICENSE_LIBERATION,该文件即随上游发布包附带的 License.txt 与 COPYING 的副本)。

LICENSE_LIBERATION 的开头即写明:Red Hat 依据 GPL v2 及下述例外条款授予许可,其中两条关键例外是:

  • 文档嵌入例外:如果用该字体创建文档并嵌入字体(或未修改的字体片段),该字体本身不会导致文档被 GPL 覆盖;
  • 物理产品例外:在物理产品中分发字体目标码时,必须赋予用户访问和修改源码、并在同一物理产品上重装修改后版本的权利。

3.2 重要版本陷阱:Liberation 2.0 起改为 OFL

README 明确指出一个升级时的关键坑点:

Note that Liberation 2.0 and later are licensed under the SIL Open Font License 1.1 instead, so LICENSE_LIBERATION must be updated as well whenever these font files are replaced.

即 Liberation 2.0 及更高版本改用 SIL Open Font License 1.1(OFL-1.1),与当前 1.07.4 的 GPLv2+例外许可完全不同。因此,如果未来升级这些字体文件,必须同步更换 LICENSE_LIBERATION,否则会因许可证文本与字体实际许可证不匹配而造成合规问题。

3.3 目录中的 4 个 TTF 文件

文件 对应 PDF 标准字体
LiberationSans-Regular.ttf Helvetica
LiberationSans-Bold.ttf Helvetica-Bold
LiberationSans-Italic.ttf Helvetica-Oblique
LiberationSans-BoldItalic.ttf Helvetica-BoldOblique

四、源码层的"字形宽度烘焙"机制

README 末尾给出了本目录与源码工程之间最关键的耦合说明:

The glyph order of these files is baked into src/core/liberationsans_widths.js and into the per-glyph scale factors in src/core/*_factors.js, so those files need to be regenerated when the fonts are updated.

这意味着:Liberation Sans 的字符顺序(glyph order)被"烘焙"进 pdf.js 的 JavaScript 源码,共涉及两类文件:

4.1 宽度表:src/core/liberationsans_widths.js

src/core/liberationsans_widths.js 以整数数组形式记录了 Liberation Sans 各字形的水平宽度,例如文件开头的注释明确写着:

// Widths of glyphs in LiberationSans-Bold.ttf.
const LiberationSansBoldWidths = [
  365, 0, 333, 278, 333, 474, 556, 556, 889, 722, 238, 333, 333, 389, 584, 278, ...

这些宽度值(单位为千分之一 em)按 TTF 的 glyph 顺序排列。pdf.js 渲染文本时,不依赖浏览器对字体的度量报告,而是直接查这张表来计算字符占位宽度,从而保证布局稳定可复现。

4.2 缩放系数:src/core/*_factors.js

除了宽度表,还有一组"每字形缩放系数"文件,用于把 Liberation Sans 的度量微调成与目标字体一致。例如 src/core/helvetica_factors.js 的文件头注释说明:

// Factors to rescale LiberationSans-Bold.ttf to have the same
// metrics as NimbusSans-Bold.otf.

即:将 LiberationSans-Bold.ttf 逐字形缩放,使其度量与 NimbusSans-Bold.otf 一致。这类 per-glyph 缩放系数文件还包括 calibri_factors.js、segoeui_factors.js、myriadpro_factors.js 等,共同服务于不同非标准字体向标准字体的度量对齐。

从源码结构看,这些 *_factors.js 与 liberationsans_widths.js 是在字体文件更新后由构建脚本重新生成的——因此 README 的警告是双重的:更换字体文件 ≠ 只替换 TTF,必须同步重新生成宽度表与缩放系数,否则会出现字形错位或宽度错乱。

五、从 README 到渲染管线:字体文件如何被使用

5.1 字体名称 → 文件名的映射

src/core/standard_fonts.js 中的 getFontNameToFileMap 将 PDF 标准字体名映射到上述字体文件,例如:

const getFontNameToFileMap = getLookupTableFactory(function (t) {
  t.Courier = "FoxitFixed.pfb";
  t.Courier-Bold = "FoxitFixedBold.pfb";
  ...
  t.Helvetica = "LiberationSans-Regular.ttf";
  t["Helvetica-Bold"] = "LiberationSans-Bold.ttf";
  ...
  t["Times-Roman"] = "FoxitSerif.pfb";
  ...
  t.Symbol = "FoxitSymbol.pfb";
  t.ZapfDingbats = "FoxitDingbats.pfb";
  t["LiberationSans-Regular"] = "LiberationSans-Regular.ttf";
  ...
});

与此同时,getStdFontMap 还维护了一张"标准 14 字体 + 常见别名"的映射表(如 Arial → Helvetica、TimesNewRoman → Times-Roman、CourierNew → Courier 等),用于把 PDF 中实际使用的字体名归一化到标准字体名。

5.2 替换候选:font_substitutions.js

src/core/font_substitutions.js 中保存了替换字体的元数据列表,例如对 Helvetica:

[
  "Helvetica",
  {
    alias: "Helvetica",
    path: "LiberationSans-Regular.ttf",
    style: NORMAL,
    ultimate: "sans-serif",
  },
],

该列表还包含 Arimo、Nimbus Sans、TeX Gyre Heros、DejaVu Sans 等候选替换字体及其 ultimate 回退族,供无法嵌入字形时选择最接近的替代方案。pdf.js 会结合 getFontNameToFileMap 与替换列表,决定最终加载哪个内置字体文件。

5.3 构建与分发:gulpfile.mjs 的集成

从 gulpfile.mjs 的构建任务可以看到标准字体的打包方式:

  • 构建时将 external/standard_fonts/*.pfb、external/standard_fonts/*.ttf 以及 LICENSE_* 一并收集,生成 web/standard_fonts 目录(如 gulpfile.mjs 所示);
  • 各分发目标(通用构建、Mozilla central、Chromium 扩展)都会把 web/standard_fonts 目录复制到各自的构建产物中。

也就是说,许可证文件(LICENSE_FOXIT / LICENSE_LIBERATION)与字体二进制是打包分发的一等公民,README 中记录的许可条款会随最终产品一并发布给终端用户。

六、维护与升级注意事项

综合 README 与源码,对 external/standard_fonts 目录的任何升级都应遵循以下清单:

  1. Foxit PFB 文件:如需替换,需保留 PDFium 的 BSD 版权声明(LICENSE_FOXIT),并确保新文件与 getFontNameToFileMap 中的文件名映射一致;
  2. Liberation TTF 文件:务必使用 Liberation Sans 1.07.4 或评估新版本的许可证变化——Liberation 2.0+ 已是 OFL-1.1,必须同步替换 LICENSE_LIBERATION;
  3. 重新生成派生数据:更换字体后,必须重新生成 src/core/liberationsans_widths.js 的宽度数组与 src/core/*_factors.js 的逐字形缩放系数,否则渲染度量将失准;
  4. 回归测试:标准字体的变化会直接影响所有未嵌入字体的 PDF 文档渲染,应跑完 test 目录下的字体相关单元测试与浏览器渲染测试后再合入。

结语

external/standard_fonts 目录虽小,却是 pdf.js 保证"标准 14 字体"跨平台一致渲染的基石:Foxit 系 PFB 覆盖 Times/Courier/Symbol/ZapfDingbats,Liberation Sans 1.07.4 覆盖 Helvetica,二者分别受 BSD 风格与 GPLv2+例外条款约束。任何对这批字体文件的更新,都必须同时考虑许可证文本、getFontNameToFileMap 映射、liberationsans_widths.js 宽度表与 *_factors.js 缩放系数的一致性——这正是 README 留给后续维护者最重要的工程警示。

登录后查看全文
pdf.js