PDViewportDictionary
PDViewportDictionaryは、Apache PDFBoxのPDModel APIに含まれるJavaクラスで、PDFのビューポート辞書を表現します。
PDViewportDictionaryは、Apache PDFBoxのPDModel APIに含まれるJavaクラスで、PDFのビューポート辞書を表現します。ビューポート辞書とは、ページ上の矩形領域を定義するPDF構造であり、その領域に特定の測定値や地理座標情報が適用されます。このクラスは、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で一般的に使用されます。
PDViewportDictionaryは、Apache PDFBoxのPDModelレイヤー内の高レベルラッパークラスで、PDF仕様で定義されたビューポート辞書構造をカプセル化します。ビューポート辞書は、ページ座標と実世界の測定値または地理座標系との対応関係を確立し、通常は単位、スケール係数、座標変換を定義する測定辞書（measure dictionary）と関連付けられます。一般的なページ境界やクロップボックスとは異なり、ビューポートは測定データが意味を持ち適用可能な特定の領域を定義するため、正確な寸法精度や地理空間参照を必要とする文書には不可欠です。PDViewportDictionaryクラスは、PDFBoxの標準的なPDModelパターンに従い、低レベルのPDF構文を抽象化しながら、基礎となるCOSDictionary表現にアクセスするためのgetterおよびsetterメソッドを提供します。
技術図面、工学文書、建築図面、または地理空間PDFを扱う開発者にとって、PDViewportDictionaryは測定精度と座標系情報を保持するために必要なプログラムインターフェースを提供します。CAD図面やGISマップを含むPDFからデータを抽出する際、ビューポート情報にアクセスすることで、測定値を元の単位と座標系で正しく解釈できるようになります。この機能は、PDFを他の形式に変換するアプリケーション、自動測定を実行するアプリケーション、または文書処理ワークフロー全体で空間データの整合性を維持する必要があるアプリケーションにとって特に重要です。適切なビューポート処理がなければ、測定データと地理座標はその意味や精度を失う可能性があります。
PDViewportDictionaryは、PDFBoxの階層化アーキテクチャの一部として動作し、低レベルのCOSDictionary表現の上位にあるPDModelレイヤーに位置します。開発者は通常、 ( 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 ) に従ってビューポートが定義されているアノテーションオブジェクトまたはページレベルの構造を通じてビューポート辞書を取得します。このクラスは、ページ座標でビューポートの矩形領域を定義するバウンディングボックス（BBox）、および縮尺、単位、座標系情報を含む関連測定辞書にアクセスするメソッドを提供します。ビューポートを読み取る際、開発者はこれらのプロパティを取得して測定コンテキストを理解できます。ビューポートを作成または変更する際は、これらのプロパティを設定して新しい測定領域を確立します。このクラスは、Javaの型とPDF辞書エントリ間の変換を処理し、矩形座標、測定辞書、オプションのビューポートプロパティがPDFファイル構造に正しくシリアル化およびデシリアル化されることを保証します。
- PDPage – ビューポートを定義できるPDF文書内の単一ページを表します
- PDAnnotation – ビューポート辞書を含む可能性のあるPDFアノテーションの基底クラス
- PDRectangle – ビューポートのバウンディングボックスを定義するために使用される矩形境界を表します
- COSDictionary – PDViewportDictionaryがラップするPDF辞書オブジェクトの低レベル表現
- Measure Dictionary – ビューポートに関連付けられた測定値と座標系情報を含みます
- (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