D3DXCreateCubeTextureFromFile 함수
파일에서 큐브 텍스처를 만듭니다.
구문
HRESULT D3DXCreateCubeTextureFromFile(
_In_ LPDIRECT3DDEVICE9 pDevice,
_In_ LPCTSTR pSrcFile,
_Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);
매개 변수
-
pDevice [in]
-
큐브 텍스처와 연결할 디바이스를 나타내는 IDirect3DDevice9 인터페이스에 대한 포인터입니다.
-
pSrcFile [in]
-
형식: LPCTSTR
파일 이름을 지정하는 문자열에 대한 포인터입니다. 컴파일러 설정에 유니코드가 필요한 경우 데이터 형식 LPCTSTR이 LPCWSTR로 확인됩니다. 그렇지 않으면 문자열 데이터 형식이 LPCSTR로 확인됩니다. 설명 부분을 참조하세요.
-
ppCubeTexture [out]
-
만든 큐브 텍스처 개체를 나타내는 IDirect3DCubeTexture9 인터페이스에 대한 포인터의 주소입니다.
반환 값
형식: HRESULT
함수가 성공하면 반환 값이 D3D_OK. 함수가 실패하면 반환 값은 D3DERR_INVALIDCALL, D3DERR_NOTAVAILABLE, D3DERR_OUTOFVIDEOMEMORY, D3DXERR_INVALIDDATA, E_OUTOFMEMORY 값 중 하나일 수 있습니다.
설명
컴파일러 설정은 함수 버전도 결정합니다. 유니코드가 정의되면 함수 호출이 D3DXCreateCubeTextureFromFileW로 확인됩니다. 그렇지 않으면 ANSI 문자열이 사용되므로 함수 호출이 D3DXCreateCubeTextureFromFileA 로 확인됩니다.
함수는 D3DXCreateCubeTextureFromFileEx(pDevice, pSrcFile, D3DX_DEFAULT, D3DX_DEFAULT, 0, D3DFMT_UNKNOWN, D3DPOOL_MANAGED, D3DX_DEFAULT, D3DX_DEFAULT, 0, NULL, NULL, NULL, ppCubeTexture)와 동일합니다.
이 함수는 .bmp, .dds, .dib, .hdr, .jpg, .pfm, .png, .ppm 및 .tga 파일 형식을 지원합니다. D3DXIMAGE_FILEFORMAT 참조하세요.
IDirect3DDevice9 개체에서 호출될 때 이 함수를 사용하여 만든 리소스는 D3DPOOL_MANAGED 나타내는 메모리 클래스에 배치됩니다. IDirect3DDevice9Ex 개체에서 이 메서드를 호출하면 리소스가 D3DPOOL_DEFAULT 나타내는 메모리 클래스에 배치됩니다.
필터링은 이 메서드를 사용하여 만든 텍스처에 자동으로 적용됩니다. 필터링은 D3DX_FILTER_TRIANGLE | D3DX_FILTER D3DX_FILTER_DITHER.
D3DXCreateCubeTextureFromFile 은 DDS(DirectDraw Surface) 파일 형식을 사용합니다. directX 텍스처 편집기(Dxtex.exe)를 사용하면 다른 파일 형식에서 큐브 맵을 생성하고 DDS 파일 형식으로 저장할 수 있습니다. Dxtex.exe DirectX SDK에서 알아볼 수 있습니다. DirectX SDK에 대한 자세한 내용은 DirectX SDK는 어디에 있나요?를 참조하세요.
요구 사항
| 요구 사항 | 값 |
|---|---|
| 헤더 |
|
| 라이브러리 |
|
추가 정보