HPDFRenderHeadlessPagePNGFile

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

Dichiarato in HPDFHeadlessCairoDevice; renderizza una pagina presa in prestito e pubblica il suo PNG in modo atomico su FileName

La directory genitore deve già esistere; una chiamata riuscita sostituisce una destinazione esistente e ne restituisce i contatori di rendering

Access.RequireOutputPath è obbligatorio e controlla il percorso della sorgente e l'identità fisica del file prima dello staging e prima della pubblicazione; il GetRenderAccess del documento fornisce questo callback

Gli alias per percorso della sorgente e per hardlink della sorgente vengono rigettati; il documento preso in prestito resta caricato e invariato per tutta la chiamata

L'helper crea in modo esclusivo un file di staging di proprietà accanto alla destinazione, scrive il PNG completato, scarica il file, ricontrolla la cancellazione ed esegue una rename o sostituzione atomica

I fallimenti di budget, rendering, cancellazione e staging preservano una destinazione esistente e cancellano il file di staging di proprietà non pubblicato

Windows usa al massimo otto sostituzioni atomiche, ritentando solo gli errori 5, 32 e 33 con attese di 1, 2, 4, 8, 16, 16 e 16 millisecondi; tutti gli altri errori falliscono immediatamente

La cancellazione viene controllata prima di ogni tentativo di sostituzione e prima e dopo ogni attesa; nessuna eliminazione della destinazione o copia non atomica viene usata come fallback

Una sostituzione Windows fallita solleva EHPDFHeadlessRenderError con l'ultimo codice di errore Windows catturato; la cancellazione preserva la diagnostica di cancellazione del renderer

Per gli stream usare HPDFRenderHeadlessPagePNG; vedere la guida del renderer per i confini di formato e risorse