THPDFLoadedPageRenderSession Class

Пази състоянието на render и жив частичен битмап, така че заредена страница да се рендира през няколко ограничени извиквания

Декларация

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

Статусни стойности

• prsReady означава, че страницата е инициализирана и не е изпълнен нито един content оператор
• prsPaused означава, че budget е свършил, преди всички оператори да са завършили
• prsCompleted означава, че пълният страничен битмап е наличен
• prsCancelled означава, че callback-ът или token-ът е спрял сесията на операторна граница

Бележки за употреба

• Всеки от двата budget може да е нула за неограничена работа, а при две нули извикването върви до терминално състояние в едно извикване
• Bitmap остава собственост на сесията и е предназначен за preview достъп само за четене
• TakeBitmap е валиден само в терминално състояние и прехвърля собствеността на повикващия
• ProgressiveJPEGScansDecoded и ProgressiveJPEGImagesDecoded броят успешната incremental image работа, а OnProgressiveJPEGScan може да отмени след видим scan
• IsRegionRender идентифицира ROI сесии; свойствата за област пазат исканите user-space граници, а броячите за видими и отрязани обекти описват подбора на рисуване от display-list
• Заредената THotPDF инстанция и cancellation token трябва да останат живи, докато сесията не бъде освободена

Свързани API

• THotPDF.BeginLoadedPageProgressiveRender
• THotPDF.BeginLoadedPageProgressiveRegionRender
• THPDFCancellationToken
• Прогресивно рендиране и отмяна