Метод IWICPlanarBitmapSourceTransform::CopyPixels (wincodec.h)
Копирует пиксели в целевые плоскости. Настраивается с помощью предоставленных входных параметров.
Если указано преобразование dstTransform, scale или format, cbStride — это преобразованный шаг, основанный на целевом формате пикселей параметра pDstPlanes , а не на формате пикселей исходного источника.
Синтаксис
HRESULT CopyPixels(
[in] const WICRect *prcSource,
UINT uiWidth,
UINT uiHeight,
WICBitmapTransformOptions dstTransform,
[in] WICPlanarOptions dstPlanarOptions,
const WICBitmapPlane *pDstPlanes,
UINT cPlanes
);
Параметры
[in] prcSource
Тип: const WICRect*
Исходный прямоугольник пикселей для копирования.
uiWidth
Тип: UINT
Ширина для масштабирования исходного растрового изображения. Этот параметр должен быть равен значению, которое можно получить с помощью IWICPlanarBitmapSourceTransform:: DoesSupportTransform.
uiHeight
Тип: UINT
Высота для масштабирования исходного растрового изображения. Этот параметр должен быть равен значению, которое можно получить с помощью IWICPlanarBitmapSourceTransform:: DoesSupportTransform.
dstTransform
Тип: WICBitmapTransformOptions
Требуемый поворот или пролистывание, выполняемые перед копированием пикселей. Поворот можно сочетать с горизонтальным или вертикальным отражением. См. статью WICBitmapTransformOptions.
[in] dstPlanarOptions
Тип: const WICPlanarOptions
Используется для указания дополнительных параметров конфигурации для преобразования. Дополнительные сведения см. в разделе WICPlanarOptions .
Декодер WIC JPEG. WiCPlanarOptionsPreserveSubsampling можно указать для сохранения коэффициентов подраспределения при уменьшении масштабирования. По умолчанию декодер JPEG пытается сохранить качество, уменьшая масштабирование только плоскости Y, в некоторых случаях изменяя изображение на 4:4:4 хрома.
pDstPlanes
Тип: WICBitmapPlane
Задает формат пикселей и выходной буфер для каждой плоскости компонента. Число плоскостей и формат пикселей каждой плоскости должны соответствовать значениям, которые можно получить с помощью IWICPlanarBitmapSourceTransform::D oesSupportTransform.
cPlanes
Тип: UINT
Количество плоскостей компонентов, заданное параметром pDstPlanes .
Возвращаемое значение
Тип: HRESULT
Если заданная конфигурация масштабирования, переворачивания/поворота и плоского формата не поддерживается, этот метод завершается сбоем с WINCODEC_ERR_INVALIDPARAMETER. Можно проверка, поддерживается ли преобразование, вызвав IWICPlanarBitmapSourceTransform::D oesSupportTransform.
Комментарии
Декодер WIC JPEG. В зависимости от настроенной подвыборки chroma изображения исходный прямоугольник имеет следующие ограничения:
| Chroma Subsampling | Координата X | Координата Y | Ширина хрома | Высота хрома |
|---|---|---|---|---|
| 4:2:0 | Кратный из 2 | Кратный из 2 | lumaWidth / 2 округляется до ближайшего целого числа. | lumaHeight / 2 округляется до ближайшего целого числа. |
| 4:2:2 | Кратный из 2 | Любой | lumaWidth / 2 округляется до ближайшего целого числа. | lumaHeight |
| 4:4:4 | Любой | Любой | llumaWidth | llumaHeight |
| 4:4:0 | Любой | Кратный из 2 | lumaWidth | llumaHeight / 2 округляется до ближайшего целого числа. |
Параметр pDstPlanes поддерживает следующие форматы пикселей.
| Число плоскостей | Плоскость 1 | Плоскость 2 | Плоскость 3 |
|---|---|---|---|
| 3 | GUID_WICPixelFormat8bppY | GUID_WICPixelFormat8bppCb | GUID_WICPixelFormat8bppCr |
| 2 | GUID_WICPixelFormat8bppY | GUID_WICPixelFormat16bppCbCr | Н/Д |
Требования
| Требование | Значение |
|---|---|
| Минимальная версия клиента | Windows 8.1 [классические приложения | Приложения UWP] |
| Минимальная версия сервера | Windows Server 2012 R2 [классические приложения | Приложения UWP] |
| Целевая платформа | Windows |
| Header | wincodec.h |
| Библиотека | Windowscodecs.lib |
| DLL | Windowscodecs.dll |