AddImageDirectFromString

Gestione delle immagini

Descrizione

Crea un XObject immagine direttamente da byte campione già codificati, anziché rilevare un formato contenitore come PNG, TIFF o JPEG.

Comportamento della versione PDF: il filtro immagine JBIG2Decode richiede PDF 1.4, mentre JPXDecode, Crypt e i campioni di immagine con BitsPerComponent = 16 richiedono PDF 1.5. Quando un documento è impostato su una versione inferiore a quella richiesta e la versione di salvataggio non è bloccata, AddImageDirectFromString eleva automaticamente la versione del documento e registra JBIG2Decode filter, JPXDecode filter, Crypt filter o 16-bit image samples in AutoBumpedFeatures. Se il chiamante blocca una versione di salvataggio inferiore, il controllo di compatibilità rifiuta il salvataggio con LastErrorCode 602

Sintassi

Delphi

Function TPDFlib.AddImageDirectFromString(Const Source: AnsiString; Width, Height, BitsPerComponent: Integer; Const ColorSpace, Filter, Decode: WideString; Interpolate: Integer): Integer;

Parametri

SourceDati immagine grezzi o codificati da memorizzare nel flusso immagine
WidthLarghezza dell'immagine in pixel
HeightAltezza dell'immagine in pixel
BitsPerComponentNumero di bit per componente del campione. I dizionari immagine PDF consentono 1, 2, 4 e 8 nelle versioni precedenti; i campioni a 16 bit richiedono PDF 1.5.
ColorSpaceNome spazio colore PDF o testo array per il dizionario immagine, ad esempio /DeviceGray, /DeviceRGB o uno spazio indicizzato.
FilterNome filtro stream PDF, come FlateDecode, DCTDecode o JPXDecode. Usare una stringa vuota per dati non filtrati.
DecodeTesto facoltativo dell'array PDF Decode. Passare una stringa vuota quando non serve una voce Decode
InterpolateUn valore diverso da zero scrive l'indicatore /Interpolate true

Valori restituiti

0Impossibile creare l'immagine oppure la modalità PDF/A corrente vieta il filtro richiesto
Non-zeroNuovo ImageID. L'immagine creata viene selezionata per le operazioni successive sulle immagini

Note

PDF/A rifiuta LZWDecode in ogni parte e JBIG2Decode / JPXDecode in PDF/A-1. Il chiamante deve far corrispondere i byte Source a ColorSpace, Filter, Decode, dimensioni e profondità

Vedere anche

AddImageFromString, AddImageFromFile, AddImageFromStream, DrawImage