AsyncRendering プロパティ

AsyncRendering は非同期レンダーパターンの視覚的側面です。単一ページ描画パスに、呼び出し側が所有するワーカーが現在ページをレンダリングしている間、レンダリングされたページ領域上に小さなローディングインジケーター（LoadingText と LoadingColor で設定）を描画するよう指示します。既定は False で、既存アプリケーションは視覚的変更なしでアップグレードします

AsyncRendering 自体はレンダリングをワーカースレッドへ押し出しません。v1.37.0 以降、TPdf はインスタンスごとにレンダリングとページアンロード呼び出しを直列化するため、ワーカーは PDFium レンダリング呼び出しを重ねることなく同じコンポーネントを通じてレンダリングできます。呼び出し側は依然としてワーカーディスパッチ、ビットマップ引き渡し、文書の生存期間を所有します。レンダリング中は文書を変更またはアンロードしないでください。FPdfAsync の TPdfFuture<T> を使ってワーカーを駆動し、AsyncRendering / LoadingText / LoadingColor にレンダリング中の視覚的手がかりを任せます

ローディングオーバーレイはページ領域の中央に描画される小さな矩形で、LoadingText キャプションに合わせてサイズ調整されます。異なる配置、アニメーション、進行率パーセンテージを必要とするアプリケーションは AsyncRendering をオフのままにし、OnPaint を通じて直接オーバーレイを処理するべきです

• オーバーレイは単一ページ描画パスからのみ発火します。2 ページ見開きモード（dmTwoPageContinuous、dmTwoPageContinuousWithCover）は現在インジケーターを表示しません。両方のモードで必要な場合は独自の OnPaint を接続してください
• 実際のスレッド外処理を行うワーカーなしでも、AsyncRendering は同期レンダリング中にオーバーレイを描画します — 遅いマシンでの非常に高 DPI のエクスポートに有用ですが、ほとんどの呼び出し側は TPdfFuture と組み合わせます
• RenderPage / RenderTile を支えるレンダーパスは、宛先 DIB を安全にラップできるときゼロコピーで、ボトムアップ DIB レイアウトではコピーされたバッファーへフォールバックします