ObjectBounds プロパティ

ページの PDF content stream は page object の並びです。テキスト run、ベクターパス、ラスター画像、shading パターン、埋め込み form XObject です(PDF 32000-1 の § 8.2)。ObjectBounds は、PDFium が CTM スタックとオブジェクト自身の cm matrix を展開したあとの、現在ページの Index 番目のオブジェクトの bounding box を返します。そのため rectangle は、追加の計算なしで hit-test、マスク作成、サムネイル切り出しにそのまま使えます

rectangle は標準の PDF 座標規約に従います。原点はページ左下、単位は 1/72 インチ、Y は上向きに増えます。したがって整形式のドキュメントでは Bottom < Top です。PDFium の FPDFPageObj_GetBounds をラップしており、呼び出し自体は O(1) ですが、パスでは内部で全輪郭頂点を反復するため、オブジェクトごとに何度も読むなら結果のキャッシュが賢明です

有効範囲は PageNumber で選択中のページの 0 .. ObjectCount - 1 です。範囲外のインデックスへアクセスするとゼロ rectangle を返します。型ごとの追加プロパティを読む前にオブジェクト種別で分岐するには、このプロパティを ObjectType と組み合わせてください

• box は幾何学的な bounding rectangle です。クリップパスや shading マスクのため、実際のインクの範囲はより狭いことがあります
• テキストオブジェクトは全グリフ box の結合にアクティブフォントの rise/descent を加えたもので、視覚的なキャップハイトの rectangle ではありません
• image と form XObject では、rectangle はオブジェクトの CTM 適用後の平行四辺形の頂点を、軸に沿った bounding box へスナップしたものです
• ページが PageRotation で回転されていても、bounds は回転前の PDF 座標空間で報告されます