Scaling

Apache PDFBoxにおけるScalingとは、テキスト、画像、グラフィックスを含むPDFコンテンツを、アスペクト比と視覚的な関係性を維持しながら比例的にサイズ変更するプロセスを指します。この操作は、PDFドキュメントをプログラム的に操作する際、特にページサイズの調整や特定のレイアウトへのコンテンツの適合において不可欠です。Scaling変換は、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 ) で定義されているPDFコンテンツオブジェクトの座標空間を変更します。

ScalingとはApache PDFBoxで利用可能な幾何変換操作であり、PDFコンテンツの座標をx軸とy軸に沿って指定された拡大縮小係数で乗算します。PDFBoxでは、通常、コンテンツストリームがページ上でどのようにレンダリングされるかを変更する変換行列を通じてScalingが適用されます。コンテンツを歪める可能性がある単純なサイズ変更操作とは異なり、適切なScalingは要素間の比例関係を維持し、ドキュメント構造の視覚的整合性を保持します。PDFBoxは、 ( 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 ) で概説されている変換行列仕様に準拠したグラフィックス状態操作を通じてScalingを実装しています。Scaling操作は、均等（両軸で同じ係数）または非均等（x軸とy軸で異なる係数）にすることができ、個々のコンテンツ要素、ページ全体、またはForm XObjectsに適用できます。

PDF操作を行う開発者にとって、Scalingは以下のような一般的なシナリオで重要です：異なる用紙サイズへのドキュメントの適応、サムネイルやプレビューの作成、特定の境界内へのコンテンツの適合、異なる表示コンテキスト間での適切なレンダリングの確保。 ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) .  International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) などの規格に準拠したアクセシブルなPDFを扱う場合、適切なScalingによって、変換中にタグ付きコンテンツ構造と読み取り順序が保持されることが保証されます。不適切なScalingは、テキストの重複、画像の歪み、レイアウト構造の破損、アクセシビリティの問題につながる可能性があります。PDFBoxのScalingメカニズムを理解することで、開発者はドキュメントの整合性を維持しながらPDFコンテンツをプログラム的に調整できます。これは、エンタープライズドキュメント管理システム、印刷ワークフロー、動的PDF生成アプリケーションにおいて特に重要です。

Apache PDFBoxは、 ( 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 ) で定義されているPDF仕様の座標系モデルに従う変換行列を利用したPDFBoxグラフィックスAPIを通じてScalingを実装しています。Scaling操作は変換行列によって表され、対角要素（aとd）がそれぞれx軸とy軸の拡大縮小係数を表します。開発者は通常、Scalingパラメータを指定したMatrixオブジェクトを使用したPDPageContentStream.transform()などのメソッドを使用するか、拡大縮小係数を直接受け取る便利なメソッドを使用してScalingを適用します。コンテンツをScalingする際、PDFBoxはグラフィックス状態のCurrent Transformation Matrix（CTM）を変更します。これは、グラフィックス状態が復元されるまで、その後のすべての描画操作に影響します。ページレベルのScalingの場合、開発者はコンテンツストリームを適切に調整しながら、MediaBox、CropBox、その他のページ境界を操作できます。Scaling操作は累積的であり、既存の変換と連結されるため、開発者は意図しない複合変換を防ぐために、保存と復元操作を使用してグラフィックス状態スタックを慎重に管理する必要があることに注意が必要です。

• Transformation Matrix – PDF座標空間における拡大縮小、回転、平行移動などの幾何変換の数学的表現
• Content Stream – 変換の対象となるページコンテンツの外観を記述するPDF演算子とオペランドのシーケンス
• Graphics State – 変換行列や拡大縮小係数を含む、コンテンツのレンダリング方法を制御するパラメータの集合
• MediaBox – ページが表示または印刷される物理的媒体の境界を定義する矩形
• Form XObject – PDF文書内で拡大縮小および複数回再利用できる自己完結型のコンテンツストリーム