THotPDF.PrefetchLoadedPages Method
表示リストのコンパイルや再生の間、描画キャッシュロックを保持せずに、読み込みページのラスターキャッシュを非同期でウォームアップします
宣言
procedure PrefetchLoadedPages(const PageRange: string= ''; DPI: Integer= 150);
ユニット
HPDFDoc
パラメータ
| 名前 | 目的 |
|---|---|
PageRange | 標準ページ範囲パーサーが受け付ける 1 起算ページ範囲。空の場合はすべての読み込みページ |
DPI | スケジュールされる各キャッシュエントリーに使うラスタ解像度。無効な値は 150 に置き換えられます |
戻り値
このメンバーは値を返しません
使用上の注意
- 新しい要求を開始すると、新しいページセットのスケジュール前に、前の要求が協調的に取り消されて合流します
- フォアグラウンドから
RenderLoadedPageToBitmap、RenderLoadedPageToBitmapCached、GetLoadedCachedRenderedBitmapなどをフォアグラウンドで呼び出すと、描画の前に実行中のプリフェッチ処理が横取りされます - 取り消しチェックポイントはコンテンツのトークン化・表示リスト構築・レンダラー再生を通して実行されます。一方、個々のコーデック・フィルター・ソース読み取り・OS 呼び出しはアトミックなままです
- キャッシュの検査と公開は直列化されますが、コンパイルとラスタライズはキャッシュロックの外で実行されるため、バックグラウンド処理がフォアグラウンド描画を独占しません
- フォアグラウンドのキャッシュ済みレンダリングは、キャンセルの完了を待つ間に既存の不変メモリキャッシュビットマップをコピーできます。コピー前に通常のメモリ予約を取得し、戻る前に論理的なワーカー完了を待ちます
- フォアグラウンドのキャッシュミスは、新しいドキュメント処理の前にワーカー完了を待ちます。明示的なキャンセル・置換・再読み込み・破棄では、保持されたワーカースレッドを合流させて解放します
- プリフェッチ要求がアクティブな間は、ドキュメントを変更または再読み込みしないでください