ValidatePdfUa - TPdf

この API エントリでは識別子、シグネチャ、コードブロック、PDF 用語を元の表記のまま保持します。

コンポーネント: TPdf · ユニット: PDFium

現在開いている PDF の PDF/UA-1 準拠マーカーを検査し、検出された準拠レベルと見つかった具体的な問題の集合を含む構造化結果を返します

構文

function ValidatePdfUa: TPdfUaValidationResult;

説明

ValidatePdfUa は開いている文書を走査し、ISO 14289-1:2014 で定義された PDF/UA-1 ファイル形式マーカーを探します:

pdfuaid:part = 1 と、一致する pdfaExtension:schemas の説明（§5）を持つ XMP メタデータストリーム。
XMP パケット内の必須の dc:title エントリ（§7.1）。
A StructTreeRootカタログ内またはファイル内のどこかにあること (§7.1) — 文書がタグ付けを持つために必要です
カタログの /MarkInfo << /Marked true /Suspects false >>（§7.1）。
カタログの /ViewerPreferences << /DisplayDocTitle true >>（§7.1）。
BCP 47 言語タグを持つカタログの /Lang（§7.2）。
トレーラーの /ID 配列と、暗号化の不在。
xmp:CreateDate / xmp:ModifyDate（Info/XMPのパリティとして推奨）。

結果は TPdfUaValidationResult レコードです：

適合性 — 検出されたレベル：puc1（PDF/UA-1 識別子が見つかりました）、pucNone（PDF/UA マーカーなし）、または pucUnknown（解析に失敗しました）。
Issues — a TPdfUaValidationIssues set containing zero or more values: pvuaiMissingXmpMetadata, pvuaiMissingPdfUaIdentifier, pvuaiMissingExtensionSchema, pvuaiMissingDcTitle, pvuaiMissingStructTreeRoot, pvuaiMissingMarkInfo, pvuaiSuspectsTrue, pvuaiMissingDisplayDocTitle, pvuaiMissingLang, pvuaiEncryptionPresent, pvuaiMissingTrailerId, pvuaiMissingXmpDates, pvuaiFontNotEmbedded, pvuaiFontMissingToUnicode, pvuaiMissingTabsOrder, pvuaiFigureMissingAlt, pvuaiFormulaMissingAlt, pvuaiNoteMissingId.

ValidatePdfUa は読み取り専用の検査であり、文書を変更せず、繰り返し呼び出しても安全です。PDF をアーカイブシステムやアクセシビリティチェッカーへ渡す前に使用し、非準拠をオペレーターへ提示します。問題リストが不要な一般的な「これは PDF/UA-1 か」の確認には、より軽量なPdfUaConformance property.

備考

ValidatePdfUa は、ファイル形式のマーカー、バイトチェック可能な少数のコンテンツヒューリスティック（フォントの埋め込み、ToUnicode CMap、ページ /Tabs の /S タブ順序）、および3つの高信頼度の構造ツリーチェック（FigureにAlt/ActualTextが欠落、FormulaにAltが欠落、Noteに一意のIDが欠落）をカバーします。見出しのネスト、フォームウィジェットのタグ付け、テーブルの /TH /Scope 属性、RoleMapの正当性、論理的な読み取り順序など、残りのコンテンツレベルのPDF/UAルールは検証しません。完全なバリデーターにするには、このメソッドをPAC 2024やaxesPDFなどの外部ツールと組み合わせてください。
非アクティブな文書で ValidatePdfUa を呼び出すと、Conformance = pucUnknown and an empty Issues set.
The validator only flags pvuaiSuspectsTrue when an explicit /Suspects trueが /MarkInfo に現れるか確認します。/Suspects キー自体がない文書は、この点では準拠とみなされます (仕様で禁止しているのはtrue).
SaveAsPdfUa は、ソースがそれらの辞書を不完全に、または間接参照として提供している場合でも、ISO 14289-1 7.1 で必須の /ViewerPreferences /DisplayDocTitle true と /MarkInfo /Marked true /Suspects false エントリを強制します (N 0 R); 既存キーは保持され、書き換え後のカタログでは辞書が直接辞書に正規化されます

例

uses System.TypInfo;

var
  Outcome: TPdfUaValidationResult;
  Issue: TPdfUaValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\report.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfUa;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfUaConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfUaValidationIssue), Ord(Issue)));
end;

ValidatePdfUa メソッド

コンポーネント: TPdf · ユニット: PDFium

構文

説明

備考

例

関連項目