THPDFLoadedPageRenderSession Class

Przechowuje stan renderowania strony i żywą częściową bitmapę, dzięki czemu załadowaną stronę można renderować w wielu ograniczonych wywołaniach

Deklaracja

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;

Jednostka

HPDFDoc

Wartości statusu

• prsReady oznacza, że strona jest zainicjalizowana i żaden operator treści nie został jeszcze wykonany
• prsPaused oznacza, że budżet wyczerpał się, zanim wszystkie operatory zostały ukończone
• prsCompleted oznacza, że kompletna bitmapa strony jest dostępna
• prsCancelled oznacza, że callback lub token zatrzymał sesję na granicy operatora

Uwagi dotyczące użycia

• Każdy z budżetów może być zerowy dla nieograniczonej pracy, natomiast oba zera prowadzą jednym wywołaniem do stanu końcowego
• Bitmap pozostaje własnością sesji i jest przeznaczona do podglądowego dostępu tylko do odczytu
• TakeBitmap jest poprawne tylko w stanie końcowym i przenosi własność na wywołującego
• ProgressiveJPEGScansDecoded i ProgressiveJPEGImagesDecoded liczą udaną pracę przyrostową nad obrazami, a OnProgressiveJPEGScan pozwala anulować po widocznym skanie
• IsRegionRender identyfikuje sesje ROI; właściwości regionu zachowują żądane granice w przestrzeni użytkownika, a liczniki widocznych i wyciętych obiektów opisują dobór malowania z listy wyświetlania
• Załadowana instancja THotPDF i token anulowania muszą pozostać żywe do czasu zwolnienia sesji

Powiązane API

• THotPDF.BeginLoadedPageProgressiveRender
• THotPDF.BeginLoadedPageProgressiveRegionRender
• THPDFCancellationToken
• Renderowanie progresywne i anulowanie