SaveAsPdfUa メソッド

SaveAsPdfUa はまず通常の SaveAs を実行し、その保存済みバイトの上にインクリメンタル更新を重ねて、ファイルを PDF/UA-1 または PDF/UA-2 ドキュメントへ昇格させます。後処理は保存されたストリームへ 4 種類のマーカーを注入します:

• PDF/UA 識別 (pdfuaid:part = 1) と対応する pdfaExtension:schemas 記述、必須の dc:title エントリ (ISO 14289-1 §7.1)、そしてブリッジされた Info 辞書フィールド (Author、Subject、Producer、Keywords、CreationDate、ModDate など) を宣言する XMP メタデータストリーム
• ソースカタログに /MarkInfo エントリがない場合の、カタログ /MarkInfo << /Marked true /Suspects false >> (§7.1)
• ソースに /ViewerPreferences エントリがない場合の、カタログ /ViewerPreferences << /DisplayDocTitle true >> (§7.1)
• ソースに /Lang がなく Options.Language が BCP 47 タグを供給する場合の、カタログ /Lang (xx) (§7.2)。トレーラーにも /ID 配列が設定されます (利用可能なら FPDF_GetFileIdentifier から再利用し、なければソースバイトから決定論的に導出されます)

出力は元の PDF の終端まではベースの SaveAs 結果とバイト単位で同一で、追加されるのはインクリメンタル更新のみです。PDF/UA を理解しない既存のリーダーでも、通常の SaveAs とまったく同じようにファイルをレンダリングします。2 つのオーバーロードの違いは構成の渡し方だけです。ファイル名のみの形式は FPDF_GetMetaText / FPDF_GetFileIdentifier / FPDFCatalog_GetLanguage からの自動設定付きの TPdfUaSaveOptions.Default を使用し、TPdfUaSaveOptions 形式では Title、Author、Subject、Keywords、Creator、Producer、CreationDate、ModDate、Language、DocumentId、InstanceId、および pdfuaid の Part、Revision、Amd、Corr 識別子を呼び出し側が上書きできます

TPdfUaSaveOptions.PdfUa2 は Part 2 を選択し、既定の pdfuaid:rev 値 2024 を供給し、カタログ /Version /2.0 を書き込みます。そのためインクリメンタル更新された PDF 1.x ソースの実効バージョンは PDF 2.0 になります

成功すると True を返します。ベースの SaveAs が失敗した場合や、インクリメンタル更新を添付できなかった場合 (PDF が短すぎる、無効なトレーラー、暗号化されたソース) は False を返します

• SaveAsPdfUa は ISO 14289-1 が要求するファイル形式マーカーを添付するだけです。構造ツリーの生成、欠落フォントの埋め込み、図への Alt テキスト追加、その他のページコンテンツ変更は行いません。タグ付きドキュメントの作成 (StructTreeRoot、Figure /Alt、テーブルの /TH /Scope など) は引き続き呼び出し側の責任です。こうしたコンテンツレベルの要求の欠落を表面化するには ValidatePdfUa を使用してください
• 注入は純粋に追加的です。ソースが既に /MarkInfo、/ViewerPreferences、/Lang を持っていれば、それらのエントリは保持され、SaveAsPdfUa は上書きしません。/Metadata のみ常に新しい PDF/UA XMP で置き換えられます
• 暗号化されたドキュメントは PDF/UA として保存できません。必要であれば、先に SaveAs(..., saRemoveSecurity) を呼び出してください
• 後処理は Pascal で実装され、メタデータリーダーを超えて PDFium DLL エクスポートに依存しないため、PDFium Delphi Component が対応するすべてのプラットフォームで動作します