ValidatePdfVT - TPdf - PDFium Delphi Component

Komponenta: TPdf · Jedinica: PDFium

Pregledava trenutačno otvoreni PDF tražeći oznake PDF/VT sukladnosti i vraća strukturirani rezultat s otkrivenom razinom sukladnosti te skupom pronadena problema

Sintaksa

function ValidatePdfVT: TPdfVTValidationResult;

Opis

ValidatePdfVT prelazi otvoreni dokument tražeći oznake na razini formata datoteke definirane u ISO 16612-2:2010:

XMP pdfvtid:GTS_PDFVTVersion (§6.3 Table 2) i pdfvtid:GTS_PDFVTModDate
Jednakost između pdfvtid:GTS_PDFVTModDate i xmp:ModifyDate (§6.3 NOTE 1)
XMP pdfxid:GTS_PDFXVersion — PDF/VT-1 mora biti PDF/X-4 (§6.2.1), dok PDF/VT-2 mora koristiti jednu od baza skupa datoteka PDF/X-4p, PDF/X-5g ili PDF/X-5pg (§6.2.2)
Opis pdfaExtension:schemas za prostor naziva pdfvtid i pdfxid
Unos /DPartRoot u katalogu s upotrebljivim DPart stablom iz §6.5: /DPartRootNode, NMTOKEN-kompatibilan XML /NodeNameList, poveznice roditelja, polje polja /DParts, rasponi /Start//End listova i reference /DPart po stranici moraju pokriti stablo stranica točno jednom u dubinskom redoslijedu
Podatci o ponavljajućim XObjectima iz §§6.7.2–6.7.4, uključujući izravne tipove vrijednosti i dopuštene vrijednosti GTS_XID, GTS_Scope i GTS_Env, neizravni DPartRoot RecordLevel koji koristi opseg Record te granicu samo za PDF/VT-2s za opseg Stream
Dekodirane nefiltrirane i FlateDecode tokove stranica ili Form XObjecta, razrješujući svaki operand Do kroz djelotvorne naslijeđene resurse radi nametanja brojanja SingleUse, vidljivosti resursa i vlasništva jednog primatelja za opseg Record
Zahtjeve enkapsuliranih XObjecta iz §6.7.5 koje se može utvrditi statički: boolean oblik, preporučeni opseg, Image Intent, obavezna izolirana transparency Group s prostorom boja miješanja te označene operatore neobaveznog sadržaja u izravnom ili ugniježđenom Form sadržaju
Polje /OutputIntents u katalogu s OutputIntentom koji ima ugrađeni /DestOutputProfile ili vanjski /DestOutputProfileRef prikladan za PDF/X bazu
Polje /ID u traileru i odsutnost /Encrypt (PDF/X zabranjuje šifriranje)
Unosi xmp:CreateDate i xmp:ModifyDate u XMP-u radi podudarnosti Info / XMP

Rezultat je zapis TPdfVTValidationResult:

Conformance — otkrivena razina: pvc1 (PDF/VT-1 oznaka), pvc2 (PDF/VT-2 oznaka), pvcNone (nema PDF/VT oznake) ili pvcUnknown (oznaka je prisutna, ali verzija na razini datoteke nije prepoznata)
Issues — skup TPdfVTValidationIssues s nulom ili više vrijednosti problema oznaka, DParta, PDF/X nasljeđivanja, ponavljajućih objekata i enkapsulacije
Vrijednosti problema ponavljajućih objekata uključuju pvviGtsScopeInvalidValue, pvviGtsScopeRecordWithoutRecordLevel, pvviGtsXidNotUuid, pvviGtsEnvMissing, pvviGtsXidInvalidType, pvviGtsEnvInvalidType, pvviGtsScopeStreamInVT1, pvviGtsScopeSingleUseRepeated, pvviGtsScopeRecordCrossesRecords i pvviGtsResourceNotVisible
Vrijednosti problema enkapsulacije uključuju pvviGtsEncapsulatedInvalidType, pvviGtsEncapsulatedMissingScope, pvviGtsEncapsulatedImageMissingIntent, pvviGtsEncapsulatedGroupInvalid i pvviGtsEncapsulatedOptionalContent
IsCompliant — vraća True kada je Conformance stvarna PDF/VT razina, a Issues prazan

ValidatePdfVT je samo za čitanje. Provjerava oznake formata datoteke, semantiku odabranog DPart stabla, opseg i enkapsulaciju ponavljajućih XObjecta, točno uparivanje PDF/VT i PDF/X baza te XMP svojstva bez obzira na to jesu li zapisana kao elementi ili RDF atributi. Uparite ga s PDF/X preflight pogonom za potpunu provjeru na razini sadržaja te, za PDF/VT-2, s InspectPdfVT2sStream ili drugim potpunim validatorom skupa datoteka. PDF/VT-2s je razina sukladnosti MIME toka čija se verzija signalizira zaglavljem MIME toka u ISO 16612-2 Annex A, a ne vrijednošću pdfvtid:GTS_PDFVTVersion na razini datoteke

Napomene

pvviMissingDPartRoot se ispisuje kada katalogu nedostaje upotrebljiva hijerarhija /DPartRoot ili kada stablo krši zahtjeve §6.5 poput neispravnih polja /DParts, miješanja /Start i /DParts, dupliciranog dječjeg vlasništva, nevažećih naziva u /NodeNameList ili neusklađene dubine, raspona stranica koji ne slijede redoslijed stabla stranica, jednostraničnih raspona koji ponavljaju /Start kao /End ili poveznica /DPart stranice koje ne pokazuju na pokrivajući list DPart
Analiza korištenja resursa skenira nefiltrirane i izravne FlateDecode tokove; tokovi sadržaja s drugim ili ulančanim filterima ostaju dostupni namenskim potpunim preflight pogonima
Dokumenti s valjanim aktivnim xrefom koriste ograničena rijetka čitanja za provjere metapodataka, DParta, OutputIntenta, Infoa, stranica, rječnika i naprednih resursa ponavljajućih objekata; neispravni xrefovi te tokovi sadržaja ili metapodataka koje nije moguće dekodirati unutar sigurnosnih ograničenja zadržavaju kompatibilnosni parsator
pvviModDateMismatch se ispisuje samo kada su i pdfvtid:GTS_PDFVTModDate i xmp:ModifyDate prisutni i njihove se vrijednosti razlikuju; SaveAsPdfVT ih uvijek zapisuje s istom vrijednošću
Poziv ValidatePdfVT nad neaktivnim dokumentom vraća zapis s Conformance = pvcUnknown i praznim skupom Issues

Primjer

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;

Vidi također