AddImageJBIG2FromFileEx

Bilder

Beskrivning

Läser in en bitmappsfil, konverterar den till monokrom bilddata och lagrar den som ett JBIG2 image XObject med namngivna optionsparametrar

Syntax

Delphi

Function TPDFlib.AddImageJBIG2FromFileEx(Const FileName: WideString; Interpolate, SymbolExtract, UseExternalEncoder, SkipBlackDots, BlackDotSize, LossyLevel: Integer): Integer;

Parametrar

FileNameBitmappsfilen som ska kodas
InterpolateSkriver bildinterpolationsflaggan när värdet inte är noll
SymbolExtractBegär extraktion av symbolordlista när den aktiva encoder-backend:en stödjer det
UseExternalEncoderFöredrar den externa JBIG2-encoder-backend:en när den finns
SkipBlackDotsAktiverar isolerad svartpricksstädning före kodning när värdet inte är noll
BlackDotSizeMaximum isolated black-pixel cluster size removed during cleanup
LossyLevelHur aggresiv städningen är, från 0 till 9, för inskannad monokrom indata

Returvärden

Returnerar det nya ImageID:et, eller 0 när filen inte kan läsas eller kodas

Anmärkningar

Funktionen mappar de namngivna parametrarna till samma kodningsväg som AddImageJBIG2FromFile använder, vilket bevarar kompatibilitet med befintliga option-bitmasker

JBIG2 backend registration

Enkodaren bakom AddImageJBIG2*-familjen och avkodaren som används för JBIG2-bilder i importerade dokument är utbytbara. PDFlibJBIG2Enc-uniten exponerar registreringsgränssnittet som fristående funktioner:

RegisterJBIG2EncoderBackendInstallerar en TJBIG2EncodeCallback som tar emot skannlinjerna, bredd, höjd och en TJBIG2EncodeOptions-record och returnerar den komprimerade bilddatan och valfri global segmentdata; den betjänar UseExternalEncoder-begäran som görs via optionen nedan
RegisterJBIG2DecoderBackendInstallerar den primära TJBIG2DecodeCallback, som tar emot bild- och globaldata-bytena och fyller en TJBIG2DecodeResult-record
RegisterJBIG2ExternalDecoderBackendRegistrerar den externa avkodningsbackend:en (jbig2dec C-avkodaren på Win64). När den är registrerad och föredra-extern-omkopplaren är på (standard), dirigeras /JBIG2Decode-inläsningsvägen genom den och den primära avkodaren förblir fallback
ClearJBIG2BackendsTar bort alla registrerade encoder- och decoder-callbacks
IsJBIG2EncoderBackendAvailable / IsJBIG2DecoderBackendAvailable / IsJBIG2ExternalDecoderBackendAvailableRapporterar huruvida motsvarande callback för tillfället är registrerad
SetPreferExternalJBIG2Decoder / GetPreferExternalJBIG2DecoderGlobal omkopplare som väljer den externa avkodaren över den inbyggda Pascal-avkodaren när båda finns; är som standard True, sätt False för att tvinga fram native-fallback:en
DefaultJBIG2EncodeOptionsReturnerar en TJBIG2EncodeOptions-record initialiserad till de standardvärden AddImageJBIG2*-anropen startar från (förlustfri, symbolordlista på, globala segment av, extern encoder föredragen)
ClearJBIG2DecodeResultSläpper skannlinjesminnet som en TJBIG2DecodeResult-record äger och återställer dess fält