技術記事

Delphi の PDFium VCL で行う PDF/VT 可変データ印刷

帳票を 8 万ページ連結したデータを取引先の印刷会社へ渡したところ、返ってきた差し戻しはたった一行です。「PDF/VT ではないので、RIP でキャッシュできない」。手元のどのビューアでも問題なく開き、色も合っていて、差し込みデータも正しく結合されています。ですが、デジタル印刷機が求めているのはそこではありません。高速な可変データ印刷では、1 ページ目の顧客ロゴのブロックが 4 万ページ目の同じブロックとバイト単位で同一オブジェクトだと印刷機が認識し、一度だけ描画して再利用できるかどうかが決定的です。PDF/VT は、その約束を機械的に検証可能にする標準です。そして「見た目が正しい」という感覚こそが落とし穴です。RIP が読む構造は画面上では見えないからです

PDFiumPas は TPdf にある小さな API 面としてこの構造を公開しています。SaveAsPdfVT が書き込み、ValidatePdfVT が検査します。この記事では、この 2 つのメソッドが実際にディスクへ何を書き出し、何を検査しているのか、ISO 16612-2 が見た目以上に厳密な箇所はどこか、そしてどこまでが正直な構造アンカーで、どこから先がクライアントに請求できる完全なプリフライトではないのかを整理します

PDF/VT が標準化するものと、なぜ先に PDF/X が必要なのか

PDF/VT(ISO 16612-2:2010)は新しいファイル形式ではありません。PDF/X ファイルに最適化メタデータの層を追加したものであり、この順序には意味があります。規格は 3 つの適合レベルを定義していますが、PDF ファイルそのものを指すのは 2 つだけです。PDF/VT-1 は単一の自己完結型ドキュメントで、PDF/VT-2 はページが共有外部リソースを参照するファイルセット型です。もう 1 つ見かけることのある PDF/VT-2s は、そもそもファイルレベルの値ではありません。Annex A にある MIME ストリームヘッダー内で使われます。文書の XMP へ GTS_PDFVTVersion = "PDF/VT-2s" を書き込んでいるコードを見つけたら、そのコードは誤りです

GTS_PDFVTVersion = "PDF/VT-2s"/ID を文書の XMP に書き込んでいるなら、そのコードは誤りです。SaveAsPdfX/ID

Delphi で構築した PDF/VT スタックの図。最適化メタデータが必須の PDF/X-4 ベース上に載り、PDF/VT-1、PDF/VT-2 の正確な適合ペアと、MIME のみの PDF/VT-2s トークン
PDF/VT のメタデータが荷重を支えるのは、完全な PDF/X ベースの上だけです

SaveAsPdfX

最小の呼び出しに必要なのは有効な文書だけです。TPdfVTSaveOptions.Default が組み込みの sRGB ICC プロファイルと適合レベル pvc1 を供給するからです。保存は内部で 3 ステップで走ります。まずセキュリティを剥がし(暗号化されたオブジェクトストリームへ平文マーカーを注入すると破損するため)、次に文書の既存 Info 辞書とトレーラー /ID をマーカーセットへ橋渡しして XMP と Info の値を一致させ、それからインクリメンタル更新で PDF/X-4 と PDF/VT のオブジェクトを追記します

var
  Pdf: TPdf;
begin
  Pdf := TPdf.Create(nil);
  try
    Pdf.FileName := 'statements-merged.pdf';
    Pdf.Active := True;
    // Default options: built-in sRGB OutputIntent, PDF/VT-1, synthesised DPart
    if Pdf.SaveAsPdfVT('statements-pdfvt.pdf') then
      Writeln('PDF/VT-1 written')
    else
      Writeln('Save failed (document not active?)');
  finally
    Pdf.Free;
  end;
end;

実際の生産出力では、ジェネリックな sRGB フォールバックではなく、印刷機のキャラクタライゼーションで OutputIntent を上書きしたいはずです。ICC バイト列と条件識別子を TPdfVTSaveOptions で渡します

var
  Pdf: TPdf;
  Opt: TPdfVTSaveOptions;
  Icc: TBytes;
begin
  Pdf := TPdf.Create(nil);
  try
    Pdf.FileName := 'directmail-merged.pdf';
    Pdf.Active := True;
    Icc := LoadIccProfile('GRACoL2013_CRPC6.icc');  // 独自のloader

    Opt := TPdfVTSaveOptions.Default;
    Opt.Conformance := pvc1;            // write時にpvc2をpvc1へnormalise
    Opt.IccProfileData := Icc;
    Opt.OutputConditionIdentifier := 'CGATS21_CRPC6';
    Opt.OutputCondition := 'Commercial print, coated, CRPC6';
    Opt.RegistryName := 'http://www.color.org';
    Opt.Title := 'Spring 2026 Direct Mail Run';
    Opt.Trapped := ptvFalse;           // PDF/X Info /Trapped state

    Pdf.SaveAsPdfVT('directmail-pdfvt.pdf', Opt);
  finally
    Pdf.Free;
  end;
