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 |