THPDFViewerModel Snapshot Methods

ビューアコントロールを構築せずにページ画像を作成し、読み込みページの描画キャッシュを再利用します

宣言

function CreatePageSnapshot(PageIndex: Integer; DPI: Integer= 150): TBitmap;
function CreateCurrentPageSnapshot(DPI: Integer= 150): TBitmap;
function CreatePageThumbnail(PageIndex, MaxWidth, MaxHeight: Integer): TBitmap;
function CreateCurrentPageThumbnail(MaxWidth, MaxHeight: Integer): TBitmap;
function PrefetchPageSnapshots(PageIndex, Radius: Integer;
  DPI: Integer= 150): Integer;
function PrefetchCurrentPageSnapshots(Radius: Integer= 1;
  DPI: Integer= 150): Integer;
function SaveCurrentPageSnapshotToBMP(const FileName: string; DPI: Integer= 150): boolean;
function SaveCurrentPageSnapshotToStream(Stream: TStream;
  ImageFormat: THPDFViewerSnapshotFormat; DPI: Integer= 150;
  JPEGQuality: Integer= 90): boolean;
function SaveCurrentPageSnapshot(const FileName: string;
  ImageFormat: THPDFViewerSnapshotFormat; DPI: Integer= 150;
  JPEGQuality: Integer= 90): boolean;

使用上の注意

• 返された各 TBitmap の所有権は呼び出し側にあり、解放が必要です
• DPI 値はサポート範囲の 12〜2400 に制限されます
• 無効なドキュメントまたはページ状態では作成系メソッドは nil を返します
• CreatePageThumbnail と CreateCurrentPageThumbnail は、要求されたピクセル境界に合った描画 DPI を選び、ページのアスペクト比を維持し、ビューの回転を適用し、指定より広いまたは高いビットマップを返しません
• PrefetchPageSnapshots と PrefetchCurrentPageSnapshots は、中央合わせのページウィンドウを非同期にウォームアップし、スケジュールするページ数を次のプロパティーに制限します RenderCacheCapacity
• プリフェッチ系メソッドはスケジュールされたページ数を返し、0 起算のページインデックスを使い、以前の読み込みページプリフェッチ要求を置き換えます
• スナップショット作成はフォアグラウンド描画の前に実行中のプリフェッチ処理を横取りします。ドキュメントレベルのプリフェッチテレメトリーは、フォアグラウンドによる横取りと明示的な取り消しを区別します
• SaveCurrentPageSnapshotToBMP は Windows BMP 出力を書き込み、ファイルが作成されたかどうかを返します
• THPDFViewerSnapshotFormat の書式を選択します。選択肢は vsfBMP、 vsfJPEG、または vsfPNG
• ストリーム出力はストリームの現在位置から始まり、ストリームの所有権を取得することはありません
• JPEG 品質は 1〜100 に制限されます
• ファイル出力は、保存に失敗したとき空または途中までエンコードされたファイルを削除します