IDirect3DDevice9::CreateCubeTexture メソッド (d3d9.h)
キューブ テクスチャ リソースを作成します。
構文
HRESULT CreateCubeTexture(
[in] UINT EdgeLength,
[in] UINT Levels,
[in] DWORD Usage,
[in] D3DFORMAT Format,
[in] D3DPOOL Pool,
[out, retval] IDirect3DCubeTexture9 **ppCubeTexture,
[in] HANDLE *pSharedHandle
);
パラメーター
[in] EdgeLength
型: UINT
キューブ テクスチャのすべての最上位面のエッジのサイズ。 各面の後続のレベルのピクセルディメンションは、前のレベルのピクセルディメンションの半分の切り捨てられた値になります(独立)。 各次元は1ピクセルのサイズで締め金で止める。 したがって、2 による除算の結果が 0 (ゼロ) の場合は、代わりに 1 が取られます。
[in] Levels
型: UINT
キューブ テクスチャの各面のレベルの数。 この値が 0 の場合、Direct3D は、mipmapped キューブ テクスチャをサポートするハードウェアに対して、各面に対して 1x1 ピクセルまでのすべてのキューブ テクスチャ サブレベルを生成します。 IDirect3DBaseTexture9::GetLevelCount を呼び出して、生成されたレベルの数を確認します。
[in] Usage
型: DWORD
使用量には 0 を指定できます。これは、使用量の値がないことを示します。 ただし、使用が必要な場合は、1 つ以上の D3DUSAGE 定数の組み合わせを使用します。 CreateCubeTexture の usage パラメーターと IDirect3D9::CreateDevice の動作フラグを照合することをお勧めします。 詳細については、「解説」を参照してください。
[in] Format
型: D3DFORMAT
キューブ テクスチャのすべての面のすべてのレベルの形式を記述する D3DFORMAT 列挙型のメンバー。
[in] Pool
種類: D3DPOOL
キューブ テクスチャを配置するメモリ クラスを記述する D3DPOOL 列挙型のメンバー。
[out, retval] ppCubeTexture
種類: IDirect3DCubeTexture9**
作成されたキューブ テクスチャ リソースを表す IDirect3DCubeTexture9 インターフェイスへのポインターのアドレス。
[in] pSharedHandle
型: HANDLE*
予約済み。 このパラメーターを NULL に設定 します。 このパラメーターは、Windows Vista 用 Direct3D 9 で リソースを共有するために使用できます。
戻り値
型: HRESULT
メソッドが成功した場合、戻り値はD3D_OK。 メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。
解説
ミップマップ (テクスチャ) は、連続してダウンサンプリングされた (mipmapped) サーフェスのコレクションです。 一方、( IDirect3DDevice9::CreateCubeTexture によって作成された) キューブ テクスチャは、6 つのテクスチャ (ミップマップ) のコレクションであり、各面に 1 つです。 すべての面がキューブ テクスチャに存在する必要があります。 また、キューブ マップ サーフェスは、3 つのディメンション (x、y、z) すべてで同じピクセル サイズである必要があります。
アプリケーションは、IDirect3D9::CheckDeviceFormat をD3DUSAGE_AUTOGENMIPMAPで呼び出すことで、特定の形式の Mipmaps (Direct3D 9) の自動生成のサポートを検出できます。 IDirect3D9::CheckDeviceFormat がD3DOK_NOAUTOGENを返した場合、IDirect3DDevice9::CreateCubeTexture は成功しますが、1 レベルのテクスチャを返します。
要件
| 対象プラットフォーム | Windows |
| ヘッダー | d3d9.h (D3D9.h を含む) |
| Library | D3D9.lib |
関連項目
D3DXCreateCubeTextureFromFileEx
D3DXCreateCubeTextureFromFileInMemory
D3DXCreateCubeTextureFromFileInMemoryEx
D3DXCreateCubeTextureFromResource