PDFium Component Docs

AddImage 메서드

이 API 항목은 식별자, 시그니처, 코드 블록, PDF 용어를 원래 형태로 유지합니다.
컴포넌트: TPdf  ·  유닛: PDFium
파일에서 이미지를 현재 PDF 페이지에 삽입합니다. 내부적으로 TPicture.LoadFromFile을 사용하므로 VCL 또는 LCL 그래픽 시스템에 등록된 모든 이미지 형식을 지원합니다. BMP, PNG(Vcl.Imaging.PngImage 또는 LCL 대응 형식), JPG 등이 포함됩니다. 좌표는 PDF 사용자 공간입니다(원점은 페이지 왼쪽 아래). WidthHeight는 배치 크기이며 원본 이미지의 픽셀 크기는 아닙니다.

구문

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

FileNamestring. 이미지 파일의 전체 경로입니다. VCL/LCL 그래픽 시스템에 등록된 모든 형식(BMP, PNG, JPG 등)을 허용합니다.

 

procedure AddImage(Bitmap: TBitmap; X, Y, Width, Height: Double);

BitmapTBitmap. A pre-loaded bitmap with PixelFormat = pf32bit. Must not be nil; raises EPdfError otherwise.

설명

AddImage는 지정한 위치와 크기로 현재 PDF 페이지에 이미지를 배치합니다. 두 가지 오버로드가 있으며, 하나는 파일 경로에서 이미지를 직접 읽고 다른 하나는 미리 준비된 TBitmap 개체를 받습니다

파일 기반 오버로드는 내부적으로 TPicture.LoadFromFile을 사용하므로 VCL 또는 LCL 그래픽 시스템에 등록된 모든 이미지 형식을 지원합니다. BMP, PNG(Vcl.Imaging.PngImage 또는 LCL 대응 형식), JPEG 등이 포함됩니다. 호출하기 전에 프로젝트의 uses 절에 관련 유닛을 포함하세요

비트맵 오버로드는 PixelFormat = pf32bitTBitmap을 받습니다. 비트맵이 이미 메모리에 있을 때(예: 오프스크린 렌더링 결과) 유용하며 디스크나 TPicture를 거치지 않습니다. nil 비트맵을 전달하면 EPdfError 예외가 발생합니다

XY 매개 변수는 PDF 사용자 단위에서 이미지 배치 사각형의 왼쪽 아래 모서리를 지정합니다(페이지 왼쪽 아래가 원점이고 Y는 위로 증가합니다). WidthHeight는 페이지에서의 렌더링 크기를 제어하며 원본 이미지는 픽셀 해상도와 무관하게 이 크기에 맞게 조정됩니다

예제

// (72, 600)에 PNG 파일을 배치하고 페이지에서 200 x 150 pt로 렌더링
Pdf1.NewPage(595, 842);
Pdf1.AddImage('C:\Images\logo.png', 72, 600, 200, 150);

// 미리 준비한 32비트 비트맵 추가
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;

참고 항목

AddPicture, AddJpegImage, AddText