procedure AddImage(const FileName: string; X, Y, Width, Height: Double);
| FileName | string. Percorso completo del file immagine. Accetta qualsiasi formato registrato con il sistema grafico VCL/LCL (BMP, PNG, JPG ecc.) |
procedure AddImage(Bitmap: TBitmap; X, Y, Width, Height: Double);
| Bitmap | TBitmap. Una bitmap pre-caricata con PixelFormat = pf32bit. Non deve essere nil; altrimenti solleva EPdfError |
AddImage inserisce un'immagine nella pagina PDF corrente nella posizione e con le dimensioni indicate. Sono disponibili due overload: uno carica l'immagine direttamente da un percorso file, l'altro accetta un oggetto TBitmap già costruito.
L'overload basato su file usa internamente TPicture.LoadFromFile, quindi è supportato qualsiasi formato immagine registrato con il sistema grafico VCL o LCL — inclusi BMP, PNG (tramite Vcl.Imaging.PngImage o l'equivalente LCL), JPEG e altri. È sufficiente includere le unità pertinenti nella clausola uses del progetto prima di chiamare questo metodo.
L'overload con bitmap accetta un TBitmap con PixelFormat = pf32bit. È utile quando il bitmap è già in memoria (ad esempio da un passaggio di rendering fuori schermo) ed evita un passaggio attraverso il disco o TPicture. Passare un bitmap nil genera un'eccezione EPdfError.
I parametri X e Y specificano l'angolo inferiore sinistro del rettangolo di posizionamento dell'immagine in unità utente PDF (origine nell'angolo in basso a sinistra della pagina, Y cresce verso l'alto). Width e Height controllano la dimensione di rendering sulla pagina; l'immagine sorgente viene ridimensionata per adattarsi a queste dimensioni a prescindere dalla sua risoluzione in pixel.
// Place a PNG file at (72, 600), rendered 200 x 150 pt on the page
Pdf1.NewPage(595, 842);
Pdf1.AddImage('C:\Images\logo.png', 72, 600, 200, 150);
// Add a pre-built 32-bit bitmap
var
Bmp: TBitmap;
begin
Bmp := TBitmap.Create;
try
Bmp.PixelFormat := pf32bit;
Bmp.LoadFromFile('C:\Images\photo.bmp');
Pdf1.AddImage(Bmp, 72, 400, 300, 200);
finally
Bmp.Free;
end;
end;