开发工具【免费下载链接】fonttoolsA library to manipulate font files from Python.项目地址https://gitcode.com/gh_mirrors/fo/fonttools点击查看免费下载GVAR是 Apple 在gvar基础上扩展的变体表它用 24 位字形 ID 取代 16 位字形 ID从而让一个可变字体能够容纳超过 65,535 个字形。在 FontTools 仓库中GVAR被实现为通用gvar表实现的一个极薄子类仅通过gid_size 3切换核心逻辑因此它完整继承了gvar的 tuple variation 数据格式、共享元组机制、惰性解码与 TTX XML 互操作能力。阅读本文后你将理解GVAR与gvar的二进制差异、FontTools 中的实现分层、编译/反编译流程以及如何通过fontBuilder或TTFontAPI 实际读写这一表。GVAR 是什么Apple 扩展的 gvar 变体按 Doc/source/ttLib/tables/G_V_A_R_.rst 的说明GVAR是gvar表的 Apple 扩展变体使用 24 位字形 ID 而非 16 位字形 ID从而允许字体拥有超过 65,535 个字形。标准 OpenType 的gvarGlyph Variations table为glyf表中的每个字形存储随fvar定义的变化空间而改变轮廓的逐字形变体数据。其最大的结构性限制在于字形 IDglyph ID字段只分配 16 位因此单字体最多只能寻址 65,536 个字形0–65535。GVAR通过把这一字段扩展为 24 位将寻址能力提升到 16,777,216 个字形 ID直接服务于大型字体集合例如需要承载海量 CJK 或超大字符集的可变字体。在版本记录中这一支持出现在 NEWS.rst- [GVAR] Add support for new GVAR table (#3728)从源码看实现一个gid_size 3的薄子类整个GVAR的实现体量非常小Lib/fontTools/ttLib/tables/G_V_A_R_.py 的全部内容如下from ._g_v_a_r import table__g_v_a_r class table_G_V_A_R_(table__g_v_a_r): gid_size 3关键点表格类命名为table_G_V_A_R_与 TTX 内部表标签GVAR一一对应它继承自 Lib/fontTools/ttLib/tables/_g_v_a_r.py 中的table__g_v_a_r即gvar表类其gid_size 2唯一的差异是gid_size 3也就是每个字形 ID 占 3 字节24 位其余格式解析、tuple variation 编解码、XML 序列化全部复用父类。也就是说FontTools 在实现层面把GVAR视为“大 ID 版本的gvar”而不是一套独立的表实现。这种设计让两种表共享同一套经过充分测试的 tuple variation 引擎同时只针对 ID 宽度这一处差异做切换。表格模块注册位于 Lib/fontTools/ttLib/tables/init.py该文件由MetaTools/buildTableList.py自动生成并在 Lib/fontTools/ttLib/ttFont.py 中被导入类型注解层面ttFont[GVAR]被标注为G_V_A_R_.table_G_V_A_R_见 Lib/fontTools/ttLib/ttFont.py。二进制格式头部结构与 glyphCount 宽度差异gvar/GVAR的头部布局在 Lib/fontTools/ttLib/tables/_g_v_a_r.py 中以sstruct格式字符串定义分为 HEAD 与 TAIL 两段GVAR_HEADER_FORMAT_HEAD # big endian version: H reserved: H axisCount: H sharedTupleCount: H offsetToSharedTuples: I # In between the HEAD and TAIL lies the glyphCount, which is # of different size: 2 bytes for gvar, and 3 bytes for GVAR. GVAR_HEADER_FORMAT_TAIL # big endian flags: H offsetToGlyphVariationData: I 字段说明均为大端序字段类型含义versionuint16版本号目前为 1reserveduint16保留字段写为 0axisCountuint16变化轴数量sharedTupleCountuint16共享元组shared tuple数量offsetToSharedTuplesuint32共享元组区域相对表起始的偏移glyphCountgvaruint16GVAR24 位3 字节字形数量flagsuint16标志位最低位决定偏移表格式0短格式1长格式offsetToGlyphVariationDatauint32字形变体数据区域偏移代码注释明确指出了唯一的差异点“在 HEAD 与 TAIL 之间是glyphCount其大小因表而异——gvar用 2 字节GVAR用 3 字节”。因此GVAR的头部总大小为GVAR_HEADER_SIZE GVAR_HEADER_SIZE_HEAD self.gid_size GVAR_HEADER_SIZE_TAIL在 compile 与 decompile 中头部、偏移表、共享元组和逐字形变体数据按上述布局依次拼接/切分。反编译时通过int.from_bytes(data[...], big)按self.gid_size读取glyphCount并断言其与ttFont.getGlyphOrder()的字形数一致。编译与反编译共享元组、偏移表与 tuple variationcompile 流程compile(ttFont)Lib/fontTools/ttLib/tables/_g_v_a_r.py#L77-L114大致分四步轴标签获取通过getAxisTags_(ttFont)从fvar表取出各轴的axisTag若字体没有fvar则回退为从 0 开始的整数轴号见下文“数值轴”一节。共享元组压缩调用TupleVariation.compileSharedTuples在所有字形的变体数据中提取共享坐标元组并建立坐标→索引的映射从而在数据区避免重复存储峰值坐标。逐字形编译对ttFont.getGlyphOrder()中的每个字形调用compileGlyph_Lib/fontTools/ttLib/tables/_g_v_a_r.py#L315-L341生成 tuple variation store。其中def compileGlyph_( dataOffsetSize, variations, pointCount, axisTags, sharedCoordIndices, *, optimizeSizeTrue, ): assert dataOffsetSize in (2, 3)这里dataOffsetSize即gid_sizeGVAR为 3它同时控制字形变体数据内部offsetToData字段的宽度。若tupleVariationCount 0该字形没有变体直接返回空字节串。最终若数据长度不是偶数会补一个\0填充字节保证后续偏移对齐。 4.组装先计算所有字形变体数据块的累计偏移再交给compileOffsets_Lib/fontTools/ttLib/tables/_g_v_a_r.py#L229-L250决定偏移表格式if max(offsets) 0xFFFF * 2: packed array.array(H, [n 1 for n in offsets]) tableFormat 0 else: packed array.array(I, offsets) tableFormat 1短格式flags最低位为 0UInt16偏移数组实际偏移 存储值 × 2与 FreeType 实现一致见decompileOffsets_中的说明长格式最低位为 1UInt32偏移数组直接存字节偏移。decompile 流程decompileLib/fontTools/ttLib/tables/_g_v_a_r.py#L138-L198解析头部后先用decompileSharedTuples还原共享坐标元组再构造一个按需读取的LazyDict每个字形的变体数据只在真正被访问时才反编译read_item闭包按gid定位该字形在偏移表中的区间再调用decompileGlyph_与TupleVariation.decompileTupleVariationStore。当ttFont.lazy is False时ensureDecompiled()会立刻消费整个惰性字典强制全部解码。通过 fontBuilder 创建 GVAR 表除了手工构造table_G_V_A_R_实例外FontTools 的字体构建器也提供了直接入口 Lib/fontTools/fontBuilder.py#L716-L720def setupGVAR(self, variations): gvar self.font[GVAR] newTable(GVAR) gvar.version 1 gvar.reserved 0 gvar.variations variations用法与已有的setupGvarLib/fontTools/fontBuilder.py#L710-L714对称variations是一个{glyphName: [TupleVariation, ...]}字典。之后保存字体时FontTools 会自动调用compile把字典编码为二进制GVAR表。与之配套varLib的构建产物也可以选择以GVAR而非gvar输出从而支持超大字形数的可变字体。TTX XML 表示含数值轴的无 fvar 形式GVAR的 TTX 序列化由父类的toXML/fromXML提供Lib/fontTools/ttLib/tables/_g_v_a_r.py#L252-L302。典型 XML 片段如下节选自 Tests/subset/data/TestGVAR.ttxgvar version value1/ reserved value0/ glyphVariations glyph.notdef tuple coord axiswght value-1.0/ delta pt0 x-20 y0/ delta pt1 x-20 y0/ ... /tuple /glyphVariations /gvarTupleVariation.toXML负责写出tuple内的coord轴坐标与delta点位移子元素。在单元测试 Tests/ttLib/tables/_g_v_a_r_test.py 中可看到完整示例coord支持三种形态——单值峰值点value0.7、三值含中间区域的 min/value/max以及多轴组合。一个值得注意的细节是数值轴numbered axes按照 VARC 静态字体的约定不带fvar的字体也可以携带gvar此时轴不再用标签如wght而是用整数编号如0、1表示。fromXML通过_numericAxisTags标志识别这一形式——只要 XML 中出现axisCount value2/读取到的轴键就会被safeEval转成整数Lib/fontTools/ttLib/tables/_g_v_a_r.py#L272-L302。测试 test_fromXML_numberedAxes 验证了把axiswght替换为axis0后仍能正确往返。这一判断被刻意放在 XML 解析侧而非依赖fvar目的是让读取端与各表的反序列化顺序解耦——即使 TTX 中gvar排在fvar之前也能得到一致结果见 test_importXML_gvarBeforeFvar。测试验证与子集化联动单元测试二进制往返Tests/ttLib/tables/_g_v_a_r_test.py 覆盖了gvar即GVAR的父类的完整行为其中许多用例对GVAR同样成立GVAR_DATATests/ttLib/tables/_g_v_a_r_test.py#L13-L60是一段 122 字节、含 3 个字形.notdef、space、I、2 个轴wght/wdth的十六进制样例数据包含共享点号、私有点号、中间区域等 tuple variation 特性test_compile/test_decompileTests/ttLib/tables/_g_v_a_r_test.py#L179-L203断言编译产物与手工构造的二进制逐字节一致并验证了lazy为True/False/None三种模式下的解码行为test_compileOffsets_shortFormat/test_compileOffsets_longFormatTests/ttLib/tables/_g_v_a_r_test.py#L268-L278分别验证短、长两种偏移表格式的打包test_toXML/test_fromXMLTests/ttLib/tables/_g_v_a_r_test.py#L218-L266验证 XML 往返的一致性。子集化保留 gvar 变体数据在子集化subset场景中gvar/GVAR属于需要保留的变体表。Tests/subset/subset_test.py#L255-L266 中的test_subset_gvar先由 Tests/subset/data/TestGVAR.ttx 编译出 TrueType 字体再用--unicodesU002B,U2212做子集化最后校验GlyphOrder、avar、fvar、gvar、name表并把结果与期望文件expect_keep_gvar.ttx比对test_subset_gvar_notdef_outline则验证带--notdef_outline时.notdef轮廓与变体数据的保留。这确认了 FontTools 的子集器会同步裁剪字形与对应的变体数据而不是留下失效的偏移。使用注意事项小结触发方式GVAR表在 TTX 中是一个独立块XML 中标签为gvar二进制表标签为GVARFontTools 按表标签自动分派到table_G_V_A_R_数据模型gvar.variations是一个{glyphName: [TupleVariation, ...]}字典可通过TupleVariation构造或从glyf轮廓点数推导getNumPoints_会为复合字形与普通轮廓加上 4 个幻影点见 Lib/fontTools/ttLib/tables/_g_v_a_r.py#L304-L312依赖关系该表声明dependencies [fvar, glyf]Lib/fontTools/ttLib/tables/_g_v_a_r.py#L58编译/反编译均需要读取glyf的点数与fvar的轴定义无fvar的静态 VARC 字体则以数值轴形式工作能力边界GVAR相比gvar的唯一能力提升是字形 ID 从 16 位扩展到 24 位tuple variation 本身的编码格式、点号压缩、共享元组等机制两者完全一致。无论是阅读现有超大字体中的GVAR还是通过fontBuilder.setupGVAR从零构建理解“父类table__g_v_a_rgid_size切换”这一核心设计就能把对gvar的既有知识无缝迁移到GVAR上。赞分享开发工具【免费下载链接】fonttoolsA library to manipulate font files from Python.项目地址https://gitcode.com/gh_mirrors/fo/fonttools点击查看免费下载相关推荐fontTools 中 GPOSGlyph Positioning表的解析、编译与 TTX 转换实战指南fontTools 中 GPOSGlyph Positioning表的解析、编译与 TTX 转换实战指南 导读 本文围绕 OpenType 字体中的 GP开发工具fontTools 中 GDEFGlyph Definition表的完整解析结构、读写、构建与实战指南fontTools 中 GDEFGlyph Definition表的完整解析结构、读写、构建与实战指南 导读 GDEFGlyph Definition开发工具fonttools 的 EBDT 表转换器嵌入式位图数据表的解析、编译与 TTX 导出实战fonttools 的 EBDT 表转换器嵌入式位图数据表的解析、编译与 TTX 导出实战 EBDTEmbedded Bitmap Data是 OpenT开发工具上一篇Happy Island Designer移动端优化教程触控操作与响应式设计实战指南下一篇每秒输出一个数字setInterval 与嵌套 setTimeout 的定时调度实战解析zh.javascript.info 习题精讲创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考