FPdfContentNormalize - PDFium Delphi Component

Modulis: FPdfContentNormalize

Sintaksę išlaikantis vienos loginės PDF puslapio turinio sekos normalizavimas ir patikimas inline paveikslų ribų aptikimas

Syntax

const
  PdfContentNormalizeDefaultInputLimit = Int64(256) * 1024 * 1024;
  PdfContentNormalizeDefaultOutputLimit = Int64(256) * 1024 * 1024;
  PdfContentNormalizeDefaultTokenLimit = 10000000;

function NormalizePdfContentSequence(const Streams: array of TBytes;
  const Options: TPdfContentNormalizeOptions; out Output: TBytes;
  out Report: TPdfContentNormalizeReport): Boolean;

function CollectPdfContentResourceUses(const Data: TBytes;
  out Uses: TPdfContentResourceUses;
  out ErrorText: string): Boolean;

function FindInlineImageBlock(const Data: TBytes; StartPos: Integer;
  out BiPos, IdPos, DataStart, EndImageStart: Integer): Boolean;

Description

NormalizePdfContentSequence sujungia pateiktus turinio srautus masyvo tvarka ir rezultatą suskaido į žetonus kaip vieną loginę puslapio turinio seką

Ji išlaiko literaliąsias eilutes, šešioliktaines eilutes, vardus, masyvus, žodynus, inline paveikslų duomenų paketus ir nepažįstamus operatorius, kanonizuodama žetonų atskyrimą; komentarai gali būti pašalinami, o struktūrinis subalansuotumas gali būti reikalaujamas

CollectPdfContentResourceUses užregistruoja išteklių vardus, kuriuos sunaudoja teksto, XObject, grafikos būsenos, spalvų erdvės, rašto, šešėliavimo, pažymėto turinio savybių ir inline paveikslų operatoriai, esant centralizuotam žetonų biudžetui

FindInlineImageBlock suranda pilną BI, ID ir EI bloką, laikydama EI baitų seką paveikslo duomenų paketo viduje ne terminatoriumi

Constants

Constant	Description
`PdfContentNormalizeDefaultInputLimit`	Numatytoji vieno puslapio loginės įvesties riba 256 MiB
`PdfContentNormalizeDefaultOutputLimit`	Numatytoji vieno puslapio normalizuotos išvesties riba 256 MiB
`PdfContentNormalizeDefaultTokenLimit`	Numatytoji vieno puslapio riba 10000000 žetonų

Functions

Function	Description
`TPdfContentNormalizeOptions.Default`	Įjungia komentarų pašalinimą, subalansuotumo tikrinimą, naudingą Flate glaudinimą ir nesaugių puslapių praleidimą; draudžia pasirašytus perrašymus ir taiko tris numatytąsias ribas
`NormalizePdfContentSequence`	Grąžina normalizuotus baitus ir išsamią ataskaitą, arba `False` su nesėkmės būsena ir diagnostiniu tekstu
`CollectPdfContentResourceUses`	Grąžina išteklių rūšį ir dekoduotą PDF vardą kiekvienam išteklius naudojančiam turinio operatoriui, arba `False` su diagnostiniu tekstu netinkamai suformuotai arba biudžetą viršijančiai įvesčiai
`FindInlineImageBlock`	Grąžina kito pilno inline paveikslo bloko, esančio `StartPos` arba vėliau, poslinkius

Types

Type	Description
`TPdfContentNormalizeStatus`	Išeities arba nesėkmės kategorija sekų ir dokumentų normalizavimui
`TPdfContentNormalizeOptions`	Normalizavimo politika ir vieno puslapio baitų bei žetonų ribos
`TPdfContentNormalizeReport`	Būsena, baitų ir puslapių sumos, srautų ir žetonų metrika, sintaksės stebėjimai ir diagnostinis tekstas
`TPdfContentResourceKind`	Išteklių reikšmės `pcrkFont`, `pcrkXObject`, `pcrkExtGState`, `pcrkColorSpace`, `pcrkPattern`, `pcrkShading` ir `pcrkProperties`
`TPdfContentResourceUse`	Vienas dekoduotas ištekliaus `Name` kartu su jo `Kind`
`TPdfContentResourceUses`	Dinaminis surinktų išteklių naudojimų masyvas turinio tvarka

Status values

