如何用iText实现地理空间PDF中图形与元数据的关联？

关键属性配置 #

要实现图形与Model Tree节点的双向关联、元数据交互及缩放功能，必须给每个图形对象绑定对应的结构树节点（StructElem），并配置以下核心属性：

• Stm（Stream）：赋值为图形元素对应内容流的PDF对象引用（即内容流的间接对象编号），让Acrobat识别节点对应的绘制内容。
• StmOwn（Stream Owner）：设置为true，声明该结构节点拥有对应内容流，明确节点与图形的归属关系。
• BBox（Bounding Box）：传入图形的页面坐标或地理坐标边界，这是“zoom to selection”功能生效的基础。

具体实现步骤 #

1. 创建结构元素：为每个需要关联的图形生成PdfStructElem实例，指定Type（如自定义类型或Annot），并将元数据存入A（Attributes）字典。
2. 绑定内容流：完成Graphics2D绘制后，获取对应PdfCanvas的底层内容流对象，将其引用设置到PdfStructElem的Stm属性，同时设置StmOwn = true。
3. 关联地理图层：将PdfStructElem添加到地理参考图层的结构树节点下，维持Model Tree的层级结构。
4. 配置边界框：给PdfStructElem设置BBox属性，传入图形的精确边界坐标，确保缩放功能正常触发。

参考规范与文档 #

相关规则和属性定义来自：

• PDF 32000-1:2008（PDF 1.7）规范：
  • 14.7.4.2 节：结构元素的属性定义（含Stm、StmOwn、BBox）
  • 14.8.2.4 节：地理空间PDF的结构树关联规则
• iText官方API文档：重点查看PdfStructElem类的属性配置说明，以及地理空间PDF相关的PdfGeoLayer类用法。

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