IDirect3DDevice9::CreateCubeTexture 메서드(d3d9helper.h)
큐브 텍스처 리소스를 만듭니다.
구문
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는 성공하지만 한 수준 텍스처를 반환합니다.
요구 사항
대상 플랫폼 | Windows |
헤더 | d3d9helper.h(D3D9.h 포함) |
라이브러리 | D3D9.lib |
추가 정보
D3DXCreateCubeTextureFromFileEx
D3DXCreateCubeTextureFromFileInMemory
D3DXCreateCubeTextureFromFileInMemoryEx
D3DXCreateCubeTextureFromResource