THPDFLoadedPageRenderSession Class

Behoudt de paginarendstatus en een levende gedeeltelijke bitmap, zodat een geladen pagina over meerdere begrensde aanroepen kan worden gerenderd

Declaratie

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;

Eenheid

HPDFDoc

Statuswaarden

• prsReady betekent dat de pagina is geïnitialiseerd en nog geen contentoperator is uitgevoerd
• prsPaused betekent dat een budget eindigde voordat alle operators waren voltooid
• prsCompleted betekent dat de volledige pagina-bitmap beschikbaar is
• prsCancelled betekent dat de callback of het token de sessie op een operatorgrens stopte

Gebruiksopmerkingen

• Een van beide budgets kan nul zijn voor onbeperkt werk, terwijl beide nul in één aanroep naar een terminalstatus gaan
• Bitmap blijft eigendom van de sessie en is bedoeld voor alleen-lezen voorbeeldtoegang
• TakeBitmap is alleen geldig in een terminalstatus en draagt het eigendom over aan de aanroeper
• ProgressiveJPEGScansDecoded en ProgressiveJPEGImagesDecoded tellen geslaagd incrementeel afbeeldingswerk, terwijl OnProgressiveJPEGScan na een zichtbare scan kan annuleren
• IsRegionRender identificeert ROI-sessies; de regio-eigenschappen behouden de aangevraagde gebruikersruimtegrenzen en de tellers voor zichtbare en geculled beschrijven de selectie van display-list-verf
• De geladen THotPDF-instantie en het annuleringstoken moeten in leven blijven totdat de sessie is vrijgemaakt

Gerelateerde API's

• THotPDF.BeginLoadedPageProgressiveRender
• THotPDF.BeginLoadedPageProgressiveRegionRender
• THPDFCancellationToken
• Voortschrijdende rendering en annulering