Метод IWICPlanarBitmapSourceTransform::D oesSupportTransform (wincodec.h)

Статья
03/13/2024

Используйте этот метод, чтобы определить, поддерживаются ли требуемые планарные выходные данные, и разрешить вызывающему объекту выбрать оптимизированный путь к коду, если это так. В противном случае вызывающие объекты должны вернуться к IWICBitmapSourceTransform или IWICBitmapSource и получить пиксели с чередованием.

Можно проверить следующие преобразования:

Определите, поддерживается ли параметр flip/rotate, указанный с помощью WICBitmapTransformOptions .
Определите, поддерживается ли запрошенная конфигурация формата плоского пикселя.
Определите ближайшие измерения, в которые реализация может изначально масштабироваться с учетом требуемых измерений.

Если преобразование поддерживается, этот метод возвращает описание результирующей плоскости в параметре pPlaneDescriptions .

Синтаксис

HRESULT DoesSupportTransform(
  [in, out] UINT                      *puiWidth,
  [in, out] UINT                      *puiHeight,
            WICBitmapTransformOptions dstTransform,
            WICPlanarOptions          dstPlanarOptions,
  [in]      const WICPixelFormatGUID  *pguidDstFormats,
  [out]     WICBitmapPlaneDescription *pPlaneDescriptions,
            UINT                      cPlanes,
  [out]     BOOL                      *pfIsSupported
);

Параметры

[in, out] puiWidth

Тип: UINT*

На входных данных — требуемая ширина. В выходных данных — наиболее близкая поддерживаемая ширина к нужной ширине; это тот же размер или больше требуемой ширины.

[in, out] puiHeight

Тип: UINT*

На входных данных — требуемая высота. В выходных данных — ближайшая поддерживаемая высота к нужной высоте; это тот же размер или больше требуемой ширины.

dstTransform

Тип: WICBitmapTransformOptions

Требуемая операция поворота или переворачивания. В этом параметре флага можно объединить несколько параметров WICBitmapTransformOptions . См. раздел WICBitmapTransformOptions.

dstPlanarOptions

Тип: WICPlanarOptions

Используется для указания дополнительных параметров конфигурации для преобразования. Дополнительные сведения см. в разделе WICPlanarOptions .

Декодер WIC JPEG:

WiCPlanarOptionsPreserveSubsampling можно указать, чтобы сохранить коэффициенты подраспределения при уменьшении масштабирования. По умолчанию декодер JPEG пытается сохранить качество, уменьшая масштабирование только плоскости Y, в некоторых случаях изменяя изображение на 4:4:4 хрома.

[in] pguidDstFormats

Тип: const WICPixelFormatGUID*

Запрошенные форматы пикселей соответствующих плоскостей.

[out] pPlaneDescriptions

Тип: WICBitmapPlaneDescription*

Если *pfIsSupported == TRUE, массив описаний плоскости содержит размер и формат каждой плоскости.

Декодер WIC JPEG. Плоскости Cb и Cr могут отличаться от значений, возвращаемых puiWidth и puiHeight из-за хрома подвыборки.

cPlanes

Тип: UINT

Количество запрошенных плоскостей компонентов.

[out] pfIsSupported

Тип: BOOL*

Задайте значение TRUE, если запрошенные преобразования поддерживаются изначально.

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

Тип: HRESULT

Проверьте значение pfIsSupported , чтобы определить, поддерживается ли преобразование через IWICPlanarBitmapSourceTransform::CopyPixels. Если этот метод завершается сбоем, выходные параметры для описаний ширины, высоты и плоскости инициализируются нулевым образом. Другие возвращаемые значения указывают на сбой.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1 [классические приложения \| Приложения UWP]
Минимальная версия сервера	Windows Server 2012 R2 [классические приложения \| Приложения UWP]
Целевая платформа	Windows
Header	wincodec.h
Библиотека	Windowscodecs.lib
DLL	Windowscodecs.dll

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

IWICPlanarBitmapSourceTransform

IWicPlanarBitmapSourceTransform::CopyPixels

WICBitmapPlaneDescription

WICBitmapTransformOptions

Поделиться через