RenderPageToMetafileStream

Rendering, stampa

Descrizione

Questa funzione è disponibile solo nella versione Delphi; esegue il rendering di una pagina dal documento selezionato in un TStream come metafile Windows (output vettoriale), preservando il testo e il contenuto vettoriale della pagina invece di rasterizzarla in pixel

Il Format scelto controlla la variante del metafile: mfEMF usa il classico percorso GDI del metafile avanzato (ampia compatibilità di consumo), mfEMFPlus e mfEMFDual usano il percorso di registrazione GDI+ (migliore fedeltà per trasparenza e anti-aliasing) e mfWMF produce il formato legacy a 16 bit

mfEMFDual registra sia i comandi GDI che GDI+ nello stesso file in modo che i software di visualizzazione più vecchi che supportano solo GDI possano comunque leggerlo, al costo di un file di dimensioni maggiori; preferire mfEMFPlus quando si sa che il destinatario supporta GDI+ (Office, Illustrator, visualizzatori moderni)

Internamente questo è un wrapper di convenienza su RenderPageToStream che mappa Format a un valore Options intero, quindi DPI viene comunque moltiplicato per il RenderScale per istanza impostato tramite SetRenderScale

Sintassi

Delphi

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

Parametri

DPII DPI da utilizzare durante il rendering della pagina; controlla le dimensioni del frame metafile; il contenuto vettoriale stesso è indipendente dai DPI
PageIl numero di pagina di cui eseguire il rendering
FormatmfEMF = GDI EMF classico; mfEMFPlus = Solo GDI+ EMF+; mfEMFDual = GDI+ EMF+ Dual (record GDI + GDI+, più grande ma ampiamente compatibile); mfWMF = WMF legacy a 16 bit
TargetLo stream in cui posizionare i byte del metafile renderizzato

Valori restituiti

0Impossibile eseguire il rendering della pagina
1La pagina è stata renderizzata correttamente e i byte del metafile sono stati scritti nello stream