PDFTron获取旋转后矩形/椭圆标注实际尺寸的技术咨询

我之前也碰到过一模一样的问题——靠GetVisibleContentBox()加旋转角度逆推原始尺寸，碰到45度这种情况直接就崩了，而且椭圆的半轴计算更是摸不着头脑。你发现XObject里的原始BBox是突破口完全正确，下面给你具体的实现思路和可复用的C#代码：

核心思路：从标注的外观XObject中提取原始BBox #

PDF里的标注旋转是通过外观矩阵（Matrix）应用在原始外观上的，而原始外观的BBox是未经过旋转的真实尺寸。我们只需要从Annot对象的外观字典里拿到对应的XObject，就能直接获取这个原始BBox，完全不用做复杂的逆旋转计算。

具体代码实现 #

通用的获取外观XObject及原始BBox的方法

private (double width, double height) GetAnnotOriginalSize(PDFNet.Annot annot)
{
    // 优先获取标注的正常状态外观字典（"/N"状态）
    PDFNet.Obj appearanceDict = annot.GetAppearance(PDFNet.Annot.AppearanceTrigger.e_normal);
    
    // 如果正常状态不存在， fallback到默认外观
    if (appearanceDict == null)
    {
        appearanceDict = annot.GetAppearance();
    }

    if (appearanceDict == null)
    {
        // 极端情况：标注无外观，可尝试用GetRect()作为备选，但精度可能受影响
        PDFNet.Rect rect = annot.GetRect();
        return (rect.Width(), rect.Height());
    }

    // 解析外观字典，拿到对应的XObject引用
    PDFNet.Obj xObjRef = null;
    if (appearanceDict.IsDict())
    {
        // 大多数标注的外观字典中，"/N"条目对应实际绘制的XObject
        xObjRef = appearanceDict.FindObj("N");
    }
    else if (appearanceDict.IsStream())
    {
        // 部分标注的外观直接以XObject流的形式存在
        xObjRef = appearanceDict;
    }

    if (xObjRef != null && xObjRef.IsStream())
    {
        // 提取XObject的BBox属性
        PDFNet.Obj bBoxObj = xObjRef.FindObj("BBox");
        if (bBoxObj != null && bBoxObj.IsArray() && bBoxObj.Size() == 4)
        {
            double xMin = bBoxObj.GetAt(0).GetNumber();
            double yMin = bBoxObj.GetAt(1).GetNumber();
            double xMax = bBoxObj.GetAt(2).GetNumber();
            double yMax = bBoxObj.GetAt(3).GetNumber();

            // 计算原始宽高（取绝对值避免坐标顺序问题）
            double originalWidth = Math.Abs(xMax - xMin);
            double originalHeight = Math.Abs(yMax - yMin);

            return (originalWidth, originalHeight);
        }
    }

    // 兜底：如果以上都失败，用可见边界框结合旋转角度逆推（不推荐，但可作为备选）
    PDFNet.Rect visibleBox = annot.GetVisibleContentBox();
    var appearance = annot.GetAppearance();
    var matrixApp = appearance?.FindObj("Matrix");
    if (matrixApp != null && matrixApp.IsArray() && matrixApp.Size() == 6)
    {
        var matrix = new PDFNet.Matrix2D(
            matrixApp.GetAt(0).GetNumber(), matrixApp.GetAt(1).GetNumber(),
            matrixApp.GetAt(2).GetNumber(), matrixApp.GetAt(3).GetNumber(),
            matrixApp.GetAt(4).GetNumber(), matrixApp.GetAt(5).GetNumber()
        );
        double rotation = GetRotationFromMatrix(matrix);
        // 逆旋转计算原始尺寸（仅作为兜底，精度不如BBox方法）
        double cosTheta = Math.Cos(rotation * Math.PI / 180);
        double sinTheta = Math.Sin(rotation * Math.PI / 180);
        double originalWidth = (visibleBox.Width() * cosTheta) + (visibleBox.Height() * sinTheta);
        double originalHeight = (visibleBox.Height() * cosTheta) + (visibleBox.Width() * sinTheta);
        return (originalWidth, originalHeight);
    }

    // 最终兜底：返回可见边界框尺寸
    return (visibleBox.Width(), visibleBox.Height());
}

针对矩形（Square）和椭圆（Ellipse/Circle）的具体使用

// 处理矩形标注
PDFNet.Annot.Square squareAnnot = new PDFNet.Annot.Square(squareAnnotObj);
var rectSize = GetAnnotOriginalSize(squareAnnot);
double rectWidth = rectSize.width;
double rectHeight = rectSize.height;

// 处理椭圆标注
PDFNet.Annot.Ellipse ellipseAnnot = new PDFNet.Annot.Ellipse(ellipseAnnotObj);
var ellipseSize = GetAnnotOriginalSize(ellipseAnnot);
double semiMajorAxis = Math.Max(ellipseSize.width, ellipseSize.height) / 2;
double semiMinorAxis = Math.Min(ellipseSize.width, ellipseSize.height) / 2;

关键说明 #

1. 为什么这个方法可靠？：PDF标注的旋转是通过外观矩阵对原始XObject进行变换实现的，原始XObject的BBox存储的是标注创建时的真实尺寸，完全不受旋转影响，所以直接提取这个值是最准确的。
2. Circle标注的处理：Circle本质是Ellipse的特例，当原始宽高相等时就是圆，所以用同样的方法获取尺寸后，半轴就是宽高的一半。
3. 边界情况处理：代码里加入了多层兜底逻辑，确保在极端情况下也能返回可用的尺寸，但优先推荐使用XObject BBox的方法。

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