D3DXCreateCubeTextureFromFileInMemory 함수

메모리내의 파일로부터 큐브 텍스처를 생성 한다.

구문

HRESULT D3DXCreateCubeTextureFromFileInMemory(      

    LPDIRECT3DDEVICE9 pDevice,
    LPCVOID pSrcData,
    UINT SrcDataSize,
    LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

파라미터

pDevice

[in] IDirect3DDevice9 인터페이스의 포인터. 큐브 텍스처에 관련지을 수 있는 장치를 나타낸다.

pSrcData

[in] 큐브 맵의 생성에 사용하는 메모리내의 파일의 포인터. 「주의」를 참조할것.

SrcDataSize

[in] 메모리내의 파일의 사이즈 (바이트 단위).

ppCubeTexture

[out] 생성 된 큐브 텍스처 개체를 나타내는,IDirect3DCubeTexture9 인터페이스의 포인터 주소.

반환값

성공했을 경우는,D3D_OK 를 돌려준다.

실패했을 경우는, 다음의 몇개의 값을 돌려준다.

D3DERR_INVALIDCALL	메서드의 호출이 무효이다. 예를 들어, 메서드의 파라미터에 무효인 값이 설정되어 있는 경우 등이다.
D3DERR_NOTAVAILABLE	이 장치는, 조회된 테크닉을 지원 하고 있지 않다.
D3DERR_OUTOFVIDEOMEMORY	Microsoft® Direct3D® 가 처리를 실시하는데 충분한 디스플레이 메모리가 없다.
D3DXERR_INVALIDDATA	데이터가 무효이다.
E_OUTOFMEMORY	Direct3D 가 호출을 완료하기 위한 충분한 메모리를 할당할 수가 없었다.

주의

이 함수가 지원 하고 있는 파일 포맷은,. bmp,. dds,. dib,. jpg,. png, 및 . tga 이다.

이 함수를 사용해 생성 한 리소스는, D3DPOOL_MANAGED 로 나타나는 메모리 클래스에 배치된다.

이 메서드는, 애플리케이션 정의의 리소스 (미가공 데이터)인, RT_RCDATA 로서 저장 된 이미지 파일을 로드하기 위해서(때문에) 사용하도록(듯이) 설계되고 있다. 그 이외의 목적으로 사용하면 이 메서드는 실패한다.

D3DXCreateCubeTextureFromFileInMemory 는, DirectDraw® 표면 (DDS) 파일 포맷을 사용한다. DXTex 툴에 의해, 다른 파일 포맷화등 큐브 맵을 생성해, 그것을 DDS 파일 포맷으로 보존할 수가 있다.

함수의 정보

헤더	d3dx9tex.h
임포트 라이브러리	d3dx9.lib
최저한의 operating system	Windows 98

참조

텍스처의 색변환