开发工具【免费下载链接】fonttoolsA library to manipulate font files from Python.项目地址https://gitcode.com/gh_mirrors/fo/fonttools点击查看免费下载导读SilfSIL FontGraphite Rules table是 Graphite 复杂文字排版引擎使用的一张 OpenType/TrueType 字体表用于存储一组带上下文约束的动作规则rules以驱动字形替换、定位、整词连字与排版属性计算。fontTools 在Lib/fontTools/ttLib/tables/S__i_l_f.py中提供了该表的完整读写实现既能将二进制字体中的Silf表反编译为结构化 Python 对象也能将其编译回二进制还能与 TTX XML 相互转换。读完本文你将掌握Silf表内部的层级结构Silf 子表、Classes、Pass、FSM、动作码 aCode、各版本格式差异、压缩机制以及如何借助 fontTools 的ttx命令实际查看与回写这类 Graphite 表。一、Silf表是什么Graphite 字体四张核心表之一在 Graphite 排版体系中字体除了包含普通字形与轮廓数据外还需额外携带四张表见 Lib/fontTools/ttLib/tables/F__e_a_t.py 与S__i_l_f.py中的类注释FeatGraphite Feature 表记录 GDLGraphite Description Language中定义的功能feature及其可能的取值GlatGraphite Glyph Attributes 表为每个字形保存一组属性值GlocGraphite index to glyph attributes 表建立字形 ID 到Glat属性数据的索引SilfGraphite Rules 表存放引擎实际执行的规则集passes、状态机、约束与动作代码SillGraphite Languages 表将语言代码映射到一组功能设定。Silf是这组表中最复杂的一张它真正承载规则语义。其类定义位于 Lib/fontTools/ttLib/tables/S__i_l_f.py文档字符串明确标注 Graphite Rules table。从源码结构看fontTools 对Silf的实现采用表头 一组 Silf 子表的容器设计table_S__i_l_f持有self.silfs []列表一个字体文件中的Silf表可以容纳多个相互独立的规则子表每个子表对应一组规则。提示Silf与其他 Graphite 表Feat、Glat、Gloc、Sill在 fontTools 的 subset 模块 中被列入默认删除表drop_tables列表因为 Graphite 规则通常不参与字形子集化而在 WOFF2 编解码器 的已知标签表中则包含Silf说明该表可被 WOFF2 容器正常承载。二、整体数据布局从二进制字节到 Python 对象table_S__i_l_f继承DefaultTable.DefaultTableLib/fontTools/ttLib/tables/DefaultTable.py因此具备标准的decompile / compile / toXML / fromXML生命周期。其二进制布局由 sstruct 格式串描述分为三个层次。2.1 表头headerSilf表头在不同版本下结构不同源码 S__i_l_f.py版本 3.0只有version: 16.16F16.16 定点浮点数随后紧跟numSilf2 字节大端与 2 字节保留版本 3.0Silf_hdr_format_3包含version、compilerVersion4 字节长整型、numSilf2 字节无符号短整型及 2 字节填充版本 5.0整个表体先经过压缩见第五节解压后仍按版本 3 的表头解析。decompile中版本分支逻辑S__i_l_f.py清晰体现了这一演进version 5.0时先调用grUtils.decompress再解析Silf_hdr_format_3version 3.0时手动从data[4:6]读取numSilf其余版本直接解析Silf_hdr_format_3。表头之后是numSilf个 4 字节的大端偏移量每个偏移量指向一个 Silf 子表的起始位置随后逐个调用Silf.decompile。2.2 Silf 子表per-silf 数据每个 Silf 子表由Silf类S__i_l_f.py表示其内部数据按顺序排列Part 1 基础信息版本 3.0 时先解析Silf_part1_format_v3ruleVersion16.16F、passOffset、pseudosOffset两个 16 位偏移量随后所有版本解析Silf_part1_formatS__i_l_f.py字段包括字段类型含义maxGlyphIDH16 位本规则集引用的最大字形 IDextraAscent/extraDescenth有符号 16 位额外上升/下降量影响行高numPassesB规则通道pass数量iSubst/iPos/iJust/iBidiB替换、定位、对齐、双向处理对应的 pass 索引255 表示无flagsB杂项标志位maxPreContext/maxPostContextB规则最大前后文长度attrPseudo等 5 个attr*B引擎内部属性编号伪字形、断词权重、方向性、镜像、跳过 passnumJLevelsB对齐级别justification levels数量对齐级别表numJLevels个Silf_justify_formatS__i_l_f.py每项含attrStretch、attrShrink、attrStep、attrWeight、runto5 个字节及 3 字节填充保存在self.jLevels列表中。Part 2Silf_part2_formatS__i_l_f.py包含numLigComp连字部件数、numUserDefn用户自定义属性数、maxCompPerLig、direction、attCollisions及 3 字节填充、numCritFeatures关键 feature 数。关键 feature 列表critFeaturesnumCritFeatures个 16 位 ID。脚本标签与 lbGID1 字节的脚本标签数量后跟若干个 4 字节 ASCII 标签存入self.scriptTags随后是lbGID2 字节。pass 偏移表oPassesnumPasses 1个 32 位偏移用于切分后续每个 Pass 的字节区间。伪字形映射 pMapnumPseudo个条目S__i_l_f.py。版本 3.0 时每条为unicode: L32 位nPseudo: H版本 3.0 时unicode为 16 位。pMap字典将 Unicode 码点映射为字形名。Classes 类映射见第三节。Pass 数组见第四节按oPasses偏移逐一解析。从源码看Silf.decompile在解析完 pMap 后会用一段冗长的currpos计算S__i_l_f.py累计前面所有结构的大小再以data[self.oPasses[i] - currpos : ...]的方式切出每个 Pass 的原始字节交给Pass.decompile。这种相对偏移转绝对偏移的换算值得注意表中存的偏移是相对子表起始的绝对偏移而解析时手头的数据切片已经裁掉了头部。2.3 版本差异速查特性version 3.03.0 version 5.0version 5.0表头仅versionnumSilf(H)versioncompilerVersionnumSilf同左但整表先压缩子表头部无ruleVersion段有Silf_part1_format_v3同左pMap 条目unicode 16 位HHunicode 32 位LH同左Classes 偏移16 位H16 位 4.0 时 32 位L其中 Classes 偏移在版本 4.0 时切换为 32 位见Classes.decompile的分支S__i_l_f.py。三、Classes线性类与非线性类Graphite 规则通过字形类class抽象一组等价字形。Classes类S__i_l_f.py维护两个列表linear线性类每个类是一组连续的 16 位字形 ID按字形 ID 顺序排列解析时直接把区间data[s:e]内每 2 字节解码为一个字形名nonLinear非线性类每个类是一组glyphId - index的键值对HH大端编码底层使用grUtils.bininfo生成的二分查找表num、searchRange、entrySelector、rangeShift四个 16 位值支持按字形 ID 快速检索。表头Silf_classmap_format只有numClass与numLinear两个 16 位字段随后的偏移表在版本 4.0 时每个偏移占 4 字节否则占 2 字节。compile过程S__i_l_f.py会先把所有类数据拼接起来再回填偏移表并更新numClass/numLinear。四、Pass规则通道、状态机与动作代码Pass类S__i_l_f.py是整个Silf表的执行核心。Graphite 的排版是**多通道multi-pass**的字形流依次经过若干个 pass每个 pass 根据一个 DFA确定性有限自动机即 FSM匹配上下文并执行替换/调整/复制等动作。4.1 Pass 二进制结构Silf_pass_formatS__i_l_f.py定义了 pass 头字段类型含义flagsBpass 标志maxRuleLoopB同一规则最大循环执行次数maxRuleContextB规则最大上下文maxBackupB最大回退字数numRulesH规则数量fsmOffsetHFSM状态转移表偏移pcCode/rcCode/aCodeLpass 约束代码、规则约束代码、动作代码的偏移oDebugL调试数据偏移numRows/numTransitional/numSuccess/numColumnsHFSM 维度信息紧随其后的数据按顺序为列映射区间colmap每个区间first, last, col三元组、状态-规则映射oRuleMap、扁平化规则列表rules、最小/最大规则前文minRulePreContext/maxRulePreContext、起始状态数组startStates、规则排序键ruleSortKeys、每条规则的上下文长度rulePreContexts、碰撞阈值collisionThreshold与 pass 约束长度pConstraint、约束偏移表oConstraints、动作偏移表oActions、状态转移矩阵stateTrans、pass 约束代码、规则约束代码、动作代码。4.2 规则rules与约束/动作代码每条规则包含一段可选的约束代码constraint和一段动作代码action。源码用偏移表oConstraints/oActions把连续的字节池切成每条规则对应的片段并做了特殊处理偏移为 0 的约束视为空decompile中会从后向前把 0 偏移继承为下一段偏移见 S__i_l_f.py。4.3 动作代码aCode的汇编与反汇编动作与约束代码由紧凑的字节码组成。aCode_info表S__i_l_f.py定义了约 65 个操作码每个操作码附带参数格式无参数如NOP、ADD、SUB、MUL、DIV、MIN、MAX、NEG、COND、逻辑运算AND/OR/NOT、比较运算EQUAL/NOT_EQ/LESS/GTR/LESS_EQ/GTR_EQ定长参数如PUSH_BYTE的b、PUSH_SHORT_U的H、PUT_SUBS的bHH变长参数ASSOC格式-1先读 1 字节计数值再跟相应数量字节高版本新增指令如PUT_GLYPH_ATTR、PUSH_ATT_TO_GLYPH_ATTR、BITOR/BITAND/BITNOT/BITSET、SET_FEAT。disassembleS__i_l_f.py将二进制代码逐条解码为INSTR(p1, p2, ...)形式的文本行供 TTX 输出assembleS__i_l_f.py则按操作码名查aCode_map反向打包成字节。配合正则instre解析指令文本可实现约束/动作代码在二进制 ↔ 文本之间的无损往返。4.4 FSM 状态机每个 pass 的 FSM 由numTransitional行 ×numColumns列的 16 位大端状态转移矩阵构成存入self.stateTrans每行一个array(H)。decompile中针对小端主机做了a.byteswap()处理S__i_l_f.pycompile时再换回保证跨平台字节序正确。状态编号含义前numTransitional行是过渡态最后numSuccess行是成功态规则触发态startStates根据maxRulePreContext - minRulePreContext 1个起始状态给出不同前文长度下的入口状态。Pass.compileS__i_l_f.py展示了生成期的工作先反向计算各偏移量oActions、oConstraints、oRuleMap再利用grUtils.entries把连续且同值的字形-列映射压缩为区间最后按Silf_pass_format及各数据块顺序拼装字节。五、压缩机制grUtils 与 LZ4从版本 5.0 开始Silf表整体使用 grUtils 提供的压缩方案S__i_l_f.py。grUtils.decompress/compress实现如下数据第 48 字节是一个 32 位大端整数高 5 位是压缩方案scheme低 27 位是原始大小sizescheme 0不压缩直接返回scheme 1使用lz4.block需要安装lz4包解压/压缩压缩时采用modehigh_compression, compression16且不存储块大小store_sizeFalse其他方案发出warnings.warn(Table is compressed with an unsupported compression scheme)警告并原样处理。因此要正确读写版本 5.0 的 Graphite 字体环境需要具备lz4依赖缺少时 fontTools 会降级为无法解压的压缩方案警告。该依赖在 requirements.txt 中可见。六、TTX XML 表示可读、可编辑、可往返Silf表在 TTX 中的 XML 形式由toXML/fromXML方法定义S__i_l_f.py 与Silf.toXML/Pass.toXML整体骨架为Silf !-- Attributes starting with _ are informative only -- version compilerVersion0 compressionScheme0 version2.0/ silf info direction1 extraAscent0 extraDescent0 flags4 lbGID6 maxCompPerLig0 maxGlyphID7 numLigComp0 numUserDefn0/ passindexes iBidi255 iJust1 iPos1 iSubst0/ contexts maxPostContext0 maxPreContext0/ attributes attCollisions0 attrBreakWeight2 attrDirectionality3 attrMirroring4 attrPseudo0 attrSkipPasses1/ classes linearClasses linear _index0c/linear /linearClasses nonLinearClasses/ /classes passes pass _index0 info collisionThreshold0 flags0 maxBackup0 maxRuleContext3 maxRuleLoop5 maxRulePreContext1 minRulePreContext0/ fsminfo numColumns3 numRows6 numSuccess2 numTransitional5/ colmap.notdef0 space0 a1 b2 c0/colmap staterulemap state number4 rules1/ state number5 rules0/ /staterulemap rules rule index0 precontext0 sortkey2 action PUT_GLYPH_8BIT_OBS(0) ASSOC(0, 1) NEXT DELETE NEXT RET_ZERO /action /rule /rules fsm starts0 1/starts row _i01 1 2/row row _i10 3 0/row row _i20 4 0/row row _i30 0 5/row row _i40 0 5/row /fsm /pass /passes /silf /Silf以上示例取自仓库测试数据 graphite_tests.ttx.Silf是真实的SilfTTX 快照。XML 要素与二进制结构一一对应version表版本、编译器版本与压缩方案compressionSchemeinfoattrs_info中列出的基础字段flags、extraAscent、extraDescent、maxGlyphID、numLigComp、numUserDefn、maxCompPerLig、direction、lbGIDpassindexes/contexts/attributes分别对应attrs_passindexesiSubst/iPos/iJust/iBidi、attrs_contextsmaxPreContext/maxPostContext、attrs_attributesattrPseudo/attrBreakWeight/attrDirectionality/attrMirroring/attrSkipPasses/attCollisionsjustifications每个justify一项对齐级别critFeatures空格分隔的关键 feature IDscriptTags空格分隔的脚本标签pseudoMappseudo unicode0x... pseudoglyphname/形式的伪字形映射classeslinearClasses与nonLinearClasses两类passes每个pass内含info、fsminfo、colmap、staterulemap、rules每条规则含constraint/action的指令文本与fsmstarts与若干row。XML 头部的注释 Attributes starting with _ are informative only下划线开头的属性仅为信息性由toXML输出S__i_l_f.py表示_index、number等辅助属性不参与二进制往返只用于人类阅读。七、实战用 ttx 查看与编辑 Silf 表借助 fontTools 的 ttx 命令行工具可以像处理 OpenType 表一样处理 Graphite 表。导出Silf表为 XMLttx -t Silf path/to/graphite-font.ttf这会生成graphite-font.ttx其中包含上节展示的Silf结构。若字体版本 5.0ttx 会通过grUtils.decompress自动解压后导出若环境未安装lz4会输出压缩方案不受支持的警告。从 XML 回写为二进制字体ttx -o rebuilt.ttf graphite-font.ttx回写时fromXML会把action/constraint中的指令文本经assemble重新打包为字节码compile会重新计算各偏移、压缩如需并拼装整表。编程方式读写from fontTools.ttLib import TTFont font TTFont(graphite-font.ttf) silf font[Silf] # table_S__i_l_f 实例 print(silf.version, silf.compilerVersion, silf.scheme) for s in silf.silfs: print(passes:, len(s.passes), classes:, len(s.classes.linear), len(s.classes.nonLinear)) for p in s.passes: print( rules:, len(p.rules), actions:, len(p.actions)) font.close()仓库测试 tables_test.py 对graphite/graphite_tests.ttf执行了双向验证test_xml_from_binary检查二进制 → XML输出与期望快照一致test_xml_from_xml检查XML → 对象 → XML往返一致。这证明 fontTools 对Silf的编解码与序列化是闭环可逆的你也可以用同样的方法对自有字体做回归验证。八、边界与注意事项版本兼容性Silf格式有 2.x、3.x、4.x、5.x 等多代版本字段宽度与偏移编码随版本变化16 位 ↔ 32 位偏移、pMap 的 unicode 宽度等。fontTools 在decompile/compile中按版本分支处理但读取旧版或非标版本时应以字体实际version字段为准。压缩依赖版本 5.0 的表需要lz4。grUtils.compress在无法压缩时会发出警告并返回未压缩数据不会导致崩溃。主机字节序FSM 行数据以array(H)存储小端主机会在解/编译时自动字节交换这要求 FSM 行列数与宽度必须自洽否则解析会错位。与子集化的关系Graphite 表默认被 subset 模块 丢弃drop_tables默认值包含Feat、Glat、Gloc、Silf、Sill如需保留需显式处理而 ttFont.py 的类型标注 已为Silf/Sill等表提供__getitem__与get的精确返回类型说明它们是 fontTools 一等公民的表实现。结语fontTools 对SilfGraphite Rules table的实现是一套完整的二进制↔对象↔XML 往返管线表头与多子表容器、Classes 线性/非线性类、多 pass 状态机、aCode 动作码的汇编/反汇编以及基于 LZ4 的 v5 压缩方案全部集中在 S__i_l_f.py 与 grUtils.py 两个文件中。无论是想分析 Graphite 字体的规则结构、做 TTX 级别的规则编辑还是编写依赖Silf的工具都可以直接复用本文梳理的字段表、XML 骨架与版本分支并结合 Graphite 官方规范 进一步核对语义细节。赞分享开发工具【免费下载链接】fonttoolsA library to manipulate font files from Python.项目地址https://gitcode.com/gh_mirrors/fo/fonttools点击查看免费下载相关推荐fontTools 中 Glat 表Graphite 字形属性表的完整解析、编译与 TTX 序列化指南fontTools 中 Glat 表Graphite 字形属性表的完整解析、编译与 TTX 序列化指南 GlatGraphite Glyph Attrib开发工具FontTools 中的 Graphite Feat 表特性数据的解析、序列化与 TTX 往返FontTools 中的 Graphite Feat 表特性数据的解析、序列化与 TTX 往返 本篇文章聚焦 fontTools 的 ttLib 子系统中针对开发工具fontTools 中 GPOSGlyph Positioning表的解析、编译与 TTX 转换实战指南fontTools 中 GPOSGlyph Positioning表的解析、编译与 TTX 转换实战指南 导读 本文围绕 OpenType 字体中的 GP开发工具上一篇PoeCharm中文版流放之路玩家的终极角色构建神器下一篇告别臃肿Win11Debloat一键优化工具让你的Windows系统重获新生创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
开发工具【免费下载链接】fonttoolsA library to manipulate font files from Python.项目地址https://gitcode.com/gh_mirrors/fo/fonttools点击查看免费下载导读SilfSIL FontGraphite Rules table是 Graphite 复杂文字排版引擎使用的一张 OpenType/TrueType 字体表用于存储一组带上下文约束的动作规则rules以驱动字形替换、定位、整词连字与排版属性计算。fontTools 在Lib/fontTools/ttLib/tables/S__i_l_f.py中提供了该表的完整读写实现既能将二进制字体中的Silf表反编译为结构化 Python 对象也能将其编译回二进制还能与 TTX XML 相互转换。读完本文你将掌握Silf表内部的层级结构Silf 子表、Classes、Pass、FSM、动作码 aCode、各版本格式差异、压缩机制以及如何借助 fontTools 的ttx命令实际查看与回写这类 Graphite 表。一、Silf表是什么Graphite 字体四张核心表之一在 Graphite 排版体系中字体除了包含普通字形与轮廓数据外还需额外携带四张表见 Lib/fontTools/ttLib/tables/F__e_a_t.py 与S__i_l_f.py中的类注释FeatGraphite Feature 表记录 GDLGraphite Description Language中定义的功能feature及其可能的取值GlatGraphite Glyph Attributes 表为每个字形保存一组属性值GlocGraphite index to glyph attributes 表建立字形 ID 到Glat属性数据的索引SilfGraphite Rules 表存放引擎实际执行的规则集passes、状态机、约束与动作代码SillGraphite Languages 表将语言代码映射到一组功能设定。Silf是这组表中最复杂的一张它真正承载规则语义。其类定义位于 Lib/fontTools/ttLib/tables/S__i_l_f.py文档字符串明确标注 Graphite Rules table。从源码结构看fontTools 对Silf的实现采用表头 一组 Silf 子表的容器设计table_S__i_l_f持有self.silfs []列表一个字体文件中的Silf表可以容纳多个相互独立的规则子表每个子表对应一组规则。提示Silf与其他 Graphite 表Feat、Glat、Gloc、Sill在 fontTools 的 subset 模块 中被列入默认删除表drop_tables列表因为 Graphite 规则通常不参与字形子集化而在 WOFF2 编解码器 的已知标签表中则包含Silf说明该表可被 WOFF2 容器正常承载。二、整体数据布局从二进制字节到 Python 对象table_S__i_l_f继承DefaultTable.DefaultTableLib/fontTools/ttLib/tables/DefaultTable.py因此具备标准的decompile / compile / toXML / fromXML生命周期。其二进制布局由 sstruct 格式串描述分为三个层次。2.1 表头headerSilf表头在不同版本下结构不同源码 S__i_l_f.py版本 3.0只有version: 16.16F16.16 定点浮点数随后紧跟numSilf2 字节大端与 2 字节保留版本 3.0Silf_hdr_format_3包含version、compilerVersion4 字节长整型、numSilf2 字节无符号短整型及 2 字节填充版本 5.0整个表体先经过压缩见第五节解压后仍按版本 3 的表头解析。decompile中版本分支逻辑S__i_l_f.py清晰体现了这一演进version 5.0时先调用grUtils.decompress再解析Silf_hdr_format_3version 3.0时手动从data[4:6]读取numSilf其余版本直接解析Silf_hdr_format_3。表头之后是numSilf个 4 字节的大端偏移量每个偏移量指向一个 Silf 子表的起始位置随后逐个调用Silf.decompile。2.2 Silf 子表per-silf 数据每个 Silf 子表由Silf类S__i_l_f.py表示其内部数据按顺序排列Part 1 基础信息版本 3.0 时先解析Silf_part1_format_v3ruleVersion16.16F、passOffset、pseudosOffset两个 16 位偏移量随后所有版本解析Silf_part1_formatS__i_l_f.py字段包括字段类型含义maxGlyphIDH16 位本规则集引用的最大字形 IDextraAscent/extraDescenth有符号 16 位额外上升/下降量影响行高numPassesB规则通道pass数量iSubst/iPos/iJust/iBidiB替换、定位、对齐、双向处理对应的 pass 索引255 表示无flagsB杂项标志位maxPreContext/maxPostContextB规则最大前后文长度attrPseudo等 5 个attr*B引擎内部属性编号伪字形、断词权重、方向性、镜像、跳过 passnumJLevelsB对齐级别justification levels数量对齐级别表numJLevels个Silf_justify_formatS__i_l_f.py每项含attrStretch、attrShrink、attrStep、attrWeight、runto5 个字节及 3 字节填充保存在self.jLevels列表中。Part 2Silf_part2_formatS__i_l_f.py包含numLigComp连字部件数、numUserDefn用户自定义属性数、maxCompPerLig、direction、attCollisions及 3 字节填充、numCritFeatures关键 feature 数。关键 feature 列表critFeaturesnumCritFeatures个 16 位 ID。脚本标签与 lbGID1 字节的脚本标签数量后跟若干个 4 字节 ASCII 标签存入self.scriptTags随后是lbGID2 字节。pass 偏移表oPassesnumPasses 1个 32 位偏移用于切分后续每个 Pass 的字节区间。伪字形映射 pMapnumPseudo个条目S__i_l_f.py。版本 3.0 时每条为unicode: L32 位nPseudo: H版本 3.0 时unicode为 16 位。pMap字典将 Unicode 码点映射为字形名。Classes 类映射见第三节。Pass 数组见第四节按oPasses偏移逐一解析。从源码看Silf.decompile在解析完 pMap 后会用一段冗长的currpos计算S__i_l_f.py累计前面所有结构的大小再以data[self.oPasses[i] - currpos : ...]的方式切出每个 Pass 的原始字节交给Pass.decompile。这种相对偏移转绝对偏移的换算值得注意表中存的偏移是相对子表起始的绝对偏移而解析时手头的数据切片已经裁掉了头部。2.3 版本差异速查特性version 3.03.0 version 5.0version 5.0表头仅versionnumSilf(H)versioncompilerVersionnumSilf同左但整表先压缩子表头部无ruleVersion段有Silf_part1_format_v3同左pMap 条目unicode 16 位HHunicode 32 位LH同左Classes 偏移16 位H16 位 4.0 时 32 位L其中 Classes 偏移在版本 4.0 时切换为 32 位见Classes.decompile的分支S__i_l_f.py。三、Classes线性类与非线性类Graphite 规则通过字形类class抽象一组等价字形。Classes类S__i_l_f.py维护两个列表linear线性类每个类是一组连续的 16 位字形 ID按字形 ID 顺序排列解析时直接把区间data[s:e]内每 2 字节解码为一个字形名nonLinear非线性类每个类是一组glyphId - index的键值对HH大端编码底层使用grUtils.bininfo生成的二分查找表num、searchRange、entrySelector、rangeShift四个 16 位值支持按字形 ID 快速检索。表头Silf_classmap_format只有numClass与numLinear两个 16 位字段随后的偏移表在版本 4.0 时每个偏移占 4 字节否则占 2 字节。compile过程S__i_l_f.py会先把所有类数据拼接起来再回填偏移表并更新numClass/numLinear。四、Pass规则通道、状态机与动作代码Pass类S__i_l_f.py是整个Silf表的执行核心。Graphite 的排版是**多通道multi-pass**的字形流依次经过若干个 pass每个 pass 根据一个 DFA确定性有限自动机即 FSM匹配上下文并执行替换/调整/复制等动作。4.1 Pass 二进制结构Silf_pass_formatS__i_l_f.py定义了 pass 头字段类型含义flagsBpass 标志maxRuleLoopB同一规则最大循环执行次数maxRuleContextB规则最大上下文maxBackupB最大回退字数numRulesH规则数量fsmOffsetHFSM状态转移表偏移pcCode/rcCode/aCodeLpass 约束代码、规则约束代码、动作代码的偏移oDebugL调试数据偏移numRows/numTransitional/numSuccess/numColumnsHFSM 维度信息紧随其后的数据按顺序为列映射区间colmap每个区间first, last, col三元组、状态-规则映射oRuleMap、扁平化规则列表rules、最小/最大规则前文minRulePreContext/maxRulePreContext、起始状态数组startStates、规则排序键ruleSortKeys、每条规则的上下文长度rulePreContexts、碰撞阈值collisionThreshold与 pass 约束长度pConstraint、约束偏移表oConstraints、动作偏移表oActions、状态转移矩阵stateTrans、pass 约束代码、规则约束代码、动作代码。4.2 规则rules与约束/动作代码每条规则包含一段可选的约束代码constraint和一段动作代码action。源码用偏移表oConstraints/oActions把连续的字节池切成每条规则对应的片段并做了特殊处理偏移为 0 的约束视为空decompile中会从后向前把 0 偏移继承为下一段偏移见 S__i_l_f.py。4.3 动作代码aCode的汇编与反汇编动作与约束代码由紧凑的字节码组成。aCode_info表S__i_l_f.py定义了约 65 个操作码每个操作码附带参数格式无参数如NOP、ADD、SUB、MUL、DIV、MIN、MAX、NEG、COND、逻辑运算AND/OR/NOT、比较运算EQUAL/NOT_EQ/LESS/GTR/LESS_EQ/GTR_EQ定长参数如PUSH_BYTE的b、PUSH_SHORT_U的H、PUT_SUBS的bHH变长参数ASSOC格式-1先读 1 字节计数值再跟相应数量字节高版本新增指令如PUT_GLYPH_ATTR、PUSH_ATT_TO_GLYPH_ATTR、BITOR/BITAND/BITNOT/BITSET、SET_FEAT。disassembleS__i_l_f.py将二进制代码逐条解码为INSTR(p1, p2, ...)形式的文本行供 TTX 输出assembleS__i_l_f.py则按操作码名查aCode_map反向打包成字节。配合正则instre解析指令文本可实现约束/动作代码在二进制 ↔ 文本之间的无损往返。4.4 FSM 状态机每个 pass 的 FSM 由numTransitional行 ×numColumns列的 16 位大端状态转移矩阵构成存入self.stateTrans每行一个array(H)。decompile中针对小端主机做了a.byteswap()处理S__i_l_f.pycompile时再换回保证跨平台字节序正确。状态编号含义前numTransitional行是过渡态最后numSuccess行是成功态规则触发态startStates根据maxRulePreContext - minRulePreContext 1个起始状态给出不同前文长度下的入口状态。Pass.compileS__i_l_f.py展示了生成期的工作先反向计算各偏移量oActions、oConstraints、oRuleMap再利用grUtils.entries把连续且同值的字形-列映射压缩为区间最后按Silf_pass_format及各数据块顺序拼装字节。五、压缩机制grUtils 与 LZ4从版本 5.0 开始Silf表整体使用 grUtils 提供的压缩方案S__i_l_f.py。grUtils.decompress/compress实现如下数据第 48 字节是一个 32 位大端整数高 5 位是压缩方案scheme低 27 位是原始大小sizescheme 0不压缩直接返回scheme 1使用lz4.block需要安装lz4包解压/压缩压缩时采用modehigh_compression, compression16且不存储块大小store_sizeFalse其他方案发出warnings.warn(Table is compressed with an unsupported compression scheme)警告并原样处理。因此要正确读写版本 5.0 的 Graphite 字体环境需要具备lz4依赖缺少时 fontTools 会降级为无法解压的压缩方案警告。该依赖在 requirements.txt 中可见。六、TTX XML 表示可读、可编辑、可往返Silf表在 TTX 中的 XML 形式由toXML/fromXML方法定义S__i_l_f.py 与Silf.toXML/Pass.toXML整体骨架为Silf !-- Attributes starting with _ are informative only -- version compilerVersion0 compressionScheme0 version2.0/ silf info direction1 extraAscent0 extraDescent0 flags4 lbGID6 maxCompPerLig0 maxGlyphID7 numLigComp0 numUserDefn0/ passindexes iBidi255 iJust1 iPos1 iSubst0/ contexts maxPostContext0 maxPreContext0/ attributes attCollisions0 attrBreakWeight2 attrDirectionality3 attrMirroring4 attrPseudo0 attrSkipPasses1/ classes linearClasses linear _index0c/linear /linearClasses nonLinearClasses/ /classes passes pass _index0 info collisionThreshold0 flags0 maxBackup0 maxRuleContext3 maxRuleLoop5 maxRulePreContext1 minRulePreContext0/ fsminfo numColumns3 numRows6 numSuccess2 numTransitional5/ colmap.notdef0 space0 a1 b2 c0/colmap staterulemap state number4 rules1/ state number5 rules0/ /staterulemap rules rule index0 precontext0 sortkey2 action PUT_GLYPH_8BIT_OBS(0) ASSOC(0, 1) NEXT DELETE NEXT RET_ZERO /action /rule /rules fsm starts0 1/starts row _i01 1 2/row row _i10 3 0/row row _i20 4 0/row row _i30 0 5/row row _i40 0 5/row /fsm /pass /passes /silf /Silf以上示例取自仓库测试数据 graphite_tests.ttx.Silf是真实的SilfTTX 快照。XML 要素与二进制结构一一对应version表版本、编译器版本与压缩方案compressionSchemeinfoattrs_info中列出的基础字段flags、extraAscent、extraDescent、maxGlyphID、numLigComp、numUserDefn、maxCompPerLig、direction、lbGIDpassindexes/contexts/attributes分别对应attrs_passindexesiSubst/iPos/iJust/iBidi、attrs_contextsmaxPreContext/maxPostContext、attrs_attributesattrPseudo/attrBreakWeight/attrDirectionality/attrMirroring/attrSkipPasses/attCollisionsjustifications每个justify一项对齐级别critFeatures空格分隔的关键 feature IDscriptTags空格分隔的脚本标签pseudoMappseudo unicode0x... pseudoglyphname/形式的伪字形映射classeslinearClasses与nonLinearClasses两类passes每个pass内含info、fsminfo、colmap、staterulemap、rules每条规则含constraint/action的指令文本与fsmstarts与若干row。XML 头部的注释 Attributes starting with _ are informative only下划线开头的属性仅为信息性由toXML输出S__i_l_f.py表示_index、number等辅助属性不参与二进制往返只用于人类阅读。七、实战用 ttx 查看与编辑 Silf 表借助 fontTools 的 ttx 命令行工具可以像处理 OpenType 表一样处理 Graphite 表。导出Silf表为 XMLttx -t Silf path/to/graphite-font.ttf这会生成graphite-font.ttx其中包含上节展示的Silf结构。若字体版本 5.0ttx 会通过grUtils.decompress自动解压后导出若环境未安装lz4会输出压缩方案不受支持的警告。从 XML 回写为二进制字体ttx -o rebuilt.ttf graphite-font.ttx回写时fromXML会把action/constraint中的指令文本经assemble重新打包为字节码compile会重新计算各偏移、压缩如需并拼装整表。编程方式读写from fontTools.ttLib import TTFont font TTFont(graphite-font.ttf) silf font[Silf] # table_S__i_l_f 实例 print(silf.version, silf.compilerVersion, silf.scheme) for s in silf.silfs: print(passes:, len(s.passes), classes:, len(s.classes.linear), len(s.classes.nonLinear)) for p in s.passes: print( rules:, len(p.rules), actions:, len(p.actions)) font.close()仓库测试 tables_test.py 对graphite/graphite_tests.ttf执行了双向验证test_xml_from_binary检查二进制 → XML输出与期望快照一致test_xml_from_xml检查XML → 对象 → XML往返一致。这证明 fontTools 对Silf的编解码与序列化是闭环可逆的你也可以用同样的方法对自有字体做回归验证。八、边界与注意事项版本兼容性Silf格式有 2.x、3.x、4.x、5.x 等多代版本字段宽度与偏移编码随版本变化16 位 ↔ 32 位偏移、pMap 的 unicode 宽度等。fontTools 在decompile/compile中按版本分支处理但读取旧版或非标版本时应以字体实际version字段为准。压缩依赖版本 5.0 的表需要lz4。grUtils.compress在无法压缩时会发出警告并返回未压缩数据不会导致崩溃。主机字节序FSM 行数据以array(H)存储小端主机会在解/编译时自动字节交换这要求 FSM 行列数与宽度必须自洽否则解析会错位。与子集化的关系Graphite 表默认被 subset 模块 丢弃drop_tables默认值包含Feat、Glat、Gloc、Silf、Sill如需保留需显式处理而 ttFont.py 的类型标注 已为Silf/Sill等表提供__getitem__与get的精确返回类型说明它们是 fontTools 一等公民的表实现。结语fontTools 对SilfGraphite Rules table的实现是一套完整的二进制↔对象↔XML 往返管线表头与多子表容器、Classes 线性/非线性类、多 pass 状态机、aCode 动作码的汇编/反汇编以及基于 LZ4 的 v5 压缩方案全部集中在 S__i_l_f.py 与 grUtils.py 两个文件中。无论是想分析 Graphite 字体的规则结构、做 TTX 级别的规则编辑还是编写依赖Silf的工具都可以直接复用本文梳理的字段表、XML 骨架与版本分支并结合 Graphite 官方规范 进一步核对语义细节。赞分享开发工具【免费下载链接】fonttoolsA library to manipulate font files from Python.项目地址https://gitcode.com/gh_mirrors/fo/fonttools点击查看免费下载相关推荐fontTools 中 Glat 表Graphite 字形属性表的完整解析、编译与 TTX 序列化指南fontTools 中 Glat 表Graphite 字形属性表的完整解析、编译与 TTX 序列化指南 GlatGraphite Glyph Attrib开发工具FontTools 中的 Graphite Feat 表特性数据的解析、序列化与 TTX 往返FontTools 中的 Graphite Feat 表特性数据的解析、序列化与 TTX 往返 本篇文章聚焦 fontTools 的 ttLib 子系统中针对开发工具fontTools 中 GPOSGlyph Positioning表的解析、编译与 TTX 转换实战指南fontTools 中 GPOSGlyph Positioning表的解析、编译与 TTX 转换实战指南 导读 本文围绕 OpenType 字体中的 GP开发工具上一篇PoeCharm中文版流放之路玩家的终极角色构建神器下一篇告别臃肿Win11Debloat一键优化工具让你的Windows系统重获新生创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考
