FPdfContentNormalize - PDFium Delphi Component

Yksikkö: FPdfContentNormalize

Syntaksin säilyttävä normalisointi yhdelle loogiselle PDF-sivun sisältösekvenssille ja kestävä inline-kuvien rajatunnistus

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 yhdistää toimitetut sisältövirrat taulukon järjestyksessä ja tokenisoi tuloksen yhtenä loogisena sivun sisältösekvenssinä

Se säilyttää literaalimerkkijonot, heksamerkkijonot, nimet, taulukot, sanakirjat, inline-kuvien hyötykuormat ja tuntemattomat operaattorit kanonistaakseen tokenien erottelun; kommentit voi poistaa ja rakenteellisen tasapainon voi vaatia

CollectPdfContentResourceUses kirjaa teksti-, XObject-, grafiikkatila-, väriavaruus-, kuvio-, varjostus-, merkityn sisällön ominaisuus- ja inline-kuvien operaattorien kuluttamat resurssinimet keskeisen tokenbudjetin alaisena

FindInlineImageBlock paikantaa täydellisen BI-, ID- ja EI-lohkon käsittelemättä kuvahyötykuormadatan sisällä olevaa EI-tavusekvenssiä päätteenä

Constants

Constant	Description
`PdfContentNormalizeDefaultInputLimit`	Oletusarvoinen sivukohtainen looginen syöteraja 256 MiB
`PdfContentNormalizeDefaultOutputLimit`	Oletusarvoinen sivukohtainen normalisoitu tulosteraja 256 MiB
`PdfContentNormalizeDefaultTokenLimit`	Oletusarvoinen sivukohtainen raja 10000000 tokenia

Functions

Function	Description
`TPdfContentNormalizeOptions.Default`	Ottaa käyttöön kommenttien poiston, tasapainon validoinnin, hyödyllisen Flate-pakkauksen ja turvattomien sivujen ohituksen; kieltää allekirjoitettujen uudelleenkirjoitukset ja soveltaa kolmea oletusraja
`NormalizePdfContentSequence`	Palauttaa normalisoidut tavut ja yksityiskohtaisen raportin tai `False`-arvon epäonnistumistilan ja diagnostiikkatekstin kanssa
`CollectPdfContentResourceUses`	Palauttaa resurssilajin ja puretun PDF-nimen jokaiselle resursseja kuluttavalle sisältöoperaattorille tai `False`-arvon diagnostiikkatekstillä epämuodostuneelle tai budjetin ylittävälle syötteelle
`FindInlineImageBlock`	Palauttaa siirtymät seuraavalle täydelliselle inline-kuvan lohkolle kohdasta `StartPos` alkaen

Types

Type	Description
`TPdfContentNormalizeStatus`	Lopputulos tai epäonnistumisluokka sekvenssin ja dokumentin normalisoinnille
`TPdfContentNormalizeOptions`	Normalisointikäytäntö sekä sivukohtaiset tavu- ja tokenrajat
`TPdfContentNormalizeReport`	Tila, tavu- ja sivusummat, virta- ja tokenmittarit, syntaksihavainnot ja diagnostiikkateksti
`TPdfContentResourceKind`	Resurssiarvot `pcrkFont`, `pcrkXObject`, `pcrkExtGState`, `pcrkColorSpace`, `pcrkPattern`, `pcrkShading` ja `pcrkProperties`
`TPdfContentResourceUse`	Yksi purettu resurssin `Name`-nimi yhdessä sen `Kind`-arvon kanssa
`TPdfContentResourceUses`	Dynaaminen kerättyjen resurssikäyttöjen taulukko sisältöjärjestyksessä

Status values

