技術記事

PDFium Componentを使用したDelphiでのPDF/X検証

Helveticaの見出しを持つ1ページのフライヤーは、デザイナーの机の上ではどのビューアでも完璧に見えます。各ビューアがHelveticaを黙ってシステムフォントに置き換えているからです。印刷サービスプロバイダのRIPには、そのような甘さはありません。ISO 15930のどのパートも、ページで使われるすべてのフォントプログラムにファイル内部への同梱を要求し、標準14書体のベースフォントも例外ではありません。だからフライヤーは、デザイン側では誰も欠けていると気づかなかったフォントについて「font not embedded」で返ってきます。ああしたチェックは、ページボックス、トラッピング宣言、出力インテントとともに、アップロードボタンが押される前に、自分のDelphiアプリケーションの中で走らせられます

面識のない印刷所に対してPDF/Xファイルが証明すべきこと

PDF/Xはブラインド交換のために存在します。デザイナーは話したことのない印刷所へファイルを送り、印刷所は、足りないフォントや誰かのラップトップに置き去りになったリンク画像について電話をすることなく、正しい出力をします。フォントは埋め込み必須です。受け取るRIPがそれを所有しているとは仮定できないからです。外部参照は禁止です。ファイルはそれ自体で完全でなければならないからです。インタラクティブ機能は禁止です。インキにクリックハンドラはないからです

PDFium Componentは、ファイルが主張するパートをTPdfXConformance列挙型で報告します。pxc1aはPDF/X-1a:2001(ISO 15930-1)で、PDF 1.3/1.4ベースの厳格なCMYKプラススポット交換です。pxc3はPDF/X-3:2002(ISO 15930-3)で、出力インテントに結び付けられたRGB、Lab、ICCベースの色を認めます。pxc4はPDF/X-4:2010(ISO 15930-7)で、PDF 1.6上で生きた透明性とレイヤーを許します。pxc6はPDF/X-6(ISO 15930-9)で、PDF 2.0上に構築されます。PDF/X識別をまったく持たないファイルはpxcNoneで返り、文書が読み込まれていないときはpxcUnknownになります

識別そのものは、互いに一致しなければならない小さなマーカーの束です。XMPパケットはpdfxid:GTS_PDFXVersionを、拡張スキーマ記述やxmp:CreateDate / xmp:ModifyDateとともに運びます。Info辞書は/GTS_PDFXVersionを繰り返し、2つの文字列は一致しなければなりません。catalogの/OutputIntentsエントリは、ファイルが準備された印刷条件を名指します。/S /GTS_PDFX、/OutputConditionIdentifier、そして完全な交換のためには/DestOutputProfileに埋め込みICCプロファイルです。trailerには/IDが必要で、暗号化は完全に排除されます。これらのそれぞれが、pvxiMissingPdfXIdentifierからpvxiInfoVersionMismatch、pvxiOutputIntentMissingIdentifier、pvxiEncryptionPresentまで、TPdfXValidationIssueの固有の値に対応します

TPdf.ValidatePdfXを印刷ゲートとして走らせる

TPdf.ValidatePdfXは引数を取らず、ConformanceとIssues(TPdfXValidationIssueのPascal集合)の2フィールドにIsCompliantメソッドを添えたTPdfXValidationResultレコードを返します。PDF/X検証はEnterpriseエディションの所属です。uses節にFPdfEnterpriseを加え、検索パスにLib\EnterpriseとLib\SmallBusinessを置けば、バリデータが実行ファイルにリンクされます。そのユニットがないと呼び出しはEPdfEnterpriseRequiredを上げます。最初のテスト実行で気づきやすいやつです

IsCompliantは意図的に厳格です。Conformanceがpxc1a、pxc3、pxc4、pxc6のどれかで、問題集合が空であるときだけTrueを返し、それにはpvxiMissingTitleも含まれます。規格はTitleを推奨として言葉にしているのに、他のほとんどの検査はハード要件です。Info辞書に/Titleがないという理由で客の仕事を突き返すのは、人々がゲートを信じなくなる種類の拒否です。だから集合を分割し、助言項目を合否判定の外に置きます

uses
  PDFium, FPdfPdfx,
  FPdfEnterprise; // PDF/Xバリデータをリンクします(Enterpriseエディション)

const
  // 自分のポリシー。ユーザーには報告するが、アップロードは妨げない問題
  AdvisoryIssues: TPdfXValidationIssues = [pvxiMissingTitle];

function PrintGate(const FileName: string;
  out Blocking, Advisory: TPdfXValidationIssues): Boolean;
