THPDFLoadedPageRenderSession Class

Sayfa render durumunu ve canlı bir kısmi bitmap tutar; böylece yüklenmiş bir sayfa birden çok sınırlı çağrıyla render edilebilir

Bildirim

THPDFLoadedPageRenderSession = class(TObject)
public
  function ContinueRender(MaxMilliseconds: Cardinal = 0;
    MaxObjects: Integer = 0): THPDFProgressiveRenderStatus;
  function TakeBitmap: TBitmap;
  property Bitmap: TBitmap read GetBitmap;
  property ObjectsProcessed: Integer read GetObjectsProcessed;
  property TotalObjects: Integer read GetTotalObjects;
  property ProgressiveJPEGScansDecoded: Integer
    read GetProgressiveJPEGScansDecoded;
  property ProgressiveJPEGImagesDecoded: Integer
    read GetProgressiveJPEGImagesDecoded;
  property Status: THPDFProgressiveRenderStatus read GetStatus;
  property IsRegionRender: Boolean read FIsRegionRender;
  property RegionLeft: Single read FRegionLeft;
  property RegionBottom: Single read FRegionBottom;
  property RegionRight: Single read FRegionRight;
  property RegionTop: Single read FRegionTop;
  property RegionVisiblePaintObjects: Integer
    read GetRegionVisiblePaintObjects;
  property RegionCulledPaintObjects: Integer
    read GetRegionCulledPaintObjects;
  property OnProgress: THPDFProgressiveRenderProgressEvent
    read FOnProgress write SetOnProgress;
  property OnProgressiveJPEGScan: THPDFProgressiveJPEGScanEvent
    read FOnProgressiveJPEGScan write SetOnProgressiveJPEGScan;
end;

Birim

HPDFDoc

Durum değerleri

• prsReady, sayfanın başlatıldığını ve hiçbir içerik operatörünün çalışmadığını ifade eder
• prsPaused, bir bütçenin tüm operatörler tamamlanmadan önce tükendiğini ifade eder
• prsCompleted, sayfanın tam bitmap'inin kullanılabilir olduğunu ifade eder
• prsCancelled, callback'in ya da token'ın oturumu bir operatör sınırında durdurduğunu ifade eder

Kullanım notları

• Bütçelerden herhangi biri sınırsız iş için sıfır olabilir; her ikisi de sıfır olduğunda tek çağrı son duruma kadar çalışır
• Bitmap oturumun sahipliğinde kalır ve salt okunur önizleme erişimi içindir
• TakeBitmap yalnızca son durumda geçerlidir ve sahipliği çağırana devreder
• ProgressiveJPEGScansDecoded ve ProgressiveJPEGImagesDecoded başarılı artımlı görüntü işini sayar; OnProgressiveJPEGScan ise görünür bir scan'in ardından iptal edebilir
• IsRegionRender ROI oturumlarını tanımlar; bölge property'leri istenen user-space sınırlarını tutar, görünür ve ayıklanan sayaçları ise display-list boyama seçimini açıklar
• Yüklenmiş THotPDF örneği ve iptal token'ı, oturum serbest bırakılana kadar canlı kalmak zorundadır

İlgili API'ler

• THotPDF.BeginLoadedPageProgressiveRender
• THotPDF.BeginLoadedPageProgressiveRegionRender
• THPDFCancellationToken
• Progressive Rendering and Cancellation