IDirect3DDevice9::SetPaletteEntries 메서드(d3d9helper.h)

아티클
08/23/2023

색상표 항목을 설정합니다.

구문

HRESULT SetPaletteEntries(
  [in] UINT               PaletteNumber,
  [in] const PALETTEENTRY *pEntries
);

매개 변수

[in] PaletteNumber

형식: UINT

작업을 수행할 특정 팔레트를 식별하는 서수 값입니다.

[in] pEntries

형식: const PALETTEENTRY*

설정할 팔레트 항목을 나타내는 PALETTEENTRY 구조체에 대한 포인터입니다. pEntries가 가리키는 PALETTEENTRY 구조체의 수는 256으로 간주됩니다. 설명 부분을 참조하세요.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값을 D3DERR_INVALIDCALL 수 있습니다.

설명

Direct3D 9 애플리케이션의 경우 이 메서드로 전송되는 모든 팔레트는 D3DCAPS9 구조체의 D3DPTEXTURECAPS_ALPHAPALETTE 기능 비트를 준수해야 합니다. D3DPTEXTURECAPS_ALPHAPALETTE 설정되지 않은 경우 팔레트의 모든 항목에 알파가 1.0으로 설정되어 있어야 합니다. 그렇지 않으면 이 메서드는 D3DERR_INVALIDCALL 실패합니다. D3DPTEXTURECAPS_ALPHAPALETTE 설정되면 모든 알파 값 집합이 허용됩니다. 모든 팔레트 항목에 알파가 0으로 설정된 경우 디버그 런타임은 경고 메시지를 출력합니다.

단일 논리 팔레트는 디바이스와 연결되며 모든 텍스처 단계에서 공유됩니다.