IWICBitmapSourceTransform::CopyPixels 메서드(wincodec.h)

아티클
08/27/2023

제공된 입력 매개 변수를 사용하여 픽셀 데이터를 복사합니다.

구문

HRESULT CopyPixels(
  [in]  const WICRect             *prc,
  [in]  UINT                      uiWidth,
  [in]  UINT                      uiHeight,
  [in]  WICPixelFormatGUID        *pguidDstFormat,
  [in]  WICBitmapTransformOptions dstTransform,
  [in]  UINT                      nStride,
  [in]  UINT                      cbBufferSize,
  [out] BYTE                      *pbBuffer
);

매개 변수

[in] prc

형식: const WICRect*

복사할 픽셀의 사각형입니다.

[in] uiWidth

형식: UINT

원본 비트맵의 크기를 조정할 너비입니다. 이 매개 변수는 IWICBitmapSourceTransform::GetClosestSize를 통해 얻을 수 있는 값과 같아야 합니다.

[in] uiHeight

형식: UINT

원본 비트맵의 크기를 조정할 높이입니다. 이 매개 변수는 IWICBitmapSourceTransform::GetClosestSize를 통해 얻을 수 있는 값과 같아야 합니다.

[in] pguidDstFormat

형식: WICPixelFormatGUID*

픽셀을 반환해야 하는 원하는 픽셀 형식의 GUID입니다.

이 GUID는 GetClosestPixelFormat 호출을 통해 얻은 형식이어야 합니다.

[in] dstTransform

형식: WICBitmapTransformOptions

픽셀 복사 전에 수행할 원하는 회전 또는 대칭 이동입니다.

변환은 DoesSupportTransform 호출에서 지원하는 작업이어야 합니다.

dstTransform이 지정된 경우 nStride는 변환된 보폭이며 원래 원본의 픽셀 형식이 아닌 pguidDstFormat 픽셀 형식을 기반으로 합니다.

[in] nStride

형식: UINT

대상 버퍼의 보폭입니다.

[in] cbBufferSize

형식: UINT

대상 버퍼의 크기입니다.

[out] pbBuffer

형식: BYTE*

출력 버퍼입니다.

반환 값

형식: HRESULT

메서드가 성공하면 S_OK를 반환하고, 그러지 않으면 HRESULT 오류 코드를 반환합니다.

설명

코덱 개발자 설명

prc에 대해 NULL이 전달되면 전체 이미지가 복사됩니다.

이 메서드에 대한 코덱 개발자 구현 세부 정보는 IWICBitmapSourceTransform 구현을 참조하세요.

여러 변환 작업이 요청되면 결과는 작업이 수행되는 순서에 따라 달라집니다. 코덱 전체에서 예측 가능성과 일관성을 보장하려면 모든 코덱이 동일한 순서로 이러한 작업을 수행하는 것이 중요합니다. 이러한 작업의 권장 순서는 다음과 같습니다.

확장
Crop
대칭 이동/회전

픽셀 형식 변환은 다른 변환에 영향을 주지 않으므로 언제든지 수행할 수 있습니다.

첫 번째 매개 변수 prc 는 이미지를 클리핑하기 위한 관심 영역을 지정하는 데 사용됩니다. 규칙에 따라 클리핑하기 전에 크기 조정이 수행되므로 이미지 크기를 조정하고 잘리는 경우 이미지의 크기를 조정한 후 관심 영역을 결정해야 합니다.

dstTransform을 지정하면 stride는 변환된 보폭이며 원래 프레임의 픽셀 형식이 아닌 CopyPixels 호출에 지정된 pixelFormat을 기반으로 합니다.

요구 사항

요구 사항	값
지원되는 최소 클라이언트	WINDOWS XP SP2, Windows Vista [데스크톱 앱 \| UWP 앱]
지원되는 최소 서버	Windows Server 2008 [데스크톱 앱 \| UWP 앱]
대상 플랫폼	Windows
헤더	wincodec.h
라이브러리	Windowscodecs.lib