THPDFLoadedPageRenderSession Class

Retém o estado de renderização da página e um bitmap parcial ativo para que uma página carregada possa ser renderizada em 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

Valores de status

• prsReady significa que a página está inicializada e nenhum operador de conteúdo foi executado
• prsPaused significa que um orçamento terminou antes que todos os operadores fossem concluídos
• prsCompleted significa que o bitmap completo da página está disponível
• prsCancelled significa que o callback ou token interrompeu a sessão em um limite de operador

Notas de uso

• Qualquer orçamento pode ser zero para trabalho ilimitado, enquanto ambos os valores zero executam até um estado terminal em uma chamada
• Bitmap permanece de propriedade da sessão e destina-se a acesso de visualização somente leitura
• TakeBitmap é válido apenas em um estado terminal e transfere a propriedade ao chamador
• ProgressiveJPEGScansDecoded e ProgressiveJPEGImagesDecoded contam trabalho incremental de imagem bem-sucedido, enquanto OnProgressiveJPEGScan pode cancelar após uma varredura visível
• IsRegionRender identifica sessões de ROI; as propriedades de região retêm os limites solicitados no espaço do usuário e os contadores visíveis e descartados descrevem a seleção de pintura da lista de exibição
• A instância THotPDF carregada e o token de cancelamento devem permanecer vivos até que a sessão seja liberada

APIs relacionadas

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