W3C

WOFF 文件格式 2.0

W3C 推荐标准,

本文档的更多详细信息
此版本:
https://www.w3.org/TR/2024/REC-WOFF2-20240808/
最新版本:
https://www.w3.org/TR/WOFF2/
上一版本:
https://www.w3.org/TR/2022/REC-WOFF2-20220310/
最新编辑草案:
https://w3c.github.io/woff/woff2/
历史:
https://www.w3.org/standards/history/WOFF2
实现报告:
https://www.w3.org/Fonts/WG/WOFF2/Implementation.html
https://w3c.github.io/woff/woff2/ImpRpt/
编辑者:
Vladimir Levantovsky (W3C Invited Experts)
前任编辑者:
Raph Levien (Google)
反馈:
WOFF 与 WOFF2 议题
勘误:
https://www.w3.org/Fonts/REC-WOFF2-20240808-errata.html

本页是非官方中文译文。W3C 英文原文是权威版本;本译文未经 W3C 认可。保留原版权和许可声明;W3C 软件与文档许可全文。

W3C Software and Document License (2023) — NOTICE
W3C Software and Document License (2023)
https://www.w3.org/copyright/software-license-2023/

This work is being provided by the copyright holders under the following license.

License

By obtaining and/or copying this work, you (the licensee) agree that you have read, understood, and will comply with the following terms and conditions.

Permission to copy, modify, and distribute this work, with or without modification, for any purpose and without fee or royalty is hereby granted, provided that you include the following on ALL copies of the work or portions thereof, including modifications:

The full text of this NOTICE in a location viewable to users of the redistributed or derivative work.

Any pre-existing intellectual property disclaimers, notices, or terms and conditions. If none exist, the W3C software and document short notice should be included.

Notice of any changes or modifications, through a copyright statement on the new code or document such as "This software or document includes material copied from or derived from [title and URI of the W3C document]. Copyright © [$year-of-document] World Wide Web Consortium. https://www.w3.org/copyright/software-license-2023/"

Disclaimers

THIS WORK IS PROVIDED "AS IS," AND COPYRIGHT HOLDERS MAKE NO REPRESENTATIONS OR WARRANTIES, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO, WARRANTIES OF MERCHANTABILITY OR FITNESS FOR ANY PARTICULAR PURPOSE OR THAT THE USE OF THE SOFTWARE OR DOCUMENT WILL NOT INFRINGE ANY THIRD PARTY PATENTS, COPYRIGHTS, TRADEMARKS OR OTHER RIGHTS.

COPYRIGHT HOLDERS WILL NOT BE LIABLE FOR ANY DIRECT, INDIRECT, SPECIAL OR CONSEQUENTIAL DAMAGES ARISING OUT OF ANY USE OF THE SOFTWARE OR DOCUMENT.

The name and trademarks of copyright holders may NOT be used in advertising or publicity pertaining to the work without specific, written prior permission. Title to copyright in this work will at all times remain with copyright holders.

摘要

本规范基于已广泛部署的 WOFF 1.0 的经验, 旨在提高压缩率, 从而降低网络带宽使用量,同时仍能 在移动设备上快速解压。其实现方式 是结合感知内容的预处理步骤 与改进的熵编码,优于 WOFF 1.0 使用的 Flate 压缩。

本文档的状态

本节描述本文档发布时的状态。当前 W3C 出版物列表以及本技术报告的最新修订版,可在 https://www.w3.org/TR/ 的 W3C 技术报告索引中查阅。

W3C 建议将本规范作为 Web 标准广泛部署。

本文档由Web 字体工作组按照推荐标准流程作为推荐标准发布。

W3C 推荐标准是经过广泛协商达成共识、得到 W3C 及其成员认可的规范,且工作组成员承诺为其实现提供免版税许可。

WOFF 2.0 规范已在所有主要浏览器中实现,并广泛用于生产网站。 它支持完整的 TrueType 和 OpenType 规范,包括可变字体、彩色字体和字体集合。

本文档自上次发布以来的完整变更 列表可供查阅。

包括压缩测量结果在内的支持材料,可在 配套的WOFF 2.0 评估报告中找到。工作组已 创建 测试,用于 WOFF2 编码器、 解码器、 浏览器及格式本身(WOFF2 验证器)。 构建这些测试的源代码可在 GitHub 获取。

可查阅实现报告。 注意,对于 OpenType 集合(原称 TrueType 集合),虽然编码和解码 分别已有两个经过测试的实现,但尚未证明有用户 代理能在解码后使用它们。浏览器对字体集合的支持 预计会改进,而一旦实现支持,WOFF 2.0 已经具备 所需的支持能力。

请通过GitHub 议题 发送对本文档的意见。

本文档由遵循W3C 专利政策的工作组制定。W3C 维护与该组交付成果有关的专利披露公开列表;该页面还包含披露专利的说明。若个人实际知悉某项专利,并认为该专利包含必要权利要求,则必须依据W3C 专利政策第 6 节披露该信息。

对于 WOFF 2.0 中使用的 Brotli 压缩方案,Google 已作出 供本规范使用的免版税许可承诺。

对于 WOFF 2.0,Monotype Imaging 已作出 供本规范使用的免版税许可承诺。

本文档受2023年11月3日 W3C 流程文档约束。

1. 引言

本文档规定 WOFF2 字体封装格式。该格式旨在 以相对容易实现的方式压缩字体数据, 并获得显著优于以往技术的压缩率,适用于 CSS @font-face 规则。相比此前开发的 WOFF 1.0 格式 [WOFF1],压缩率的提高 得益于改进的熵编码,以及字体数据的预处理和 优化步骤,这些步骤减少了各种字体数据结构中的固有冗余。 WOFF 2.0 开发历史的详细信息见 WOFF 2.0 评估报告 [WOFF2ER]。

1.1 记法约定

本文档中全大写的关键词“MUST”、“MUST NOT”、“REQUIRED”、“SHALL”、 “SHALL NOT”、“SHOULD”、“SHOULD NOT”、“RECOMMENDED”、“MAY”和“OPTIONAL” 应按 RFC 2119 [RFC2119] 中的说明解释。 如果这些词以小写或大小写混合形式出现,则应按 其通常的英语含义解释。

本文档包含标为“注意”的文字段落, 并与规范正文区分开。这些注释 旨在提供资料性的解释或澄清,为实现者和 用户提供提示或指导,但不属于规范性 文本。

本文档还使用十六进制记法“0x...”来定义 魔数或标签值等二进制常量、位字段 /标志的格式,以及伪代码按位运算符中使用的掩码值。

2. 一般要求

WOFF2 格式的主要目的是高效封装通过 CSS @font-face 规则链接到 Web 文档的字体。支持 WOFF2 链接字体文件格式的用户代理必须遵守 CSS3 Fonts 规范的要求 ([CSS3-Fonts] 第 4.1 节:@font-face 规则)。特别是, 此类链接字体 仅可供引用它们的文档使用;不得 供用户系统上的其他应用程序或文档使用。

