THPDFViewerModel Snapshot Methods

تصویر صفحه بدون ساخت کنترل Viewer می‌سازد و از کش رندر صفحهٔ بارگذاری‌شده استفاده می‌کند

اعلان‌ها

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 محدود می‌کنند
• متدهای prefetch تعداد صفحات زمان‌بندی‌شده را برمی‌گردانند، از اندیس صفحات صفر-مبنا استفاده می‌کنند و هر درخواست prefetch قبلی صفحه را جایگزین می‌کنند
• ساخت snapshot پیش از رندر پیش‌زمینه، کار prefetch فعال را پیشی می‌گیرد و تله‌متری prefetch در سطح سند، پیشی‌گرفتن پیش‌زمینه را از لغو صریح تفکیک می‌کند
• متد SaveCurrentPageSnapshotToBMP خروجی Windows BMP می‌نویسد و برمی‌گرداند که فایل ساخته شده است یا نه
• مقدار THPDFViewerSnapshotFormat حالت vsfBMP، vsfJPEG یا vsfPNG را انتخاب می‌کند
• خروجی استریم از موقعیت جاری استریم آغاز می‌شود و هرگز مالک استریم نمی‌شود
• کیفیت JPEG در بازهٔ 1 تا 100 محدود می‌شود
• خروجی فایل در صورت شکست ذخیره، فایل خالی یا نیمه‌کد‌شده را حذف می‌کند