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
| DPI | Rozliš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 |
| Format | mfEMF = classic GDI EMF; mfEMFPlus = GDI+ EMF+ Only; mfEMFDual = GDI+ EMF+ Dual (GDI + GDI+ records, larger but broadly compatible); mfWMF = legacy 16-bit WMF |
| Target | Proud, do něhož se umístí vykreslené bajty metafile |
Návratové hodnoty
| 0 | Stránku se nepodařilo vykreslit |
|---|---|
| 1 | Stránka byla správně vykreslena a bajty metasouboru byly zapsány do streamu |