iText7中文教程：第二章 - PDF底层内容绘制技术详解

前言

作为iText7中文教程的第二章，我们将深入探讨PDF文档的底层绘制技术。本章内容将帮助开发者理解PDF文档的构成原理，掌握使用iText7进行精确内容控制的方法。

一、PDF底层绘制基础

1.1 坐标系与图形状态

PDF文档采用标准的笛卡尔坐标系系统，默认情况下：

• 原点位于页面左下角
• X轴向右延伸
• Y轴向上延伸
• 单位系统采用用户单位(user unit)，默认1单位=1点(1/72英寸)

在iText7中，我们可以通过PdfCanvas类来操作这个坐标系系统。图形状态(Graphics State)是PDF中一个核心概念，它包含：

• 当前变换矩阵(CTM)
• 线条宽度
• 颜色空间
• 裁剪路径
• 文本状态等

1.2 基本绘制操作

iText7提供了与PDF操作符对应的方法：

PDF操作符	iText7方法	功能描述
m	moveTo()	移动画笔到指定位置
l	lineTo()	绘制直线到指定位置
S	stroke()	描边路径
f	fill()	填充路径

二、实战：绘制坐标系系统

2.1 初始化画布

PdfDocument pdf = new PdfDocument(new PdfWriter(dest));
PageSize ps = PageSize.A4.rotate();
PdfPage page = pdf.addNewPage(ps);
PdfCanvas canvas = new PdfCanvas(page);

关键点：

• 使用PageSize定义页面尺寸
• 通过rotate()方法实现横向页面
• PdfCanvas是核心绘制工具

2.2 坐标系变换

将原点移动到页面中心：

canvas.concatMatrix(1, 0, 0, 1, ps.getWidth()/2, ps.getHeight()/2);

变换矩阵参数说明：

[ a  b  0 ]
[ c  d  0 ]
[ e  f  1 ]

• a,d: 缩放因子
• b,c: 倾斜因子
• e,f: 平移距离

2.3 绘制轴线与箭头

// X轴
canvas.moveTo(-(ps.getWidth()/2-15), 0)
       .lineTo(ps.getWidth()/2-15, 0)
       .stroke();

// X轴箭头
canvas.setLineJoinStyle(PdfCanvasConstants.LineJoinStyle.ROUND)
       .moveTo(ps.getWidth()/2-25, -10)
       .lineTo(ps.getWidth()/2-15, 0)
       .lineTo(ps.getWidth()/2-25, 10)
       .stroke();

2.4 图形状态管理

最佳实践是使用状态栈：

canvas.saveState()  // 保存当前状态
      .setLineWidth(2)
      .setStrokeColor(Color.RED)
      .moveTo(...)
      .lineTo(...)
      .stroke()
      .restoreState();  // 恢复之前状态

三、高级绘制技巧

3.1 颜色空间

iText7支持多种颜色空间：

// CMYK颜色空间
Color cmykColor = new DeviceCmyk(0.1f, 0.8f, 0.3f, 0.2f);

// RGB颜色空间
Color rgbColor = new DeviceRgb(255, 0, 0);

// 灰度空间
Color grayColor = new DeviceGray(0.5f);

3.2 虚线绘制

canvas.setLineDash(10, 10, 8);  // 实线长10，间隔10，相位8

3.3 文本绘制基础

canvas.beginText()
      .setFontAndSize(font, 12)
      .moveText(x, y)
      .showText("Hello World")
      .endText();

3.4 高级文本效果

实现星战开场文字效果的关键技术：

// 对每个字符单独设置变换矩阵
canvas.setTextMatrix(a, b, c, d, e, f)
      .showText(String.valueOf(char));

其中变换矩阵参数：

• a,d: 缩放因子
• b,c: 倾斜因子
• e,f: 位置偏移

四、性能优化建议

1. 批量绘制：尽可能在一次stroke()调用中完成多条路径绘制
2. 状态管理：合理使用saveState()/restoreState()避免重复设置
3. 字体缓存：重复使用PdfFont对象
4. 路径优化：简化复杂路径减少PDF文件大小

结语

本章深入讲解了iText7的底层绘制API，掌握了这些技术后，开发者可以实现任意复杂的PDF内容绘制。虽然高级API更适合大多数场景，但在需要精确控制或特殊效果时，这些底层技术将发挥不可替代的作用。

在后续章节中，我们将探讨如何结合高级API和低级API，实现更高效的PDF生成方案。