输入字体文件可包含多种字体数据表,这些表描述于 [OFF] 规范第 5 章。字体文件中 表的顺序可能不同,虽然表目录中的条目 必须按标签升序排列,但实际的表可以在字体文件中 以任意顺序存放。

解压 WOFF2 文件时,解码器必须将表目录中的条目 按表标签的字母升序排列,并且应按照 [OFF] 的建议(第 8.1 小节“优化表顺序”) 安排字体文件中的表顺序。

3. 整体文件结构与基本数据类型

WOFF2 文件的结构与 SFNT 和 WOFF 1.0 字体文件类似, 即文件头后是表目录,再后是这些表的 数据。SFNT 结构的完整说明见 TrueType [TrueType]、OpenType [OpenType] 和 ISO“开放字体格式” [OFF] 规范。不过, WOFF2 在一些重要方面与 SFNT 不同。最显著的是, 所有字体表的数据被压缩在包含全部字体表的单一数据流中。 与 WOFF 1.0 类似,可选的扩展元数据块和私有数据块分别 作为独立数据块表示,并拼接成 WOFF 2.0 文件。 压缩字体数据流和扩展元数据块使用的 压缩算法均为 Brotli [Brotli]。

完整的 WOFF2 文件由多个数据块组成:48 字节的文件头,其后立即 依次跟随可变大小的表目录、可选的集合 目录(仅当输入字体文件为字体集合时存在)、压缩字体数据块、 可选的扩展元数据块,以及可选的私有数据块。除了 在规定表长度或块偏移按 4 字节对齐的位置 填充至多三个零字节外, 数据块之间、 WOFF2 文件头与表目录之间,或最后一个 数据块或表之后,不得有任何无关数据。 如果存在此类无关数据, 符合规范的用户代理必须将该文件作为无效文件拒绝。此外, 如果任何数据块或字体表的偏移和长度 指示文件中重叠的字节范围, 或超出文件末尾的范围,也必须将该文件作为无效文件拒绝。

WOFF2 文件
WOFF2Header 包含基本字体类型和版本、以及元数据和私有数据块偏移的文件头。
TableDirectory 字体表目录,包含大小等信息。  
CollectionDirectory 可选的表,包含字体集合条目的字体片段描述。  
CompressedFontData 字体表的内容,经过压缩后存储在 WOFF2 文件中。  
ExtendedMetadata 可选的扩展元数据块,以 XML 格式表示,并经过压缩后存储在 WOFF2 文件中。
PrivateData 供字体设计者、字库厂商或供应商使用的可选私有数据块。  

3.1. 数据类型

数据类型
UInt8 8 位无符号整数。 
Int16 二进制补码形式的 16 位有符号整数,以大端序存储。 
UInt16 16 位无符号整数,以大端序存储。 
UInt32  32 位无符号整数,以大端序存储。 
255UInt16 16 位无符号整数的变长编码,用于优化字体中间数据的存储。 
UIntBase128 32 位无符号整数的变长编码。 

255UInt16 数据类型

255UInt16 是范围为 0 到 65535(含两端)的 无符号整数的变长编码。此数据类型旨在作为各种 字体值的中间表示;这些值通常以 UInt16 表示, 但实际数值较小。根据编码值的不同, 数据字段长度可为一到三个字节,其中第一个字节的值 要么表示较小数值本身,要么作为代码,定义 附加字节的格式。下方的类 C 伪代码描述了 如何读取 255UInt16 格式:

    Read255UShort( data )
    {
        UInt8 code;
        UInt16 value, value2;

        const oneMoreByteCode1    = 255;
        const oneMoreByteCode2    = 254;
        const wordCode            = 253;
        const lowestUCode         = 253;

        code = data.getNextUInt8();
        if ( code == wordCode ) {
            /* Read two more bytes and concatenate them to form UInt16 value*/
            value = data.getNextUInt8();
            value <<= 8;
            value &= 0xff00;
            value2 = data.getNextUInt8();
            value |= value2 & 0x00ff;
        }
        else if ( code == oneMoreByteCode1 ) {
            value = data.getNextUInt8();
            value = (value + lowestUCode);
        }
        else if ( code == oneMoreByteCode2 ) {
            value = data.getNextUInt8();
            value = (value + lowestUCode*2);
        }
        else {
            value = code;
        }
        return value;
    }
    

注意,编码并不唯一。例如,数值 506 可 编码为 [255, 253]、[254, 0] 或 [253, 1, 250]。编码器可以生成 其中任一种,而 解码器必须接受所有这些形式。编码器应选择较短的 编码,并且对同一数值必须始终选择同一种编码, 因为这通常会获得更好的压缩效果。

UIntBase128 数据类型

UIntBase128 是另一种无符号整数的变长编码, 适用于最大为 232-1 的数值。UIntBase128 编码的数 由一串字节组成,除最后一个字节外,所有字节的最高位 均置位,最后一个字节的最高位清零。数值本身以 128 为基数, 编码在每个字节的低 7 位中。因此,UIntBase128 的 解码过程为:从 value = 0 开始。读取一个字节,将 value 设为 原 value 乘以 128 加上(该字节与 127 按位与的结果)。重复上一步,直到 该字节的最高位为 false。

UIntBase128 编码格式可能出现非最优编码,例如 同一数值可以用不同数量的字节表示(利用 前导零)。例如,数值 63 可以编码为一个字节 0x3F, 也可以编码为两个(或更多)字节:[0x80, 0x3f]。编码器不得这样做, 必须生成尽可能短的编码。解码器 如果遇到带前导零的 UintBase128 编码值 (以字节 0x80 开始的值)、长度超过 5 字节的 UintBase128 序列,或超过 232-1 的 UintBase128 编码值,必须拒绝该字体文件。下面的类 C 伪代码 描述如何读取 UIntBase128 格式:

    bool ReadUIntBase128( data, *result )
    {
        UInt32 accum = 0;

        for (i = 0; i < 5; i++) {
            UInt8 data_byte = data.getNextUInt8();

            // No leading 0's
            if (i == 0 && data_byte == 0x80) return false;

            // If any of top 7 bits are set then << 7 would overflow
            if (accum & 0xFE000000) return false;

            *accum = (accum << 7) | (data_byte & 0x7F);

            // Spin until most significant bit of data byte is false
            if ((data_byte & 0x80) == 0) {
                *result = accum;
                return true;
            }
        }
        // UIntBase128 sequence exceeds 5 bytes
        return false;
    }
    

3.2. WOFF2 文件头

WOFF 2.0 文件头包含识别签名,并提供 所封装字体数据压缩后与未压缩大小的 信息。它还指示 WOFF 2.0 文件所包含的 具体字体数据类型、字体版本号,并提供 文件内附加数据块的偏移。