var
  Pdf: TPdf;
  Res: TPdfXValidationResult;
begin
  Pdf := TPdf.Create(nil);
  try
    Pdf.FileName := FileName;
    Pdf.Active := True;

    Res := Pdf.ValidatePdfX;
    Advisory := Res.Issues * AdvisoryIssues;
    Blocking := Res.Issues - AdvisoryIssues;

    // IsCompliantと同じ適合判定。ただし助言項目を除きます
    Result := (Res.Conformance in [pxc1a, pxc3, pxc4, pxc6]) and
      (Blocking = []);
  finally
    Pdf.Free;
  end;
end;

一度もPDF/Xを名乗らなかったファイルは、長い問題リストとともにこのゲートに落ちます。XMPメタデータなし、識別子なし、出力インテントなし、Infoのバージョンエントリなし。それでもこのリストは見せる価値があります。ファイルを再度書き出す人へのやることリストとして読めるからです。ValidatePdfXの編集アプリケーションでの性質ももう1つ重要です。コンポーネントがいま保存するだろう状態の文書を検査するので、読み込み後に追加したページや変更したメタデータも検証対象になります

なぜ印刷所はTrimBoxのないPDFを拒否するのか?

TrimBoxは仕上がりページ、断裁機が通った後に残る矩形です。すべてのPDFページが持つMediaBoxは紙だけを表します。断ち切り、トンボ、レジストレーションマーク、カラーバーを保持します。面付けソフトはTrimBoxを基準にページを印刷用紙へ並べるので、TrimBoxがなければオペレータは名刺の端を推測で切ることになります。外れた推測は断ち切りを削り取るか、端に白い細片を残します

印刷対応PDFページのPDFium Componentの図。断ち切り、トンボ、カラーバー、レジストレーションマークがTrimBox矩形の周りに並ぶ紙(MediaBox)と、面付けソフトが読むTrimBoxを示し、キーが欠けるとpvxiMissingTrimBoxが上がります
MediaBoxは断ち切り、トンボ、カラーバーを含む紙そのものであり、TrimBoxは断裁機が見つけるべき仕上がりページです。そしてPDF/Xプロデューサーが全ページに書くべき箱でもあります

ValidatePdfXは3つの幾何検査を走らせます。pvxiMissingTrimBoxは、/TrimBoxキーがファイルのどこにも現れないときに上がります。pvxiTrimBoxWithArtBoxは、ページが/TrimBoxと/ArtBoxを同時に持つときです。pvxiPageBoxOutsideMediaBoxは、/TrimBoxや/BleedBoxが/MediaBoxをはみ出すときに上がります。プレスが焼き付けられない領域を記述していることになるからです。矩形は隅をどちらの順でも並べられるので、比較の前に正規化されます

ボックス検査は、各ページ辞書に直接書かれた矩形を読みます。/Pagesノードから継承されたボックスや間接参照として保存されたボックスは包含テストの対象外なので、その方式で作られたファイルはTrimBoxの存在だけでもって判定されます。自分のプロデューサーがボックスを書くなら、全ページに直接書いてください。各ページが完全な包含テストを受けます

Info辞書の/Trappedキーは、別の生産工程の問いに答えます。トラッピングは隣接する色をわずかに重ね、プレスの見当ずれが色の間に白い隙間を開かないようにします。印刷所は、それがすでに済んでいるかを知る必要があります。トラップ済みのファイルにさらにトラップすると重なりが倍になり、未トラップのファイルで省略すれば隙間が見えるリスクを負います。それゆえPDF/Xは/Trapped /Trueか/Trapped /Falseを求めます。欠けたキーや/Unknownは人間にファイルを開かせることになり、コンポーネントはpvxiTrappedNotSetとして報告します

構造上の禁止事項と、その適用パート

ValidatePdfXの構造レイヤーは、何もレンダリングせずにファイルの辞書を検査し、ストリームの中身は走査の対象から外します。圧縮データがたまたま/JavaScriptというバイト列を含むJPEGは、誤ヒットを起こせません。ValidatePdfXは、ファイルがどのパートを名乗っていても、次の検査を走らせます

  • pvxiLzwForbidden:/LZWDecodeフィルタがどこかに現れる。Flateが同じ仕事をし、再書き出しはそちらを使うべきです
  • pvxiJavaScriptForbidden:/JavaScriptのアクションまたは名前ツリーが存在する場合
  • pvxiFormFieldsForbidden:/AcroForm辞書または/XFAエントリが存在する場合
  • pvxiAdditionalActions:/AA追加アクション辞書が存在する場合
  • pvxiEmbeddedFilesForbidden:/EmbeddedFilesまたは/FileAttachment(ファイル添付)注釈が存在する場合
  • pvxiOpiForbidden:/OPIや/Alternatesエントリが、どこか別の場所に保存された置き換え可能な画像コンテンツを指している場合

