PDMeasureDictionary

PDMeasureDictionaryは、Apache PDFBox PDModel APIのクラスであり、幾何学的な注釈の座標系と測定単位を定義するために使用される特殊な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 ) で定義されている技術図面や地理空間文書で使用される注釈に有効です。測定辞書は、ユーザーが測定マークアップ注釈を操作する際に、距離、面積、角度がどのように計算され表示されるかを指定します。

PDMeasureDictionaryは、PDF測定辞書構造へのオブジェクト指向インターフェースを提供する高レベルのJavaクラスです。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ビューアが技術図面、建築計画図、地図などで測定ツールを使用する際に正確な測定値を表示できるようにします。

汎用的なキーと値のペアを格納する基本的なPDF辞書とは異なり、PDMeasureDictionaryは縮尺比率、座標系、単位変換、表示フォーマットなど、測定に関連するデータを専門的に扱います。このクラスは、視覚的な注釈自体を表すのではなく、測定注釈に正確な実世界のキャリブレーションデータを付加するメタデータを提供する点で、PDFBoxの他の注釈クラスとは異なります。

このクラスは、距離の縮尺係数、面積の縮尺係数、角度の形式、エンドユーザーへの測定値の表示方法を決定する数値フォーマット規則など、複雑な測定仕様をカプセル化します。

技術的なPDF文書を扱う開発者にとって、PDMeasureDictionaryは正確な実世界の測定を必要とするPDFを作成または処理する際に不可欠です。エンジニア、建築家、測量士、GISの専門家は、デジタル文書に基づいて意思決定を行うために、PDFビューアの適切にキャリブレーションされた測定ツールに依存しています。

測定辞書を適切に実装しない場合、ユーザーはPDF技術図面から寸法情報を確実に抽出することができず、建設、製造、土地管理プロジェクトにおいて高コストのエラーにつながる可能性があります。このクラスにより、開発者はキャリブレーションデータをPDF文書に直接埋め込むことができ、ズームレベルや表示デバイスに関係なく測定値の精度が維持されます。

また、PDMeasureDictionaryは技術文書に埋め込まれた測定メタデータを要求する業界固有の標準への準拠を促進するため、エンジニアリング、建設、地理空間業界向けのアプリケーションにとって重要です。

PDMeasureDictionaryは、PDFファイル構造内の測定辞書を表す低レベルのCOSDictionaryオブジェクトをラップすることで機能します。開発者は、JavaオブジェクトとPDFデータ型間の変換を処理するgetterおよびsetterメソッドを通じて、このクラスと対話します。

このクラスは、いくつかの主要な測定コンポーネントを管理します。

縮尺と単位: 測定辞書は、PDFユーザー空間単位（通常は1/72インチ）と実世界の単位との関係を定義します。例えば、縮尺はPDF上の1インチが実際には10フィートを表すことを指定できます。

変換率配列: 距離と面積の測定の変換係数を定義し、異なる単位での表示を可能にします（例：メートル、フィート、マイル間の変換）。

座標系: 辞書は、地理空間PDFの矩形座標系または地理座標系（緯度/経度）を指定でき、地図上での正確な位置特定と距離計算を可能にします。

表示フォーマット: 数値形式配列は、精度、単位ラベル、分数表示と小数表示、接頭辞/接尾辞テキストなど、測定値の表示方法を制御します。

測定マークアップ注釈（距離、周囲長、面積の注釈など）に関連付けられると、PDMeasureDictionaryは、ユーザーが文書を操作する際に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ビューア間での互換性を保証します。

• PDAnnotation – 測定マークアップに測定辞書を利用できるすべてのPDF注釈の基底クラス
• PDPage – 関連する測定辞書を持つ注釈を含むことができるPDFページを表す
• COSDictionary – PDMeasureDictionaryがラップし抽象化する低レベルのPDF辞書オブジェクト
• PDResources – 注釈とその測定メタデータと連携して動作するページレベルのリソースを管理
• PDRectangle – 測定辞書内の座標系仕様で使用される矩形境界を定義