WOFF2 文件头
UInt32signature0x774F4632 'wOF2'
UInt32flavor输入字体的“sfnt version”。
UInt32lengthWOFF 文件的总大小。
UInt16numTables字体表目录中的 条目数量。
UInt16reserved保留;设为 0。
UInt32totalSfntSize未压缩字体数据所需的 总大小,包括 sfnt 文件头、
目录 和字体表(含填充)。
UInt32totalCompressedSize压缩数据块的总长度。
UInt16majorVersionWOFF 文件的 主版本号。
UInt16minorVersionWOFF 文件的 次版本号。
UInt32metaOffset元数据块相对于 WOFF 文件开头的偏移。
UInt32metaLength压缩元数据块的长度。
UInt32metaOrigLength元数据块的 未压缩大小。
UInt32privOffset私有数据块相对于 WOFF 文件开头的偏移。
UInt32privLength私有数据块的长度。

WOFF2 文件头的解释方式与 [WOFF1] 中的 WOFF 文件头相同,仅增加一个 totalCompressedSize 字段。 WOFF2 文件头中的 signature 字段 必须为 0x774F4632('wOF2'),用于 与 WOFF 1.0 文件区分。如果该字段 不含此值,用户代理必须将文件作为无效文件拒绝。 有效的 WOFF 2.0 文件 必须将保留字段设为“零”,但解码器 不得因为文件头保留字段的值非零 而拒绝下载的字体文件。用户代理 不得因为正确解码后所得字体文件的大小 与 WOFF2 文件头中编码的 totalSfntSize 值不符而拒绝该字体文件。

WOFF2 文件头中的“totalSfntSize”值仅供 参考。它可能表示未压缩输入字体文件的大小,但如果存在变换后的 'glyf' 和 'loca' 表,重建表的未压缩大小及 解压后的字体总大小可能与 WOFF2 文件头所指定的原始总大小 有很大差异。

4. 字体目录

字体目录部分包含表目录,输入字体文件中的每个唯一字体表 对应一个条目;当输入文件为字体集合时,还可包含 可选的集合目录表。

4.1. 表目录格式

表目录是下文定义的 WOFF2 表目录条目 数组。目录紧接 WOFF2 文件头之后,因此 文件头中没有指向此块的显式偏移。 其大小取决于具体内容;因此,最佳解码策略 是按流处理文件,而不是尝试 随机访问。每个表目录条目指定一个字体数据表的 原始大小;对于应用了额外变换的表, 还指定变换后的大小。变换后的表通过 'flags' 字段识别, 该字段组合已知表标签(位 0–5,见“已知表标签”)和变换 版本号(位 6 和 7,见下文说明),以确定所用变换。 表标签与变换版本号的组合确定了 对表应用的具体变换。目前定义的变换详见 本规范第 5 章。

与原始输入字体文件中的表目录条目 按字母升序排列不同, WOFF2 表目录条目定义了各表被处理 并编码到压缩字体数据流中的物理顺序。 字体文件解压时,解码器负责对重建的表目录 排序并重新排列。

为简化字体解码过程,编码器 必须重新排列变换后的 表,使关联的 'glyf' 和 'loca' 表始终成对出现, 且 'loca' 表跟在 'glyf' 表之后。 注意,变换后的 'loca' 表条目只是占位符,指示 重建该表所需的大小,而不占用数据流中的字节。 因此,要求表目录中的 'loca' 条目紧接变换后的 'glyf' 表,可以简化 'loca' 表重建步骤的实现, 该步骤在对 'glyf' 表应用逆变换(详见第 5.1 小节) 时执行。表顺序约束的更多信息见 第 5.5 小节。

各个表目录条目的格式如下:

TableDirectoryEntry
UInt8flags表类型和标志
UInt32tag4 字节标签(可选)
UIntBase128origLength原始表长度
UIntBase128transformLength变换后长度(若适用)

flags 字段的解释如下。位 [0..5] 包含“已知标签” 表的索引,该表列出字体中可能出现的标签。如果标签 不在表中,此位字段的值为 63。位 6 和 7 指示 对各表应用的预处理变换版本号(0–3)。 对于除 'glyf' 和 'loca' 之外的所有字体表,变换版本 0 表示空变换,即原始表数据 直接交给 Brotli 压缩器,纳入压缩数据流。 对于 'glyf' 和 'loca' 表,变换版本 3 表示空 变换,即原始表数据直接交给 Brotli 压缩器, 不应用第 5.1 小节和 第 5.3 小节定义的预处理。 变换后的表格式及相应的变换版本号 详见本规范第 5 章。

若某个表定义了多个变换版本,编码器通常应 选择使变换后表长度最小的版本, 除非减少量微不足道。

若某个表标签定义了多个变换版本,编码器 可使用适用于输入数据的任何已定义变换;解码器 必须能够接受 任何已定义的变换。 如果解码器 遇到指定未知变换版本号的表条目, 则必须拒绝整个字体,因为无法正确解码。

字体表采用已知表标签编码,还是显式包含 四字节标签,在语义上没有区别;这只是旨在提高压缩效率的 编码选择。同样,某个四字节 标签是否出现在“已知表标签”表中,也不是关于 此标签是否应包含在 Web 字体中的规范性声明。编码器在编码标签已列于 “已知表标签”表中的输入字体表时,必须使用已知表标志。

对于未列入已知标签列表的自定义表标签 (或未来可能定义的新标准标签),存在预定义的扩展机制。 如果 flags 字节的位 [0..5] 为 63(0x3f), 则标志字节之后跟随一个任意的 4 字节标签值。否则, TableDirectoryEntry 结构省略 tag 字段,并根据标志字节的位 [0..5] 从下方固定的“已知表标签”表推导标签。解码器 可以接受以自定义表标签 定义的表条目,即使其后跟随的标签被识别为 某个已知表标签。

已知表标签
标志 标签 标志 标签 标志 标签 标志 标签
0cmap16EBLC32CBDT48gvar
1head17gasp33CBLC49hsty
2hhea18hdmx34COLR50just
3hmtx19kern35CPAL51lcar
4maxp20LTSH36SVG 52mort
5name21PCLT37sbix53morx
6OS/222VDMX38acnt54opbd
7post23vhea39avar55prop
8cvt 24vmtx40bdat56trak
9fpgm25BASE41bloc57Zapf
10glyf26GDEF42bsln58Silf
11loca27GPOS43cvar59Glat
12prep28GSUB44fdsc60Gloc
13CFF 29EBSC45feat61Feat
14VORG30JSTF46fmtx62Sill
15EBDT31MATH47fvar63后跟任意标签

注意,根据基于 SFNT 的字体格式规范, 所有表标签应由四个字符组成。少于四个字母的标签,如 “cvt ”(标签值 0x63767420),需在末尾填充空格。

flags(及可选 tag 字段)之后是一或两个长度值,均以 UIntBase128 无符号整数编码。origLength 字段指定 字体未压缩版本中该表的长度。对于还要进行额外 变换的表, 必须包含 transformLength 字段, 指定该表变换后版本的长度。

当且仅当表在 Brotli 压缩前经过非空变换时, 表目录条目中才存在 transformLength 字段。 未变换的表,其目录条目不含 transformLength 字段。

