Метод 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

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

IWICPlanarBitmapSourceTransform