Метод IWICJpegFrameDecode::SetIndexing (wincodec.h)
Включает индексирование JPEG для эффективного произвольного доступа.
Синтаксис
HRESULT SetIndexing(
WICJpegIndexingOptions options,
UINT horizontalIntervalSize
);
Параметры
options
Значение, указывающее, следует ли создавать индексы немедленно или отложить до будущего вызова IWICBitmapSource::CopyPixels.
horizontalIntervalSize
Тип: UINT
Степень детализации индексирования в пикселях.
Возвращаемое значение
Тип: HRESULT
Возвращает S_OK после успешного завершения.
Комментарии
Этот метод обеспечивает эффективный случайный доступ к пикселям изображения за счет использования памяти. Объем памяти, необходимый для индексирования, зависит от запрошенной степени детализации индекса. Если не вызывается SetIndexing , гораздо эффективнее получить доступ к JPEG, проходя через его пиксели сверху вниз во время вызовов IWICBitmapSource::CopyPixels.
Этот метод завершится ошибкой, если индексирование в файле не поддерживается. IWICJpegFrameDecode::D oesSupportIndexing должен быть вызван, чтобы сначала определить, поддерживается ли индексирование. Если этот метод вызывается несколько раз, последний вызов изменяет степень детализации индекса на запрошенный размер.
Указанный размер интервала управляет горизонтальным интервалом для записей индекса. Это значение внутренне округляется в соответствии с размером MCU JPEG (минимальная закодированная единица), который обычно составляет 8 или 16 немасштабированных пикселей. Вертикальный размер интервала индекса всегда равен одному размеру MCU.
Индексы можно создавать немедленно или во время будущих вызовов IWICBitmapSource::CopyPixels , чтобы сократить объем избыточной распаковки.
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 10 [только классические приложения] |
| Минимальная версия сервера | Windows Server 2016 [только классические приложения] |
| Целевая платформа | Windows |
| Header | wincodec.h |
| Библиотека | Windowscodecs.lib |
| DLL | Windowscodecs.dll |