变换后长度字段提供该表在经过 [Brotli] 压缩前的变换后大小。 此字段可选,仅在某些表中存在(见下文 “压缩数据格式”说明)。注意,虽然变换后长度 可用于确定解压后的表大小,但变换后字体表的 原始表长度应谨慎对待。

变换后表的重建过程保证保留表的功能, 但可能产生与原始数据不同的二进制 结果。例如,'glyf' 表记录可使用一或两个字节的格式 编码轮廓点坐标,重复值可以在坐标流中 显式重复,也可以省略(由控制点的 标志字节指示)。因此,字形轮廓点可有多种表示, 均产生相同的渲染结果;然而,重建字形记录的 二进制数据可能与原始数据相差很大。详见 ISO“开放字体格式”[OFF] 规范第 5.3.3 小节。

因此,变换后表的 origLength 字段值应仅作为 参考,在解码 WOFF2 数据时,不应据此决定 内存分配。

4.2. 集合目录格式

集合目录仅在输入字体为集合时存在,即 WOFF2 文件头的“flavor”字段为 0x74746366('ttcf')时。若存在,集合目录紧接 表目录之后,由一个 CollectionHeader 和一或 多个 CollectionFontEntry 记录组成。

如果输入字体为集合,表目录对 整个集合中的每个唯一表包含一个条目,无论该表 是否由集合中的不同字体共享。因此,使用 WOFF2 压缩的 字体集合,其表目录包含该集合文件中 所有字体的全部表。

集合目录以集合头开始,后跟集合 字体条目的数组。

CollectionHeader
UInt32version原始字体中 TTC 头的版本。
255UInt16numFonts集合中的字体数量。

集合字体条目指定集合中的各个字体(数量由 CollectionHeader 的“numFonts” 字段定义)。每个条目的格式如下:

CollectionFontEntry
255UInt16numTables此字体的表数量
UInt32flavor字体的“sfnt version”
255UInt16index[numTables]为此字体的每个表标识表目录条目的索引(表目录首个条目的索引为零)。

原始集合中某个表的偏移若被多个偏移表引用, 则视为“共享”。编码器 必须为每个由偏移定义的唯一字体表输出一个 TableDirectoryEntry, 无论该表是否由集合中的多个字体共享。 即,如果集合中多个字体的相应表记录引用 相同偏移的共享字体表, 则不得在 WOFF2 压缩数据流中重复该表数据。

如果输入文件是包含多个唯一 glyf 和 loca 表的字体集合,则所述 变换,即针对 glyf 和 loca 表的变换, 必须应用到每一 对表。允许并鼓励共享 glyf 和 loca 表(这是字体集合的主要优点之一);不过, 集合中可能有两对或更多对 glyf /loca 表无法共享。共享表时,编码器 必须验证两个表均被 共享且构成关联的一对(若存在多对 glyf /loca 表),并且 必须拒绝包含仅共享 glyf 或 loca 其中之一的字体的集合。

处理字体集合时,编码器 必须保留输入集合中各嵌套字体的原有顺序,并且 必须为每个字体将匹配的 TableDirectoryEntry 索引记录到 CollectionFontEntry 中。

解码器必须还原 字体数量相同、并含相应偏移表的集合。输出集合文件 各字体的偏移表 必须具有与输入集合相同的 numTables;若原始输入偏移表含 DSIG, 则该值少一。如果 CollectionHeader 中 TTC 头的版本字段 设为“2.0”,解码器必须将输出集合的 TTC 头字段 {ulDsigTag, ulDsigLength, ulDsigOffset} 设为 null,或将 TTC 头格式转换为版本 1(0x00010000)。

处理字体集合时,解码器 必须重建输入集合中各嵌套字体的原有顺序。各嵌套字体 内部的表可以重排。处理存在多对 'glyf'/'loca' 表的集合时,解码器 必须检查 CollectionFontEntry 索引,确保所引用的 'glyf' 和 'loca' 表彼此配对, 并在发现配对不匹配时拒绝该集合。表配对的更多 信息见表目录格式说明。 符合规范的用户代理必须能加载 并使用 WOFF2 解码器生成的格式正确的字体集合文件。

5. 压缩数据格式

WOFF2 文件的 CompressedFontData 字段包含各字体表数据的拼接, 其顺序与 WOFF2 表目录中的条目顺序一致。 解压后的数据流中,表条目之间 不得存在表目录定义之外的无关数据。 若存在此类数据, 符合规范的用户代理必须将文件作为无效文件拒绝。 CompressedFontData 流必须使用 Brotli 压缩算法 [Brotli] 压缩。如果数据块因任何 原因解压失败,WOFF2 文件均为无效, 不得加载。

WOFF2 字体表数据的解码过程可规定为: 先解除 CompressedFontData 字段的字节级压缩, 得到“表数据块”,再应用下文描述的 附加解码步骤。实际实现可合并这些步骤, 或以增量或流式方式执行其中部分步骤,但 结果必须与此处规定的顺序过程一致。

某些表(如 glyf、loca 和 hmtx,由各自标签标识)会进行 额外变换。若表未变换,其数据以原样 出现在压缩流中,占表数据块的 origLength 字节。是否变换以及所用变换版本号,由 标志的最高两位定义(详见第 4.1 小节), 表数据还须按下文指定的变换处理。 在这种情况下,变换后的表占表数据块的 transformLength 字节。

解压并重建后的 表数据必须按 [OFF] 规范指定的格式存储。每个 重建的表目录条目必须包含有效的 'checkSum' 值, 解码器必须重新计算每个解码后表的 checkSum。 此外,由于对 glyf 和 loca 表应用了修改性变换,解码器 必须重新计算整个字体的 checkSumAdjustment 值,并将更新后的值存储在 head 表中。

不应依赖已知表标志值来判断是否存在 变换后的表。例如,glyf 表可在 目录中表示为 flag = 10 且无 tag,或 flag = 63 并后跟 'glyf' 标签。应结合定义变换 版本号的 flags 值和表标签来确定所用变换。

表目录中 origLength (未变换表)与 transformLength(变换后表)字段的 总和,必须等于使用 [Brotli] 解压后的字体数据块大小。若 解压后的大小与上述表目录 定义的长度总和不符, 则不得加载该 WOFF2 文件。

根据当前 WOFF2 版本,可对三种表应用变换: 表示轮廓数据的 glyf,loca, 用于表示 glyf 表内各个字形的偏移,以及 表示字形水平度量的 hmtx,前提是字体包含这些表。 创作工具可使用任何适用的变换,同时考虑 第 5.3 小节和 第 5.5 小节的额外约束。glyf 表变换 规定于第 5.1 小节,loca 表变换规定于第 5.3 小节, hmtx 表变换规定于 第 5.4 小节。

CFF 表处理与去子例程化。

多数使用 CFF 轮廓的 OpenType 字体,通过将 CFF 数据子例程化来 更紧凑地存储数据。WOFF2 开发与评估 中的实验表明,若在 WOFF2 编码前对 CFF 轮廓数据 进行去子例程化,Brotli 压缩可更高效地工作, 并获得更好的压缩率,平均减少压缩数据大小 约 5–10%。不过,CFF 去子例程化同时会使 输出文件大小增加约 10%。

