HPDFRenderHeadlessPagePNGFile

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

HPDFHeadlessCairoDevice で宣言されています。借り受けた 1 ページをレンダリングし、その PNG を FileName にアトミックに公開します

親ディレクトリは既に存在しなければなりません。成功した呼び出しは既存の宛先を置き換え、レンダリングカウンタを返します

Access.RequireOutputPath は必須で、ステージングの前と公開の前にソースパスと物理ファイル ID をチェックします。ドキュメントの GetRenderAccess がこのコールバックを供給します

ソースパスとソースハードリンクのエイリアスは拒否されます。借り受けたドキュメントは呼び出し全体を通じてロード済みかつ変更なしのままです

ヘルパーは宛先のそばに所有ステージングファイルを排他的に作成し、完成した PNG を書き込み、ファイルをフラッシュし、キャンセルを再チェックして、アトミックなリネームまたは置換を行います

バジェット・レンダリング・キャンセル・ステージングの失敗では、既存の宛先が保持され、所有する未公開ステージングファイルは削除されます

Windows は最大 8 回のアトミック置換を行い、待機 1、2、4、8、16、16、16 ミリ秒でエラー 5、32、33 のみをリトライします。その他のエラーは即座に失敗します

キャンセルは毎回の置換試行の前と各待機の前後でチェックされます。宛先の削除や非アトミックコピーへのフォールバックは使いません

Windows の置換に失敗すると、捕捉された最終 Windows エラーコード付きで EHPDFHeadlessRenderError が発生します。キャンセルではレンダラのキャンセル診断が保持されます

ストリームには HPDFRenderHeadlessPagePNG を使ってください。フォーマットとリソースの境界はレンダラガイドを参照してください