IDirect3DDevice9::CreateCubeTexture メソッド (d3d9helper.h)

[アーティクル]
08/23/2023

キューブテクスチャリソースを作成します。

構文

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 に設定 します。このパラメーターは、Direct3D 9 for Windows Vista でリソースを共有するために使用できます。

戻り値

種類: HRESULT

メソッドが成功した場合、戻り値はD3D_OK。メソッドが失敗した場合、戻り値は次のいずれかになります:D3DERR_INVALIDCALL、D3DERR_OUTOFVIDEOMEMORY、E_OUTOFMEMORY。

解説

ミップマップ (テクスチャ) は、連続してダウンサンプリングされた (mipmapped) サーフェスのコレクションです。一方、キューブテクスチャ ( IDirect3DDevice9::CreateCubeTexture によって作成) は、顔ごとに 1 つずつ、6 つのテクスチャ (mipmaps) のコレクションです。すべての面がキューブテクスチャに存在する必要があります。また、キューブマップサーフェスは、3 次元 (x、y、z) すべて同じピクセルサイズである必要があります。

アプリケーションは、IDirect3D9::CheckDeviceFormat を呼び出して、特定の形式の Mipmaps (Direct3D 9) の自動生成のサポートを検出D3DUSAGE_AUTOGENMIPMAP。 IDirect3D9::CheckDeviceFormat がD3DOK_NOAUTOGENを返した場合、IDirect3DDevice9::CreateCubeTexture は成功しますが、1 レベルのテクスチャを返します。

要件


対象プラットフォーム	Windows
ヘッダー	d3d9helper.h (D3D9.h を含む)
Library	D3D9.lib

IDirect3DDevice9::CreateCubeTexture メソッド (d3d9helper.h)

構文

パラメーター

戻り値

解説

要件

関連項目

フィードバック

フィードバック

その他のリソース