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

아티클
08/23/2023

큐브 텍스처 리소스를 만듭니다.

구문

HRESULT CreateCubeTexture(
  [in]          UINT                  EdgeLength,
  [in]          UINT                  Levels,
  [in]          DWORD                 Usage,
  [in]          D3DFORMAT             Format,
  [in]          D3DPOOL               Pool,
  [out, retval] IDirect3DCubeTexture9 **ppCubeTexture,
  [in]          HANDLE                *pSharedHandle
);

매개 변수

[in] EdgeLength

형식: UINT

큐브 텍스처의 모든 최상위 면 가장자리 크기입니다. 각 얼굴의 후속 수준의 픽셀 차원은 이전 수준의 픽셀 차원의 절반에 대한 잘린 값입니다(독립적으로). 각 차원은 1픽셀 크기로 고정됩니다. 따라서 2로 나누면 0이 되고 1이 대신 수행됩니다.

[in] Levels

형식: UINT

큐브 텍스처의 각 면에 있는 수준 수입니다. 이 값이 0이면 Direct3D는 mipmapped 큐브 텍스처를 지원하는 하드웨어에 대해 각 얼굴에 대해 1x1 픽셀까지 모든 큐브 텍스처를 생성합니다. IDirect3DBaseTexture9::GetLevelCount를 호출하여 생성된 수준 수를 확인합니다.

[in] Usage

형식: DWORD

사용량 값이 없음을 나타내는 0일 수 있습니다. 그러나 사용이 필요한 경우 하나 이상의 D3DUSAGE 상수 조합을 사용합니다. CreateCubeTexture의 사용 매개 변수를 IDirect3D9::CreateDevice의 동작 플래그와 일치시킬 수 있습니다. 자세한 내용은 설명 부분을 참조하세요.

[in] Format

형식: D3DFORMAT

큐브 텍스처의 모든 면에 있는 모든 수준의 형식을 설명하는 D3DFORMAT 열거형 형식의 멤버입니다.

[in] Pool

형식: D3DPOOL

큐브 텍스처를 배치해야 하는 메모리 클래스를 설명하는 D3DPOOL 열거형 형식의 멤버입니다.

[out, retval] ppCubeTexture

형식: IDirect3DCubeTexture9**

생성된 큐브 텍스처 리소스를 나타내는 IDirect3DCubeTexture9 인터페이스에 대한 포인터의 주소입니다.

[in] pSharedHandle

형식: HANDLE*

예약되어 있습니다. 이 매개 변수를 NULL로 설정합니다. 이 매개 변수는 Windows Vista용 Direct3D 9에서 리소스를 공유하는 데 사용할 수 있습니다.

반환 값

형식: HRESULT

메서드가 성공하면 반환 값이 D3D_OK. 메서드가 실패하면 반환 값은 D3DERR_INVALIDCALL, D3DERR_OUTOFVIDEOMEMORY, E_OUTOFMEMORY 중 하나일 수 있습니다.

설명

밉맵(텍스처)은 연속적으로 다운샘플링(mipmapped) 표면의 컬렉션입니다. 반면에 큐브 텍스처( IDirect3DDevice9::CreateCubeTexture에서 생성됨)는 얼굴마다 하나씩 6개의 텍스처(Mipmap)로 구성된 컬렉션입니다. 모든 얼굴은 큐브 텍스처에 있어야 합니다. 또한 큐브 맵 표면은 세 가지 차원(x, y 및 z)에서 동일한 픽셀 크기여야 합니다.

애플리케이션은 D3DUSAGE_AUTOGENMIPMAP 사용하여 IDirect3D9::CheckDeviceFormat을 호출하여 특정 형식의 Mipmap 자동 생성(Direct3D 9)에 대한 지원을 검색할 수 있습니다. IDirect3D9::CheckDeviceFormat이 D3DOK_NOAUTOGEN 반환하는 경우 IDirect3DDevice9::CreateCubeTexture는 성공하지만 한 수준 텍스처를 반환합니다.