ファイル指定（Filespec）

ファイル指定（filespec）は、外部ファイルまたは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文書に関連付けられたファイルに関する情報のコンテナとして機能する、PDF仕様で定義された辞書構造です。この辞書は、外部ファイル（PDFの外部に保存されたファイル）または埋め込みファイル（埋め込みファイルストリームとしてPDF構造内に保存されたファイル）を記述できます。

ファイル指定は、構造化されたプラットフォーム非依存の方法でファイルを参照する点で、単純な文字列参照とは異なります。基本的な文字列がファイルパスを指定するだけであるのに対し、ファイル指定辞書には、ファイル名の複数の表現（異なるプラットフォーム用）、説明情報、文書との関係、および埋め込みファイルストリーム自体を含めることができます。辞書には通常、/Type（/Filespecに設定）、/F（ファイル名）、/UF（Unicodeファイル名）、/EF（埋め込みファイル辞書）、/Desc（説明）などのキーが含まれます。

PDFを扱う開発者にとって、ファイル指定は、外部リソースやファイル添付を含む機能を実装する際に不可欠です。ファイル指定により、PDFはソース文書、データファイル、マルチメディアコンテンツ、アクセシビリティ関連リソースなどの補足ファイルを保持できます。以下の場合、ファイル指定の理解が不可欠です：

• ユーザーがPDF文書内にファイルを埋め込むことができる添付ファイル機能を実装する場合
• 複数のファイルを含むポートフォリオPDF（PDFパッケージとも呼ばれる）を作成する場合
• コンプライアンスに必要な関連ファイルを参照するアクセシブルなPDFを構築する場合
• PDFから埋め込みファイルを抽出または処理する必要があるアプリケーションを開発する場合
• 外部ファイルを参照する際にクロスプラットフォーム互換性を確保する場合

標準化された構造により、異なるオペレーティングシステムやPDFプロセッサ間でファイル参照が一貫して機能することが保証されます。

ファイル指定辞書には、ファイルの参照または埋め込み方法を定義するいくつかの主要コンポーネントが含まれています。基本的に、/Fキーは文字列としてファイル名を提供し、/UFキーは国際的なファイル名のためのUnicode互換バージョンを提供します。ファイルを埋め込む場合、/EFキーは、ファイルデータを含む実際のストリームオブジェクトを参照する/F、/UF、または/DOSなどのキーを含む埋め込みファイルストリーム辞書を指します。

埋め込みファイルストリーム自体には、圧縮、作成日、変更日、ファイルサイズを記述するパラメータとともに、ファイルのバイナリデータが含まれます。ストリーム辞書には、/Size（非圧縮サイズ）、/CreationDate、/ModDateなどのメタデータを含む/Params辞書が含まれます。

外部ファイルの場合、ファイル指定はファイルパスを提供しますが、PDFプロセッサは実行時にこのパスを解決する必要があります。埋め込みファイルの場合、データはPDF内に自己完結しており、文書を完全に可搬性のあるものにします。ファイル指定には、埋め込みファイルとPDF文書との関係を記述する/AFRelationshipキーも含めることができます。これは、PDF/AおよびアクセシブルなPDF形式において特に重要です。

• Embedded File Stream（埋め込みファイルストリーム） – 埋め込みファイルのバイナリデータを含む実際のストリームオブジェクト
• Cos Object – ファイル指定のような辞書オブジェクトを含む、PDFアーキテクチャの基本オブジェクトタイプ
• PDF Portfolio（PDFポートフォリオ） – ファイル指定を使用して整理された複数のファイルを含むPDF文書
• Name Tree（名前ツリー） – PDF内のファイル指定やその他の名前付きオブジェクトを整理するために使用されるデータ構造
• Associated Files（関連ファイル） – ファイル指定を通じてPDFコンテンツにリンクされたファイルで、アクセシビリティやアーカイブ標準でしばしば必要とされる