PDFium Delphi Component Docs

RenderTile Метод

Компонент: TPdf  ·  Модуль: PDFium
Рендерит прямоугольную область страницы в новый bitmap. Возвращённый bitmap нужно освобождать вручную

Syntax

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

Left, TopInteger. Левый верхний угол области тайла для рендеринга, в пикселях, относительно полной страницы на заданном уровне зума
Width, HeightInteger. Размер тайла в пикселях. Возвращённый bitmap будет таких размеров
PageWidth, PageHeightInteger. Полные размеры страницы в пикселях на желаемом уровне зума. Они задают масштаб, в котором рендерится страница
RotationTRotation. Поворот отображения страницы: ro0 (по умолчанию), ro90, ro180 или ro270
OptionsTRenderOptions. Набор флагов TRenderOption, управляющих качеством и поведением рендеринга
ColorTColor. Цвет заливки фона bitmap перед рендерингом. По умолчанию clWhite

 

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

BitmapTBitmap. Существующий TBitmap, в который рендерится тайл. Создать и освободить bitmap обязан вызывающий
Left, TopInteger. Левый верхний угол области тайла для рендеринга, в пикселях, относительно полной страницы на заданном уровне зума
Width, HeightInteger. Размер тайла в пикселях
PageWidth, PageHeightInteger. Полные размеры страницы в пикселях на желаемом уровне зума
RotationTRotation. Поворот отображения страницы: ro0 (по умолчанию), ro90, ro180 или ro270
OptionsTRenderOptions. Набор флагов TRenderOption, управляющих качеством и поведением рендеринга
ColorTColor. Цвет заливки фона, применяемый к bitmap перед рендерингом. По умолчанию clWhite

Description

Color = clNone или Color = clDefault выбирает прозрачный фон и растровое изображение PDFium с поддержкой альфа-канала. Непокрытые пиксели тайла сохраняют нулевую альфу независимо от нативного запроса фоновой прозрачности страницы; стандартный фон clWhite непрозрачен

Рендерит прямоугольный тайл текущей страницы. В отличие от RenderPage, рендерящей полную страницу в заданном размере, RenderTile рендерит только вырезанную область. Идеально для высококонтрастного показа больших страниц, где рендеринг всей страницы разом съел бы слишком много памяти

PageWidth / PageHeight задают полный отрендеренный размер страницы ("уровень зума"), а Left / Top / Width / Height — выходное окно внутри этого полного размера

Example

// 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;

See Also

RenderPage, PageWidth