THPDFLoadedPageRenderSession Třída

Uchovává stav renderu stránky a živou částečnou bitmapu, takže načtenou stránku lze vyrenderovat ve více ohraničených voláních

Deklarace

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;

Jednotka

HPDFDoc

Hodnoty stavu

• prsReady znamená, že stránka je inicializována a neproběhl žádný operátor obsahu
• prsPaused znamená, že rozpočet skončil dříve, než se dokončily všechny operátory
• prsCompleted znamená, že je k dispozici kompletní bitmapa stránky
• prsCancelled znamená, že callback nebo token zastavily relaci na hranici operátoru

Poznámky k použití

• Oba rozpočty mohou být pro neomezenou práci nula, přičemž obě nulové hodnoty spustí v jednom volání koncový stav
• Bitmap zůstává vlastnictvím relace a je určena pro přístup k náhledu pouze pro čtení
• TakeBitmap je platná pouze v koncovém stavu a převádí vlastnictví na volajícího
• ProgressiveJPEGScansDecoded a ProgressiveJPEGImagesDecoded počítají úspěšnou inkrementální práci s obrázkem, zatímco OnProgressiveJPEGScan může zrušit po viditelném skenu
• IsRegionRender identifikuje relace ROI; vlastnosti oblasti zachovávají požadované hranice uživatelského prostoru a viditelné i odfiltrované čítače popisují výběr malby v seznamu zobrazení
• Načtená instance THotPDF a token zrušení musí zůstat naživu, dokud není relace uvolněna

Související API

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