IWICBitmapFrameEncode::SetPalette 메서드(wincodec.h)

인덱싱된 픽셀 형식의 IWICPalette 를 설정합니다.

구문

HRESULT SetPalette(
  [in] IWICPalette *pIPalette
);

매개 변수

[in] pIPalette

형식: IWICPalette*

인덱싱된 픽셀 형식에 사용할 IWICPalette 입니다.

인코더는 인코더가 지원하는 픽셀 형식을 반영하도록 색상표를 변경할 수 있습니다.

반환 값

형식: HRESULT

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

설명

픽셀 형식이 인덱싱되지 않은 픽셀 형식으로 설정된 프레임에서 호출되는 경우 이 메서드는 실패하지 않습니다. 대상 픽셀 형식이 인덱싱되지 않은 형식이면 색상표는 무시됩니다.

이미 IWICBitmapEncoder::SetPalette 를 호출하여 전역 팔레트를 설정한 경우 이 메서드는 현재 프레임에 대해 해당 팔레트를 재정의합니다.

WritePixels/WriteSource를 처음 호출하기 전에 팔레트를 지정해야 합니다. 이렇게 하면 원본 이미지를 인코더 픽셀 형식으로 변환할 때 WriteSource 가 지정된 팔레트를 사용합니다. 색상표를 지정하지 않으면 WriteSource에 대한 첫 번째 호출에서 색상표가 생성됩니다.

요구 사항

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