HPDFRenderHeadlessPagePNGFile

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

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

O diretório pai precisa já existir; uma chamada bem-sucedida substitui um destino existente e retorna seus contadores de render

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

Aliases de caminho de origem e de hardlink de origem são rejeitados; o documento emprestado permanece carregado e inalterado durante toda a chamada

O helper cria exclusivamente um arquivo de staging próprio ao lado do destino, grava o PNG completo, faz flush do arquivo, checa o cancelamento de novo e executa um rename ou substituição atômica

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

O Windows usa no máximo oito substituições atômicas, retentando 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 é checado antes de cada tentativa de substituição e antes e depois de cada espera; nenhuma deleção de destino ou cópia não atômica é usada como fallback

Uma substituição Windows com falha dispara EHPDFHeadlessRenderError com o código final de erro 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 formato e recursos