IWICPlanarBitmapSourceTransform::D oesSupportTransform 메서드(wincodec.h)

  • 아티클

이 메서드를 사용하여 원하는 평면 출력이 지원되는지 확인하고 호출자가 최적화된 코드 경로(있는 경우)를 선택할 수 있도록 합니다. 그렇지 않으면 호출자가 IWICBitmapSourceTransform 또는 IWICBitmapSource 로 대체되고 인터리브된 픽셀을 검색해야 합니다.

다음 변환을 확인할 수 있습니다.

  • 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 평면은 chroma 하위 샘플링으로 인해 puiWidth 및 puiHeight 에서 반환된 값과 다른 크기일 수 있습니다.

cPlanes

형식: UINT

요청된 구성 요소 평면의 수입니다.

[out] pfIsSupported

형식: BOOL*

요청된 변환이 기본적으로 지원되는 경우 TRUE로 설정합니다.

반환 값

형식: HRESULT

pfIsSupported 값을 확인하여 변환이 IWICPlanarBitmapSourceTransform::CopyPixels를 통해 지원되는지 확인합니다. 이 메서드가 실패하면 너비, 높이 및 평면 설명에 대한 출력 매개 변수가 0으로 초기화됩니다. 다른 반환 값은 실패를 나타냅니다.

요구 사항

요구 사항 값
지원되는 최소 클라이언트 Windows 8.1 [데스크톱 앱 | UWP 앱]
지원되는 최소 서버 Windows Server 2012 R2 [데스크톱 앱 | UWP 앱]
대상 플랫폼 Windows
헤더 wincodec.h
라이브러리 Windowscodecs.lib
DLL Windowscodecs.dll

추가 정보

IWICPlanarBitmapSourceTransform

IWicPlanarBitmapSourceTransform::CopyPixels

WICBitmapPlaneDescription

WICBitmapTransformOptions

WICPlanarOptions