THotPDF.AddImage

THotPDF

Добавляет изображение в PDF-документ и возвращает индекс изображения, который CurrentPage.ShowImage может нарисовать

Синтаксис Delphi:

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;

Описание

Вызывайте AddImage, чтобы зарегистрировать изображение и получить его дескриптор, который позже можно нарисовать через CurrentPage.ShowImage. Файловая перегрузка принимает файлы BMP, JPEG и JPEG 2000, а графическая — загруженный экземпляр TGraphic. Compression выбирает метод сжатия изображения PDF. IsMask указывает, используется ли изображение как маска, а MaskIndex определяет связанное изображение-маску

Используйте AddImageAsMask и AddImageWithMask, когда нужна явная привязка /ImageMask или /Mask без ручной передачи низкоуровневого аргумента IsMask. AddImageWithJpegQuality переопределяет JpegQuality для одного изображения, сохраняя документное значение по умолчанию для последующих. AddMonochromeImageAuto или icAutoMono позволяют HotPDF самому выбрать Flate, CCITT Group 4 или JBIG2 для 1-битного bitmap-содержимого с учётом размера изображения и ограничений соответствия. Когда два вызова AddImage дают идентичные закодированные данные изображения с одинаковой масочной связью, HotPDF переиспользует существующий image XObject и возвращает существующий индекс вместо встраивания дублирующего потока

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;

См. также: CurrentPage.ShowImage