PDFium Delphi Component Docs

InspectPdfUaUnicodeCoverage metode

Komponent: TPdf  ·  Enhed: PDFium
Rapporterer objektomfattende PDF/UA Unicode- og ActualText-udtræksdækning

Syntax

function InspectPdfUaUnicodeCoverage: TPdfUaUnicodeCoverageReport; overload;
function InspectPdfUaUnicodeCoverage(const Options: TPdfUaUnicodeCoverageOptions): TPdfUaUnicodeCoverageReport; overload;

Description

Metoden scanner hver PDFium-tekstside én gang og grupperer eksplicitte tegn efter deres oprindelige native tekstobjekt

Et tegn er dækket af en ikke-nul direkte Unicode-mapping eller af printbart ActualText knyttet til netop dette tekstobjekt, så erstatningstekst ikke kan maskere tilstødende indhold

Artifact-tegn og PDFium-genererede tegn tælles separat og udelades fra den semantiske dækning

Hvert gemt TPdfUaUnicodeObjectCoverage registrerer siden, PageObjectIndex når tilgængeligt, MCID, FirstCharacterIndex, direkte og erstattende tællere, mappingsfejl samt afgrænset ActualText-evidence med dets ActualTextApplied- og ActualTextTruncated-flag

Standardindstillingerne gemmer kun ikke-dækkede objekter, begrænser evidence til 1000 objekter og hvert ActualText-uddrag til 256 tegn, mens de aggregerede tællere fortsætter på tværs af hele dokumentet

Completed er False, når de påkrævede PDFium-API'er ikke er tilgængelige, en side ikke kan indlæses, eller den native tegntilstand ikke kan læses; allerede indsamlede tællere og evidence forbliver tilgængelige

Options and result

MemberPurpose
IncludeCoveredObjectsGemmer dækket objekt-evidence såvel som ikke-dækket evidence
MaxReportedObjectsBegrænser gemt objekt-evidence uden at stoppe den aggregerede optælling
MaxActualTextCharactersPerObjectBegrænser hvert gemt erstatningsuddrag, mens tegntællerne bevares
DirectUnicodeCharacterCount, ActualTextCharacterCountTæller de to vellykkede semantiske udtræksveje
SemanticCharacterCount, ArtifactCharacterCount, GeneratedCharacterCountOpdeler alle scannede tegn i semantiske, Artifact- og PDFium-genererede totaler
CoveredTextObjectCount, ActualTextObjectCount, InvalidActualTextObjectCount, PagesScannedObjektniveaus dækningstotaler og scanningsfremskridt i TPdfUaUnicodeCoverageReport
UnicodeMapErrorCharacterCount, MissingUnicodeCharacterCountTæller native mappingsfejl og nul Unicode-værdier
UnresolvedTextObjectCharacterCountTæller eksplicitte semantiske tegn, hvis kildeobjekt ikke kan opløses
ReportLimitReachedAngiver, at yderligere matchende objekter blev talt, men ikke gemt
IsCoveredReturnerer kun True for en fuldført scanning uden mappingsfejl, manglende Unicode eller uopløselige objekter

Example

var Report: TPdfUaUnicodeCoverageReport;
Report := Pdf1.InspectPdfUaUnicodeCoverage;
if Report.Completed and not Report.IsCovered then
  ShowMessage(IntToStr(Report.UncoveredTextObjectCount) + ' text objects need repair');

See Also

ValidatePdfUa, InspectPdfUaLanguageCoverage, PDF standards helpers