MediaBox

MediaBoxは、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 ) 。これは、デフォルトユーザー空間単位（通常は1/72インチ）でページの座標系と寸法を確立します。PDF文書内のすべてのページは、ページ自体に直接定義されているか、ページツリーの祖先ノードから継承されたMediaBoxを持つ必要があります。

MediaBoxは、PDFページ辞書内で4つの数値の配列として指定される矩形であり、ページの物理的な境界を定義する座標[左下x、左下y、右上x、右上y]を表します ( 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 ) 。これらの座標は、デフォルトユーザー空間座標系で表現され、原点(0,0)は通常ページの左下隅にあります。

他のページ境界ボックス（CropBox、BleedBox、TrimBox、ArtBox）とは異なり、MediaBoxはすべてのページに必須であり、他のすべてのボックスの派生元となる基準として機能します。MediaBoxはページが占有できる最大の領域を表し、定義されている場合は他のすべての境界ボックスを包含します。MediaBoxは通常、A4（595 × 842ポイント）やUSレター（612 × 792ポイント）などの実際の用紙サイズに対応します。

MediaBoxを理解することは、PDFの作成、操作、またはレンダリングに携わる開発者にとって不可欠です。なぜなら、ページがどのように表示され、印刷されるかを決定するためです。プログラムでPDFを生成する際、MediaBoxを正しく設定することで、コンテンツが物理的な媒体上で期待されるサイズと位置に表示されることが保証されます。

アクセシビリティとTagged PDFの開発において、MediaBoxは代替表現や構造要素を配置するために使用される座標系を確立する上で重要な役割を果たします ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) 。MediaBoxの値が不正確だと、コンテンツが切り取られたり、不適切にスケーリングされたり、可視領域の外に配置されたりして、ユーザーエクスペリエンスやアクセシビリティに問題が生じる可能性があります。

PDFからコンテンツを抽出する場合や形式間で変換する場合、MediaBoxは保持または適応する必要があるページ寸法に関する重要な情報を提供します。PDFを表示するアプリケーションは、MediaBoxを使用して初期ビューポートサイズとズームレベルを決定します。

MediaBoxは、ページ辞書内で/MediaBoxキーを使用して定義され、その後に4つの数値の配列が続きます。たとえば、USレターサイズのページは次のように指定されます：

/MediaBox [0 0 612 792]

これは、左下隅が(0,0)、右上隅が(612,792)の矩形を定義し、幅612ポイント、高さ792ポイントのページを作成します。

ページオブジェクトが明示的にMediaBoxエントリを含まない場合、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 ) 。この継承メカニズムにより、すべてのページが同じ寸法を共有する場合、文書はページツリーの上位レベルで共通のMediaBoxを定義でき、冗長性を削減できます。

複数の境界ボックスが存在する場合、それらはクリッピング領域の階層を確立します：CropBox（存在する場合）は可視領域を定義し、MediaBox内またはそれと等しくなければなりません。BleedBox、TrimBox、ArtBoxは、定義されている場合、特定の目的をさらに絞り込みますが、すべてMediaBoxの境界内に収まる必要があります。PDFプロセッサは、これらのネストされた矩形を使用して、特定のユースケースに基づいてレンダリング、印刷、およびコンテンツ抽出を制御します。

• CropBox – ページコンテンツを表示または印刷する際にクリッピングする領域を定義する矩形
• TrimBox – トリミング後のページの意図された仕上がりサイズを定義する矩形
• BleedBox – 製作環境で出力する際にページコンテンツをクリッピングする領域を定義する矩形
• User Space – PDFコンテンツストリーム内で位置と寸法を定義するために使用される座標系
• Page Dictionary – 単一ページのすべての属性とリソースを含むPDFオブジェクト