procedure AddImage(const FileName: string; X, Y, Width, Height: Double);
| FileName | string. Pełna ścieżka do pliku obrazu. Akceptowany jest dowolny format zarejestrowany w systemie graficznym VCL/LCL (BMP, PNG, JPG itd.) |
procedure AddImage(Bitmap: TBitmap; X, Y, Width, Height: Double);
| Bitmap | TBitmap. Wcześniej załadowana mapa bitowa z PixelFormat = pf32bit. Nie może mieć wartości nil; w przeciwnym razie zgłaszane jest EPdfError |
AddImage umieszcza obraz na bieżącej stronie PDF w zadanej pozycji i o zadanym rozmiarze. Dostępne są dwa przeciążenia: jedno ładuje obraz bezpośrednio ze ścieżki pliku, a drugie przyjmuje wcześniej przygotowany obiekt TBitmap
Przeciążenie oparte na pliku używa wewnętrznie TPicture.LoadFromFile, dlatego obsługiwany jest dowolny format obrazu zarejestrowany w systemie graficznym VCL lub LCL — w tym BMP, PNG (przez Vcl.Imaging.PngImage lub odpowiednik LCL), JPEG i inne. Upewnij się jedynie, że odpowiednie jednostki są uwzględnione w klauzuli uses projektu przed wywołaniem tej metody
Przeciążenie bitmapowe przyjmuje TBitmap z PixelFormat = pf32bit. Jest to przydatne, gdy mapa bitowa znajduje się już w pamięci (na przykład z kroku renderowania poza ekranem) i pozwala uniknąć zapisu na dysk lub pośrednictwa TPicture. Przekazanie mapy bitowej o wartości nil zgłasza wyjątek EPdfError
Parametry X i Y określają lewy dolny róg prostokąta umieszczenia obrazu w jednostkach użytkownika PDF (początek układu w lewym dolnym rogu strony, Y rośnie w górę). Width i Height sterują renderowanym rozmiarem na stronie; obraz źródłowy jest skalowany, aby zmieścić się w tych wymiarach niezależnie od swojej rozdzielczości pikselowej
// 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;