RenderPageToMetafileStream

Renderização e impressão

Descrição

Esta função está disponível apenas na edição Delphi; ela renderiza uma página do documento selecionado em um TStream como um meta-arquivo do Windows (saída vetorial), preservando o texto e o conteúdo vetorial da página em vez de rasterizá-lo em pixels

O formato escolhido controla a variante do meta-arquivo: mfEMF usa o caminho clássico do meta-arquivo aprimorado GDI (ampla compatibilidade com o consumidor), mfEMFPlus e mfEMFDual usam o caminho de gravação GDI+ (melhor fidelidade para transparência e suavização) e mfWMF produz o formato herdado de 16 bits

O mfEMFDual grava comandos GDI e GDI+ no mesmo arquivo para que consumidores mais antigos que suportam apenas GDI ainda possam lê-lo à custa de um tamanho de arquivo 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 o Format para um valor inteiro de Options, de modo que o DPI ainda é multiplicado pelo RenderScale por instância definido via SetRenderScale

Sintaxe

Delphi

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

Parâmetros

DPIO DPI a ser usado ao renderizar a página. Controla as dimensões do quadro do meta-arquivo; o conteúdo vetorial em si é independente de DPI
PageO número da página a renderizar
FormatmfEMF = GDI EMF clássico; mfEMFPlus = GDI+ EMF+ Only; mfEMFDual = GDI+ EMF+ Dual (registros GDI + GDI+, maior mas amplamente compatível); mfWMF = WMF herdado de 16 bits
TargetO fluxo no qual colocar os bytes do meta-arquivo renderizado

Valores retornados

0A página não pôde ser renderizada
1A página foi renderizada corretamente e os bytes do meta-arquivo foram gravados no fluxo