Go x/image/font/opentype NewFace 怎样设置字体 DPI

用 Go 的 golang.org/x/image/font/opentype 渲染 TTF 或 OTF 时，DPI 不写在字体文件里，而是通过 opentype.FaceOptions 传给 opentype.NewFace。最常用的设置是把字号写入 Size，把目标显示或输出密度写入 DPI，再用返回的 font.Face 查询指标或交给 font.Drawer 绘制。

官方接口：https://pkg.go.dev/golang.org/x/image/font/opentype

先把字体、字号和 DPI 放到正确的位置

一个小型海报或图片文字工具通常先读取字体字节，再解析成 *opentype.Font，最后创建面。这个顺序很重要：Parse 负责理解 TTF/OTF 数据，NewFace 才负责基于字号、DPI 和 Hinting 生成可供 font 包使用的面。

因此，设置 DPI 的核心代码只有这一段：

face, err := opentype.NewFace(parsedFont, &opentype.FaceOptions{
	Size:    18,  // 使用 18 point 作为字号
	DPI:     144, // 目标栅格密度为每英寸 144 点
	Hinting: font.HintingFull, // 选择字形节点的量化策略
})
if err != nil {
	return fmt.Errorf("创建字体面失败: %w", err) // 保留底层错误，便于定位字体或参数问题
}
defer face.Close() // Face 使用完后释放内部资源

这里的 144 不是“把文字画到 144 像素位置”，也不是把输入字体放大 144 倍。它表示栅格化时采用的每英寸点数；Size 仍然是 point 字号。若只想使用默认配置，可以传入 nil，但需要接受库的默认字号、DPI 和 Hinting。

用一个最小项目验证 NewFace 的参数组合

下面的示例使用 Go 自带的 Go Fonts 资源，省掉外部字体文件路径；实际项目替换成自己的 TTF/OTF 字节即可。示例重点是创建面并读取指标，不把示意输出冒充成已经执行过的结果。

package main

import (
	"fmt" // 输出本次配置，方便人工核对
	"log"

	"golang.org/x/image/font"
	"golang.org/x/image/font/gofont/goregular"
	"golang.org/x/image/font/opentype"
)

func main() {
	parsedFont, err := opentype.Parse(goregular.TTF)
	if err != nil {
		log.Fatal(err) // 字体数据无法解析时不要继续创建 Face
	}

	face, err := opentype.NewFace(parsedFont, &opentype.FaceOptions{
		Size:    16, // point 字号；按排版需求调整
		DPI:     96, // 常见屏幕密度示例；打印或高密度画布要重新选择
		Hinting: font.HintingNone, // 先关闭量化，便于观察基础布局指标
	})
	if err != nil {
		log.Fatal(err) // 失败时保留 NewFace 的具体错误
	}
	defer face.Close() // 不再使用 Face 时及时释放资源

	metrics := face.Metrics()
	fmt.Printf("ascent=%v descent=%v height=%v\\n", metrics.Ascent, metrics.Descent, metrics.Height)
}

这个小项目的检查点是：NewFace 成功返回、face.Metrics() 能拿到一组指标，并且同一组 Size 下改变 DPI 后，布局指标应按新的栅格尺度重新评估。不要只盯着单个字符的视觉大小，行高、上升部和下降部更适合判断面是否按预期创建。

用 Metrics 判断 DPI 是否与输出目标匹配

font.Face 把字体面提供给绘制层，Metrics() 则返回当前面对应的排版信息。可以把它理解为三层：Size 描述排版字号，DPI 描述每英寸的栅格密度，Metrics 反映当前组合最终可用于行布局的尺度。

如果文字明显偏小，先确认是不是同时把 Size 和 DPI 都按“像素”传入；如果行距不对，先比较 Metrics().Height，不要通过随意改绘制坐标来掩盖面参数问题。绘制到 image.RGBA 时，画布像素尺寸仍由 image.Rect 决定，DPI 不会自动替你扩大画布。

常见边界：DPI 不是字体文件属性，也不是坐标单位

最容易混淆的有三件事：字体文件提供字形轮廓，FaceOptions 提供本次栅格化参数，font.Drawer.Dot 提供绘制起点。DPI 只属于第二层。你可以用同一份解析后的 *opentype.Font 创建多个不同 DPI 的面，但每个 Face 仍应在自己的使用范围内管理，并且不要把同一个 Face 当成并发安全对象。

实战中建议固定一个配置函数：输入目标字号和目标密度，返回新的 font.Face；需要换输出设备时重新创建面，并再次查看 Metrics。这样既不会修改字体源数据，也不会把一个为屏幕准备的 DPI 误带到打印或高密度图片任务里。

相关问题

NewFace 的 opts 可以传 nil 吗？

可以。官方文档说明 nil 会使用合理默认值；但需要精确控制字号和 DPI 时，建议显式传入 FaceOptions，让配置可读、可复查。

DPI 变大后，image.Image 会自动变大吗？

不会。DPI 影响字体面使用的栅格尺度，画布的宽高仍由图像矩形决定。需要更大输出时，同时规划画布像素尺寸和字体面参数。

为什么还要关注 Hinting？

Hinting 决定向量字体字形节点怎样量化。小字号或强调像素边界时需要结合目标输出观察取舍，不能把所有清晰度问题都归因于 DPI。