PDRectlinearMeasureDictionary

PDRectlinearMeasureDictionary は、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 ) で定義されている rectilinear measurement dictionary（直交計測辞書）を表す特殊な構造です。この高レベル PDModel API クラスにより、開発者は PDF ドキュメント内で正確な計測を行う注釈をプログラムで作成、読み取り、変更することができます。これらの計測注釈は、縮尺、距離、面積、角度の計算を PDF ドキュメント内に直接表示します。このような計測ツールは、正確な寸法情報が重要となる技術図面、建築図面、エンジニアリング図、地理空間ドキュメントなどで一般的に使用されています。

PDRectlinearMeasureDictionary は、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 ) で規定されている rectilinear measure dictionary（直交計測辞書）のプロパティと動作をカプセル化する Java クラスです。一般的な注釈辞書とは異なり、rectilinear measure dictionary は直交軸（水平および垂直）に沿った計測を専門的に扱うため、標準的な直交座標系を持つドキュメントにおける距離、周囲長、面積の表現に最適です。このクラスは、縮尺比率、単位ラベル、数値フォーマット、座標系などの計測固有のプロパティに対するゲッターおよびセッターメソッドを提供します。ポリゴン計測などの他の計測タイプとの違いは、任意の多角形形状ではなく、rectilinear パス（ページ軸に平行な直線に沿った計測）に計算を制限している点です。

技術的な PDF ドキュメントを扱う開発者にとって、PDRectlinearMeasureDictionary は PDF ビューアーやエディターにインタラクティブな計測機能を追加するための重要な機能を提供します。このクラスにより、アプリケーションは正確で標準準拠の計測注釈を作成でき、ユーザーは手動計算なしに縮尺図面から実世界の寸法を計算することができます。この PDFBox クラスを使用することで、開発者は異なる PDF リーダーやプラットフォーム間で一貫した解釈を保証する計測メタデータをプログラムで埋め込むことができます。これは、建設、製造、GIS などの業界で特に重要です。これらの業界では、計測精度が意思決定やコンプライアンスに直接影響を与えるためです。このクラスは、基礎となる PDF 辞書構造の複雑さを抽象化し、開発者が低レベルの PDF オブジェクトを直接操作するのではなく、直感的な Java メソッドを通じて計測プロパティを扱えるようにします。

PDRectlinearMeasureDictionary は、 ( 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 ) で定義されている rectilinear 計測に必要な特定の属性を実装することで、基本的な measurement dictionary 構造を拡張しています。このクラスは、縮尺比率（PDF 座標単位を実世界の単位に変換）、計測単位文字列（インチの場合は “in”、ミリメートルの場合は “mm” など）、計測値の表示方法を制御する数値フォーマット配列などの重要な計測パラメータへの参照を維持することで機能します。開発者が rectilinear 計測注釈を作成または変更する際は、PDRectlinearMeasureDictionary オブジェクトをインスタンス化し、X 軸と Y 軸の縮尺などのプロパティを設定します。これらの縮尺は、非均一スケーリングを持つドキュメントでは異なる場合があります。このクラスは内部的に、PDF ファイル構造内の measure dictionary を表す対応する COS（Carousel Object Structure）辞書を管理します。PDF が保存されると、PDFBox は Java オブジェクトのプロパティを適切な PDF 辞書フォーマットにシリアライズし、仕様への準拠を保証します。rectilinear measure dictionary は、注釈の座標空間とページ座標空間の関係を定義するビューポート情報も維持し、ズームレベルや表示変換に関係なく正確な計測を可能にします。

• PDAnnotation – PDFBox におけるすべての PDF 注釈の基底クラスで、計測注釈はこれを拡張します
• PDPage – PDFBox PDModel API における PDF ページを表し、計測注釈を含む注釈を保持します
• COSDictionary – PDRectlinearMeasureDictionary などの PDModel オブジェクトの基礎となる低レベルの Carousel Object Structure 辞書
• Measure Dictionary – 注釈の計測情報を含む辞書を指す PDF 仕様の用語
• Viewport – 計測目的で注釈の座標系とページ座標系の関係を定義する辞書