Método IWICJpegFrameDecode::SetIndexing (wincodec.h)

Habilita a indexação do JPEG para acesso aleatório eficiente.

Sintaxe

HRESULT SetIndexing(
  WICJpegIndexingOptions options,
  UINT                   horizontalIntervalSize
);

Parâmetros

options

Tipo: WICJpegIndexingOptions

Um valor que especifica se os índices devem ser gerados imediatamente ou adiados até uma chamada futura para IWICBitmapSource::CopyPixels.

horizontalIntervalSize

Tipo: UINT

A granularidade da indexação, em pixels.

Retornar valor

Tipo: HRESULT

Retorna S_OK após a conclusão bem-sucedida.

Comentários

Esse método permite acesso aleatório eficiente aos pixels de imagem em detrimento do uso de memória. A quantidade de memória necessária para indexação depende da granularidade de índice solicitada. A menos que SetIndexing seja chamado, é muito mais eficiente acessar um JPEG progredindo por meio de seus pixels de cima para baixo durante chamadas para IWICBitmapSource::CopyPixels.

Esse método falhará se a indexação não tiver suporte no arquivo. IWICJpegFrameDecode::D oesSupportIndexing deve ser chamado para determinar primeiro se há suporte para indexação. Se esse método for chamado várias vezes, a chamada final alterará a granularidade do índice para o tamanho solicitado.

O tamanho do intervalo fornecido controla o espaçamento horizontal das entradas de índice. Esse valor é arredondado internamente de acordo com o tamanho de MCU (unidade codificada mínima) do JPEG, que normalmente é de 8 ou 16 pixels não dimensionados. O tamanho vertical do intervalo de índice é sempre igual a um tamanho de MCU.

Os índices podem ser gerados imediatamente ou durante chamadas futuras para IWICBitmapSource::CopyPixels para reduzir o trabalho de descompactação redundante.

Requisitos

Requisito	Valor
Cliente mínimo com suporte	Windows 10 [somente aplicativos da área de trabalho]
Servidor mínimo com suporte	Windows Server 2016 [somente aplicativos da área de trabalho]
Plataforma de Destino	Windows
Cabeçalho	wincodec.h
Biblioteca	Windowscodecs.lib
DLL	Windowscodecs.dll

Confira também

IWICBitmapSource::CopyPixels

IWICJpegFrameDecode

IWICJpegFrameDecode::ClearIndexing

IWICJpegFrameDecode::D oesSupportIndexing