end;

そのコード片で 1 つ重要なのは、議論できる制限ではなく、意図的に設けられたガードレールだという点です。Opt.Conformance := pvc2 を設定しても PDF/VT-2 ファイルは作れません。ライターは pvc1 以外の要求を pvc1 へ正規化します。PDF/VT-2 はファイルセット形式であり、出力文書を 1 つ追記する単一ファイルライターは、§6.2.2 が要求する外部リソース集合を物理的に組み立てられないからです。pvc2 の値は読み込み経路のために存在し、ValidatePdfVT が既存のファイルセット文書を認識して報告できるようにするものです。書き込みの対象ではありません

DPart ツリー: RIP が実際に読む構造

PDF/VT の核心は Document Part(DPart)階層です。これにより印刷機は長いジョブをレコード単位に区切り、レコードを受取人や郵送束ごとにまとめ、Document Part Metadata を付けて下流装置が各ピースを振り分けて課金できるようになります。ISO 16612-2 §6.5 は配線をこう定義しています。カタログは /DPartRoot を運び、ルート DPart ノードは /DPartRootNode と、各階層レベルを名指しする /NodeNameList を運びます。リーフ DPart はページツリーの範囲を覆い、一部に属するすべてのページは、ページレベルの /DPart エントリを通じて自分のリーフへ逆参照します

RIP が消費する PDF/VT DPart 階層の PDFium Component 図。カタログ DPartRoot、ルートノード NodeNameList、ページ範囲をカバーするリーフ DPart、ページレベル DPart の逆参照
DPart ツリーは、RIP がレコードを分割し共有コンテンツをキャッシュするために読む構造です

元の文書にすでに利用可能な階層があるなら、SaveAsPdfVT はそれを保持します。ない場合は、ライターが最小構成の階層を合成します。現在のページツリー全体を順に覆う単一の文書レベル DPart を作り、各有効ページオブジェクトに /DPart の逆参照を追記し、1 レベルだけの /NodeNameList [/Document] を付けます。その最小ツリーが何であるかは、自分に正直でいてください。§6.5 の形の要件を満たすための構造アンカーであって、ビジネスメタデータではありません。受取人も郵便物の境界も製品バッチも発明できません。その情報はそもそもソースになかったからです。受取人ごとのデータがあるなら、より深い DPart ツリーを自分で組み立て、作ったレベルに合わせて /NodeNameList を拡張することが期待されています

キーの有無だけで終わらない検証

ValidatePdfVT は 3 つの要素を持つ TPdfVTValidationResult レコードを返します。検出された Conformance、Issues の集合、そして適合レベルが実際のレベルで問題集合が空のときにだけ true になる IsCompliant ヘルパーです。問題の列挙は意図的に具体的なので、失敗した結果は単なる「無効」ではなく、どの条項を見落としたかを教えてくれます:

PDFium VCL を使う Delphi における PDF/VT 検証の図。正確なベースペアリング、再帰 DPart たどり、PDF/X-4 マーカー、XMP 日付チェックが TPdfVTValidationResult レコードに供給
ValidatePdfVT は、曖昧な invalid 判定の代わりに、どの条項が失敗したかを報告します
var
  Pdf: TPdf;
  Res: TPdfVTValidationResult;
begin
  Pdf := TPdf.Create(nil);
  try
    Pdf.FileName := 'statements-pdfvt.pdf';
    Pdf.Active := True;
    Res := Pdf.ValidatePdfVT;

    if Res.IsCompliant then
      Writeln('PDF/VT compliant: ', VTLevelName(Res.Conformance))
    else
    begin
      if pvviMissingDPartRoot in Res.Issues then
        Writeln('DPart hierarchy missing or unusable');
      if pvviMissingPdfXIdentifier in Res.Issues then
        Writeln('PDF/X-4 base identifier absent');
      if pvviMissingOutputIntent in Res.Issues then
        Writeln('OutputIntent / ICC profile missing');
      if pvviEncryptionPresent in Res.Issues then
        Writeln('Encrypted - PDF/X forbids this');
    end;
  finally
    Pdf.Free;
  end;
end;

深く理解しておく価値があるのは、適合レベルの組み合わせ確認と DPart 走査の 2 つです。どちらも緩めに実装しやすい部分だからです。組み合わせ側では、バリデータは「何らかの PDF/X ならよい」ではなく完全一致を求めます。PDF/VT-1 ファイルは PDF/X-4 ベースでのみ受け入れられ、PDF/VT-2 ファイルは PDF/X-4p、PDF/X-5g、PDF/X-5pg ベースでのみ受け入れられます。PDF/X-1a ベースに載った PDF/VT-1 マーカーは、黙って通されるのではなく報告されます

