PDAnnotationStamp
PDAnnotationStampは、Apache PDFBox Javaライブラリにおいて、PDF文書内のスタンプ注釈を表すクラスです。
PDAnnotationStampは、Apache PDFBox 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 ) 。これらの注釈は、基礎となるコンテンツを変更することなく、ステータス、承認、またはその他の標準化されたマーキングを示すために、文書ワークフローで一般的に使用されます。
PDAnnotationStampは、Apache PDFBoxのPDAnnotation基底クラスを拡張する具象実装クラスであり、PDF仕様で定義されているスタンプ型の注釈を処理するために特別に設計されています。テキスト注釈（自由形式のコメントを含む）やマークアップ注釈（既存のコンテンツを強調表示または変更する）とは異なり、スタンプ注釈は「承認済み」「機密」「草稿」などの標準的な表記やカスタムスタンプを表す固定されたアイコンまたは外観を表示します。
PDFBoxでは、PDAnnotationStampクラスは、これらのスタンプ注釈をプログラム的に作成、構成、操作するためのメソッドを提供します。このクラスにより、開発者はスタンプの名前（視覚的な外観を決定）、位置、サイズ、およびその他のプロパティを設定できます。 ( 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 ) によれば、スタンプ注釈には事前定義された標準名のセットがありますが、カスタム外観を作成して割り当てることも可能です。
PDAnnotationStampは、文書管理システム、承認ワークフロー、自動文書処理パイプラインを構築する開発者にとって重要です。スタンプ注釈は、異なるPDFビューアやプラットフォーム間で保持される、ステータスインジケータで文書をマークする標準化された非破壊的な方法を提供します。ページコンテンツに直接グラフィックを描画するのとは異なり、スタンプは元の文書構造を変更することなく、追加、削除、または変更できる個別の注釈オブジェクトとして残ります。
Tagged PDFを扱うアクセシビリティを意識した開発者にとって ( Citation: PDF Association, 2023 PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/ ) 、スタンプ注釈を適切に実装することで、コンテンツツリーの整合性を維持しながら、文書のマーキングが論理構造内に保持されることが保証されます。これは ( Citation: N.A., 2014 (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) . International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html ) のような標準への準拠において特に重要であり、アクセシブルな文書体験を確保するために注釈を正しく処理する必要があります。
Apache PDFBoxでPDAnnotationStampを使用する際、開発者は通常、次のプロセスに従います。
注釈インスタンスの作成: 新しいPDAnnotationStampオブジェクトをインスタンス化し、PDF文書内の特定のページに関連付けます。
スタンプ名の設定: 標準的なスタンプ名（「Approved」「Experimental」「Confidential」「Final」「Sold」「Departmental」「ForComment」「TopSecret」「Draft」「ForPublicRelease」「NotApproved」など）を割り当て、デフォルトの外観を決定します。
注釈矩形の定義: PDF座標系の座標を持つPDRectangleオブジェクトを使用して、スタンプがページ上に表示される位置と寸法を指定します。
外観プロパティの構成: 標準的なスタンプが要件を満たさない場合、色、不透明度を設定したり、カスタム外観ストリームを作成したりして、スタンプの視覚的外観をオプションでカスタマイズします。
ページへの追加: 完成したPDAnnotationStampをページの注釈リストに追加し、 ( 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 ) で定義されている文書構造の一部にします。
注釈はページコンテンツの上の独立したレイヤーとして残り、元の文書を保持しながら、人間の読者と自動化されたシステムの両方で処理できる視覚的なステータスインジケータを提供します。
- PDAnnotation – Apache PDFBoxにおけるすべての注釈タイプの基底クラスで、共通のプロパティとメソッドを提供します
- PDAnnotationMarkup – 作成者や作成日などの関連するマークアッププロパティを持つことができる注釈の親クラスです
- PDPage – スタンプなどの注釈が表示されるPDF文書内の単一ページを表します
- PDRectangle – PDFページ上に注釈を配置するための境界ボックス座標を定義します
- PDAppearanceStream – 注釈がレンダリングされる際の外観を定義する視覚的表現データを含みます
- (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 Association (2023)
- PDF Association(2023). Retrieved from https://pdfa.org/resource/tagged-pdf-best-practice-guide-syntax/
- (N.A.) (2014)
- (N.A.). (2014). Document management applications — Electronic document file format enhancement for accessibility — Part 1: Use of ISO 32000-1 (PDF/UA-1) . International Organization for Standardization Retrieved from https://www.iso.org/standard/64599.html