RenderPageThumbnail - TPdf - PDFium Delphi Component

Компонент: TPdf · Модуль: PDFium

Рендерит любую страницу с индексом от единицы в битмап, умещающийся в запрошенные границы миниатюры

Syntax

function RenderPageThumbnail(PageIndex, MaxWidth, MaxHeight: Integer): TBitmap;

function RenderPageThumbnail(PageIndex, MaxWidth, MaxHeight: Integer; Rotation: TRotation; Options: TRenderOptions; Background: TColor; const ColorScheme: TPdfColorScheme): TBitmap;

Parameters

PageIndex	`Integer` - Отсчитываемый от единицы индекс рендеримой страницы
MaxWidth	`Integer` - Максимальная ширина миниатюры в пикселях
MaxHeight	`Integer` - Максимальная высота миниатюры в пикселях
Rotation	`TRotation` - Дополнительный поворот рендеринга по часовой стрелке
Options	`TRenderOptions` - Нативные флаги рендеринга PDFium, входящие в ключ кэша
Background	`TColor` - Цвет фона битмапа
ColorScheme	`TPdfColorScheme` - Необязательные переопределения цветов контуров и текста для слабовидящих

Return Value

Битмап TBitmap во владении вызывающего кода или nil, когда документ неактивен, индекс страницы недействителен или запрошенный размер неположителен

Description

Короткая перегрузка сохраняет пропорции страницы и рендерит на белом фоне, а полная перегрузка управляет поворотом, флагами, фоном и цветами для слабовидящих

Обе перегрузки повторно используют глубокие внутренние копии битмапа через единый LRU миниатюр и при каждом вызове возвращают отдельный битмап TBitmap во владении вызывающего кода

Метод не меняет PageNumber, не подменяет текущую загруженную страницу и не рассылает уведомления о смене страницы

Remarks

Имена API, типы, файлы и термины PDF сохраняют исходное написание, чтобы поиск по коду оставался надёжным
Используйте этот метод для лент миниатюр или панелей навигации, которые не должны тревожить состояние редактирования основного экземпляра TPdf

Example

Bmp := Pdf1.RenderPageThumbnail(3, 180, 240);
try
  if Bmp <> nil then
    Image1.Picture.Assign(Bmp);
finally
  Bmp.Free;
end;

RenderPageThumbnail Метод