THPDFLoadedPageRenderSession Class

Bevare side-render-tilstand og et levende delvist bitmap, så en indlæst side kan rendres gennem flere afgrænsede kald

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 betyder, at siden er initialiseret, og at ingen indholdsoperator er kørt
• prsPaused betyder, at et budget sluttede før alle operatører var fuldført
• prsCompleted betyder, at hele side-bitmapet er tilgængeligt
• prsCancelled betyder, at callbacket eller tokenet stoppede sessionen ved en operator-grænse

Usage notes

• Begge budgetter kan være nul for ubegrænset arbejde, mens to nul-værdier kører til en terminal tilstand i ét kald
• Bitmap forbliver ejet af sessionen og er beregnet til skrivebeskyttet forhåndsvisning
• TakeBitmap er kun gyldig i en terminal tilstand og overfører ejerskab til calleren
• ProgressiveJPEGScansDecoded og ProgressiveJPEGImagesDecoded tæller succesfuldt inkrementelt billedarbejde, mens OnProgressiveJPEGScan kan annullere efter et synligt scan
• IsRegionRender identificerer ROI-sessioner; regionsegenskaberne bevarer de ønskede user-space-grænser, og de synlige og frasorterede tællere beskriver display-listens malings-selektion
• Den indlæste THotPDF-instans og annullerings-tokenet skal forblive i live, indtil sessionen frigøres

Related APIs

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