Microsoft DirectX 8.0 (C++)

D3DXCreateCubeTexture

必要に応じて呼び出しパラメータを調整し、空のキューブ テクスチャを作成する。

HRESULT D3DXCreateCubeTexture(
  LPDIRECT3DDEVICE8 pDevice,
  UINT Size,
  UINT MipLevels,
  DWORD Usage,
  D3DFORMAT Format,
  D3DPOOL Pool,
  LPDIRECT3DCUBETEXTURE8* ppCubeTexture
);

パラメータ

pDevice
[in] テクスチャに関連付けられているデバイスを表す IDirect3DDevice8 インターフェイスへのポインタ。
Size
[in] キューブ テクスチャの幅と高さ (ピクセル単位)。たとえば、キューブ テクスチャが 8x8 ピクセルのキューブの場合、このパラメータの値は 8 となる。
MipLevels
[in] 要求されるミップ レベルの数。この値が 0 または D3DX_DEFAULT の場合は、完全なミップマップ チェーンが作成される。
Usage
[in] 0 または D3DUSAGE_RENDERTARGET。このフラグに D3DUSAGE_RENDERTARGET を設定すると、そのサーフェスはレンダリング ターゲットとして使用されることを示す。リソースは、SetRenderTarget メソッドの pNewRenderTarget パラメータに渡すことができる。D3DUSAGE_RENDERTARGET を指定する場合、アプリケーションは IDirect3D8::CheckDeviceFormat を呼び出して、デバイスがこれらの処理をサポートしていることを確認する必要がある。
Format
[in] キューブ テクスチャに対して要求されたピクセル フォーマットを記述する、D3DFORMAT 列挙型のメンバ。返されるキューブ テクスチャのフォーマットは、Format で指定されたフォーマットと異なる場合がある。アプリケーションは、返されたキューブ テクスチャのフォーマットを確認する必要がある。
Pool
[in] キューブ テクスチャの配置先となるメモリ クラスを記述する、D3DPOOL 列挙型のメンバ。
ppCubeTexture
[out] 作成されたキューブ テクスチャ オブジェクトを表す、IDirect3DCubeTexture8 インターフェイスへのポインタのアドレス。

戻り値

成功した場合は D3D_OK を返す。

失敗した場合は、次のいずれかの値を返す。

D3DERR_INVALIDCALL
D3DERR_NOTAVAILABLE
D3DERR_OUTOFVIDEOMEMORY
E_OUTOFMEMORY

注意

キューブ テクスチャは、サーフェスのコレクションである点でほかのサーフェスとは異なる。キューブ テクスチャを指定して SetRenderTarget を呼び出すには、IDirect3DCubeTexture8::GetCubeMapSurface を使用して個々の面を選択し、結果サーフェスを SetRenderTarget に渡す必要がある。

D3DXCreateCubeTexture は、内部で D3DXCheckCubeTextureRequirements を使用して呼び出しパラメータを調整する。したがって、IDirect3Ddevice8::CreateCubeTexture の呼び出しが失敗する場合でも、D3DXCreateCubeTexture の呼び出しは成功することが多い。

動作環境

  ヘッダー : D3dx8tex.h で宣言。
  インポート ライブラリ : D3dx8.lib を使用。