기술 문서

Delphi PDFium Component의 PDF/X 검증

Helvetica 헤드라인을 얹은 한 페이지 전단지는 디자이너 책상의 모든 뷰어에서 완벽해 보입니다. 각 뷰어가 조용히 시스템 폰트로 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 2.0 기반의 PDF/X-6(ISO 15930-9)입니다. PDF/X 식별이 전혀 없는 파일은 pxcNone으로 돌아오고, 문서가 로드되지 않았을 때 받는 것이 pxcUnknown입니다

식별 자체는 서로 일치해야 하는 작은 표식 다발입니다. XMP 패킷은 확장 스키마 설명과 xmp:CreateDate / xmp:ModifyDate와 함께 pdfxid:GTS_PDFXVersion을 나르고, Info 딕셔너리는 /GTS_PDFXVersion을 반복하며 두 문자열은 일치해야 합니다. 카탈로그의 /OutputIntents 항목은 /S /GTS_PDFX와 /OutputConditionIdentifier, 완전한 교환을 위해서는 /DestOutputProfile에 임베드된 ICC 프로파일로 파일이 준비된 인쇄 조건을 이름 짓습니다. 트레일러에는 /ID가 필요하고 암호화는 완전히 배제됩니다. 이 각각은 pvxiMissingPdfXIdentifier부터 pvxiInfoVersionMismatch, pvxiOutputIntentMissingIdentifier, pvxiEncryptionPresent까지 TPdfXValidationIssue의 자기 값에 대응합니다

인쇄 관문으로서의 TPdf.ValidatePdfX

TPdf.ValidatePdfX는 인수를 받지 않고 두 필드, 즉 Conformance와 Issues(TPdfXValidationIssue의 Pascal 집합)에 IsCompliant 메서드를 더한 TPdfXValidationResult 레코드를 반환합니다. PDF/X 검증은 Enterprise 에디션 소속입니다. uses 절에 FPdfEnterprise를 추가하고 검색 경로에 Lib\Enterprise와 Lib\SmallBusiness를 두면 검증기가 실행 파일에 링크됩니다. 그 유닛이 없으면 호출은 EPdfEnterpriseRequired를 던지는데, 첫 테스트 실행에서 바로 알아차릴 수 있습니다

IsCompliant는 의도적으로 엄격합니다. Conformance가 pxc1a, pxc3, pxc4, pxc6 중 하나이고 이슈 집합이 비어 있을 때만, 그리고 그 안에는 pvxiMissingTitle도 포함되어 True를 반환합니다. 표준은 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의 한 가지 속성이 더 중요합니다. 컴포넌트가 지금 당장 저장할 문서를 기준으로 검사하므로, 로드 뒤에 추가한 페이지나 바꾼 메타데이터도 검증 대상에 포함됩니다

인쇄소는 TrimBox 없는 PDF를 왜 거절할까?

TrimBox는 완성된 페이지, 즉 미터 절단 뒤에 남는 사각형입니다. 모든 PDF 페이지가 지니는 MediaBox는 시트일 뿐입니다. 블리드, 크롭 마크, 레지스트레이션 표적, 컬러 바를 담습니다. 조판 소프트웨어는 TrimBox 기준으로 페이지를 인쇄 시트에 배치하므로, TrimBox가 없으면 작업자가 명함이 어디서 끝나는지 추측해야 합니다. 잘못된 추측은 블리드를 잘라 내거나 한쪽 가장자리에 흰 실밥을 남깁니다

인쇄 준비된 PDF 페이지를 보여주는 PDFium Component 다이어그램: 블리드, 크롭 마크, 컬러 바, 레지스트레이션 마크가 조판 소프트웨어가 읽는 TrimBox 사각형 주위에 놓인 MediaBox 시트이며, 키가 없으면 pvxiMissingTrimBox가 발생합니다
MediaBox는 블리드, 크롭 마크, 컬러 바를 담은 전체 시트이고, TrimBox는 미터가 찾아야 하는 완성된 페이지이자 PDF/X 생산자가 모든 페이지에 써야 하는 박스입니다

ValidatePdfX는 기하 검사 세 개를 돌립니다. 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 항목이 다른 곳에 저장된 교체 가능한 이미지 콘텐츠를 가리킵니다

두 검사는 더 있고 파일이 주장하는 파트에 달려 있으며, 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 출력 프로파일이 아니면 EArgumentException을 던져, 검증기가 1분 뒤에 거절할 파일을 써 내지 않습니다

