THPDFLoadedPageRenderSession Class

Conserva lo stato di render della pagina e una bitmap parziale ancora viva, così una pagina caricata può essere renderizzata su più chiamate limitate

Dichiarazione

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

Valori di stato

• prsReady significa che la pagina è inizializzata e nessun operatore di contenuto è stato eseguito
• prsPaused significa che un budget si è esaurito prima del completamento di tutti gli operatori
• prsCompleted significa che la bitmap completa della pagina è disponibile
• prsCancelled significa che la callback o il token ha fermato la sessione a un confine tra operatori

Note sull'utilizzo

• Ciascun budget può essere zero per lavoro illimitato, mentre entrambi a zero eseguono fino a uno stato terminale in una sola chiamata
• Bitmap resta di proprietà della sessione ed è pensata per accesso in sola lettura come anteprima
• TakeBitmap è valido solo in uno stato terminale e trasferisce la proprietà al chiamante
• ProgressiveJPEGScansDecoded e ProgressiveJPEGImagesDecoded conteggiano il lavoro incrementale riuscito sulle immagini, mentre OnProgressiveJPEGScan può cancellare dopo una scanline visibile
• IsRegionRender identifica le sessioni ROI; le proprietà di regione conservano i bound richiesti in spazio utente e i contatori visible e culled descrivono la selezione della paint list del display list
• L'istanza caricata di THotPDF e il token di cancellazione devono restare vivi finché la sessione non viene liberata

API correlate

• THotPDF.BeginLoadedPageProgressiveRender
• THotPDF.BeginLoadedPageProgressiveRegionRender
• THPDFCancellationToken
• Rendering Progressivo e Cancellazione