文字与字体

psdtext 解析文字图层（TySh）与 EngineData；psdfont 读取调用方提供的 TrueType、CFF1 与 CFF2 字体，提供有限的排版、塑形、Hinting、光栅化和可变字体信息。

[!IMPORTANT] psdkit 不读取系统字体目录，也不自动替换缺失字体。所有字体都由调用方显式提供；缺字体时返回 missing_font / missing_glyph，而不是用别的字体顶替。

读取文字

加载字体与排版

face, err := psdkit.OpenFont(ctx, "fonts/Inter-Regular.ttf")
if err != nil {
	return err
}
resolver := psdkit.FontResolverFunc(func(ctx context.Context, name string) (*psdkit.FontFace, error) {
	if name == "Inter-Regular" {
		return face, nil
	}
	return nil, psdfont.ErrMissingFont
})
style := psdkit.FontStyle{FontName: "Inter-Regular", Size: 48}
run, err := psdkit.LayoutOpenType(ctx, "Hello", style, resolver, psdkit.OpenTypeShapeOptions{})
if err != nil {
	return err
}
coverage, err := psdkit.RasterizeFontRun(ctx, run, image.Rect(0, 0, 320, 80)) // *image.Alpha

编辑文字

Editor.SetTextContent(ctx, id, text, options) 修改单样式水平点文字的内容，保留现有字体、样式和变换。可以通过 Render 显式选择已有文字算法并自动更新像素，也可以通过 Pixels 提供准确的新图层像素；二者互斥。PSD/PSB 保存时会写入更新后的文字与栅格，重开后可继续编辑。

自动更新像素

自动路径要求 RGB8 父文档、原始资源中明确的方形 72ppi 分辨率、水平点文字、单字符样式与一致的段落样式、Sharp 抗锯齿元数据、无文字网格及 Warp，且没有文档级 Txt2。字体必须由调用方按原 PostScript 名称提供，并且每次编辑都要选择 ApproximateText 或 ApproximateOpenTypeText，不会自动开启近似或回退到旧像素。

以下例子使用已显式加载字体的 resolver；新文字及其样式也必须在所选算法的支持范围内：

if err := editor.SetTextContent(ctx, id, "Hello", psdedit.TextEditOptions{
	Render: &psdkit.SceneOptions{
		FontResolver: resolver,
		ApproximateText: &psdkit.TextRenderOptions{Samples: 4},
	},
}); err != nil {
	return err
}
// 无需额外提供 Pixels 或 CompositeImage。
if err := editor.Save(ctx, "edited.psd"); err != nil {
	return err
}

OpenType 路径改用 ApproximateOpenTypeText，并显式选择 Kerning: psdscene.OpenTypeTextNone 或 psdscene.OpenTypeTextMetrics；多行、行距与字距等已声明排版模型还须显式开启 ApproximateTypography。两条路径分别沿用已有的字形、脚本、字体与排版限制，不因文字内容可保存而保证可生成其字形。

自动像素覆盖整个父画布，保留真实画布尺寸、DPI 和文字变换；不接受裁剪范围不同的 Bounds。这些是应用图层透明度、蒙版与效果之前的源像素，后续合成各应用一次。文字参数与像素一起提交；缺字体、缺字、算法不支持、预算不足或取消均不留下部分更新。字体回调在编辑器锁外执行，回调期间若另有编辑，原候选不会覆盖新状态。

提供准确像素

需要保存中文、emoji、组合字符或其他超出自动算法范围的内容时，继续提供与现有字体、样式和变换一致的准确像素：

if err := editor.SetTextContent(ctx, id, "中文标题 😀\n第二行", psdedit.TextEditOptions{
	Pixels: accurateTextPixels,
}); err != nil {
	return err
}

Pixels 是应用图层不透明度、蒙版与效果之前的 straight-alpha RGB8 图像；其 Rect 是新的绝对图层边界。库复制这些像素并校验布局，但不校验画面是否与文字一致，也不会为这条路径自动选择字体或排版算法。

CRLF 和 LF 统一为 CR，字符与段落范围按 UTF-16 code unit 重建：补充平面的 emoji 占两个单位，组合字符保持原码点序列，不做 Unicode 归一化。Txt 与 EngineData 同步保存，未知描述符、字体参数、变换位型及尾部字节保留；PSD/PSB 重开后可继续编辑。

非法 UTF-8 返回 ErrInvalidEdit；除 CR/LF 外的控制字符（含 NUL、Tab）和 U+2028/U+2029 行／段落分隔符返回 ErrUnsupported。现代 Txt2、多字符样式、不同段落样式、段落文字、竖排和带 Warp 的文字仍不支持。SetNativeTextState 可导入由原生应用生成的文字状态。

尚未完成

• 完整排版与复杂文字脚本；
• TrueType 字节码执行；
• Photoshop 私有 Sharp 抗锯齿的完整覆盖率。

字形轮廓、字宽、覆盖率与像素一致性分别验证，详见能力矩阵。