基于PDF内部结构实现文本填充图片遇空白页问题求助

我在应用中通过SVG生成PDF，直接构建PDF内部结构树（头、主体、交叉引用表、trailer等）。SVG中的tspan元素带有指向JPEG图片的URL填充属性，我尝试用以下PDF代码实现文本填充图片，但生成的PDF页面为空白，请求协助解决。

15 0 obj 
<< /Type /Pattern 
/PatternType 1 
/PaintType 1 
/TilingType 1 
/BBox [0 0 60 60] 
/XStep 60 
/YStep 60 
/Resources 16 0 R 
/Length 12 
>> 
stream
q
/img1 Do
endstream
Q

BT 
/F1 1 Tf 
1 0 0 -1 0 0 Tm 
0 0 0 1 K
15.0 W
0 J
0 0 0 1 k
BX /ca0 gs EX
(HELLO) Tj 
/Pattern cs 
/P1 scn 
0 0 TD 
(HELLO) Tj 
ET

以下是代码中存在的关键问题及修正方法：

1. Pattern对象的语法与长度错误 #

• Pattern对象的stream块外多了一个Q，这会破坏PDF结构，必须移到endstream之前。另外，内容流里必须添加矩阵变换，让图片适配Pattern的BBox尺寸。
• 指定的/Length 12和实际内容流长度不匹配，PDF解析器会直接忽略这个流。要么移除/Length字段（现代解析器能自动计算），要么准确计算流的字节数。
  修正后的Pattern对象：

15 0 obj 
<< 
  /Type /Pattern 
  /PatternType 1 
  /PaintType 1 
  /TilingType 1 
  /BBox [0 0 60 60] 
  /XStep 60 
  /YStep 60 
  /Resources 16 0 R 
>> 
stream
q
60 0 0 60 0 0 cm  % 把图片缩放到60x60的Pattern tile尺寸
/img1 Do
Q
endstream
endobj

2. Pattern资源未正确关联 #

你在文本绘制中用了/P1 scn，但资源字典（16 0 R）里没有把/P1映射到Pattern对象（15 0 obj），PDF找不到这个资源。资源字典必须补充Pattern映射，同时确保/img1指向你的JPEG图片对象：

16 0 obj
<<
  /Font << /F1 [你的字体对象ID] 0 R >>  % 确保字体已定义
  /XObject << /img1 [你的JPEG图片对象ID] 0 R >>
  /Pattern << /P1 15 0 R >>
>>
endobj

3. 文本绘制状态错误 #

• 文本矩阵1 0 0 -1 0 0 Tm会翻转Y轴，导致文本被绘制到页面可视区域之外（PDF默认原点在左下角），改成1 0 0 1 50 500 Tm能让文本显示在页面中间。
• BX /ca0 gs EX是无效的标记内容指令，会干扰绘制状态，直接删掉。
• 先执行(HELLO) Tj再切换颜色空间，这行文本会用黑色填充，如果你只需要图片填充的文本，删掉这行即可。

4. 确保JPEG图片对象完整 #

你的/img1对应的XObject必须包含完整的图片属性：

[图片对象ID] 0 obj
<<
  /Type /XObject
  /Subtype /Image
  /Width 60  % 和Pattern的BBox宽度一致
  /Height 60 % 和Pattern的BBox高度一致
  /ColorSpace /DeviceRGB
  /BitsPerComponent 8
  /Filter /DCTDecode
>>
stream
[JPEG文件的二进制数据]
endstream
endobj

修正后的页面内容流示例 #

BT 
/F1 24 Tf  % 调大字体，确保文本可见
1 0 0 1 50 500 Tm  % 调整文本位置到页面可视区域
/Pattern cs 
/P1 scn 
(HELLO) Tj 
ET

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