Reikšmė	Reikšmė
`pcnsNotStarted`	Ataskaita inicijuota, bet normalizavimas neužbaigtas
`pcnsCompleted`	Normalizavimas sėkmingai užbaigtas
`pcnsInputLimitExceeded`	Loginė įvestis viršijo `MaxInputBytesPerPage` arba sukonfigūruota riba nebuvo teigiama
`pcnsOutputLimitExceeded`	Normalizuoti baitai viršytų `MaxOutputBytesPerPage`
`pcnsTokenLimitExceeded`	Turinio seka viršijo `MaxTokensPerPage`
`pcnsMalformedToken`	PDF turinio žetono nepavyko perskaityti pilnai
`pcnsUnresolvedInlineImage`	Nepavyko rasti pilnos inline paveikslo duomenų paketo ribos
`pcnsUnbalancedState`	Reikalautas grafikos, teksto, pažymėto turinio, suderinamumo, masyvų arba žodynų sričių subalansuotumas nepavyko
`pcnsUnsupportedFilter`	Dokumento lygio normalizavimas susidūrė su jam nedekoduojamu turinio srauto filtru
`pcnsEncryptedDocument`	Dokumento lygio normalizavimas atsisakė šifruotos įvesties
`pcnsSignedDocument`	Dokumento lygio normalizavimas be įgaliojimo atsisakė pasirašytos įvesties
`pcnsDocumentRewriteFailed`	Gaubiantis PDF objekto grafo perrašymas arba tikrinimas nepavyko
`pcnsResourceBudgetExceeded`	Visą procesą apimantis `TPdfParserResourceBudget` terminas pasiektas anksčiau nei normalizavimas užbaigtas

Options

Laukas	Aprašas
`RemoveComments`	Praleidžia PDF komentarus išlaikydama būtinas žetonų ribas
`RequireBalancedState`	Reikalauja subalansuotų `q`/`Q`, `BT`/`ET`, pažymėto turinio, suderinamumo, masyvų ir žodynų sričių
`CompressOutput`	Leidžia dokumento lygio gaubikliui Flate suglaudinti normalizuotą puslapio srautą, kai glaudinimas sumažina jo dydį
`SkipUnsafePages`	Leidžia dokumento lygio normalizavimui po nesaugaus arba nepalaikomo rezultato išlaikyti puslapį nepakeistą vietoje dokumento perrašymo nutraukimo
`AllowSignedDocument`	Aiškiai leidžia pilną pasirašytos įvesties perrašymą, kuris panaikina esamas parašo baitų rėžius
`MaxInputBytesPerPage`	Didžiausias bendras baitų skaičius pateiktuose turinio srautuose vienam puslapiui
`MaxOutputBytesPerPage`	Didžiausias leistinas baitų skaičius normalizuotoje turinio sekoje
`MaxTokensPerPage`	Didžiausias vienam puslapiui peržiūrimų žetonų skaičius

Report fields

Laukas	Aprašas
`Status`	Dabartinė `TPdfContentNormalizeStatus`
`SourceByteCount`	Bendras šaltinio turinio baitų skaičius
`OutputByteCount`	Bendras normalizuotų arba perrašytų išvesties baitų skaičius
`PageCount`	Puslapiai, kuriuos apžiūrėjo dokumento lygio normalizavimas
`NormalizedPageCount`	Puslapiai, sėkmingai pakeisti normalizuotu turiniu
`SkippedPageCount`	Nesaugūs puslapiai, pagal praleidimo politiką išlaikyti nepakeisti
`InputStreamCount`	Šaltinio turinio srautai, sujungti į logines puslapių sekas
`OutputStreamCount`	Sugeneruoti normalizuoti turinio srautai
`CoalescedArrayCount`	Daugiasraučiai `/Contents` masyvai, pakeisti viena normalizuotu srautu
`TokenCount`	Apdoroti žetonai
`CommentCount`	Sutikti komentarai, nesvarbu, ar išlaikyti, ar pašalinti
`InlineImageCount`	Išlaikyti pilni inline paveikslų blokai
`UnknownOperatorCount`	Neatpažinti operatoriai, išlaikyti žodis į žodį
`ErrorMessage`	Pirmosios nesėkmės diagnostinis tekstas

Inline-image offsets

BiPos yra BI raktažodžio baito poslinkis
IdPos yra ID raktažodžio baito poslinkis
DataStart yra pirmasis duomenų paketo baitas po vienintelės būtinos tarpo eilutės po ID
EndImageStart yra užbaigiančio EI raktažodžio baito poslinkis, taigi vienas baitas už duomenų paketo
Funkcija grąžina False, kai pilnas blokas StartPos arba vėliau nerastas

FPdfContentNormalize modulis