Inter 仓库 fontsample 工具实战指南macOS 下用 CoreText 生成字体 PDF/PNG 文本样张【免费下载链接】interThe Inter font family项目地址: https://gitcode.com/gh_mirrors/in/inter本文基于 Inter 开源字体仓库gh_mirrors/in/inter内的misc/tools/fontsample工具完整讲解其构建方式、命令行用法与底层实现原理。fontsample是一个 macOS 专用的 Objective-C 命令行程序用于将任意 macOS 可读取的字体文件渲染成居中的文本样张并输出为 PDF或 PNG是字体开发与质量检查流程中快速查验字形渲染效果的实用小工具。读完本文你将掌握该工具的编译、参数配置、输出格式控制以及其基于 CoreText / CoreGraphics / ImageIO 的完整渲染管线。工具定位为字体开发服务的 macOS 样张生成器fontsample位于 misc/tools/fontsample/README.md其定位非常明确一个 macOS 专用程序用于为某个具体字体文件生成带文本样式的 PDF。它面向的典型场景是字体开发者/设计师在构建出新的字形后快速把字体文件丢给工具得到一张可直接查看排版效果的样张例如用于检查 Inter 各字重、斜体或可变字体的字形渲染是否正常。工具本身只依赖 macOS 系统框架Foundation、CoreText、CoreGraphics、CoreServices、ImageIO不依赖任何第三方字体渲染库因此构建极简一条make即可完成编译。构建与基本使用编译在 misc/tools/fontsample/ 目录下直接执行$ makeMakefile 中定义了完整的编译规则使用clang作为编译器源文件为 fontsample.mmObjective-C故用clang的 C 模式编译并开启-fobjc-arc自动引用计数链接阶段引入-lobjc以及 Foundation、CoreText、CoreServices、CoreGraphics、ImageIO 五个系统框架。默认编译标志包含-Wall -g -fno-common若需要调试构建可传DEBUG1此时关闭-O0优化否则默认不额外优化。清理产物执行make clean。编译成功后运行./fontsample -h查看完整用法$ ./fontsample -h usage: ./fontsample [options] fontfile options: -h, -help Show usage and exit. -z, -size size Font size to render. Defaults to 96. -t, -text text Text line to render. Defaults to Rags78 **A**. -o file Write output to file instead of default filename. Defaults to fontfile.pdf. If the provided filename ends with .png a PNG is written instead of a PDF. fontfile Any font file that macOS can read.注-h输出中未列出-width与-height但源码 fontsample.mm 的usagetemplate及参数解析逻辑实际支持这两个选项详见下文“参数说明”这是源码与 README 的一个细微差异使用时以实际行为为准。最小示例# 为 Inter-Regular.woff2 生成默认样张 PDF $ ./fontsample Inter-Regular.woff2 # 指定字号与文本输出到自定义文件 $ ./fontsample -z 128 -t The quick brown fox -o sample.pdf Inter-Regular.woff2 # 输出 PNG 格式 $ ./fontsample -t Hello Inter -o sample.png Inter-Regular.woff2输出文件名缺省时取输入字体文件去掉扩展名后加.pdf例如Inter-Regular.woff2→Inter-Regular.pdf若-o指定的文件名以.png结尾不区分大小写则输出 PNG否则一律输出 PDF。命令行参数详解fontsample支持的所有选项汇总如下参数别名取值默认值说明-h-help无—打印用法并退出-z-size数值96渲染字号pt必须 1且为合法数字-t-text字符串Rags78 **A**渲染的单行文本-o—文件路径fontfile.pdf输出文件以.png结尾则输出 PNG-width—像素整数自动PNG 输出时强制图像宽度源码支持README 未列出-height—像素整数自动PNG 输出时强制图像高度源码支持README 未列出参数解析逻辑源码级参数解析由 fontsample.mm 的parseargs完成要点如下所有选项必须以-开头且长度大于 1-h/-help打印用法后以退出码 0 退出。-z/-size通过atof解析为浮点数若结果为 NaN 或小于 1则通过badarg报错并退出-width/-height使用strtoull解析为无符号整数。getargval负责取选项的下一个参数值若缺失、为空或以-开头会报 “missing value for argument” 错误。未知标志一律报unknown flag非选项参数被收集为位置参数main中要求恰好一个fontfile——少于一个报missing fontfile多于一个报extraneous argument after fontfile。渲染管线从字体文件到 PDF/PNG整个渲染流程可以从main → pdfmake这条调用链拆解核心步骤依次为加载字体、构建文本行、计算排版度量、绘制输出。1. 加载字体loadFontloadFont 接收字体文件路径与字号按以下顺序创建字体对象CFURLCreateWithFileSystemPath将路径转为 POSIX 风格 URLCGDataProviderCreateWithURL创建数据提供者读取失败则报failed to read file退出CGFontCreateWithDataProvider解析字体数据解析失败报failed to parse font退出CTFontCreateWithGraphicsFont以指定size创建 CoreText 字体对象失败报CTFontCreateWithGraphicsFont failed退出并在返回前释放cgf、dataProvider、url。注意调用方必须对返回值执行CFRelease函数注释已明确要求pdfmake在渲染完成后确实释放了font与textLine。2. 构建文本行createTextLinecreateTextLine 将文本与字体封装为带kCTFontAttributeName属性的NSAttributedString再调用CTLineCreateWithAttributedString得到可绘制的排版行CTLineRef。若文本无效例如无法排版pdfmake会报invalid sample text并退出。3. 计算度量CTLineGetTypographicBoundspdfmake中通过CGFloat width CTLineGetTypographicBounds(textLine, ascent, descent, leading); CGFloat height ascent descent leading;获得文本行的排版宽度与高度作为后续页面/画布的自动尺寸。draw函数据此把文本在画布内水平、垂直居中水平位置x ceilf((width - textWidth) / 2)垂直位置y descent ceilf((height - textHeight) / 2)descent用于保证文本基线定位正确。4. 输出 PDFmakePDFmakePDF 使用CGPDFContextCreate创建 PDF 上下文页尺寸mediaBox取文本行的排版宽高流程为CGPDFContextBeginPage → draw → CGPDFContextEndPage → CGPDFContextClose最终把生成的 PDF 数据写入输出文件。源码中draw的白色背景填充代码被注释掉见 fontsample.mm即默认输出透明背景、仅含居中文本的 PDF 页面。5. 输出 PNGmakePNGmakePNG 走另一条路径画布尺寸默认取width × height * 1.2高度放大 120% 防止裁剪若指定了-width/-height则覆盖对应维度。分配width * height * 4字节的位图缓冲区用CGBitmapContextCreate创建 RGBA 位图上下文kCGImageAlphaPremultipliedLast8 位每通道。draw绘制文本后CGBitmapContextCreateImage生成CGImageRef再由writePNG借助 ImageIO 的CGImageDestinationCreateWithURLkUTTypePNG写入 PNG 文件失败时返回 NO 并在 stderr 记录日志。应用场景与注意事项使用前提本工具是 macOS 专用程序依赖 Objective-C 运行时与系统框架无法在 Linux/Windows 上直接编译运行构建机器需具备 Xcode 命令行工具提供clang与系统 SDK。字体格式fontfile接受任何 macOS 能读取的字体文件理论上涵盖 OTF、TTF、WOFF2、TTC/OTC 等Inter 仓库构建产物如 docs/font-files/Inter-Regular.woff2、docs/font-files/InterVariable.ttf均可直接作为输入用于快速查验样张。与仓库其他工具的配合fontsample是 Inter 工具链中偏“人工目检”的一环自动化质量检查另有make test驱动的 fontbakery 报告见仓库根 Makefile。若需要批量生成字距kerning样张可参考同为工具链的 misc/tools/kernsample.py。已知限制源码中makePDF留有 “TODO: read and use options.width and options.height” 注释fontsample.mm即-width/-height目前仅对 PNG 输出生效PDF 页面尺寸始终由文本度量自动决定。小结fontsample是一个小而完整的 macOS 字体渲染工具约 300 行 Objective-C 源码串联起 CoreText 文本排版、CoreGraphics 绘制、ImageIO 图片输出三大系统框架提供了字号、文本、输出格式、画布尺寸等实用控制项。对于 Inter 这类需要高频验证字形渲染效果的字体项目它是一条低成本、可复现的目检途径其实现同时也是一个学习 macOS 系统级字体渲染 API 的简洁范本。相关文件可按以下路径深入阅读READMEmisc/tools/fontsample/README.md、构建配置misc/tools/fontsample/Makefile、完整实现misc/tools/fontsample/fontsample.mm。【免费下载链接】interThe Inter font family项目地址: https://gitcode.com/gh_mirrors/in/inter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考 Inter 仓库 fontsample 工具实战指南：macOS 下用 CoreText 生成字体 PDF/PNG 文本样张
Inter 仓库 fontsample 工具实战指南macOS 下用 CoreText 生成字体 PDF/PNG 文本样张【免费下载链接】interThe Inter font family项目地址: https://gitcode.com/gh_mirrors/in/inter本文基于 Inter 开源字体仓库gh_mirrors/in/inter内的misc/tools/fontsample工具完整讲解其构建方式、命令行用法与底层实现原理。fontsample是一个 macOS 专用的 Objective-C 命令行程序用于将任意 macOS 可读取的字体文件渲染成居中的文本样张并输出为 PDF或 PNG是字体开发与质量检查流程中快速查验字形渲染效果的实用小工具。读完本文你将掌握该工具的编译、参数配置、输出格式控制以及其基于 CoreText / CoreGraphics / ImageIO 的完整渲染管线。工具定位为字体开发服务的 macOS 样张生成器fontsample位于 misc/tools/fontsample/README.md其定位非常明确一个 macOS 专用程序用于为某个具体字体文件生成带文本样式的 PDF。它面向的典型场景是字体开发者/设计师在构建出新的字形后快速把字体文件丢给工具得到一张可直接查看排版效果的样张例如用于检查 Inter 各字重、斜体或可变字体的字形渲染是否正常。工具本身只依赖 macOS 系统框架Foundation、CoreText、CoreGraphics、CoreServices、ImageIO不依赖任何第三方字体渲染库因此构建极简一条make即可完成编译。构建与基本使用编译在 misc/tools/fontsample/ 目录下直接执行$ makeMakefile 中定义了完整的编译规则使用clang作为编译器源文件为 fontsample.mmObjective-C故用clang的 C 模式编译并开启-fobjc-arc自动引用计数链接阶段引入-lobjc以及 Foundation、CoreText、CoreServices、CoreGraphics、ImageIO 五个系统框架。默认编译标志包含-Wall -g -fno-common若需要调试构建可传DEBUG1此时关闭-O0优化否则默认不额外优化。清理产物执行make clean。编译成功后运行./fontsample -h查看完整用法$ ./fontsample -h usage: ./fontsample [options] fontfile options: -h, -help Show usage and exit. -z, -size size Font size to render. Defaults to 96. -t, -text text Text line to render. Defaults to Rags78 **A**. -o file Write output to file instead of default filename. Defaults to fontfile.pdf. If the provided filename ends with .png a PNG is written instead of a PDF. fontfile Any font file that macOS can read.注-h输出中未列出-width与-height但源码 fontsample.mm 的usagetemplate及参数解析逻辑实际支持这两个选项详见下文“参数说明”这是源码与 README 的一个细微差异使用时以实际行为为准。最小示例# 为 Inter-Regular.woff2 生成默认样张 PDF $ ./fontsample Inter-Regular.woff2 # 指定字号与文本输出到自定义文件 $ ./fontsample -z 128 -t The quick brown fox -o sample.pdf Inter-Regular.woff2 # 输出 PNG 格式 $ ./fontsample -t Hello Inter -o sample.png Inter-Regular.woff2输出文件名缺省时取输入字体文件去掉扩展名后加.pdf例如Inter-Regular.woff2→Inter-Regular.pdf若-o指定的文件名以.png结尾不区分大小写则输出 PNG否则一律输出 PDF。命令行参数详解fontsample支持的所有选项汇总如下参数别名取值默认值说明-h-help无—打印用法并退出-z-size数值96渲染字号pt必须 1且为合法数字-t-text字符串Rags78 **A**渲染的单行文本-o—文件路径fontfile.pdf输出文件以.png结尾则输出 PNG-width—像素整数自动PNG 输出时强制图像宽度源码支持README 未列出-height—像素整数自动PNG 输出时强制图像高度源码支持README 未列出参数解析逻辑源码级参数解析由 fontsample.mm 的parseargs完成要点如下所有选项必须以-开头且长度大于 1-h/-help打印用法后以退出码 0 退出。-z/-size通过atof解析为浮点数若结果为 NaN 或小于 1则通过badarg报错并退出-width/-height使用strtoull解析为无符号整数。getargval负责取选项的下一个参数值若缺失、为空或以-开头会报 “missing value for argument” 错误。未知标志一律报unknown flag非选项参数被收集为位置参数main中要求恰好一个fontfile——少于一个报missing fontfile多于一个报extraneous argument after fontfile。渲染管线从字体文件到 PDF/PNG整个渲染流程可以从main → pdfmake这条调用链拆解核心步骤依次为加载字体、构建文本行、计算排版度量、绘制输出。1. 加载字体loadFontloadFont 接收字体文件路径与字号按以下顺序创建字体对象CFURLCreateWithFileSystemPath将路径转为 POSIX 风格 URLCGDataProviderCreateWithURL创建数据提供者读取失败则报failed to read file退出CGFontCreateWithDataProvider解析字体数据解析失败报failed to parse font退出CTFontCreateWithGraphicsFont以指定size创建 CoreText 字体对象失败报CTFontCreateWithGraphicsFont failed退出并在返回前释放cgf、dataProvider、url。注意调用方必须对返回值执行CFRelease函数注释已明确要求pdfmake在渲染完成后确实释放了font与textLine。2. 构建文本行createTextLinecreateTextLine 将文本与字体封装为带kCTFontAttributeName属性的NSAttributedString再调用CTLineCreateWithAttributedString得到可绘制的排版行CTLineRef。若文本无效例如无法排版pdfmake会报invalid sample text并退出。3. 计算度量CTLineGetTypographicBoundspdfmake中通过CGFloat width CTLineGetTypographicBounds(textLine, ascent, descent, leading); CGFloat height ascent descent leading;获得文本行的排版宽度与高度作为后续页面/画布的自动尺寸。draw函数据此把文本在画布内水平、垂直居中水平位置x ceilf((width - textWidth) / 2)垂直位置y descent ceilf((height - textHeight) / 2)descent用于保证文本基线定位正确。4. 输出 PDFmakePDFmakePDF 使用CGPDFContextCreate创建 PDF 上下文页尺寸mediaBox取文本行的排版宽高流程为CGPDFContextBeginPage → draw → CGPDFContextEndPage → CGPDFContextClose最终把生成的 PDF 数据写入输出文件。源码中draw的白色背景填充代码被注释掉见 fontsample.mm即默认输出透明背景、仅含居中文本的 PDF 页面。5. 输出 PNGmakePNGmakePNG 走另一条路径画布尺寸默认取width × height * 1.2高度放大 120% 防止裁剪若指定了-width/-height则覆盖对应维度。分配width * height * 4字节的位图缓冲区用CGBitmapContextCreate创建 RGBA 位图上下文kCGImageAlphaPremultipliedLast8 位每通道。draw绘制文本后CGBitmapContextCreateImage生成CGImageRef再由writePNG借助 ImageIO 的CGImageDestinationCreateWithURLkUTTypePNG写入 PNG 文件失败时返回 NO 并在 stderr 记录日志。应用场景与注意事项使用前提本工具是 macOS 专用程序依赖 Objective-C 运行时与系统框架无法在 Linux/Windows 上直接编译运行构建机器需具备 Xcode 命令行工具提供clang与系统 SDK。字体格式fontfile接受任何 macOS 能读取的字体文件理论上涵盖 OTF、TTF、WOFF2、TTC/OTC 等Inter 仓库构建产物如 docs/font-files/Inter-Regular.woff2、docs/font-files/InterVariable.ttf均可直接作为输入用于快速查验样张。与仓库其他工具的配合fontsample是 Inter 工具链中偏“人工目检”的一环自动化质量检查另有make test驱动的 fontbakery 报告见仓库根 Makefile。若需要批量生成字距kerning样张可参考同为工具链的 misc/tools/kernsample.py。已知限制源码中makePDF留有 “TODO: read and use options.width and options.height” 注释fontsample.mm即-width/-height目前仅对 PNG 输出生效PDF 页面尺寸始终由文本度量自动决定。小结fontsample是一个小而完整的 macOS 字体渲染工具约 300 行 Objective-C 源码串联起 CoreText 文本排版、CoreGraphics 绘制、ImageIO 图片输出三大系统框架提供了字号、文本、输出格式、画布尺寸等实用控制项。对于 Inter 这类需要高频验证字形渲染效果的字体项目它是一条低成本、可复现的目检途径其实现同时也是一个学习 macOS 系统级字体渲染 API 的简洁范本。相关文件可按以下路径深入阅读READMEmisc/tools/fontsample/README.md、构建配置misc/tools/fontsample/Makefile、完整实现misc/tools/fontsample/fontsample.mm。【免费下载链接】interThe Inter font family项目地址: https://gitcode.com/gh_mirrors/in/inter创作声明：本文部分内容由AI辅助生成（AIGC），仅供参考