Метод IWICBitmapFrameEncode::SetThumbnail (wincodec.h)

  • Статья

Задает эскиз кадра, если он поддерживается кодеком.

Синтаксис

HRESULT SetThumbnail(
  [in] IWICBitmapSource *pIThumbnail
);

Параметры

[in] pIThumbnail

Тип: IWICBitmapSource*

Источник растрового изображения для использования в качестве эскиза.

Возвращаемое значение

Тип: HRESULT

Возвращает S_OK в случае успешного выполнения или значение ошибки в противном случае.

Возвращает WINCODEC_ERR_UNSUPPORTEDOPERATION, если функция не поддерживается кодировщиком.

Комментарии

Рекомендуется вызвать Метод SetThumbnail перед вызовом WritePixels или WriteSource. Эскиз не будет добавлен в закодированный файл, если метод SetThumbnail вызывается после вызова WritePixels или WriteSource.

  • BMP, PNGНастройка эскизов не поддерживается. Эта функция возвращает WINCODEC_ERR_UNSUPPORTEDOPERATION.
  • JPEGНастройка эскиза поддерживается. Исходное изображение будет повторно закодировано в формате JPEG 8bpp или 24bpp и будет записано в блок метаданных APP1 JPEG.
  • TIFF Настройка эскиза поддерживается. Исходное изображение будет повторно закодировано как TIFF и будет записано в блок SubIFD кадра.
  • JPEG-XRНастройка эскиза поддерживается. Исходное изображение будет повторно закодировано как дополнительный кадр 8bpp или 24bpp.

Требования

Требование Значение
Минимальная версия клиента Windows XP с пакетом обновления 2 (SP2), Windows Vista [классические приложения | Приложения UWP]
Минимальная версия сервера Windows Server 2008 [классические приложения | Приложения UWP]
Целевая платформа Windows
Header wincodec.h
Библиотека Windowscodecs.lib
DLL Windowscodecs.dll

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

Основные понятия

Общие сведения о кодировке

Создание кодека WIC-Enabled

IWICBitmapFrameEncode