さらに2つの検査はファイルが名乗るパートに依存し、ValidatePdfXは検出されたConformanceでそれらをゲートします。pvxiTransparencyForbiddenはPDF/X-1aとPDF/X-3だけに適用され、ここでは透明性グループや有効なソフトマスクは認められません。PDF/X-4とPDF/X-6のファイルは生きた透明性を保てるので、同じオブジェクトでも何も上げません。pvxiColorSpaceForbiddenはPDF/X-1aだけに適用され、/DeviceRGB、/CalRGB、/Labで上がります。X-1aはCMYKとスポットの交換であり、デバイス非依存の色空間はX-3でやって来るからです。パートを特定できなかったファイルは、自分に適用されないかもしれない規則でフラグを立てられることはありません

PDF/X-1aは出力プロファイルにもより近い目を向けます。埋め込まれた/DestOutputProfileは、CMYKデータ空間と、RIPが色変換に必要とするルックアップテーブルを持つ、ICCバージョン2の出力(prtr)プロファイルでなければならず、ストリームの/Nは4でなければなりません。汎用PDFライターが貼り込んだsRGBプロファイルや壊れたプロファイルはpvxiInvalidOutputProfileを生みます。ライター側も同じ試験を適用します。Conformanceをpxc1aにしたSaveAsPdfXは、IccProfileDataが使えるICC v2のCMYK出力プロファイルでないとき、バリデータが1分後に拒否するファイルを書く代わりにEArgumentExceptionを上げます

Delphi向けPDFium ComponentのTPdf.ValidatePdfXの図。マーカー、コンテンツ、ページ幾何の検査と、PDFiumオブジェクトモデルによるフォント埋め込み検査からなるバイトレベルのトークン走査を実行し、1つのTPdfXValidationResultレコードへ統合します
ValidatePdfXは1つの読み込み済み文書を、バイトレベルのコンテンツ検査とPDFiumオブジェクトモデルのフォント検査に振り分け、両レイヤーを1つの型付き結果レコードに統合します

フォント埋め込みは2回検査される

フォントに2つの検査があるのは、バイト走査には質問の一部しか答えられないからです。構造レイヤーは、ファイルがフォントを使っていながら/FontFile、/FontFile2、/FontFile3のプログラムをまったく持たないとき、pvxiFontNotEmbeddedを上げます。この規則は意図的に保守的です。フォント記述子とフォントプログラムの個数比較は精密に見えて、複数のフォントが1つの記述子を共有するファイルで誤作動します。代償として、9書体を埋め込み、1書体のシステムフォントを紛れ込ませた文書はバイト走査をすり抜けます

2つ目のレイヤーがその隙間を、PDFiumオブジェクトモデルで塞ぎます。TPdf.ValidatePdfXは各ページを読み込み、FPDFPage_CountObjectsとFPDFPage_GetObjectでオブジェクトをたどり、FPDFTextObj_GetFontですべてのテキストオブジェクトのフォントを解決し、FPDFFont_GetIsEmbeddedを尋ねます。埋め込まれていないフォントが1つ見つかるとpvxiPdfiumFontNotEmbeddedを加えて走査を終えるので、表紙で落ちる300ページのカタログは1ページ目の後で答えが返ります。このレイヤーにはPDFiumライブラリの読み込みと、FPDFFont_GetIsEmbeddedをエクスポートするビルドが必要です。エクスポートのないライブラリではこのレイヤーはスキップされ、バイトレベルの判定が単独で立ちます

どちらの検査も「埋め込みか否か」に答えます。客が、どのページのどのフォントが拒否を引き起こしたのか尋ねるときは、DelphiのPDFiumでPDFフォントプロパティを分析する方法の列挙コードが、バリデータの判定の続きを引き受けます。それまでの間は、各ブロッキング問題をデザイナーに通じる1文に変える小さなヘルパーが大いに役立ちます

