THPDFLoadedPageRenderSession Class

Retém o estado de renderização da página e um bitmap parcial em uso, para que uma página carregada possa ser renderizada ao longo de várias chamadas limitadas

Declaração

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;

Unidade

HPDFDoc

Status values

• prsReady significa que a página está inicializada e que nenhum operador de conteúdo foi executado
• prsPaused means a budget ended before all operators completed
• prsCompleted significa que o bitmap completo da página está disponível
• prsCancelled significa que o callback ou o token parou a sessão numa fronteira de operador

Notas de utilização

• Qualquer dos orçamentos pode ser zero para trabalho ilimitado, e com ambos a zero a sessão corre até um estado terminal numa só chamada
• Bitmap continua a pertencer à sessão e destina-se a acesso de pré-visualização só de leitura
• TakeBitmap só é válido num estado terminal e transfere a propriedade para o chamador
• ProgressiveJPEGScansDecoded e ProgressiveJPEGImagesDecoded count successful incremental image work, while OnProgressiveJPEGScan can cancel after a visible scan
• IsRegionRender identifica as sessões de ROI; as propriedades da região mantêm os limites pedidos no espaço de utilizador e os contadores de visíveis e de descartados descrevem a seleção de pintura da display list
• A instância carregada de THotPDF e o token de cancelamento têm de permanecer vivos até a sessão ser libertada

APIs relacionadas

• THotPDF.BeginLoadedPageProgressiveRender
• THotPDF.BeginLoadedPageProgressiveRegionRender
• THPDFCancellationToken
• Renderização progressiva e cancelamento