PDFium Delphi Component Docs

RenderTile 메서드

컴포넌트: TPdf  ·  유닛: PDFium
페이지의 직사각형 영역을 새 비트맵으로 렌더링합니다. 반환된 비트맵은 직접 해제해야 합니다

구문

function RenderTile(Left, Top, Width, Height, PageWidth, PageHeight: Integer; Rotation: TRotation = ro0; Options: TRenderOptions = []; Color: TColor = clWhite): TBitmap;

Left, TopInteger. 렌더링할 타일 영역의 왼쪽 위 좌표입니다. 지정한 줌 레벨의 전체 페이지 기준 픽셀 단위입니다
Width, HeightInteger. 타일의 픽셀 크기입니다. 반환된 비트맵이 이 크기를 갖습니다
PageWidth, PageHeightInteger. 원하는 줌 레벨에서의 전체 페이지 픽셀 크기입니다. 페이지가 렌더링될 스케일을 결정합니다
RotationTRotation. 페이지에 적용할 표시 회전입니다. ro0(기본값), ro90, ro180, ro270
OptionsTRenderOptions. 렌더링 품질과 동작을 제어하는 TRenderOption 플래그 집합입니다
ColorTColor. 렌더링 전에 비트맵을 채울 배경색입니다. 기본값은 clWhite

 

procedure RenderTile(Bitmap: TBitmap; Left, Top, Width, Height, PageWidth, PageHeight: Integer; Rotation: TRotation = ro0; Options: TRenderOptions = []; Color: TColor = clWhite);

BitmapTBitmap. 타일을 렌더링할 기존 TBitmap입니다. 이 비트맵의 생성과 해제는 호출자가 책임집니다
Left, TopInteger. 렌더링할 타일 영역의 왼쪽 위 좌표입니다. 지정한 줌 레벨의 전체 페이지 기준 픽셀 단위입니다
Width, HeightInteger. 타일의 픽셀 크기입니다
PageWidth, PageHeightInteger. 원하는 줌 레벨에서의 전체 페이지 픽셀 크기입니다
RotationTRotation. 페이지에 적용할 표시 회전입니다. ro0(기본값), ro90, ro180, ro270
OptionsTRenderOptions. 렌더링 품질과 동작을 제어하는 TRenderOption 플래그 집합입니다
ColorTColor. 렌더링 전에 비트맵에 적용할 배경색입니다. 기본값은 clWhite

설명

Color = clNone 또는 Color = clDefault를 지정하면 투명 배경과 알파 채널을 지원하는 PDFium 비트맵을 사용합니다. 내용이 그려지지 않은 타일 픽셀의 알파 값은 네이티브 페이지의 배경 투명도 조회 결과와 관계없이 0으로 유지됩니다. 기본 배경색 clWhite는 불투명합니다

현재 페이지의 사각형 타일 하나를 렌더링합니다. 지정한 크기로 전체 페이지를 그리는 RenderPage와 달리 RenderTile은 잘라낸 영역만 렌더링합니다. 큰 페이지를 한 번에 통째로 그리면 메모리를 너무 먹는 상황의 고해상도 표시에 이상적입니다

PageWidth / PageHeight는 페이지의 전체 렌더링 크기("줌 레벨")를 정의하고, Left / Top / Width / Height는 그 전체 크기 안의 출력 창을 정의합니다

예제

// Render top-left 800x600 tile of a page scaled to 2000x2828
var Bmp: TBitmap;
Bmp := Pdf.RenderTile(0, 0, 800, 600, 2000, 2828);
try
  Image1.Picture.Assign(Bmp);
finally
  Bmp.Free;
end;

관련 항목

RenderPage, PageWidth