CropBox

CropBoxは、PDFページのコンテンツを表示または印刷する際にクリッピングする領域を定義する矩形です ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 。これによりページの可視境界が決定され、開発者はページコンテンツのどの部分をエンドユーザーに表示するかを制御できます。CropBoxが存在する場合、デフォルトの可視領域（通常はMediaBoxで定義される）を上書きします。

CropBoxは、PDF仕様で定義されている複数のページ境界ボックスの1つです ( Citation: N.A., 2020 (N.A.). (2020). Document management — Portable document format — Part 2: PDF 2.0 .  International Organization for Standardization Retrieved from https://www.iso.org/standard/75839.html ) 。これは、ページの座標系で指定された矩形領域を表し、ページコンテンツのクリッピング領域を定義します。ページメディアの物理的な寸法を定義するMediaBoxとは異なり、CropBoxは、ページが画面に表示されたりプリンタに送信されたりする際に、そのコンテンツのどの部分が可視になるかを具体的に決定します。

CropBoxはPDF文書において任意の要素です。明示的に指定されていない場合、CropBoxはMediaBoxの寸法がデフォルト値となります。CropBoxはMediaBoxの境界と等しいか、その内部に収まっている必要があります。MediaBoxの寸法を超えて拡張することはできません。BleedBox、TrimBox、ArtBoxなどの他の境界ボックスが定義されている場合、それらは通常、CropBoxの内部に収まっているか、CropBoxと等しくなっている必要があります。

PDFの生成や操作を行う開発者にとって、CropBoxの理解は、エンドユーザーにコンテンツがどのように表示されるかを制御するために不可欠です。プログラムでPDFを作成する際、余分なコンテンツを非表示にしたり、ページを特定の寸法にクロップしたり、特定の表示コンテキスト用に文書を準備したりするために、CropBoxを設定する必要がある場合があります。

CropBoxは、インポートまたは結合されたPDFコンテンツを扱う際に特に重要になります。ソースページには、意図された可視領域外のコンテンツが含まれている可能性があるためです。CropBoxを操作することで、開発者は基礎となるコンテンツストリームを変更することなくプログラムでページをクロップできます。これは、ページの可視性を制御する非破壊的な方法です。コンテンツを再描画したり削除したりするよりも効率的です。単に表示矩形を調整するだけだからです。

CropBoxは、ページ辞書内で4つの数値の配列として定義され、PDF座標系において[x_左下 y_左下 x_右上 y_右上]として指定されます。これらの座標は、ページの可視領域を決定する矩形を定義します。

PDFビューアまたはプリンタがページを処理する際、CropBoxを使用してクリッピング領域を確立します。この矩形の外側にあるコンテンツは表示されませんが、コンテンツ自体はPDFファイル内に残ります。つまり、後でCropBoxを変更することで、ページを再生成することなく、以前に非表示だったコンテンツを表示できます。

CropBoxの継承モデルは、PDFのページツリー構造に従います。ページの辞書にCropBoxが指定されていない場合、値はページツリーの親ノードから継承されます。これにより、開発者は複数のページに対してデフォルトのCropBoxを効率的に設定できると同時に、個々のページで継承された値を上書きすることも可能です。

CropBoxをプログラムで操作する場合、開発者は通常、CropBoxの寸法を取得および設定するメソッドを提供するPDFライブラリを使用します。これらの操作は、コンテンツストリームを変更することなくページ辞書を修正するため、処理とファイルサイズへの影響という点では比較的軽量な操作です。

• MediaBox – 物理的なページサイズとページメディアの境界を定義する矩形
• BleedBox – 本番環境でページコンテンツをクリッピングする領域
• TrimBox – トリミング後のページの意図された仕上がり寸法
• ArtBox – ページ作成者が意図したページの意味のあるコンテンツの範囲
• Page Boundaries – PDFページのさまざまな側面を定義する様々な矩形領域の総称