ObjectBounds プロパティ

この API エントリでは識別子、シグネチャ、コードブロック、PDF 用語を元の表記のまま保持します。

現在 page 上の 1 つの page object に対する、すべての CTM と object ごとの matrix を適用した後の PDF user-space 座標による、ぴったり合った axis-aligned bounding rectangle です

page の PDF content stream は page objects の列です。ここには text run、vector path、raster image、shading pattern、埋め込み form XObject (PDF 32000-1 § 8.2) が含まれます。ObjectBounds は、PDFium が CTM stack と object 自身の cm matrix を平坦化した後の、現在 page にある Index 番の object の bounding box を返します。余計な計算なしで hit testing、mask building、thumbnail crop にそのまま使えます

rectangle は標準的な PDF 座標規約を使います。原点は page 左下、単位は 1/72 inch、Y は上向きです。したがって、整形式の文書では Bottom < Top になります。PDFium の FPDFPageObj_GetBounds を包んでおり、呼び出し自体は O(1) ですが、path については内部で全 contour vertex を走査します。1 object あたり何度も読むなら結果を cache するのが賢明です

有効範囲は PageNumber で選択されている page の 0 .. ObjectCount - 1 です。範囲外 index へ access すると zero rectangle が返ります。追加の per-type property を読む前に object の種類で分岐するなら、この property を ObjectType と組み合わせてください

• box は geometric な bounding rectangle です。clipping path や shading mask のため、実際のインク範囲はこれより狭いことがあります
• text object は、見た目の cap-height rectangle ではなく、すべての glyph box と active font の rise / descent の合計を返します
• image と form XObject では、object の CTM を適用した後の parallelogram の頂点を、axis-aligned bounding box に丸めた rectangle になります
• PageRotation で page が回転していても、bounds は回転前の PDF coordinate space で報告されます

ObjectCount, ObjectType, ObjectHandle, ObjectTransparent, PageNumber