Clasa THPDFLoadedPageRenderSession

Retains page render state and a live partial bitmap so a loaded page can be rendered over multiple bounded calls

Declaration

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;

Unit

HPDFDoc

Status values

• prsReady înseamnă că pagina este inițializată și niciun operator de conținut nu a rulat
• prsPaused înseamnă că un buget s-a încheiat înainte de finalizarea tuturor operatorilor
• prsCompleted înseamnă că bitmap-ul complet al paginii este disponibil
• prsCancelled înseamnă că callback-ul sau token-ul a oprit sesiunea la o graniță de operator

Usage notes

• Oricare buget poate fi zero pentru muncă nelimitată, în timp ce ambele valori zero rulează până la o stare terminală într-un singur apel
• Bitmap rămâne proprietatea sesiunii și este destinat accesului de previzualizare doar în citire
• TakeBitmap este valid doar într-o stare terminală și transferă proprietatea către apelant
• ProgressiveJPEGScansDecoded și ProgressiveJPEGImagesDecoded numără munca incrementală reușită asupra imaginilor, în timp ce OnProgressiveJPEGScan poate anula după o scanare vizibilă
• IsRegionRender identifică sesiunile ROI; proprietățile de regiune rețin limitele cerute în spațiul utilizatorului, iar contoarele de vizibile și eliminate descriu selecția de pictură a listei de afișare
• The loaded THotPDF instance and cancellation token must remain alive until the session is freed

Related APIs

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