AddImageFromFileOffsetA
Gestione delle immagini
Descrizione
Il suffisso A indica l'entry point DLL ANSI (char); l'interfaccia ActiveX/COM espone soltanto la forma Unicode. Il comportamento è identico a AddImageFromFileOffset e gli argomenti stringa vengono interpretati usando la code page corrente di SetAnsiMode
Aggiunge al documento selezionato un'immagine da una parte di un file
Ad esempio, se molte immagini sono concatenate in un file, questa funzione consente di estrarle singolarmente e aggiungerle al documento.
Dopo l'aggiunta al documento, un'immagine può essere disegnata più volte su qualsiasi pagina senza aumentare ulteriormente le dimensioni del PDF.
I tipi di file immagine supportati sono: BMP, TIFF, JPEG, PNG, GIF, WMF ed EMF
Comportamento della versione PDF: l'importazione di dati immagine a 16 bit per componente richiede PDF 1.5. Quando un documento è impostato su PDF 1.4 o precedente e la versione di salvataggio non è bloccata, AddImageFromFileOffset porta automaticamente il documento a PDF 1.5 e registra 16-bit image samples in AutoBumpedFeatures. Se il chiamante blocca una versione di salvataggio precedente, il controllo di compatibilità rifiuta il salvataggio con LastErrorCode 602
Per immagini BMP e TIFF è possibile chiamare CompressImages prima di questa funzione. Gli altri tipi vengono compressi automaticamente.
Sintassi
Delphi
Function DLAddImageFromFileOffsetA(InstanceID: Integer; FileName: PAnsiChar; Offset, DataLength, Options: Integer): Integer;DLL
int DLAddImageFromFileOffsetA(int InstanceID, const char * FileName, int Offset, int DataLength, int Options);Parametri
| FileName | Il nome del file contenente le immagini |
|---|---|
| Offset | Offset del file dove inizia l'immagine richiesta. Il primo byte ha offset 0 |
| DataLength | La lunghezza dei dati dell'immagine in byte |
| Options | Per le immagini TIFF multipagina, questo parametro specifica il numero della pagina da caricare. Per le immagini PNG: 0 = Carica l'immagine normalmente 1 = Carica il canale alfa come immagine in scala di grigi 2 = Carica l'immagine e il canale alfa (limita l'alfa a 8 bit) 3 = Carica l'immagine (limita l'immagine a 8 bit/canale) 4 = Carica il canale alfa (limitato a 8 bit/canale) 5 = Carica l'immagine con il canale alfa (limita entrambi a 8 bit/canale) 6 = Carica l'immagine e il canale alfa 7 = Carica l'immagine e il profilo colore ICC Per gli altri tipi di immagine, il parametro deve essere impostato su 0. L'impostazione di Options su -1 forza il caricamento delle immagini TIFF, EMF e WMF tramite la libreria grafica GDI+. È possibile caricare con GDI+ anche le immagini TIFF multipagina impostando il parametro Options su -PageNumber, ad esempio -3 per la pagina 3 |
Valori restituiti
| 0 | Impossibile leggere l'immagine dal file: dati non validi o file non trovato |
|---|---|
| Non-zero | L'immagine è stata letta dal file e aggiunta correttamente al documento. Il valore restituito è l'ID dell'immagine, utilizzabile con le funzioni di disegno delle immagini quali DrawImage |