THotPDF.AddImage Method

Start Spis treści Omówienie

THotPDF.AddImage

THotPDF

Góra Poprzedni Następny

Dodaje obraz do dokumentu PDF i zwraca indeks obrazu, który CurrentPage.ShowImage może narysować

Delphi syntax:

function AddImage(Image: TGraphic; Compression: THPDFImageCompressionType;

IsMask: boolean = False; MaskIndex: Integer = -1): Integer; overload;

function AddImageAsMask(FileName: TFileName; Compression: THPDFImageCompressionType = icFlate): Integer; overload;

function AddImageWithMask(FileName: TFileName; MaskIndex: Integer; Compression: THPDFImageCompressionType = icJpeg): Integer; overload;

function AddImageWithJpegQuality(FileName: TFileName; Quality: TJPEGQualityRange): Integer; overload;

function AddMonochromeImageAuto(FileName: TFileName): Integer; overload;

function AddImage(FileName: TFileName; Compression: THPDFImageCompressionType;

IsMask: boolean = False; MaskIndex: Integer = -1): Integer; overload;

Description

Wołaj AddImage, by zarejestrować obraz i otrzymać uchwyt obrazu, który można później narysować przez CurrentPage.ShowImage. Overload plikowy przyjmuje pliki BMP, JPEG i JPEG 2000, a overload graficzny — załadowaną instancję TGraphic. Compression wybiera metodę kompresji obrazu w PDF. IsMask wskazuje, czy obraz jest używany jako maska, a MaskIndex identyfikuje powiązany obraz maski

Używaj AddImageAsMask i AddImageWithMask, gdy potrzebujesz jawnego binarnego okablowania /ImageMask albo /Mask bez ręcznego przekazywania niskopoziomowego argumentu IsMask. Używaj AddImageWithJpegQuality, by nadpisać JpegQuality dla jednego obrazu, zachowując domyślne ustawienie dokumentu dla kolejnych obrazów. Używaj AddMonochromeImageAuto albo icAutoMono, by HotPDF dobrał Flate, CCITT Group 4 albo JBIG2 dla treści bitmapowej 1-bit na podstawie rozmiaru obrazu i ograniczeń zgodności. Gdy dwa wywołania AddImage produkują identyczne zakodowane dane obrazu z tą samą relacją maski, HotPDF reużywa istniejący XObject obrazu i zwraca istniejący indeks obrazu zamiast osadzać zduplikowany strumień

Code Example


var
  ImageHandle: Integer;
begin
  ImageHandle := HPDF.AddImage( '.\Sample.jpg', icJpeg );
  HPDF.CurrentPage.ShowImage( ImageHandle, 100, 200, 150, 100 );  // Draw the image at position 100,200 with size 150x100
end;