Метод 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 |
См. также раздел
Основные понятия