HPDFRenderHeadlessPagePNGFile
function HPDFRenderHeadlessPagePNGFile(const Access: THPDFHeadlessRenderAccess;
const FileName: string; const Options: THPDFHeadlessRenderOptions):
THPDFHeadlessRenderResult;
Gedeclareerd in HPDFHeadlessCairoDevice; rendert één geleende pagina en publiceert diens PNG atomair naar FileName
De ouderdirectory moet al bestaan; een geslaagde aanroep vervangt een bestaande destination en geeft diens render-counters terug
Access.RequireOutputPath is vereist en checkt bronpad en fysieke bestandsidentiteit vóór staging en vóór publicatie; de GetRenderAccess van het document levert deze callback
Bronpad- en bron-hardlink-aliases worden geweigerd; het geleende document blijft gedurende de hele aanroep geladen en ongewijzigd
De helper maakt exclusief een staging-bestand in caller-eigendom aan naast de destination, schrijft de voltooide PNG, flußt het bestand, checkt opnieuw op annulering en voert een atomare rename of vervanging uit
Budget-, rendering-, annulerings- en staging-fouten behouden een bestaande destination en verwijderen het unpublished staging-bestand in caller-eigendom
Windows gebruikt hoogstens acht atomare vervangingen en retryt alleen fouten 5, 32 en 33 met waits van 1, 2, 4, 8, 16, 16 en 16 milliseconden; alle andere fouten falen direct
Annulering wordt gecheckt vóór elke vervangingspoging en vóór en na elke wait; geen destination-verwijdering of niet-atomare kopie wordt als fallback gebruikt
Een gefaalde Windows-vervanging raiset EHPDFHeadlessRenderError met de vastgelegde finale Windows error code; annulering behoudt de annuleringsdiagnostiek van de renderer
Voor streams, gebruik HPDFRenderHeadlessPagePNG; zie de renderergids voor formaat- en resourcegrenzen