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

  • Статья

Кодирует источник растрового изображения.

Синтаксис

HRESULT WriteSource(
  [in] IWICBitmapSource *pIBitmapSource,
  [in] WICRect          *prc
);

Параметры

[in] pIBitmapSource

Тип: IWICBitmapSource*

Источник точечных рисунков для кодирования.

[in] prc

Тип: WICRect*

Прямоугольник размера источника растрового изображения.

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

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Комментарии

Если метод SetSize не вызывается до вызова WriteSource, размер, заданный в prc , используется, если значение не равно NULL. В противном случае используется размер IWICBitmapSource , заданный в pIBitmapSource .

Если метод SetPixelFormat не вызывается до вызова WriteSource, используется формат пикселей IWICBitmapSource , заданный в pIBitmapSource .

Если метод SetResolution не вызывается до вызова WriteSource, используется формат пикселей pIBitmapSource .

Если метод SetPalette не вызывается до вызова WriteSource, целевой формат пикселей индексируется, а формат пикселей pIBitmapSource соответствует формату пикселей кадра кодировщика, используется формат пикселей pIBitmapSource .

Если при кодировании изображения GIF задана глобальная палитра, а палитра уровня кадра не задана непосредственно пользователем или пользовательским независимым поставщиком программного обеспечения (ISV), WriteSource будет использовать глобальную палитру для кодирования кадра, даже если pIBitmapSource имеет палитру уровня кадра.

Начиная с Windows Vista, можно выполнять повторяющиеся вызовы WriteSource , если общая собранная высота исходного прямоугольника совпадает с заданной с помощью SetSize.

Начиная с Windows 8.1, исходный прямоугольник должен быть по крайней мере измерениями, заданными в SetSize. Если ширина исходного прямоугольника превышает ширину SetSize , дополнительные пиксели справа игнорируются. Если высота исходного прямоугольника превышает оставшуюся незаполненную высоту, дополнительные строки сканирования в нижней части игнорируются.

Требования

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

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

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

Написание кодека WIC-Enabled

IWICBitmapFrameEncode

Общие сведения о компоненте обработки образов Windows