Метод IWICJpegFrameDecode::SetIndexing (wincodec.h)

  • Статья

Включает индексирование JPEG для эффективного произвольного доступа.

Синтаксис

HRESULT SetIndexing(
  WICJpegIndexingOptions options,
  UINT                   horizontalIntervalSize
);

Параметры

options

Тип: WICJpegIndexingOptions

Значение, указывающее, следует ли создавать индексы немедленно или отложить до будущего вызова 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

См. также раздел

IWICBitmapSource::CopyPixels

IWICJpegFrameDecode

IWICJpegFrameDecode::ClearIndexing

IWICJpegFrameDecode::D oesSupportIndexing