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

Component: TPdf · Unit: PDFium

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

Syntax

function ValidatePdfVT: TPdfVTValidationResult;

Description

ValidatePdfVT обходить відкритий документ у пошуку маркерів рівня файлового формату, визначених ISO 16612-2:2010:

XMP pdfvtid:GTS_PDFVTVersion (§6.3 Table 2) і pdfvtid:GTS_PDFVTModDate
Рівність між pdfvtid:GTS_PDFVTModDate і xmp:ModifyDate (§6.3 NOTE 1)
XMP pdfxid:GTS_PDFXVersion — PDF/VT-1 мусить бути PDF/X-4 (§6.2.1), тоді як PDF/VT-2 мусить використовувати одну з основ file-set: PDF/X-4p, PDF/X-5g чи PDF/X-5pg (§6.2.2)
Опис pdfaExtension:schemas для обох просторів імен, pdfvtid і pdfxid
Запис /DPartRoot у каталозі з придатним DPart-деревом §6.5: /DPartRootNode, сумісний з XML NMTOKEN /NodeNameList, батьківські посилання, /DParts масив-масивів, діапазони /Start//End листя та посторінкові посилання /DPart мусять покривати дерево сторінок рівно один раз у depth-first порядку
Підказки повторюваних XObject із §§6.7.2–6.7.4, включно з прямими типами значень і дозволеними значеннями GTS_XID, GTS_Scope і GTS_Env, непрямим RecordLevel у DPartRoot, який використовує область Record, та межею тільки-для-PDF/VT-2s для області Stream
Декодовані нефільтровані та FlateDecode потоки сторінок чи Form XObject з розв'язанням кожного операнда Do через ефективні успадковані ресурси, щоб забезпечити лічильники SingleUse, видимість ресурсів і одноодержувачне володіння для області Record
Вимоги до encapsulated XObject із §6.7.5, які можна встановити статично: булева форма, рекомендована область, Intent зображення, потрібна ізольована transparency Group з колірним простором змішування та позначені оператори optional-content у прямому чи вкладеному Form-вмісті
Масив /OutputIntents у каталозі з OutputIntent, що має вбудований /DestOutputProfile або зовнішній /DestOutputProfileRef, відповідні для основи PDF/X
Масив /ID у trailer і відсутність /Encrypt (PDF/X забороняє шифрування)
Записи xmp:CreateDate і xmp:ModifyDate в XMP для парності Info / XMP

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

Conformance — виявлений рівень: pvc1 (маркер PDF/VT-1), pvc2 (маркер PDF/VT-2), pvcNone (маркера PDF/VT немає) або pvcUnknown (маркер наявний, але файловий рівень версії не розпізнано)
Issues — набір TPdfVTValidationIssues з нулем або більше значень проблем маркерів, DPart, успадкування PDF/X, повторюваних об'єктів та інкапсуляції
Значення проблем повторюваних об'єктів включають pvviGtsScopeInvalidValue, pvviGtsScopeRecordWithoutRecordLevel, pvviGtsXidNotUuid, pvviGtsEnvMissing, pvviGtsXidInvalidType, pvviGtsEnvInvalidType, pvviGtsScopeStreamInVT1, pvviGtsScopeSingleUseRepeated, pvviGtsScopeRecordCrossesRecords і pvviGtsResourceNotVisible
Значення проблем інкапсуляції включають pvviGtsEncapsulatedInvalidType, pvviGtsEncapsulatedMissingScope, pvviGtsEncapsulatedImageMissingIntent, pvviGtsEncapsulatedGroupInvalid і pvviGtsEncapsulatedOptionalContent
IsCompliant — повертає True, коли Conformance є справжнім рівнем PDF/VT, а Issues порожній

ValidatePdfVT — read-only. Він перевіряє маркери файлового формату, семантику обраного DPart-дерева, область і інкапсуляцію повторюваних XObject, точне спарювання основ PDF/VT з PDF/X та властивості XMP незалежно від того, записані вони як елементи чи атрибути RDF. Поєднуйте його з preflight-рушієм PDF/X для повної перевірки рівня вмісту, а для PDF/VT-2 — з InspectPdfVT2sStream чи іншим повним валідатором file-set. PDF/VT-2s — це рівень відповідності MIME-потоку, чия версія сигналізується заголовком MIME-потоку в ISO 16612-2 Annex A, а не файловим значенням pdfvtid:GTS_PDFVTVersion

Remarks

pvviMissingDPartRoot випромінюється, коли в каталозі бракує придатної ієрархії /DPartRoot або дерево порушує вимоги §6.5, як-от некоректні масиви /DParts, змішані /Start і /DParts, подвоєне володіння дітьми, недійсні імена /NodeNameList чи невідповідності глибини, діапазони сторінок, що не слідують порядку дерева сторінок, односторінкові діапазони, які повторюють /Start як /End, або посилання /DPart сторінок, що не вказують на покривний листовий DPart
Аналіз використання ресурсів сканує нефільтровані та прямі FlateDecode потоки; content streams з іншими чи ланцюговими фільтрами залишаються доступними спеціалізованим full-preflight рушіям
Документи з дійсним активним xref використовують обмежені розріджені читання для перевірок метаданих, DPart, OutputIntent, Info, сторінок, словників і просунутих ресурсних перевірок повторюваних об'єктів; некоректні xref і потоки вмісту чи метаданих, які не вдається декодувати в межах безпечних лімітів, зберігають сумісний парсер
pvviModDateMismatch випромінюється лише коли обидва pdfvtid:GTS_PDFVTModDate і xmp:ModifyDate наявні та їхні значення розходяться; SaveAsPdfVT завжди записує їх з однаковим значенням
Виклик ValidatePdfVT на неактивному документі повертає запис із Conformance = pvcUnknown і порожнім набором Issues

Example

uses System.TypInfo;

var
  Outcome: TPdfVTValidationResult;
  Issue: TPdfVTValidationIssue;
begin
  Pdf1.FileName := 'C:\Incoming\statements.pdf';
  Pdf1.Active := True;
  Outcome := Pdf1.ValidatePdfVT;
  Memo1.Lines.Add('Level: ' + GetEnumName(TypeInfo(TPdfVTConformance),
    Ord(Outcome.Conformance)));
  for Issue in Outcome.Issues do
    Memo1.Lines.Add('- ' + GetEnumName(TypeInfo(TPdfVTValidationIssue), Ord(Issue)));
end;

ValidatePdfVT метод

Component: TPdf · Unit: PDFium

Syntax

Description

Remarks

Example

See Also