Довідник розробника PDFium Delphi Component

Component: TPdf · Unit: PDFium

Досліджує поточний відкритий PDF на маркери PDF/X і вибрані вимоги рівня вмісту, повертаючи виявлений рівень відповідності та набір конкретних знайдених проблем

Syntax

function ValidatePdfX: TPdfXValidationResult;

Description

ValidatePdfX обходить відкритий документ у пошуку маркерів файлового формату та вибраних правил вмісту, визначених родиною ISO 15930

Потік метаданих XMP, що містить pdfxid:GTS_PDFXVersion (і за бажанням pdfxid:GTS_PDFXConformance для PDF/X-1a / PDF/X-3)
Опис pdfaExtension:schemas для простору імен pdfxid (конвенція extension-schema XMP)
Запис /GTS_PDFXVersion у Document Information Dictionary з тим самим значенням, що й властивість XMP
Масив /OutputIntents у каталозі, що посилається на словник OutputIntent із вбудованим профілем ICC через /DestOutputProfile
Запис /Title у словнику Info (PDF/X наполегливо рекомендує)
Масив /ID у trailer і відсутність /Encrypt (шифрування заборонене всіма версіями PDF/X)
Записи xmp:CreateDate і xmp:ModifyDate в XMP для парності Info / XMP

Результатом є запис TPdfXValidationResult:

Conformance — виявлений рівень, визначений з рядка версії XMP: pxc1a (збігається з "PDF/X-1"), pxc3 ("PDF/X-3"), pxc4 ("PDF/X-4"), pxcNone (маркера PDF/X немає) або pxcUnknown (маркер наявний, але не розпізнаний)
Issues — набір TPdfXValidationIssues, що покриває метадані, парність словника Info, форму OutputIntent, шифрування, заборонений активний вміст, вбудовування шрифтів, обмеження прозорості й колірних просторів, наявність TrimBox, геометрію page-box і стан trapped
IsCompliant — повертає True, коли Conformance є справжнім рівнем PDF/X, а Issues порожній

ValidatePdfX — read-only інспекція. Застосовуйте її, перш ніж відправляти PDF/X-вміст у препрес-процес, щоб виявити невідповідність для оператора. Для поширеного запиту «який це рівень PDF/X?», що не потребує списку проблем, надайте перевагу легшій властивості PdfXConformance

Remarks

ValidatePdfX включає консервативні перевірки вбудованих шрифтів, прозорості, колірних просторів, забороненого активного вмісту та геометрії page-box, але це не повний preflight-рушій ISO 15930; використовуйте спеціалізований preflight-інструмент, коли потрібне покриття сертифікаційного рівня
Документи з дійсним xref без шифрування використовують обмежені розріджені читання активних генерацій об'єктів і обмежують декодовані метадані XMP 16 MiB; непідтримувані, зашифровані чи некоректні структури зберігають сумісний шлях валідатора
Валідатор звітує pvxiInfoVersionMismatch лише коли обидва Info /GTS_PDFXVersion і XMP pdfxid:GTS_PDFXVersion наявні та розходяться
Виклик ValidatePdfX на неактивному документі повертає запис із Conformance = pxcUnknown і порожнім набором Issues
Розрізнення рівнів (pxc1a / pxc3 / pxc4) базується на substring-зіставленні рядка версії XMP з "PDF/X-1", "PDF/X-3", "PDF/X-4". Власні рядки версій поза цими шаблонами відкочують до pxcUnknown

Example

uses System.TypInfo;

var
  Outcome: TPdfXValidationResult;
  Issue: TPdfXValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\ad.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfX;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfXConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfXValidationIssue), Ord(Issue)));
end;

ValidatePdfX метод

Component: TPdf · Unit: PDFium

Syntax

Description

Remarks

Example

See Also