CFF 预处理/去子例程化视为可在 WOFF2 编码前 实现的外部步骤,因此不属于本规范范围。 字体生产者可优化生产流程,选择 减小压缩字体大小以实现最快的 Web 字体传输,代价是 增大输出 CFF 字体大小(但也会改善渲染性能); 或保留子例程化的 CFF 数据,以最小化输入/输出字体大小。

WOFF 2.0 对某些表应用的变换,旨在减少和/或 消除 SFNT 格式中的固有冗余,并重组字体数据 流以提高熵编码效率。因此,重建后的字体数据 将保留输入字体的全部功能,但由于可能存在 编码差异(例如 'glyf' 表中轮廓点坐标的 不同优化程度,和/或 'loca' 表偏移 计算的差异),不同 WOFF2 解码器生成的输出文件可能 与输入文件不逐位一致。输入字体的表还可能 在编码过程中重排, 或由解码器重排以符合 [OFF] 规范推荐的表顺序 – 因此, 即使表内容不变,其偏移也可能改变。 编码前后字体数据结构中的二进制差异 (即使很小,且主要源于解码器优化和表重排) 会使已有的 'DSIG' 表失效。因此,符合规范的 WOFF2 编码器 必须从输入字体数据中移除 DSIG 表,然后再应用变换与熵编码。

WOFF 2.0 编码器还必须设置 head 表 'flags' 字段的第 11 位 (见 [OFF] 规范),表明 重建字体经过无损的修改性变换。

5.1. 变换后的 glyf 表格式

glyf 表数据可采用两种格式之一存入 WOFF2, 格式由变换版本号定义(编码在表目录标志位中, 详见第 4.1 小节)。变换版本“3” 定义空变换,glyf 表内容 以原始、未修改格式表示。下文指定的变换版本“0” 可选,用于消除 glyf 表数据中的某些冗余。

本小节指定的 glyf 表变换版本“0” (由表目录标志位定义,详见第 4.1 小节) 旨在减少冗余信息, 更高效地编码字形的实际 TrueType 轮廓。 此修改后的变换基于 MicroType Express [MTX] 规范中描述的类似变换。 MTX 引用为资料性内容;修改后变换的细节 规定于下文,本节为规范性内容。

虽然 glyf 表变换保留字体中每个字形的功能与渲染保真度, 但很可能生成一组新的字形记录, 其二进制数据与原始字体不一致。依据 [OFF] 第 5.3.3 小节的编码规则, 一个字形记录可能有多种有效重建方式。根据具体情形 以及对重建 glyf 数据应用的优化程度,重建表的大小可能大于、小于或等于 WOFF2 所压缩的输入字体原始 glyf 表大小。 本规范和 [OFF] 标准均不强制 对字体数据进行特定优化。因此,WOFF2 解码器 实现有责任确保从文件重建字形记录时分配 足够内存 – 原始 glyf 表大小, 即为变换后的 glyf 表提供的 origLength 值, 只能作为参考。

无论字形记录重建过程的实现细节如何, 也无论对重建 'glyf' 数据采用何种优化程度, 用户代理不得 因重建 'glyf' 表的大小不匹配 WOFF2 表目录 'glyf' 条目中编码的 origLength 值,而拒绝正确解码的字体文件。

为提高压缩效率,将 glyf 表拆分为 多个子流,把同类数据分组。变换后的表由 若干指定各子流大小的字段组成,随后 依次排列各子流。解码时进行逆变换, 将不同子流中的数据重新组合,为原始 glyf 表的每个条目创建完整字形记录。

变换后的 glyf 表
数据类型 语义 说明及值类型(若适用)
UInt16reserved0x0000
UInt16 optionFlags 位 0:置位时, 表示存在 overlapSimpleBitmap[] 位数组。 位 1–15:保留。
UInt16numGlyphs字形数量
UInt16indexFormatloca 表的偏移格式,应与 indexToLocFormat(位于原始 head 表)一致(见 [OFF] 规范)
UInt32nContourStreamSizenContour 流的字节大小
UInt32nPointsStreamSizenPoints 流的字节大小
UInt32flagStreamSizeflag 流的字节大小
UInt32glyphStreamSizeglyph 流的字节大小(变长编码值的流,见下文说明)
UInt32compositeStreamSizecomposite 流的字节大小(变长编码值的流,见下文说明)
UInt32bboxStreamSizebbox 数据的字节大小,为 bboxBitmap(紧凑位数组)与 bboxStream(Int16 值流)的长度之和
UInt32instructionStreamSize指令流大小(UInt8 值流)
Int16nContourStream[]Int16 值流,表示每个字形记录的轮廓数量
255UInt16nPointsStream[]表示字形记录中各轮廓的轮廓点数量的值流
UInt8flagStream[]UInt8 值流,表示每个轮廓点的标志值。
可变glyphStream[]字节流,以变长编码格式(定义于第 5.2 小节)表示点坐标值
可变compositeStream[]表示组件标志值及关联复合字形数据的字节流
UInt8bboxBitmap[]位图(长度为 numGlyphs 的位数组),指示显式边界框
Int16bboxStream[]表示字形边界框数据的 Int16 值流
UInt8instructionStream[]表示各对应字形指令集的 UInt8 值流
UInt8overlapSimpleBitmap[]长度为 numGlyphs 的位数组,提供每个 简单字形的重叠标志[位 6]值。 (复合字形的标志值 已经编码为 compositeStream[] 的一部分。)

描述解码过程,特别是指出哪些数据有效或无效, 最能说明此格式。另请注意,此格式在语义层面 规定解码结果,而不规定特定字节流。

变换后的 glyf 表含有 bboxBitmap,逐字形指示 边界框是否显式编码,或应从 坐标值推导。编码器和解码器都必须执行 确定边界框状态的相关计算。对于每个 简单字形, 编码器必须使用全部轮廓点(包括曲线上点和曲线外点) 计算 xMin、yMin、xMax 和 yMax,并将结果 与该字形已编码的边界框信息比较。若两者相同, 编码器必须省略边界框信息。否则, 如果 计算出的边界框值不等于字体中编码的字形值, 编码器必须设置相应的 bboxBitmap 标志, 并在 bboxStream 中记录原始边界框值。 对于包含零个轮廓的字形记录, 编码器必须检查边界框值全部为零;若不满足, 必须将输入字体作为无效字体拒绝。对于空字形或 零轮廓字形, 编码器必须始终清除相应的 bboxBitmap 标志。 对于复合字形, 编码器必须始终设置相应的 bboxBitmap 标志, 并在 bboxStream 中记录原始边界框值。

若需推导边界框,解码器必须执行类似 计算。对于给定字形,当 bboxBitmap 中相应位未设置时,必须在解码时 使用全部轮廓点坐标计算 xMin、yMin、 xMax 和 yMax。bboxBitmap 的总字节数 等于 4 * floor((numGlyphs + 31) / 32)。位紧凑排列, 字形 0 对应第一个字节的最高 位,字形 7 对应第一个字节的最低 位,字形 8 对应第二个字节的最高 位,依此类推。位值 1 表示显式设置边界框。

