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

Component: TPdf · Unit: PDFium

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

Syntax

function ValidatePdfE: TPdfEValidationResult;

Description

ValidatePdfE обходить відкритий документ у пошуку маркерів файлового формату PDF/E-1, визначених ISO 24517-1:2008:

Потік метаданих XMP, що містить pdfe:ISO_PDFEVersion (§5 + §13.3)
Відповідний опис pdfaExtension:schemas для простору імен pdfe (вимога extension-schema зі XMP Specification 2004, успадкована через §13.1)
Запис /ISO_PDFEVersion у Document Information Dictionary зі значенням literal-string (§5 SHALL)
Рівність між значенням словника Info та значенням XMP (§6.5 / §13.1)
Масив /ID у trailer (§6.2)
Записи xmp:CreateDate і xmp:ModifyDate в XMP (успадковані з ISO 19005-1 §6.7 через §13.1)

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

Conformance — виявлений рівень: pec1 (ідентифікатор PDF/E-1 знайдено і він непорожній), pecNone (маркера PDF/E немає) або pecUnknown (parse не вдався або маркер наявний, але значення відсутнє)
Issues — набір TPdfEValidationIssues, що містить нуль або більше значень: pveiMissingXmpMetadata, pveiMissingPdfEIdentifier, pveiMissingExtensionSchema, pveiMissingInfoVersionEntry, pveiInfoVersionMismatch, pveiMissingTrailerId, pveiMissingXmpDates
IsCompliant — повертає True, коли Conformance є справжнім рівнем PDF/E, а Issues порожній

ValidatePdfE — read-only інспекція — вона не модифікує документ і безпечна для повторних викликів. Застосовуйте її, перш ніж відправляти PDF/E-вміст в інженерний архів, щоб виявити невідповідності файлового формату, які ця бібліотека здатна виявити. Для поширеного запиту «чи це PDF/E-1?», що не потребує списку проблем, надайте перевагу легшій властивості PdfEConformance

Remarks

На документах із дійсним ланцюгом xref валідація розв'язує активні словники та декодує метадані через обмежені розріджені читання замість копіювання повного джерела в пам'ять; непідтримувані структури зберігають сумісний шлях валідації
ValidatePdfE — інспекція файлового формату — вона не забезпечує правила рівня вмісту PDF/E (повноту вбудовування шрифтів, ToUnicode CMaps, заборонені Reference XObjects / PostScript XObjects / TR / TR2 != Default / XFA-форми / JavaScript-дії тощо). Для повного валідатора поєднуйте цей метод із зовнішнім інструментом, як-от callas pdfaPilot або axesPDF
Валідатор звітує pveiInfoVersionMismatch лише коли обидва Info /ISO_PDFEVersion і XMP pdfe:ISO_PDFEVersion наявні та розходяться. Коли запис Info відсутній, валідатор звітує лише pveiMissingInfoVersionEntry (без хибного mismatch)
Виклик ValidatePdfE на неактивному документі повертає запис із Conformance = pecUnknown і порожнім набором Issues
PDF/E-1 дозволяє шифрування (§6.3) за умови, що рядки /ID у trailer залишаються прямими об'єктами. Тому валідатор НЕ позначає шифрування як невідповідність

Example

uses System.TypInfo;

var
  Outcome: TPdfEValidationResult;
  Issue: TPdfEValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\drawing.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfE;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfEConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfEValidationIssue), Ord(Issue)));
end;

ValidatePdfE метод

Component: TPdf · Unit: PDFium

Syntax

Description

Remarks

Example

See Also