// 自作ヘルパー。仕事を妨げる問題のための、客向けテキストです
function PdfXIssueText(Issue: TPdfXValidationIssue): string;
begin
  case Issue of
    pvxiMissingTrimBox:
      Result := 'No TrimBox: the finished page size is not defined';
    pvxiTrimBoxWithArtBox:
      Result := 'A page defines both TrimBox and ArtBox';
    pvxiPageBoxOutsideMediaBox:
      Result := 'TrimBox or BleedBox extends past the sheet';
    pvxiTrappedNotSet:
      Result := 'Trapped must be set to True or False';
    pvxiFontNotEmbedded, pvxiPdfiumFontNotEmbedded:
      Result := 'At least one font is not embedded';
    pvxiTransparencyForbidden:
      Result := 'Live transparency is not allowed in PDF/X-1a or PDF/X-3';
    pvxiColorSpaceForbidden:
      Result := 'RGB or Lab color is not allowed in PDF/X-1a';
    pvxiInvalidOutputProfile:
      Result := 'The output intent needs a CMYK printer profile';
  else
    Result := 'PDF/X requirement not met';
  end;
end;

procedure ReportBlocking(const Blocking: TPdfXValidationIssues);
var
  Issue: TPdfXValidationIssue;
begin
  for Issue in Blocking do
    Writeln('REJECT: ', PdfXIssueText(Issue));
end;

PDFium DLLなしでディスク上のファイルを検査する

構造レイヤーは単独でも、ValidatePdfXCompliance(Source: TStream)として使えます。FPdfPdfxユニットで宣言され、FPdfPdfxEngineに実装されています。PDFiumライブラリに依存しない素のObject Pascalなので、レンダリングエンジンが歓迎されない場所に収まります。Webサーバー上のアップロードハンドラ、生成アートワークを審査するCIステップ、ネイティブバイナリを同梱したくないプラットフォームのLazarusサービスなどです。ストリームを与えられたとおりにそのまま読むので、「プリンタが何を受け取るか」が問いのときに適した道具であり、「この文書を保存し直したらどうなるか」ではありません

uses
  Classes, FPdfPdfx,
  FPdfPdfxEngine; // バイトレベルのPDF/Xエンジンのみ。PDFiumライブラリは不要

function QuickPdfXGate(const FileName: string): Boolean;
var
  Fs: TFileStream;
  Res: TPdfXValidationResult;
begin
  Fs := TFileStream.Create(FileName, fmOpenRead or fmShareDenyWrite);
  try
    Res := ValidatePdfXCompliance(Fs);
    // IsCompliant は pxcNone と pxcUnknown をすでに拒否します
    Result := Res.IsCompliant;
  finally
    Fs.Free;
  end;
end;

ストリームはシーク可能である必要があります。バリデータはファイルの終端からxrefデータを読むからです。圧縮オブジェクトストリームとxrefストリーム、つまりPDF/X-4ファイルの標準的なレイアウトも、他の構造と同じように読まれます。この経路でのフォント判定はバイトレベルのものだけです。テキストオブジェクトごとの検査にはPDFiumオブジェクトモデルが要るからです。ValidatePdfXComplianceをすべてのアップロードへの安い最初のゲートとして走らせ、完全なTPdf.ValidatePdfXはそれを通ったファイルに取っておけば、拒否されたファイルはページ読み込みのコストを払いません

ゲートが止まる場所、認証が始まる場所

ValidatePdfXがカバーするのは、識別マーカー、出力インテントとそのプロファイル、構造上の禁止、パート固有の透明性と色の規則、ページ幾何、トラッピング宣言、そして個々のテキストオブジェクトに至るフォント埋め込みです。インキ被覆率の上限、画像解像度、スポットカラーの命名は、色管理されたプリフライトエンジンの管轄で、印刷所が仕事を認証するときに使う道具です。アプリ内ゲートの価値はタイミングにあります。上述の構造的な拒否はどれも、客がまだアップロード画面にいる間に現れます。同じTPdfXValidationResultはコンポーネントのレポートジェネレータにも流れ込み、PDFium ComponentでバッチプリフライトレポートCLIを作る方法が、フォルダ1つ分のファイルにこのパターンを適用した例を見せます。PDF/XはXMP識別から出力インテントまで、アーカイブ用PDF/Aと多くの仕組みを共有していて、アーカイブ側はPDFium ComponentでのPDF/Aプリフライト検証で扱っています

PDF/Xバリデータ、適合出力を生む対応するSaveAsPdfXライター、そして同じ方式で作られたPDF/A、PDF/UA、PDF/E、PDF/VTの検査は、Delphi、C++Builder、Lazarus向けのPDFium ComponentのEnterpriseエディションの一部です。印刷ポータルは、プレビューのレンダリングに使うのと同じライブラリで、受け入れ判定ができます