读取变换后的 glyf 表后,解码过程 逐个字形迭代。对每个字形,从变换后 glyf 表引用的各流中读取零或多个字节。 重建字形时,解码器还需为每个字形存储 其在新重建字形表中的偏移,这些数据 共同构成重建的 loca 表内容 (关于重建的更多信息,见下文第 5.3 小节, 其中说明 loca 表的重建)。

字形记录的重建

重建过程首先执行以下步骤,确定 编码的字形类型(简单、复合或空字形):

从 nContour 流读取一个 Int16,存入重建 TrueType 字形的 numberOfContours 字段。其解释与 TrueType 规范 相同:为零时,字形为空;为 正值时,字形为简单字形,且该值为轮廓 数量;nContour 为 -1(0xffff)时,字形为复合字形。

空字形的解码

空字形(nContour = 0)的重建很简单: 增加字形记录计数,并在 loca 表中创建新条目,满足 loca[n] = loca[n-1]。若 bboxBitmap 标志指示边界框值已显式编码在 bboxStream 中,解码器 必须将 WOFF2 文件 作为无效文件拒绝。

简单字形的解码

对于简单字形(nContour > 0),继续如下处理:

  1. 从 nPoints 流读取 numberOfContours 个 255UInt16 值,每个 值表示对应轮廓的点数。通过计算累积和再减去 一,将它们转换为 endPtsOfContours[] 数组。例如,流中的值若为 [2, 4],则 endPtsOfContours 为 [1, 5]。此外,读取的值的 总和就是字形的总点数 nPoints。在本例 中,nPoints 为 6。
  2. 从 flags 流读取 nPoints 个 UInt8 值,每个对应重建 字形轮廓中的一个点。标志 字节的解释详见第 5.2 小节。
  3. 对每个点(即 nPoints 次),从 glyph 流读取若干坐标 字节。字节数由前一步读取的标志 字节决定:(flag < 0x7f) 在 0–83 范围内时为一个字节,84–119 时为两个字节, 120–123 时为三个字节,124–127 时为四个字节(各范围均含端点)。按 第 5.2 小节的过程解码这些字节,重建 字形点坐标的 delta-x 和 delta-y。使用标准 TrueType 字形 编码,将这些值存入重建字形, 详见 [OFF] 第 5.3.3 小节。
  4. 从 glyph 流读取一个 255UInt16 值,即 instructionLength,表示指令字节数。
  5. 从 instructionStream 读取 instructionLength 个字节, 作为指令存入重建的字形。

optionFlags 第 0 位指示是否存在额外的 overlapSimpleBitmap[] 位数组。其他位均保留,应清零。 如果输入字体的所有简单字形都将 OVERLAP_SIMPLE 标志设为零, 编码器必须清除 optionFlags 第 0 位并省略 overlapSimpleBitmap[] 位数组。 如果输入字体中至少一个简单字形 的标志第 6 位已设置, 编码器必须将 optionFlags 第 0 位设为 “1”,且必须创建额外的 overlapSimpleBitmap[] 位数组,其中 相应位必须设置为输入字体中各 简单字形的标志第 6 位的值。

解码器 必须检查 optionFlags 第 0 位, 以确定额外的 overlapSimpleBitmap[] 是否包含在变换后的 'glyf' 表中。若不存在该位数组, 则在重建简单字形标志时, 解码器必须将全部 OVERLAP_SIMPLE 标志值设为零。 若包含 overlapSimpleBitmap[],解码器 必须使用其位设置重建 OVERLAP_SIMPLE, 并将相应位值设置为输出字体每个简单字形 首个标志字节的第 6 位。

复合字形的解码

对于复合字形(nContour == -1),以下步骤取代 上述步骤 1–5:

1a. 从 compositeStream 读取一个 UInt16,按 TrueType 规范 解释为组件标志字。根据标志值,另有 4 到 14 个参数字节,解释为字形索引、 arg1、arg2,以及可选的缩放或仿射矩阵。

2a. 从 composite 流读取步骤 1a 确定数量的 参数字节,存入重建字形。如果步骤 1a 的 标志字设置了 FLAG_MORE_COMPONENTS(位 5), 返回步骤 1a。

3a. 如果任何标志字设置了 FLAG_WE_HAVE_INSTRUCTIONS (位 8),则从 glyph 读取指令,并按 上述步骤 4 和 5 的过程 存入重建字形。

边界框的解码

对于简单和复合字形,如果边界框位向量中 相应位已设置,还需从 bbox 流读取 4 个 Int16, 分别表示 xMin、yMin、xMax 和 yMax, 并记录到重建字形的相应字段。 对于简单字形,如果边界框位向量中 相应位未设置,则计算轮廓中 x 和 y 坐标的 最小值与最大值,以推导并存储边界框。

复合字形必须显式提供边界框。 原因是计算边界框更复杂, 需要解析对组件字形的引用,同时考虑 复合字形指令及各组件指定的缩放, 这会与纯流式字体解码实现冲突。 解码器必须 检查复合字形记录中是否存在边界框信息, 不得加载缺少复合字形边界框数据的字体文件。

5.2. 变长 X 和 Y 坐标的解码

简单字形数据结构定义 组成字形轮廓的全部轮廓,表示为一系列 曲线上和曲线外的坐标点。这些坐标编码为增量值, 表示前一点与当前点相应 X 和 Y 坐标的差值;每个轮廓的第一个点 相对于 (0,0)。为尽量减小点坐标 数据集,每个点表示为 (flag, xCoordinate, yCoordinate) 三元组。标志值存于独立数据流, 坐标值作为字形数据流的一部分,以 变长格式编码,每点总计占 2–5 字节。

标志的最高位指示该点位于曲线上 还是曲线外 (最高位为 0 时, 该点在曲线上), 其余七位确定 X 和 Y 坐标值的格式, 指定 128 种可能的索引组合;这些组合 根据 TrueType 字体数据的典型统计分布 分配。X 和 Y 坐标使用半字节记录时 (每坐标 4 位或 12 位),位在字节流中紧凑排列, 先放 X 坐标(最高位在前),再放 Y 坐标 (最高位在前)。这样显著减小字形数据集的大小, 而把同类值(标志、坐标)分组到独立、连续的 数据流中,则可更高效地应用 编码第二阶段的熵编码。

128 个索引值中的每个都定义以下属性, 详见下表:

注意,“Byte Count” 字段表示三元组 (flag, xCoordinate, yCoordinate) 的总大小,包括 在独立流中编码的 ‘flag’ 值。

