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

Habilita la indexación de JPEG para un acceso aleatorio eficaz.

Sintaxis

HRESULT SetIndexing(
  WICJpegIndexingOptions options,
  UINT                   horizontalIntervalSize
);

Parámetros

options

Tipo: WICJpegIndexingOptions

Valor que especifica si los índices se deben generar inmediatamente o aplazar hasta una llamada futura a IWICBitmapSource::CopyPixels.

horizontalIntervalSize

Tipo: UINT

Granularidad de la indexación, en píxeles.

Valor devuelto

Tipo: HRESULT

Devuelve S_OK después de completarse correctamente.

Comentarios

Este método permite un acceso aleatorio eficaz a los píxeles de imagen a costa del uso de memoria. La cantidad de memoria necesaria para la indexación depende de la granularidad del índice solicitada. A menos que se llame a SetIndexing , es mucho más eficaz acceder a un JPEG avanzando por sus píxeles de arriba abajo durante las llamadas a IWICBitmapSource::CopyPixels.

Este método producirá un error si no se admite la indexación en el archivo. Se debe llamar a IWICJpegFrameDecode::D oesSupportIndexing para determinar primero si se admite la indexación. Si se llama a este método varias veces, la llamada final cambia la granularidad del índice al tamaño solicitado.

El tamaño del intervalo proporcionado controla el espaciado horizontal de las entradas de índice. Este valor se redondea internamente según el tamaño de MCU (unidad codificada mínima) de JPEG, que normalmente es de 8 o 16 píxeles sin escala. El tamaño vertical del intervalo de índice siempre es igual a un tamaño de MCU.

Los índices se pueden generar inmediatamente o durante futuras llamadas a IWICBitmapSource::CopyPixels para reducir el trabajo de descompresión redundante.

Requisitos

Requisito	Value
Cliente mínimo compatible	Windows 10 [solo aplicaciones de escritorio]
Servidor mínimo compatible	Windows Server 2016 [solo aplicaciones de escritorio]
Plataforma de destino	Windows
Encabezado	wincodec.h
Library	Windowscodecs.lib
Archivo DLL	Windowscodecs.dll

Consulte también

IWICBitmapSource::CopyPixels

IWICJpegFrameDecode

IWICJpegFrameDecode::ClearIndexing

IWICJpegFrameDecode::D oesSupportIndexing