THotPDF.AddImage

THotPDF

PDF belgesine bir görüntü ekler ve CurrentPage.ShowImage'ın çizebileceği bir görüntü indeksi döndürür

Delphi sözdizimi:

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;

Açıklama

Bir görüntüyü kaydetmek ve daha sonra CurrentPage.ShowImage ile çizilebilecek bir görüntü tanıtıcısı almak için AddImage çağırın. Dosya aşırı yüklemesi BMP, JPEG ve JPEG 2000 dosyalarını kabul eder; graphic aşırı yüklemesi ise yüklenmiş bir TGraphic örneğini kabul eder. Compression, PDF görüntü sıkıştırma yöntemini seçer. IsMask, görüntünün maske olarak kullanılıp kullanılmayacağını belirtir; MaskIndex ilişkili maske görüntüsünü tanımlar. icJpeg ile bir JPEG dosyası veya TJPEGImage yeniden sıkıştırılmadan gömülür ve renk modelini korur: gri tonlamalı JPEG'ler DeviceGray, renkli JPEG'ler DeviceRGB, CMYK JPEG'ler DeviceCMYK görüntüsüne dönüşür. JPEG dosyaları içeriğinden tanınır; böylece büyük harfli adlar ve .jpeg uzantısı da çalışır. icFlate ile 1, 4 ve 8 bitlik paletli bitmap'ler bit derinliklerini ve kendi paletlerini korur. İki düzeyli filtreler (icCCITT31, icCCITT32, icCCITT42, icJBIG2), palet hangi sırayla listelenirse listelensin paletin koyu rengini siyah sayar

Düşük düzeyli IsMask argümanını elle geçirmeden açık ikili /ImageMask veya /Mask bağlantısı gerektiğinde AddImageAsMask ve AddImageWithMask kullanın. Belgelerin varsayılanını sonraki görüntüler için korurken tek bir görüntü için JpegQuality'yi geçersiz kılmak üzere AddImageWithJpegQuality kullanın. 1 bitlik bitmap içeriği için HotPDF'in görüntü boyutuna ve uyumluluk kısıtlarına göre Flate, CCITT Group 4 veya JBIG2 seçmesine izin vermek üzere AddMonochromeImageAuto veya icAutoMono kullanın. İki AddImage çağrısı aynı maske ilişkisiyle özdeş kodlanmış görüntü verisi ürettiğinde HotPDF, var olan görüntü XObject'ini yeniden kullanır ve yinelenen bir stream gömmek yerine var olan görüntü indeksini döndürür

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;

Ayrıca bkz.: CurrentPage.ShowImage