三元组编码
索引 字节数 X 位数 Y 位数 X 增量 Y 增量 X 符号 Y 符号
0208不适用0不适用-
10+
2256-
3256+
4512-
5512+
6768-
7768+
81024-
91024+
102800不适用-不适用
110+
12256-
13256+
14512-
15512+
16768-
17768+
181024-
191024+
2024411--
211+-
221-+
231++
2417--
2517+-
2617-+
2717++
2833--
2933+-
3033-+
3133++
3249--
3349+-
3449-+
3549++
36244171--
371+-
381-+
391++
4017--
4117+-
4217-+
4317++
4433--
4533+-
4633-+
4733++
4849--
4949+-
5049-+
5149++
52244331--
531+-
541-+
551++
5617--
5717+-
5817-+
5917++
6033--
6133+-
6233-+
6333++
6449--
6549+-
6649-+
6749++
68244491--
691+-
701-+
711++
7217--
7317+-
7417-+
7517++
7633--
7733+-
7833-+
7933++
8049--
8149+-
8249-+
8349++
8438811--
851+-
861-+
871++
88257--
89257+-
90257-+
91257++
92513--
93513+-
94513-+
95513++
963882571--
971+-
981-+
991++
100257--
101257+-
102257-+
103257++
104513--
105513+-
106513-+
107513++
1083885131--
1091+-
1101-+
1111++
112257--
113257+-
114257-+
115257++
116513--
117513+-
118513-+
119513++
1204121200--
121+-
122-+
123++
1245161600--
125+-
126-+
127++

三元组编码的补充信息和背景见 MTX 提案 [MTX] 第 5.11 节。

5.3. 变换后的 loca 表格式

loca 表可采用两种格式之一存入 WOFF2, 由变换版本号定义(编码于表目录标志位, 详见第 4.1 小节)。版本“3” 定义空变换,loca 表内容 以原始、未修改格式表示。版本“0”虽可选, 对于 loca 表,只要 glyf 表数据经过变换,就必须应用此变换。换言之,glyf 和 loca 要么均以变换后的格式存在, 要么均应用空变换。

loca 表变换版本“0” (由表目录标志位定义,详见第 4.1 小节) 规定如下。

变换后 loca 表的 transformLength 必须始终为零。 origLength 必须是适当大小(numGlyphs+1 乘以每字形大小; 若 indexFormat,定义见 第 5.1 小节 变换后的 glyf 表格式,为零, 每字形大小为两字节,否则为四字节)。若变换后的 loca 表的 transformLength 非零,或编码的 origLength 与上述计算 大小不符,解码器必须将 WOFF2 文件作为无效文件拒绝。

loca 表必须在 glyf 表解码时重建。 重建 loca 表的过程 规定于第 5.1 小节,作为 变换后 glyf 表解码的一部分。对于 重建的字形记录, 解码器必须存储各字形相应的偏移, 采用的格式由变换后表的 indexFormat 字段指定,该表为 glyf。

5.4. 变换后的 hmtx 表格式

hmtx 表数据可采用两种格式之一存入 WOFF2, 格式由变换版本号定义(编码在表目录标志位中, 详见第 4.1 小节)。变换版本“0” 定义空变换,hmtx 表内容 以原始、未修改格式表示。下文指定的变换版本“1” 可选,用于消除 hmtx 表数据中的某些冗余。

变换版本“1”利用 TrueType 字形的固有冗余: 按 TrueType 建议设计的字形轮廓,其左侧边距 很可能等于边界框的 xMin。 hmtx 表格式规定于第 5.2.4 小节,参见 [OFF]; 该表含两个左侧边距信息数组,分别用于比例和等宽 字形段。满足某些条件时,每个数组都可从原始数据中移除, 并从字形边界框信息重建。

变换后的 hmtx 表格式
数据类型 语义 说明及值类型(若适用)
UInt8 Flags 指示所用变换细节的位字段:
位 0:置位时表示 lsb[] 数组不存在,需从 glyf 表的 xMin 值重建;
位 1:置位时表示 leftSideBearing[] 数组不存在,需从 glyf 表的 xMin 值重建。
当表目录指示 hmtx 变换时, Flags(位 0、位 1 或两者)必须置位。 位 2–7 保留,必须为零。
UInt16 advanceWidth[] Uint16 值流,表示比例字形水平度量数组的 advanceWidth 值。流大小等于 numOfHMetrics,其定义位于 hhea 表中。
Int16 lsb[] Int16 值流,表示比例字形水平度量数组的左侧边距值。 仅当 Flags 第 0 位未设置时存在,否则省略。 流大小等于 numOfHMetrics,由 hhea 表定义。
Int16 leftSideBearing[] Int16 值流,表示等宽字形水平度量数组的左侧边距值。 仅当 Flags 第 1 位未设置时存在,否则省略。 流大小等于 (numGlyphs - numOfHMetrics)。

本小节的变换版本 1 可选,仅当输入字体 为 TrueType 类型(即含 glyf 表),且 hmtx 表中编码的比例或等宽字形段中,各字形的 leftSideBearing 恰好等于 glyf 中相应 xMin 时才能使用。编码的 leftSideBearing 对应空字形时需特别检查,只有空字形的该值 为零时才能应用 hmtx 变换。

若 hmtx 变换适用且希望采用,编码器 必须检查 字体中每个字形的 leftSideBearing 与边界框 xMin 是否相同 (空字形则检查 leftSideBearing == 0);对于字体集合, 必须对每一对相应的 glyf 和 hmtx 表执行此检查。若 比例或等宽字形段分别满足条件, 编码器必须将 hmtx 变换版本号设为“1”,必须从 hmtx 表移除对应数组,并设置相应 Flags 位。对于共享 hmtx 表的集合,必须检查字形边界框 xMin 与 lsftSideBearing 是否匹配,检查须涵盖共享 hmtx 与 不同 glyf 表的所有组合;若不匹配, 则不得应用 hmtx 表 变换。

当表目录标志指示应用 hmtx 变换时,用户代理 必须检查 Flags;若其无效,必须拒绝 WOFF2 文件。解码器必须根据 字形边界框信息提供的 xMin 值重建 lsb[] 和/或 leftSideBearing[], 信息来自 glyf 表。

5.5. 表顺序约束

以下对有效 WOFF2 文件的约束,旨在 支持节省内存的 WOFF 2.0 文件传输与解码。

表目录中的 loca 必须位于 glyf 之后。 WOFF2 包含单独编码的字体文件时,表目录可以 在 glyf 与 loca 之间插入其他表;但若包含字体集合,每个 loca 必须紧接其对应的 glyf。 例如顺序 'cmap', 'glyf', 'hhea', 'hmtx', 'loca', 'maxp' ... 对单独编码的字体可接受;但集合 必须将 glyf / loca 彼此配对,虽然 各对不必形成连续表块,例如 'cmap', 'glyf', 'loca', 'hhea', 'hmtx', 'glyf', 'loca', 'maxp', 'post' ... 是可接受的。 loca 的额外约束见第 5.3 小节。

6. 扩展元数据块

WOFF2 文件可以包含扩展元数据块。其解释 与 [WOFF 1] 完全相同。

