HPDFRenderHeadlessPagePNGFile

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

Declarado en HPDFHeadlessCairoDevice; renderiza una página prestada y publica su PNG atómicamente en FileName

El directorio padre ya debe existir; una llamada exitosa reemplaza un destino existente y devuelve sus contadores de render

Access.RequireOutputPath es obligatorio y verifica la ruta de la fuente y la identidad física del archivo antes del staging y antes de la publicación; el GetRenderAccess del documento aporta este callback

Los alias de ruta de fuente y de hardlink de fuente se rechazan; el documento prestado sigue cargado y sin cambios durante toda la llamada

El helper crea exclusivamente un archivo de staging propio junto al destino, escribe el PNG completo, hace flush del archivo, verifica de nuevo la cancelación y realiza un rename o reemplazo atómico

Los fallos de presupuesto, render, cancelación y staging preservan un destino existente y borran el archivo de staging propio no publicado

Windows usa a lo sumo ocho reemplazos atómicos, reintentando solo los errores 5, 32 y 33 con esperas de 1, 2, 4, 8, 16, 16 y 16 milisegundos; todos los demás errores fallan de inmediato

La cancelación se verifica antes de cada intento de reemplazo y antes y después de cada espera; no se usa borrado del destino ni copia no atómica como fallback

Un reemplazo fallido en Windows lanza EHPDFHeadlessRenderError con el código de error final de Windows capturado; la cancelación conserva el diagnóstico de cancelación del renderer

Para streams usa HPDFRenderHeadlessPagePNG; ver la guía del renderer para los límites de formato y recursos