annotations.json（注釈JSON）

annotations.jsonファイルは、BuildVuがPDFからHTML5への変換時に生成するJSON形式のデータファイルで、PDF注釈に関する構造化された情報が含まれています。BuildVuが ( 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文書を処理すると、注釈データを抽出し、このJSONファイルにシリアライズして、Webベースのビューワで利用できるようにします。このファイルにより、元のPDFを必要とせずに、HTML5環境でインタラクティブな注釈機能をレンダリングおよび操作できるようになります。

annotations.jsonファイルは、BuildVu変換後のPDF文書内に存在するすべての注釈を記述した、機械可読なJSON文書です。 ( 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注釈には、テキストノート、ハイライト、マークアップ、リンク、スタンプ、フォームフィールドウィジェットなどのインタラクティブ要素が含まれます。BuildVuは、これらのネイティブなPDF注釈オブジェクトを、タイプ、位置、外観、内容、動作フラグなどの注釈プロパティを保持するJSON構造に変換します。PDF固有のデータ構造を使用する元のPDF注釈ディクショナリとは異なり、annotations.jsonはWeb開発者がアクセスしやすい標準的なJSONデータ型と規則を使用します。このファイルは通常、HTML5コンテンツファイルと一緒に生成され、JavaScriptベースのPDFビューワによって読み込まれ、ブラウザ内で注釈レイヤーを再構築します。

PDFビューワソリューションを実装するWeb開発者にとって、annotations.jsonはPDF注釈のセマンティクスとWeb技術の間の重要な橋渡しとなります。このファイルにより、JavaScriptでバイナリPDF構造を直接解析する必要がなくなり、すぐに利用できるJSON形式が提供されます。開発者は、このデータを使用してインタラクティブな注釈オーバーレイをレンダリングしたり、注釈編集機能を実装したり、検索やインデックス作成のために注釈メタデータを抽出したりできます。構造化された形式により、PDF文書全体を処理することなく、注釈データの効率的な読み込みと操作が可能になります。さらに、注釈データをレンダリングされたコンテンツから分離することで、プログレッシブローディング戦略や、アプリケーション要件に基づく選択的な機能実装が可能になります。

BuildVuがPDF文書を変換する際、各ページに関連付けられた注釈ディクショナリを走査し、関連する注釈プロパティを抽出します。各注釈について、BuildVuは注釈サブタイプ（例：Text、Highlight、Link）、位置とバウンディングボックスを定義する幾何座標、色や不透明度などの視覚的外観属性、テキストや画像データなどのコンテンツ、およびユーザーインタラクションを制御する動作フラグを取得します。このデータは、ページ番号ごとに整理されたJSON構造にシリアライズされ、各注釈はそのプロパティのキーと値のペアを含むJSONオブジェクトとして表現されます。生成されたannotations.jsonファイルは、変換されたHTMLおよびアセットファイルと一緒に出力ディレクトリに保存されます。Webビューワは、このJSONファイルを非同期で読み込み、解析してブラウザのDOM内に注釈オブジェクトを再構築します。その際、PDF座標空間をCSSポジショニングにマッピングし、必要に応じてHTML、SVG、またはCanvas要素を使用して注釈の外観をレンダリングします。

• Annotation（注釈） – ( 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文書内のインタラクティブ要素
• BuildVu – IDRsolutionsのPDFからHTML5への変換ライブラリで、PDF文書からWeb対応コンテンツを生成します
• HTML5 Viewer（HTML5ビューワ） – 注釈レイヤーを含む変換されたPDFコンテンツを表示するブラウザベースのアプリケーション
• Interactive Forms（インタラクティブフォーム） – Web上でレンダリングするために注釈データに含まれる可能性のあるPDFフォームフィールドとウィジェット
• JSON Serialization（JSONシリアライゼーション） – PDF注釈オブジェクトをJavaScript Object Notation形式に変換するプロセス