不过,WOFF 1 使用 zlib 压缩存储扩展元数据块, 而WOFF2 中, 若存在元数据,必须用 [Brotli] 压缩并存为独立流。 此变更旨在尽量减少实现 WOFF2 所需的字节级压缩 算法数量,也因为预计 Brotli 在多数情况下能 获得优于 zlib 的压缩率。

元数据块必须 紧接压缩字体数据流之后。其起始位置 必须始终按 4 字节对齐; 存在扩展元数据时,若需达到 4 字节边界, 必须在压缩数据块末尾填充至多三个零字节。 若元数据块是 WOFF 文件的最后 一个块,则块末尾之后不应有额外填充。

7. 私有数据块

WOFF2 可以包含 任意数据块,允许字体创建者纳入其希望 提供的任何信息。 这些数据的内容不得影响用户代理的字体使用或 加载行为。用户代理不应对私有块内容作任何假设; 它可能包含 ASCII 或 Unicode 文本,或 供应商定义的二进制数据,也可能压缩或加密,但 没有公开定义的格式。符合规范的用户代理不会 对其结构作任何假设。只有负责该私有块的字体 开发者或供应商才应了解其内容。

私有数据块 若存在,必须是 WOFF 文件最后一个块,位于压缩字体 数据流及扩展元数据块(若有)之后。 私有数据块必须 在文件中的 4 字节边界开始;为此可在前一块之后 按需插入至多三个零字节作为填充。 私有数据块的末尾 必须对应 WOFF2 文件末尾。


A. 互联网媒体类型注册

本附录在font 顶级类型 [RFC8081] 下注册新的互联网媒体类型。 本附录符合 BCP 13 和 W3CRegMedia。

WOFF 2.0
类型名称:

font

子类型名称:

woff2

必需参数:

无。

可选参数:

无。

编码注意事项:

二进制。

互操作性注意事项:

WOFF 2.0 是对 WOFF 1.0 的改进。两种格式有不同的互联网媒体类型,可以并行使用。

已发布规范:

此媒体类型注册内容摘自 W3C 的WOFF 2.0 规范。

使用此媒体类型的应用程序:

WOFF 2.0 由 Web 浏览器使用,通常与 HTML 和 CSS 配合。

附加信息:
魔数:
WOFF 文件头的 signature 字段必须包含“魔数”0x774F4632('wOF2')
文件扩展名:
woff2
Macintosh 文件类型代码:
(未指定代码)
Macintosh 通用类型标识符代码:
org.w3c.woff2
@font-face 格式:
woff2
片段标识符
参见 [RFC8081] 第 4.2 节
更多信息的联系人及电子邮箱:

Chris Lilley (www-font@w3.org).

预期用途:

COMMON

使用限制:

无

作者:

WOFF2 规范是万维网联盟 WebFonts 工作组的成果。

变更管理者:

W3C 拥有本规范的变更控制权。

B. 变更

本附录为资料性内容。

自 2022年3月10日W3C 推荐标准以来的变更

自 2021年7月6日W3C 推荐标准以来的变更

自 2018年3月1日推荐标准以来的变更

自 2016年3月15日候选推荐标准以来的变更

自工作草案 (2015年4月14日)以来的变更

自首份公开 工作草案(2014年5月8日)以来的变更

C. 安全与隐私注意事项

本附录为资料性内容。

W3C TAG 正在为规范编辑者制定自查问卷:安全与隐私,供其提供资料性回答。

根据需考虑的问题

  1. 本规范是否处理可识别个人身份的信息?

    否。

  2. 本规范是否处理高价值数据?

    否。WOFF2 不存储信用卡信息等内容。

  3. 本规范是否为源引入跨浏览会话持久存在的新状态?

    否。具体而言,WOFF2 字体仅供 引用它们的文档使用;它们不会持久保留, 供用户系统上的其他应用或文档使用。

  4. 本规范是否向 Web 暴露持久的跨源状态?

    否。

  5. 本规范是否向源暴露其当前无法访问的其他数据?

    否。

  6. 本规范是否启用新的脚本执行/加载机制?

    否。WOFF2 字体不包含脚本,也不链接脚本。

  7. 本规范是否允许源访问用户位置?

    否。

  8. 本规范是否允许源访问用户设备上的传感器?

    否。

  9. 本规范是否允许源访问用户本地计算环境的某些方面?

    否。WOFF2 字体通常在服务器上生成并存储,生成时无法访问 用户环境。解压后,它们不含活动代码,无法 检查用户环境。

  10. 本规范是否允许源访问其他设备?

    否。

  11. 本规范是否允许源在某种程度上控制用户代理的原生 UI?

    否。

  12. 本规范是否向 Web 暴露临时标识符?

    否。

  13. 本规范是否区分第一方与第三方上下文中的行为?

    否。

  14. 本规范在用户代理的“隐身”模式下应如何工作?

    没有区别。

  15. 本规范是否将数据持久保存到用户的本地设备?

    否。

  16. 本规范是否有“安全注意事项”和“隐私注意事项”章节?

    是。

  17. 本规范是否允许降低默认安全特性?

    否。

font 顶级类型的安全章节 [RFC8081] 包含 与 WOFF2 有关的其他安全信息。

WOFF2 使用 Brotli 压缩。除了本附录,还应查阅 Brotli 规范的安全注意事项章节 [Brotli]。


D. 参考文献

D.1 规范性参考文献

[WOFF1]
WOFF File Format 1.0 Jonathan Kew, Tal Leming, Erik van Blokland, Editors. World Wide Web Consortium, 13 December 2012. The latest version of the WOFF specification is available at http://www.w3.org/TR/WOFF/
[OFF]
Open Font Format specification (ISO/IEC 14496-22:2019). together with Amendment 1: Color font technology and other updates
[Brotli]
Brotli Compressed Data Format, RFC 7932 J. Alakuijala and Z. Szabadka, Editors. Internet Engineering Task Force, Informational, July 2016.
[RFC2119]
RFC 2119: Key words for use in RFCs to Indicate Requirement Levels. S. Bradner, Editor. Internet Engineering Task Force, Best Current practice, March 1997.
[RFC8081]
The font Top Level Type, RFC 8081 C. Lilley, (Editor). Internet Engineering Task Force, Proposed Standard, February 2017.
[CSS3-Fonts]
CSS Fonts Module Level 3, John Daggett, Myles C. Maxfield, Chris Lilley (Editors). World Wide Web Consortium Recommendation, 2018. The latest version of CSS3 Fonts is available at http://www.w3.org/TR/css-fonts-3/

D.2 资料性参考文献

[WOFF2ER]
WOFF 2.0 Evaluation Report Chris Lilley, Editor. World Wide Web Consortium, 2015.
[OpenType]
Microsoft OpenType specification. OpenType is a registered trademark of Microsoft Corporation.
[TrueType]
Apple TrueType Reference manual. Apple, 2014. TrueType is a registered trademark of Apple, Inc.
[MTX]
MicroType® Express (MTX) Font Format Sarah Martin, Al Ristow, Steve Martin, Vladimir Levantovsky, and Christopher Chapman. W3C Member Submission, 5 March 2008.