Microsoft DirectX 8.0 (C++) |
必要に応じて呼び出しパラメータを調整し、空のキューブ テクスチャを作成する。
HRESULT D3DXCreateCubeTexture( LPDIRECT3DDEVICE8 pDevice, UINT Size, UINT MipLevels, DWORD Usage, D3DFORMAT Format, D3DPOOL Pool, LPDIRECT3DCUBETEXTURE8* ppCubeTexture );
成功した場合は D3D_OK を返す。
失敗した場合は、次のいずれかの値を返す。
D3DERR_INVALIDCALL |
D3DERR_NOTAVAILABLE |
D3DERR_OUTOFVIDEOMEMORY |
E_OUTOFMEMORY |
キューブ テクスチャは、サーフェスのコレクションである点でほかのサーフェスとは異なる。キューブ テクスチャを指定して SetRenderTarget を呼び出すには、IDirect3DCubeTexture8::GetCubeMapSurface を使用して個々の面を選択し、結果サーフェスを SetRenderTarget に渡す必要がある。
D3DXCreateCubeTexture は、内部で D3DXCheckCubeTextureRequirements を使用して呼び出しパラメータを調整する。したがって、IDirect3Ddevice8::CreateCubeTexture の呼び出しが失敗する場合でも、D3DXCreateCubeTexture の呼び出しは成功することが多い。
ヘッダー : D3dx8tex.h で宣言。
インポート ライブラリ : D3dx8.lib を使用。