PDViewerPreferences.PRINT_SCALING

PDViewerPreferences.PRINT_SCALINGは、Apache PDFBoxライブラリの定数で、PDF文書内のPrintScalingビューア設定を表します。この設定は、 ( 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ビューアが印刷時に自動的なページスケーリングを適用するかどうかを制御します。開発者は、この設定を使用して、文書を実際のサイズで印刷するか、用紙に合わせて拡大縮小するかを指定できます。

PDViewerPreferences.PRINT_SCALINGは、Apache PDFBoxのPDModel API内のJava定数で、PDF文書のビューア設定ディクショナリ内の/PrintScalingエントリに対応します。この設定は2つの値を受け入れます：None（スケーリングを適用しないことを示す）またはAppDefault（PDFビューアアプリケーションがデフォルト動作を使用することを許可する）。Noneに設定すると、文書は自動的なページ合わせスケーリングなしで実際のサイズで印刷されます。これは、フォーム、技術図面、特定の用紙サイズ向けに設計された文書など、正確な寸法が重要な文書において特に重要です。この設定は、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生成と操作を行う開発者にとって、PDViewerPreferences.PRINT_SCALINGは、ユーザーの印刷体験を制御する上で重要な機能を提供します。この設定をNoneに設定すると、文書が印刷時に意図されたサイズとレイアウトを維持し、フォームフィールドの配置、バーコードの読み取り精度、正確な測定に影響を与える可能性のある不要な歪みやサイズ変更を防ぎます。これは、一貫したフォーマットが障害を持つユーザーを支援するアクセシブルな文書 ( 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 ) や、請求書、契約書、公式フォームなどのビジネス文書において特に重要です。これらの文書では、スケーリングによって事前印刷された用紙や複写式フォームとの配置の問題が発生する可能性があります。PDFBoxを通じてこの設定をプログラム的に制御することで、開発者はより予測可能でプロフェッショナルな印刷結果を生成できます。

Apache PDFBoxでは、開発者はPDF文書のViewerPreferencesディクショナリを表すPDViewerPreferencesクラスを通じて、印刷スケーリング設定にアクセスし、変更します。印刷スケーリング設定を設定するには、開発者はまず文書カタログからPDViewerPreferencesオブジェクトを取得または作成し、次にPRINT_SCALING定数を使用して対応するsetterメソッドを使用します。基盤となる実装は、 ( 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のカタログディクショナリ構造に適切なエントリを書き込みます。PDFビューアまたはプリンタドライバがこの設定に遭遇すると、値を解釈し、それに応じて印刷動作を調整します。定数自体は、PDFBox API内の型安全な識別子として機能し、開発者がビューア設定を読み書きする際に正しいディクショナリキーを参照することを保証します。この抽象化レイヤーにより、開発者は低レベルのPDF構文を手動で構築することなく、PDF構造を扱うことができます。

• PDViewerPreferences – PDF文書のすべてのビューア設定を管理するApache PDFBoxクラス
• PDDocumentCatalog – ビューア設定やその他の文書全体の設定を含むPDF文書の最上位カタログオブジェクト
• Viewer Preferences（ビューア設定） – 文書をユーザーにどのように表示するかを提案するPDFディクショナリエントリのコレクション
• Print Dialog Preset（印刷ダイアログプリセット） – 印刷ダイアログでどのオプションが事前選択されるかを制御する関連ビューア設定
• Page Scaling（ページスケーリング） – 物理的な用紙に対して文書ページのサイズをどのように決定するかを制御するプリンタ設定