ネームツリー（埋め込みファイル）

ネームツリー（EmbeddedFiles）は、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内に埋め込まれたファイルを整理して検索およびアクセスするための方法を提供します。EmbeddedFilesネームツリーは、PDF文書内のすべての添付ファイルの主要なインデックスとして機能し、PDFプロセッサとユーザーの両方が埋め込みコンテンツを列挙および取得できるようにします。

EmbeddedFilesネームツリーは、キーがファイル名を表すテキスト文字列で、値が埋め込みファイルを記述するファイル仕様辞書であるキー・バリュー型のデータ構造です。 ( 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 ) によると、このツリーは文書カタログのNames辞書内に存在し、PDFで定義されている一般的なネームツリー構造に従います。さまざまなオブジェクトタイプにマッピングされる可能性のある他のネームツリーとは異なり、EmbeddedFilesネームツリーは特に埋め込みファイルストリームを含むファイル仕様辞書にマッピングされます。このツリー構造により、PDFに数百または数千の添付ファイルが含まれている場合でも、効率的な検索と埋め込みファイルの列挙が可能になります。これは、文書レベルでカタログ化されるのではなく、特定のページに関連付けられるページレベルのファイル添付注釈とは異なります。

PDFを扱う開発者にとって、EmbeddedFilesネームツリーは添付ファイル機能を実装する上で不可欠です。埋め込みファイルの抽出、リスト表示、または管理を行う必要があるアプリケーションを構築する際、このツリーは文書内に存在するファイルを発見するための標準化されたアクセスポイントを提供します。この構造を理解することは、リソースを適切に埋め込むPDF作成ツールの開発、添付ファイルの目録を作成する文書管理システムの構築、および補足資料が添付される可能性のあるアクセシビリティ準拠PDFの作成において不可欠です。ネームツリー構造はまた、異なるPDFプロセッサ間で予測可能な動作を保証し、使用されるPDFライブラリやビューアに関係なく、開発者が添付ファイル処理のための信頼性の高いコードを記述できるようにします。

EmbeddedFilesネームツリーは、すべてのPDFネームツリーに共通する階層構造に従い、中間ノードを使用してバランスを維持し、効率的な検索を可能にします。各リーフノードには、キー（テキスト文字列としてのファイル名）と値（ファイル仕様辞書）が交互に並ぶ配列が含まれています。ファイル仕様辞書は、実際のファイルデータを含む埋め込みファイルストリームと、MIMEタイプ、作成日、変更日などのメタデータを参照します。PDFプロセッサが埋め込みファイルを取得する必要がある場合、要求されたファイル名を各ノードレベルの名前と比較することでツリー構造をトラバースし、最終的に適切なファイル仕様辞書を見つけます。このツリーは、文書カタログのNames辞書内のEmbeddedFilesエントリを通じてアクセスされ、次のパスに従います：Catalog → Names → EmbeddedFiles。 ( 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プロセッサが埋め込みファイルを確実に検索および列挙できることが保証されます。

• Name Dictionary（ネーム辞書） – EmbeddedFilesを含むさまざまなネームツリーを保持する文書カタログ内のコンテナ
• File Specification Dictionary（ファイル仕様辞書） – 埋め込みまたは外部のファイルを記述する辞書で、その場所とプロパティを含む
• Embedded File Stream（埋め込みファイルストリーム） – 埋め込みファイルのバイナリデータを含む実際のストリームオブジェクト
• Document Catalog（文書カタログ） – PDFの文書構造のルートオブジェクトで、主要な文書レベルのリソースを参照する
• File Attachment Annotation（ファイル添付注釈） – 埋め込みファイルを参照することもできるページレベルの注釈だが、文書レベルではなくページレベルで参照される