RenderPageToMetafileStream
Processamento e impressão
Descrição
Esta função só está disponível na edição Delphi. Compõe uma página do documento selecionado para um TStream como metaficheiro do Windows (saída vetorial), conservando o texto e o conteúdo vetorial da página em vez de os rasterizar em píxeis
O Format escolhido controla a variante de metaficheiro: mfEMF utiliza o caminho clássico de metaficheiro avançado GDI (ampla compatibilidade com consumidores), mfEMFPlus e mfEMFDual utilizam o caminho de gravação GDI+ (melhor fidelidade para transparência e antisserrilhamento) e mfWMF produz o formato legado de 16 bits
mfEMFDual regista comandos GDI e GDI+ no mesmo ficheiro, para que os consumidores mais antigos apenas de GDI ainda consigam lê-lo à custa de um ficheiro maior. Prefira mfEMFPlus quando souber que o consumidor é compatível com GDI+ (Office, Illustrator, visualizadores modernos)
Internamente, este é um wrapper de conveniência sobre RenderPageToStream que mapeia Format para um valor inteiro de Options, pelo que DPI continua a ser multiplicado pelo RenderScale por instância definido através de SetRenderScale
Sintaxe
Delphi
Function TPDFlib.RenderPageToMetafileStream(DPI: Double; Page: Integer; Format: TPDFlibMetafileFormat; Target: TStream): Integer;Parâmetros
| DPI | O DPI a utilizar ao compor a página. Controla as dimensões da moldura do metaficheiro; o próprio conteúdo vetorial é independente do DPI |
|---|---|
| Page | O número da página a compor |
| Format | mfEMF = EMF GDI clássico; mfEMFPlus = Apenas EMF+ GDI+; mfEMFDual = EMF+ Dual GDI+ (registos GDI + GDI+, maior mas amplamente compatível); mfWMF = WMF de 16 bits antigo |
| Target | O fluxo onde colocar os bytes do metaficheiro processado |
Valores devolvidos
| 0 | Não foi possível compor a página |
|---|---|
| 1 | A página foi renderizada corretamente e os bytes do metaficheiro foram escritos no fluxo |