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
| Source | Dati immagine grezzi o codificati da memorizzare nel flusso immagine |
|---|---|
| Width | Larghezza dell'immagine in pixel |
| Height | Altezza dell'immagine in pixel |
| BitsPerComponent | Numero 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. |
| ColorSpace | Nome spazio colore PDF o testo array per il dizionario immagine, ad esempio /DeviceGray, /DeviceRGB o uno spazio indicizzato. |
| Filter | Nome filtro stream PDF, come FlateDecode, DCTDecode o JPXDecode. Usare una stringa vuota per dati non filtrati. |
| Decode | Testo facoltativo dell'array PDF Decode. Passare una stringa vuota quando non serve una voce Decode |
| Interpolate | Un valore diverso da zero scrive l'indicatore /Interpolate true |
Valori restituiti
| 0 | Impossibile creare l'immagine oppure la modalità PDF/A corrente vieta il filtro richiesto |
|---|---|
| Non-zero | Nuovo 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