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 chroma 하위 샘플링으로 변경합니다.

pDstPlanes

형식: WICBitmapPlane

각 구성 요소 평면에 대한 픽셀 형식 및 출력 버퍼를 지정합니다. 각 평면의 평면 수와 픽셀 형식은 IWICPlanarBitmapSourceTransform::D oesSupportTransform을 통해 얻을 수 있는 값과 일치해야 합니다.

cPlanes

형식: UINT

pDstPlanes 매개 변수로 지정된 구성 요소 평면의 수입니다.

반환 값

형식: HRESULT

지정된 배율, 대칭 이동/회전 및 평면 형식 구성이 지원되지 않는 경우 이 메서드는 WINCODEC_ERR_INVALIDPARAMETER 함께 실패합니다. IWICPlanarBitmapSourceTransform::D oesSupportTransform을 호출하여 변환이 지원되는지 검사 수 있습니다.

설명

WIC JPEG 디코더: 이미지의 구성된 크로마 하위 샘플링에 따라 원본 사각형에는 다음과 같은 제한이 있습니다.

크로마 하위 샘플링	X Coordinate	Y Coordinate	크로마 너비	크로마 높이
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
헤더	wincodec.h
라이브러리	Windowscodecs.lib
DLL	Windowscodecs.dll

추가 정보

IWICPlanarBitmapSourceTransform