从iTextSharp迁移至iText7：文本高度计算结果为何存在差异？

这种文本高度的差异其实是iText两个版本在字体度量计算逻辑和文本渲染API设计上的核心区别导致的，大字号下差异更明显是因为字体度量的微小偏差会随着字号放大被线性放大。下面帮你拆解原因并给出适配方案：

差异根源 #

• 字体度量模型更新：iText7采用了更贴合PDF标准的字体边界框（Bounding Box）计算逻辑，而iTextSharp的计算方式相对简化，对于带有复杂字形的字体（比如黑体、艺术字体），两者的ascent（上升线）、descent（下降线）取值差异会更显著。
• TextRenderInfo API差异：两个版本的TextRenderInfo提供的文本尺寸获取方法完全不同，iTextSharp依赖GetAscentLine()/GetDescentLine()的坐标差计算高度，而iText7的API直接暴露字体度量参数，逻辑更严谨。
• 坐标系细节调整：虽然两者默认原点都在左下角，但iText7对文本渲染基准线的对齐逻辑做了优化，避免了iTextSharp中某些边缘场景的近似计算。

适配iText7的文本宽高计算方案 #

假设你在iTextSharp中的代码类似这样：

public void RenderText(TextRenderInfo renderInfo) {
    var ascentPoint = renderInfo.GetAscentLine().GetStartPoint();
    var descentPoint = renderInfo.GetDescentLine().GetStartPoint();
    float textHeight = ascentPoint[1] - descentPoint[1];
    // 其他处理逻辑
}

迁移到iText7后，你需要调整为以下两种更精准的计算方式：

方式1：基于字体度量的通用计算 #

这种方式直接从字体文件读取标准度量，适合批量文本的高度预估：

public void RenderText(TextRenderInfo renderInfo) {
    // 获取当前文本的字体度量信息
    FontProgram fontProgram = renderInfo.GetFont().GetFontProgram();
    FontMetrics fontMetrics = fontProgram.GetFontMetrics();
    
    // 注意：iText7中descent是负数，所以实际高度是ascent减去descent（等价于ascent + 绝对值descent）
    float textHeight = fontMetrics.GetAscent() - fontMetrics.GetDescent();
    // 如果文本有缩放变换，需要乘以缩放比例
    Matrix textMatrix = renderInfo.GetTextMatrix();
    float scaleY = textMatrix.GetScaleY();
    float actualHeight = textHeight * scaleY;
    
    // 你的后续处理逻辑
}

方式2：基于当前渲染文本的实际高度 #

如果需要考虑文本的实际渲染状态（比如带有特殊字形、字符间距调整），可以直接用TextRenderInfo提供的方法：

public void RenderText(TextRenderInfo renderInfo) {
    // 获取当前文本的实际上升/下降值
    float ascent = renderInfo.GetAscent();
    float descent = renderInfo.GetDescent();
    // 实际高度 = 上升值 - 下降值（descent为负，所以是两者绝对值之和）
    float actualHeight = ascent - descent;
    
    // 你的后续处理逻辑
}

额外注意事项 #

• 字体嵌入完整性：确保PDF中使用的字体是完全嵌入的，iText7会严格读取嵌入字体的度量数据，而iTextSharp可能会用系统默认字体的度量替代未完全嵌入的字体，导致差异。
• 单元测试基准调整：如果你的单元测试是基于iTextSharp的旧结果，需要更新基准值，因为iText7的计算结果更符合PDF标准，是更精准的文本高度。
• 行间距处理：如果是计算整行文本的高度，还要额外加上行间距（leading），iText7中可以通过renderInfo.GetLineAscent()和renderInfo.GetLineDescent()获取整行的上下边界。

内容的提问来源于stack exchange，提问作者Sau001