HPDFRenderHeadlessPagePNGFile

function HPDFRenderHeadlessPagePNGFile(const Access: THPDFHeadlessRenderAccess;
  const FileName: string; const Options: THPDFHeadlessRenderOptions):
  THPDFHeadlessRenderResult;

Declarada em HPDFHeadlessCairoDevice; renderiza uma página emprestada e publica atomicamente o PNG dela em FileName

O diretório pai tem de já existir; uma chamada bem-sucedida substitui um destino existente e devolve os contadores de renderização dele

Access.RequireOutputPath é obrigatório e verifica a identidade física do caminho e do ficheiro da fonte antes do staging e antes da publicação; o GetRenderAccess do documento fornece este callback

Aliases de caminho de fonte e de hardlinks de fonte são rejeitados; o documento emprestado permanece carregado e inalterado ao longo da chamada

O helper cria exclusivamente um ficheiro de staging próprio ao lado do destino, escreve o PNG concluído, faz flush do ficheiro, verifica o cancelamento outra vez e executa um rename ou uma substituição atómica

Falhas de orçamento, renderização, cancelamento e staging preservam um destino existente e apagam o ficheiro de staging próprio não publicado

Windows usa no máximo oito substituições atómicas, repetindo apenas os erros 5, 32 e 33 com esperas de 1, 2, 4, 8, 16, 16 e 16 milissegundos; todos os outros erros falham imediatamente

O cancelamento é verificado antes de cada tentativa de substituição e antes e depois de cada espera; nenhuma eliminação de destino nem cópia não atómica é usada como fallback

Uma substituição de Windows falhada levanta EHPDFHeadlessRenderError com o código de erro final de Windows capturado; o cancelamento preserva o diagnóstico de cancelamento do renderer

Para streams use HPDFRenderHeadlessPagePNG; veja o guia do renderer para as fronteiras de formatos e de recursos