RenderPageToMetafileStream

Rendering and printing

Description

Тази функция е налична само в изданието за Delphi; тя рендерира страница от избрания документ в TStream като Windows метафайл (векторен изход), запазвайки текстовото и векторното съдържание на страницата, вместо да го растеризира до пиксели

Избраният Format контролира варианта на метафайла: mfEMF използва класическия GDI подобрен метафайл път (широка потребителска съвместимост), mfEMFPlus и mfEMFDual използват пътя за запис на GDI+ (по-добра точност за прозрачност и антиалиасинг), а mfWMF произвежда наследения 16-битов формат

mfEMFDual записва както GDI, така и GDI+ команди в един и същ файл, така че по-старите потребители, които поддържат само GDI, да могат да го четат за сметка на по-голям размер на файла; предпочитайте mfEMFPlus, когато знаете, че потребителят поддържа GDI+ (Office, Illustrator, модерни програми за преглед)

Вътрешно това е удобна обвивка над RenderPageToStream, която картографира Format към целочислена стойност на Options, така че DPI все още се умножава по зададения за всяка инстанция RenderScale чрез SetRenderScale

Syntax

Delphi

Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;

Parameters

DPIРазделителната способност DPI, която да се използва при изобразяване на страницата. Контролира размерите на рамката на метафайла; самото векторно съдържание е независимо от DPI
PageНомерът на страницата за рендериране
FormatmfEMF = classic GDI EMF; mfEMFPlus = GDI+ EMF+ Only; mfEMFDual = GDI+ EMF+ Dual (GDI + GDI+ records, larger but broadly compatible); mfWMF = legacy 16-bit WMF
TargetПотокът, в който да се поставят рендерираните байтове на метафайла

Return values

0Страницата не може да бъде рендерирана
1Страницата беше рендерирана правилно и байтовете на метафайла бяха записани в потока