RenderPageToMetafileStream

Vykreslování a tisk

Popis

Tato funkce je dostupná jen v edici Delphi. Vyrenderuje stránku z vybraného dokumentu do TStream jako Windows metafile (vektorový výstup), takže text a vektorový obsah stránky zůstanou zachované místo rasterizace na pixely

Zvolený Format řídí variantu metafile: mfEMF používá klasickou cestu GDI enhanced metafile (široká kompatibilita se spotřebiteli), mfEMFPlus a mfEMFDual používají nahrávací cestu GDI+ (lepší věrnost u průhlednosti a anti-aliasingu) a mfWMF vytváří zastaralý 16bitový formát

mfEMFDual zaznamenává do téhož souboru příkazy GDI i GDI+, takže si ho přečtou i starší spotřebitelé jen s GDI, za cenu většího souboru. Když víte, že spotřebitel zvládá GDI+ (Office, Illustrator, moderní prohlížeče), upřednostněte mfEMFPlus

Uvnitř jde o pohodlný wrapper nad RenderPageToStream, který mapuje Format na celočíselnou hodnotu Options, takže DPI se dále násobí RenderScale instance nastaveným přes SetRenderScale

Syntaxe

Delphi

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

Parametry

DPIRozlišení DPI při vykreslování stránky. Řídí rozměry rámu metafilu; samotný vektorový obsah je na DPI nezávislý
PageČíslo stránky, která se má vykreslit
FormatmfEMF = classic GDI EMF; mfEMFPlus = GDI+ EMF+ Only; mfEMFDual = GDI+ EMF+ Dual (GDI + GDI+ records, larger but broadly compatible); mfWMF = legacy 16-bit WMF
TargetProud, do něhož se umístí vykreslené bajty metafile

Návratové hodnoty

0Stránku se nepodařilo vykreslit
1Stránka byla správně vykreslena a bajty metasouboru byly zapsány do streamu