RenderPageToMetafileStream
Рендеринг и печать
Описание
Эта функция доступна только в версии для Delphi; она рендерит страницу из выбранного документа в TStream в виде Windows-метафайла (векторный вывод), сохраняя текст и векторное содержимое страницы вместо растрирования в пиксели
Выбранный Format управляет вариантом метафайла: mfEMF — классический путь GDI enhanced metafile (широкая совместимость), mfEMFPlus и mfEMFDual — записывающий путь GDI+ (точнее передаёт прозрачность и сглаживание), mfWMF — унаследованный 16-битный формат
Формат mfEMFDual записывает как команды GDI, так и команды GDI+ в один и тот же файл, чтобы старые программы, поддерживающие только GDI, могли его читать ценой увеличения размера файла; предпочитайте mfEMFPlus, если знаете, что целевая программа поддерживает GDI+ (Office, Illustrator, современные средства просмотра)
Внутренне это удобная обертка над RenderPageToStream, которая сопоставляет Format целочисленному значению Options, поэтому DPI все равно умножается на RenderScale конкретного экземпляра, установленный через SetRenderScale
Синтаксис
Delphi
Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;Параметры
| DPI | DPI при растеризации страницы. Управляет размерами рамки метафайла; сам векторный контент от DPI не зависит |
|---|---|
| Page | Номер страницы для рендеринга |
| Format | mfEMF = классический GDI EMF; mfEMFPlus = GDI+ EMF+ Only; mfEMFDual = GDI+ EMF+ Dual (записи GDI + GDI+, большего размера, но широко совместимый); mfWMF = устаревший 16-разрядный WMF |
| Target | Поток для помещения отрендеренных байтов метафайла |
Возвращаемые значения
| 0 | Не удалось отрендерить страницу |
|---|---|
| 1 | Страница была отрендерена корректно, а байты метафайла были записаны в поток |