PDF直线注释COS值异常咨询：L参数与Rect不匹配

你查看的是一条连接圆形与文本的红色长直线Line类型PDF注释，其COS值如下：

COSName{Border}: COSArray{[COSInt{0}, COSInt{0}, COSFloat{2.821204}]}
  COSName{C}: COSArray{[COSInt{1}, COSFloat{0.1491314}, COSInt{0}]}
  COSName{L}: COSArray{[COSFloat{516.9559}, COSFloat{438.1117}, COSFloat{585.4388}, COSFloat{437.9156}]}
  COSName{LE}: COSArray{[COSName{None}, COSName{None}]}
  COSName{Rect}: COSArray{[COSFloat{467.3483}, COSFloat{432.3077}, COSFloat{522.7586}, COSFloat{478.6829}]}

针对Rect符合预期但L参数坐标异常（y值差极小、x值超出Rect范围）的问题，常见原因如下：

• 未考虑注释的变换矩阵（Matrix）：PDF注释支持通过Matrix参数定义坐标系变换（平移、旋转、缩放等）。Rect是经过变换后的注释边界框，而L存储的是变换前的原始坐标。你可以检查该注释是否存在Matrix字段，在PDFBox中可通过PDAnnotation.getMatrix()获取并验证变换逻辑。

• 外观流（Appearance Stream）替代了逻辑坐标：部分PDF生成工具会直接通过AP（Appearance）字典中的外观流绘制注释，此时L参数可能只是无效的占位数据，实际显示效果由外观流决定。你可以查看注释的AP字典内容，确认是否存在自定义外观。

• PDF生成工具的bug：老旧或第三方PDF生成工具可能存在注释参数计算错误，导致L的坐标逻辑异常，但Rect作为边界框是单独计算的，因此出现两者不一致的情况。这种属于PDF文件本身的生成问题，需结合生成工具的特性排查。

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