Delphi용 PDFium Component의 TPdf.ValidatePdfX가 마커, 콘텐츠, 페이지 기하 검사와 PDFium 객체 모델 폰트 임베딩 패스로 바이트 수준 토큰 스캔을 돌리고 하나의 TPdfXValidationResult 레코드로 병합하는 모습을 보여주는 다이어그램
ValidatePdfX는 로드된 문서 하나를 바이트 수준 콘텐츠 검사와 PDFium 객체 모델 폰트 패스로 펼쳐 넣은 뒤 두 계층을 단일 타입화 결과 레코드로 병합합니다

폰트 임베딩, 두 번 검사

폰트는 두 번 검사됩니다. 바이트 스캔이 답할 수 있는 건 질문의 일부이기 때문입니다. 구조 계층은 파일이 폰트를 쓰면서 /FontFile, /FontFile2, /FontFile3 프로그램을 전혀 나르지 않을 때 pvxiFontNotEmbedded를 일으킵니다. 그 규칙은 의도적으로 보수적입니다. 폰트 디스크립터를 폰트 프로그램과 대조하는 것은 정밀해 보이지만 여러 폰트가 하나의 디스크립터를 공유하는 파일에서 오작동합니다. 값은 아홉 폰트를 임베드한 문서에 시스템 폰트 하나가 슬며시 끼어들면 바이트 스캔을 통과한다는 것입니다

두 번째 계층은 PDFium 객체 모델로 그 틈을 막습니다. TPdf.ValidatePdfX는 각 페이지를 로드하고 FPDFPage_CountObjects와 FPDFPage_GetObject로 객체를 걷고, FPDFTextObj_GetFont로 모든 텍스트 객체의 폰트를 해석하고, FPDFFont_GetIsEmbedded를 묻습니다. 임베드되지 않은 폰트 하나는 pvxiPdfiumFontNotEmbedded를 더하고 순회를 끝내므로, 표지에서 실패하는 300페이지 카탈로그의 답은 1페이지 뒤에 돌아옵니다. 이 계층은 PDFium 라이브러리가 로드돼 있고 FPDFFont_GetIsEmbedded를 내보내는 빌드가 필요합니다. 그 내보내기가 없는 라이브러리라면 계층은 건너뛰어지고 바이트 수준 판정이 홀로 섭니다

두 검사 모두 "임베드 여부"에 답합니다. 고객이 어느 페이지의 어느 폰트가 거절을 불렀는지 묻는다면 Delphi에서 PDFium으로 PDF 폰트 속성 분석하기의 열거 코드가 검증기 판정이 멈춘 자리에서 이어받습니다. 그때까지 각 차단 이슈를 디자이너가 이해하는 문장으로 바꿔 주는 짧은 헬퍼가 큰 힘이 됩니다:

// 여러분의 헬퍼: 작업을 막는 이슈의 고객용 텍스트
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이라 렌더링 엔진이 반갑지 않은 자리에 어울립니다. 웹 서버의 업로드 핸들러, 생성된 아트웍을 검증하는 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;

스트림은 탐색 가능해야 합니다. 검증기가 크로스레퍼런스 데이터를 파일 끝에서 읽기 때문입니다. 압축된 오브젝트 스트림과 크로스레퍼런스 스트림, 즉 PDF/X-4 파일의 평범한 레이아웃도 다른 구조처럼 읽힙니다. 이 경로에서 폰트 판정은 바이트 수준뿐입니다. 텍스트 객체별 검사는 PDFium 객체 모델이 필요하니까요. 모든 업로드에 값싼 첫 관문으로 ValidatePdfXCompliance를 돌리고 전체 TPdf.ValidatePdfX는 그것을 통과한 파일에 아끼세요. 거절된 파일은 페이지 로드 값을 치르지 않습니다

관문이 멈추고 인증이 시작하는 지점

ValidatePdfX는 식별 표식, 출력 인텐트와 그 프로파일, 구조적 금지, 파트별 투명도와 색 규칙, 페이지 기하, 트래핑 선언, 개별 텍스트 객체까지의 폰트 임베딩을 커버합니다. 잉크 커버리지 한도, 이미지 해상도, 스팟 색 이름은 색 관리 프리플라이트 엔진, 즉 인쇄소가 작업을 인증할 때 쓰는 도구의 영역입니다. 애플리케이션 안 관문의 가치는 타이밍입니다. 위에서 설명한 모든 구조적 거절은 고객이 아직 업로드 화면에 있는 동안 나타납니다. 같은 TPdfXValidationResult는 컴포넌트의 보고서 생성기에도 먹이고, PDFium Component로 배치 프리플라이트 보고서 CLI 만들기가 그 패턴을 폴더 한 통의 파일에 적용한 모습을 보여 줍니다. 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 에디션의 일부입니다. 인쇄 포털이 미리보기를 렌더링에 쓰는 같은 라이브러리로 받아들이는 것을 검사할 수 있는 이유입니다