PDFium Component Docs

AddImage Methode

Component: TPdf  ·  Unit: PDFium
Voegt een afbeelding uit een bestand toe aan de huidige PDF-pagina op de opgegeven positie en grootte. Intern wordt TPicture.LoadFromFile gebruikt, dus elk afbeeldingsformaat dat is geregistreerd met de VCL- of LCL-grafische systemen wordt ondersteund (BMP, PNG via Vcl.Imaging.PngImage / LCL TPortableNetworkGraphic, JPG, enz) De coördinaten staan in de PDF-gebruikersruimte (oorsprong linksonder op de pagina); Width en Height zijn de plaatsingsgrootte in gebruikerseenheden, niet de pixelgrootte van de bronafbeelding

Syntax

procedure AddImage(const FileName: string; X, Y, Width, Height: Double);

FileNamestring. Volledig pad naar het afbeeldingsbestand. Elk formaat dat is geregistreerd bij het VCL/LCL-grafische systeem (BMP, PNG, JPG, enz.) wordt geaccepteerd

 

procedure AddImage(Bitmap: TBitmap; X, Y, Width, Height: Double);

BitmapTBitmap. Een vooraf geladen bitmap met PixelFormat = pf32bit. Mag niet nil zijn; geeft anders EPdfError

Description

AddImage plaatst een afbeelding op de huidige PDF-pagina op de opgegeven positie en grootte. Er zijn twee overloads beschikbaar: één laadt de afbeelding rechtstreeks vanaf een bestandspad, de andere accepteert een reeds aangemaakt TBitmap-object

De bestandsgebaseerde overload gebruikt intern TPicture.LoadFromFile, dus elk afbeeldingsformaat dat is geregistreerd bij het VCL- of LCL-grafische systeem wordt ondersteund — inclusief BMP, PNG (via Vcl.Imaging.PngImage of het LCL-equivalent), JPEG en andere. Zorg alleen dat de relevante units in de uses-clause van uw project staan voordat u deze methode aanroept

De bitmap-overload accepteert een TBitmap met PixelFormat = pf32bit. Dat is handig wanneer de bitmap al in het geheugen staat (bijvoorbeeld uit een offscreen-renderstap) en voorkomt een omweg via schijf of TPicture. Een nil-bitmap meegeven geeft een EPdfError-exceptie

De parameters X en Y geven de linkerbenedenhoek van de plaatsingsrechthoek aan, in PDF-gebruikerseenheden (oorsprong linksonder op de pagina, Y loopt omhoog). Width en Height bepalen de weergegeven grootte op de pagina; de bronafbeelding wordt naar deze afmetingen geschaald, ongeacht de pixelresolutie

Example

// 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;

See Also

AddPicture, AddJpegImage, AddText