D3DXCreateCubeTexture 関数

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

構文

HRESULT D3DXCreateCubeTexture(
  _In_  LPDIRECT3DDEVICE9      pDevice,
  _In_  UINT                   Size,
  _In_  UINT                   MipLevels,
  _In_  DWORD                  Usage,
  _In_  D3DFORMAT              Format,
  _In_  D3DPOOL                Pool,
  _Out_ LPDIRECT3DCUBETEXTURE9 *ppCubeTexture
);

パラメーター

pDevice [in]

種類: LPDIRECT3DDEVICE9

テクスチャに関連付けるデバイスを表す IDirect3DDevice9 インターフェイスへのポインター。

サイズ [入力]

型: UINT

キューブ テクスチャの幅と高さ (ピクセル単位)。 たとえば、キューブ テクスチャが 8 ピクセル x 8 ピクセルのキューブの場合、このパラメーターの値は 8 である必要があります。

MipLevels [in]

型: UINT

要求されたミップ レベルの数。 この値が 0 またはD3DX_DEFAULTの場合は、完全なミップマップ チェーンが作成されます。

使用法 [入力]

種類: DWORD

0、D3DUSAGE_RENDERTARGET、またはD3DUSAGE_DYNAMIC。 このフラグを D3DUSAGE_RENDERTARGET に設定すると、サーフェスがレンダー ターゲットとして使用されることを示します。 その後、SetRenderTarget メソッドの pNewRenderTarget パラメーターにリソースを渡すことができます。 D3DUSAGE_RENDERTARGETが指定されている場合、アプリケーションは CheckDeviceFormat を呼び出して、デバイスがこの操作をサポートしていることをチェックする必要があります。 動的テクスチャの使用の詳細については、「動的テクスチャの 使用」を参照してください。

書式 [in]

型: D3DFORMAT

キューブ テクスチャの要求されたピクセル形式を記述する D3DFORMAT 列挙型のメンバー。 返されるキューブ テクスチャの形式は、 Format で指定された形式とは異なる場合があります。 アプリケーションは、返されるキューブ テクスチャの形式をチェックする必要があります。

プール [入力]

種類: D3DPOOL

キューブ テクスチャを配置するメモリ クラスを記述する D3DPOOL 列挙型のメンバー。

ppCubeTexture [out]

種類: LPDIRECT3DCUBETEXTURE9*

作成されたキューブ テクスチャ オブジェクトを表す IDirect3DCubeTexture9 インターフェイスへのポインターのアドレス。

戻り値

種類: HRESULT

関数が成功した場合、戻り値はD3D_OK。 関数が失敗した場合、戻り値は、D3DERR_INVALIDCALL、D3DERR_NOTAVAILABLE、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORYのいずれかになります。

解説

キューブ テクスチャは、サーフェスのコレクションであるという点で、他のサーフェスとは異なります。

内部的には、D3DXCreateCubeTexture は D3DXCheckCubeTextureRequirements を使用して呼び出し元のパラメーターを調整します。 したがって、多くの場合、D3DXCreateCubeTexture の呼び出しは 、CreateCubeTexture の呼び出しが失敗する場合に成功します。

必要条件

要件	値
ヘッダー	D3dx9tex.h
ライブラリ	D3dx9.lib

関連項目

D3DX 9 のテクスチャ関数