D3DXCreateCubeTextureFromFileInMemoryEx 함수

메모리내의 파일로부터 큐브 텍스처를 생성 한다. 이것은,D3DXCreateCubeTextureFromFileInMemory 의 상위의 함수이다.

구문

HRESULT D3DXCreateCubeTextureFromFileInMemoryEx(      

    LPDIRECT3DDEVICE9 pDevice,
    LPCVOID pSrcData,
    UINT SrcDataSize,
    UINT Size,
    UINT MipLevels,
    DWORD Usage,
    D3DFORMAT Format,
    D3DPOOL Pool,
    DWORD Filter,
    DWORD MipFilter,
    D3DCOLOR ColorKey,
    D3DXIMAGE_INFO *pSrcInfo,
    PALETTEENTRY *pPalette,
    LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

파라미터

pDevice

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

pSrcData

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

SrcDataSize

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

Size

[in] 폭 또는 높이 (픽셀 단위). 이 값이 0 또는 D3DX_DEFAULT 의 경우, 넓이는 파일로부터 취득된다.

MipLevels

[in] 요구되는 밉레벨의 수. 이 값이 0 또는 D3DX_DEFAULT 의 경우는, 완전한 밉맵 체인이 생성 된다.

Usage

[in] 0, D3DUSAGE_RENDERTARGET, 또는 D3DUSAGE_DYNAMIC. 이 플래그를 D3DUSAGE_RENDERTARGET 로 설정 하면, 그 표면은 렌더링 타겟으로서 사용되는 것을 나타낸다. 리소스는,IDirect3DDevice9::SetRenderTarget 메서드의 pNewRenderTarget 파라미터에 건네줄 수가 있다. D3DUSAGE_RENDERTARGET 를 지정하는 경우, 애플리케이션은 IDirect3D9::CheckDeviceFormat 를 호출해, 장치가 이 처리를 지원 하고 있는 것을 확인할 필요가 있다. 동적 텍스처의 사용법의 더 자세한 정보는, 「동적 텍스처의 사용법」을 참조할것.

Format

[in] D3DFORMAT 열거형의 멤버. 큐브 텍스처에 대해서 요구된 픽셀 포맷을 기술한다. 돌려받는 텍스처의 포맷은,Format 로 지정한 포맷과 다른 경우가 있다. 애플리케이션은, 돌려주어진 텍스처의 포맷을 확인할 필요가 있다. Format 의 값이 D3DFMT_UNKNOWN 의 경우, 포맷은 파일로부터 취득된다.

Pool

[in] D3DPOOL 열거형의 멤버. 큐브 텍스처의 배치처가 되는 메모리 클래스를 기술한다.

Filter

[in] 이미지를 필터링 하는 방법을 제어하는 1 개 혹은 복수의 D3DX_FILTER 의 편성. 이 파라미터에 D3DX_DEFAULT 를 지정하는 것은, D3DX_FILTER_TRIANGLE | D3DX_FILTER_DITHER 를 지정하는 것으로 동일하다.

MipFilter

[in] 이미지를 필터링 하는 방법을 제어하는 1 개 혹은 복수의 D3DX_FILTER 의 편성. 이 파라미터에 D3DX_DEFAULT 를 지정하는 것은, D3DX_FILTER_BOX 를 지정하는 것으로 동일하다.

ColorKey

[in] 투명이 되는 D3DCOLOR 의 값. 컬러 키를 무효로 하는 경우는 0 을 지정한다. 소스 이미지의 포맷과는 관계없이, 이것은 항상 32 비트의 ARGB 컬러이다. 알파가 의미가 있고, 보통은 컬러 키를 불투명하게 하는 경우는 FF 를 지정한다. 따라서, 불투명한 흑의 경우, 값은 0xFF000000 가 된다.

pSrcInfo

[in, out] 소스 이미지 파일내의 데이터의 기술을 저장 하는 D3DXIMAGE_INFO 구조체의 포인터, 또는 NULL.

pPalette

[out] 저장 하는 256 색팔레트를 나타내는 PALETTEENTRY 구조체의 포인터, 또는 NULL. 「주의」를 참조할것.

ppCubeTexture

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

반환값

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

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

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

주의

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

큐브 텍스처는, 표면의 집합인 점이 다른 표면와 다르다. 큐브 텍스처를 지정해 IDirect3DDevice9::SetRenderTarget 을 호출하려면 ,IDirect3DCubeTexture9::GetCubeMapSurface 를 사용해 특정의 면을 선택해, 그 표면을 IDirect3DDevice9::SetRenderTarget 에 건네줄 필요가 있다.

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

PALETTEENTRY 의 더 자세한 정보는, Microsoft Platform Software Development Kit (SDK)를 참조할것. Microsoft DirectX® 8.0 의 시점에서,PALETTEENTRY 구조체의 peFlags 멤버는, Platform SDK 에 설명되고 있도록(듯이)는 기능하지 않는다. peFlags 멤버는, 현재, 8 비트 팔레트화 포맷의 알파 채널이다.

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

함수의 정보

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

참조

텍스처의 색변환