DPart 走査こそが厳密さの大半を担う部分です。カタログに /DPartRoot キーがあっても足りません。偽造された空のオブジェクトや、ページリンクを持たないオブジェクトは、やはり消費できないからです。HasValidDPartHierarchy と再帰的な ValidateDPartNode が構造全体をたどります。親リンクを追い、重複する子と循環を拒否し、/Start と /DParts が排他的であることを強制し、リーフのページ範囲が深さ優先順でページツリーを覆い、各ページの /DPart が自分を含むリーフを指すことを要求します。これらの内部故障はすべて、公開列挙を広げるのではなく、単一の pvviMissingDPartRoot 問題ビットに潰されます。このフラグは「ルートキーが欠落」と文字通り読まず、「DPart 階層が使用不可」と読んでください

バリデータが強制する 3 つの構文トラップ

§6.5 Table 4 は、一見もっともらしいいくつかの形を退けています。手作業で DPart ツリーを組むと起こりやすい種類の過ちなので、明示しておく価値があります:

  • /DParts はフラットな配列ではなく、配列の配列です。 外側の配列の各要素は、それ自体が間接参照の配列でなければなりません。フラットな /DParts [9 0 R] は拒否され、適合する形は /DParts [[9 0 R] [10 0 R]] です。これにより、階層を持たない構造が有効なレベルのふりをするのを防ぎます
  • /End は本当の複数ページ範囲にだけ付きます。 リーフ DPart が /End を持てるのは /Start も持つときだけで、/End はページツリー順で /Start より後でなければなりません。/Start 3 0 R /End 3 0 R という縮退した形は、1 ページのパートとして読まれるのではなく、階層を使用不可にします
  • /NodeNameList の名前は、XML NMTOKEN として PDF 名前のアンエスケープに耐えなければなりません。 /Bad#20Name のような名前は空白を含む形へ展開され、有効なトークンではありません。実装は軽い ASCII 検査(英字、数字、.、-、_、:、および非 ASCII バイト)を行い、空白や区切り文字の過ちを捕えつつ、正当なローカライズ名やベンダー固有名を拒否しません

XMP マーカー: 同じプロパティを 2 通りで書く

PDF/VT の識別情報は、XMP の pdfvtid 名前空間、具体的には GTS_PDFVTVersion と GTS_PDFVTModDate として、標準の xmp:CreateDate や xmp:ModifyDate と並んで存在します。素朴なリーダーが誤って「欠落」と報告する原因になる微妙な点は、これらが 2 通りで直列化され得ることです。要素テキスト(<pdfvtid:GTS_PDFVTVersion>PDF/VT-1</pdfvtid:GTS_PDFVTVersion>)としても、description 要素の RDF 属性としても書けます。PDFiumPas は両形式を読むので、属性スタイルで書かれた他ツールのファイルが不利になりません。さらに §6.3 の整合性規則、すなわち GTS_PDFVTModDate が xmp:ModifyDate と等しいべきという規則も強制し、不一致は pvviModDateMismatch を上げます

同じ条項にはもう 1 つルールがあります。未知の GTS_PDFVTVersion 値は、pvcNone へ畳み込まず、pvcUnknown として保持されます。この区別は運用上重要です。pvcNone は「PDF/VT マーカーがまったくない、普通の PDF」を意味し、pvcUnknown は「このバリデータが認識しないバージョンが刻まれている」(PDF/VT-2s のケースもそのうち)を意味します。両者を混同すると、不正形のファイルが普通の文書と同じ扱いに隠れてしまいます

構造検査がカバーする範囲

これらのメソッドが約束する境界は正確に理解しておくべきです。可変データ印刷の適合性には実際の費用がかかるからです。DPart と組み合わせの検査はバイトレベルの構造検証です。最適化用スケルトン、PDF/X-4 のベースマーカー、OutputIntent、XMP が存在し、内部的に整合していることを確認します。内容レベルの PDF/X-4 プリフライト—宣言された出力条件に対する色、フォント埋め込み、透明合成—は別の層です。契約印刷機へ流すジョブであれば、PDFiumPas の構造検証に専用の PDF/X プリフライトエンジンとテスト印刷を組み合わせてください。他の適合性主張を健全に確認するときと同じです。構造層が捕まえるのは、RIP キャッシュを静かに壊す種類の失敗です。完全な確認の半分であり、全体ではありません

これらの検査をより広いリリースゲートへ組み込むなら、同じバイトレベル走査の考え方が、ライブラリのほかの標準対応にも生きています。たとえば オブジェクトストリームとクロスリファレンスストリームの検証 はファイルがプリフライトへ到達する前の段階で役立ち、Form XObjects を使った再利用可能なページスタンプ の背後にある共有オブジェクト規律は、文書をそもそも RIP に優しいものにします。ここで説明した PDF/VT と PDF/X の保存および検証 API は、Delphi と C++Builder 向け PDFium VCL component の一部であり、製品ページには完全な適合性リファレンスが掲載されています