THPDFLoadedPageRenderSession Class

Zadržava stanje renderovanja stranice i živi delimični bitmap da bi se učitana stranica mogla iscrtati kroz više ograničenih poziva

Deklaracija

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;

Jedinica

HPDFDoc

Vrednosti statusa

• prsReady znači da je stranica inicijalizovana i da nijedan operator sadržaja nije izvršen
• prsPaused znači da se budžet završio pre nego što su svi operatori obavljeni
• prsCompleted znači da je kompletan bitmap stranice dostupan
• prsCancelled znači da je callback ili token zaustavio sesiju na granici operatora

Napomene o upotrebi

• Bilo koji budžet može biti nula za neograničen rad, a kada su oba nula, izvršava se do terminalnog stanja u jednom pozivu
• Bitmap ostaje u vlasništvu sesije i namenjen je pristupu samo za čitanje u pregledu
• TakeBitmap je važeći samo u terminalnom stanju i prenosi vlasništvo na pozivaoca
• ProgressiveJPEGScansDecoded i ProgressiveJPEGImagesDecoded broje uspešne inkrementalne poslove sa slikama, dok OnProgressiveJPEGScan može otkazati nakon vidljivog skena
• IsRegionRender identifikuje ROI sesije; svojstva regiona zadržavaju tražene granice u korisničkom prostoru, a brojači vidljivih i odbačenih objekata opisuju odabir elemenata za iscrtavanje
• Učitana instanca THotPDF i token za otkazivanje moraju ostati živi dok sesija ne bude oslobođena

Povezani API-ji

• THotPDF.BeginLoadedPageProgressiveRender
• THotPDF.BeginLoadedPageProgressiveRegionRender
• THPDFCancellationToken
• Progresivno renderovanje i otkazivanje