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

아티클
03/05/2024

디바이스의 스테이지에 텍스처를 할당합니다.

구문

HRESULT SetTexture(
  [in] DWORD                 Stage,
  [in] IDirect3DBaseTexture9 *pTexture
);

매개 변수

[in] Stage

형식: DWORD

0부터 시작하는 샘플러 번호입니다. 텍스처는 샘플러에 바인딩됩니다. 샘플러가 필터링 모드 및 주소 래핑 모드와 같은 샘플링 상태를 정의합니다. 텍스처는 프로그래밍 가능 및 고정 함수 파이프라인에서 다르게 참조됩니다.

프로그래밍 가능한 셰이더는 샘플러 번호를 사용하여 텍스처를 참조합니다. 프로그래밍 가능한 셰이더에 사용할 수 있는 샘플러의 수는 셰이더 버전에 따라 달라집니다. 꼭짓점 셰이더는 샘플러(Direct3D 9 asm-vs)를 참조하세요. 픽셀 셰이더의 경우 샘플러(Direct3D 9 asm-ps)를 참조하세요.
반면에 고정 함수 파이프라인은 텍스처 스테이지 번호별로 텍스처를 참조합니다. 샘플러의 최대 수는 D3DCAPS9 구조체 의 MaxSimultaneousTextures 및 MaxTextureBlendStages라는 두 개의 대문자에서 결정됩니다.

스테이지/샘플러 번호에는 두 가지 다른 특수 사례가 있습니다.

D3DDMAPSAMPLER 라는 특수 번호는 변위 매핑(Direct3D 9)에 사용됩니다.
프로그래밍 가능한 꼭짓점 셰이더는 vs_3_0(DirectX HLSL)에서 꼭짓점 텍스처에 액세스할 때 D3DVERTEXTEXTURESAMPLER 정의된 특수 번호를 사용합니다.

[in] pTexture

형식: IDirect3DBaseTexture9*

설정되는 텍스처를 나타내는 IDirect3DBaseTexture9 인터페이스에 대한 포인터입니다.

반환 값

형식: HRESULT

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

설명

풀 형식의 D3DPOOL_SCRATCH 사용하여 텍스처를 만드는 경우 SetTexture를 사용할 수 없습니다. DevCaps를 D3DDEVCAPS_TEXTURESYSTEMMEMORY 사용하여 설정하지 않는 한 SetTexture는 풀 형식의 D3DPOOL_SYSTEMMEM 텍스처에서 허용되지 않습니다.