THotPDF.AddImage 메서드

PDF 문서에 이미지를 추가하고, CurrentPage.ShowImage로 그릴 수 있는 이미지 인덱스를 반환합니다

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;

AddImage를 호출해 이미지를 등록하고, 나중에 CurrentPage.ShowImage로 그릴 수 있는 이미지 핸들을 얻습니다. 파일 오버로드는 BMP, JPEG, JPEG 2000 파일을, graphic 오버로드는 로드된 TGraphic 인스턴스를 받습니다. Compression은 PDF 이미지 압축 방식을 선택합니다. IsMask는 이미지를 마스크로 사용하는지를, MaskIndex는 연결된 마스크 이미지를 지정합니다. icJpeg를 쓰면 JPEG 파일이나 TJPEGImage가 재압축 없이 임베드되며 색상 모델이 유지됩니다. 그레이스케일 JPEG는 DeviceGray, 컬러 JPEG는 DeviceRGB, CMYK JPEG는 DeviceCMYK 이미지가 됩니다. JPEG 파일은 내용으로 식별하므로 대문자 이름이나 .jpeg 확장자도 동작합니다. icFlate에서는 1비트, 4비트, 8비트 팔레트 비트맵이 비트 깊이와 자체 팔레트를 유지합니다. bilevel 필터(icCCITT31, icCCITT32, icCCITT42, icJBIG2)는 팔레트에 나열된 순서와 관계없이 더 어두운 팔레트 색을 검정으로 취급합니다

하위 수준의 IsMask 인수를 직접 넘기지 않고 명시적인 바이너리 /ImageMask 또는 /Mask 연결이 필요하면 AddImageAsMask와 AddImageWithMask를 사용하세요. 이미지 하나에 대해서만 JpegQuality를 덮어쓰고 이후 이미지에는 문서 기본값을 유지하려면 AddImageWithJpegQuality를 사용하세요. AddMonochromeImageAuto나 icAutoMono를 쓰면 이미지 크기와 규격 제약에 따라 1비트 비트맵 콘텐츠에 Flate, CCITT Group 4, JBIG2 중 하나를 HotPDF가 선택합니다. 두 AddImage 호출이 같은 마스크 관계에서 동일한 인코딩 이미지 데이터를 만들면, HotPDF는 중복 스트림을 임베드하지 않고 기존 image XObject를 재사용해 기존 이미지 인덱스를 반환합니다

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;