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 |