HPDFRenderHeadlessPagePNGFile

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

Deklareret i HPDFHeadlessCairoDevice; renderer én lånt side og publicerer atomisk dens PNG til FileName

Overmappen skal allerede findes; et succesfuldt kald erstatter en eksisterende destination og returnerer dens render-tællere

Access.RequireOutputPath er krævet og tjekker kildesti og fysisk filidentitet før staging og før publicering; dokumentets GetRenderAccess leverer denne callback

Kildesti- og kilde-hardlink-aliasser afvises; det lånte dokument forbliver indlæst og uændret gennem hele kaldet

Helperen opretter eksklusivt en ejet staging-fil ved siden af destinationen, skriver den fuldførte PNG, flusher filen, tjekker cancellation igen og udfører en atomisk rename eller erstatning

Budget-, renderings-, cancellation- og staging-fejl bevarer en eksisterende destination og sletter den eede upublicerede staging-fil

Windows bruger højst otte atomiske erstatninger og retrier kun fejl 5, 32 og 33 med ventetider på 1, 2, 4, 8, 16, 16 og 16 millisekunder; alle andre fejl fejler straks

Cancellation tjekkes før hvert erstatningsforsøg og før og efter hver ventetid; ingen destinationssletning eller ikke-atomisk kopiering bruges som fallback

En mislykket Windows-erstatning udløser EHPDFHeadlessRenderError med den opfangede endelige Windows-fejlkode; cancellation bevarer rendererens cancellation-diagnostik

Til streams brug HPDFRenderHeadlessPagePNG; se renderer-guiden for format- og ressourcelgrænser