PDFium Component Docs

AddImage Methode

Deze API-entry behoudt identifiers, signatures, codeblokken en PDF-termen in hun oorspronkelijke vorm.
Component: TPdf  ·  Eenheid: 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

Syntaxis

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

FileNamestring. Volledig pad naar het afbeeldingsbestand. Elk formaat dat is geregistreerd met 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; anders wordt EPdfError opgegooid

Beschrijving

AddImage voegt een afbeelding uit een bestand toe aan de huidige PDF-pagina op de opgegeven positie en grootte. Er zijn twee overloads beschikbaar: één laadt de afbeelding rechtstreeks uit een bestandspad, de andere accepteert een vooraf opgebouwd TBitmap-object

De bestandsgebonden overload gebruikt intern TPicture.LoadFromFile, dus elk afbeeldingsformaat dat is geregistreerd met het VCL- of LCL-grafische systeem wordt ondersteund, inclusief BMP, PNG (via Vcl.Imaging.PngImage of het LCL-equivalent), JPEG en andere. Zorg er alleen voor dat de relevante units zijn opgenomen in de uses-clausule van je project voordat je deze methode aanroept

De bitmapoverload accepteert een TBitmap met PixelFormat = pf32bit. Dit is handig wanneer de bitmap al in het geheugen staat en voorkomt een omweg via schijf of TPicture. Het doorgeven van een nil-bitmap veroorzaakt een EPdfError-exceptie

De parameters X en Y geven de linkeronderhoek van de plaatsingsrechthoek van de afbeelding op in PDF-gebruikerseenheden, met de oorsprong linksonder op de pagina en Y omhoog. Width en Height bepalen de gerenderde grootte op de pagina; de bronafbeelding wordt naar deze afmetingen geschaald, ongeacht de pixelresolutie

Voorbeeld

// Plaats een PNG-bestand op (72, 600), gerenderd als 200 x 150 pt op de pagina
Pdf1.NewPage(595, 842);
Pdf1.AddImage('C:\Images\logo.png', 72, 600, 200, 150);

// Voeg een vooraf opgebouwde 32-bits bitmap toe
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;

Zie ook

AddPicture, AddJpegImage, AddText