Value	Meaning
`pcnsNotStarted`	Raportti on alustettu, mutta normalisointi ei ole valmistunut
`pcnsCompleted`	Normalisointi valmistui onnistuneesti
`pcnsInputLimitExceeded`	Looginen syöte ylitti `MaxInputBytesPerPage`-rajan tai määritetty raja ei ollut positiivinen
`pcnsOutputLimitExceeded`	Normalisoidut tavut ylittäisivät `MaxOutputBytesPerPage`-rajan
`pcnsTokenLimitExceeded`	Sisältösekvenssi ylitti `MaxTokensPerPage`-rajan
`pcnsMalformedToken`	PDF-sisältötokenia ei voitu lukea kokonaan
`pcnsUnresolvedInlineImage`	Täydellistä inline-kuvan hyötykuormarajaa ei löytynyt
`pcnsUnbalancedState`	Vaadittu grafiikan, tekstin, merkityn sisällön, yhteensopivuuden, taulukon tai sanakirjan laajuustasapaino epäonnistui
`pcnsUnsupportedFilter`	Dokumenttitason normalisointi kohtasi sisältövirran suodattimen, jota se ei voi purkaa
`pcnsEncryptedDocument`	Dokumenttitason normalisointi kieltäytyi salatusta syötteestä
`pcnsSignedDocument`	Dokumenttitason normalisointi kieltäytyi allekirjoitetusta syötteestä ilman lupaa
`pcnsDocumentRewriteFailed`	Ympäröivän PDF-objektigraafin uudelleenkirjoitus tai vahvistus epäonnistui
`pcnsResourceBudgetExceeded`	Prosessinlaajuinen `TPdfParserResourceBudget`-määräaika tuli täyteen ennen kuin normalisointi valmistui

Options

Field	Description
`RemoveComments`	Jättää PDF-kommentit pois säilyttäen vaaditut tokenrajat
`RequireBalancedState`	Vaatii tasapainoiset `q`/`Q`-, `BT`/`ET`-, merkityn sisällön, yhteensopivuus-, taulukko- ja sanakirjalaajuudet
`CompressOutput`	Sallii dokumenttitason kääreen Flate-pakata normalisoidun sivuvirran, kun pakkaus pienentää sen kokoa
`SkipUnsafePages`	Sallii dokumenttitason normalisoinnin säilyttää sivun muuttumattomana turvattoman tai tukemattoman tuloksen jälkeen dokumentin uudelleenkirjoituksen keskeyttämisen sijaan
`AllowSignedDocument`	Sallii eksplisiittisesti allekirjoitetun syötteen täyden uudelleenkirjoituksen, mikä mitätöi olemassa olevat allekirjoitustavualueet
`MaxInputBytesPerPage`	Enimmäiskokonaistavumäärä toimitetuissa sisältövirrissa yhdelle sivulle
`MaxOutputBytesPerPage`	Enimmäistavumäärä, joka on sallittu normalisoidussa sisältösekvenssissä
`MaxTokensPerPage`	Enimmäismäärä tarkasteltuja tokeneita yhdelle sivulle

Report fields

Field	Description
`Status`	Nykyinen `TPdfContentNormalizeStatus`
`SourceByteCount`	Lähtesisällön tavujen kokonaismäärä
`OutputByteCount`	Normalisoitujen tai uudelleenkirjoitettujen tulostavujen kokonaismäärä
`PageCount`	Dokumenttitason normalisoinnin tarkastelemat sivut
`NormalizedPageCount`	Sivut, jotka korvattiin onnistuneesti normalisoidulla sisällöllä
`SkippedPageCount`	Turvattomat sivut, jotka säilytettiin muuttumattomina ohituskäytännön nojalla
`InputStreamCount`	Lähtesisältövirrat, jotka yhdistettiin loogisiksi sivusekvensseiksi
`OutputStreamCount`	Tuotetut normalisoidut sisältövirrat
`CoalescedArrayCount`	Monivirraiset `/Contents`-taulukot, jotka korvattiin yhdellä normalisoidulla virralla
`TokenCount`	Käsitellyt tokenit
`CommentCount`	Kohdatut kommentit, olivatpa ne säilytettyjä tai poistettuja
`InlineImageCount`	Säilytetyt täydelliset inline-kuvan lohkot
`UnknownOperatorCount`	Tunnistamattomat operaattorit säilytettyinä sellaisenaan
`ErrorMessage`	Diagnostiikkateksti ensimmäisestä epäonnistumisesta

Inline-image offsets

BiPos on BI-avainsanan tavusiirtymä
IdPos on ID-avainsanan tavusiirtymä
DataStart on ensimmäinen hyötykuormatavu ID:tä seuraavan ainoan vaaditun tyhjämerkin jälkeen
EndImageStart on päättävän EI-avainsanan tavusiirtymä ja siten yksi tavu hyötykuorman ohi
Funktio palauttaa False-arvon, kun täydellistä lohkoa ei löydy kohdasta StartPos tai sen jälkeen

FPdfContentNormalize-yksikkö