IDirect3DDevice9::CreateVolumeTexture メソッド (d3d9.h)

[アーティクル]
02/29/2024

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

構文

HRESULT CreateVolumeTexture(
  [in]          UINT                    Width,
  [in]          UINT                    Height,
  [in]          UINT                    Depth,
  [in]          UINT                    Levels,
  [in]          DWORD                   Usage,
  [in]          D3DFORMAT               Format,
  [in]          D3DPOOL                 Pool,
  [out, retval] IDirect3DVolumeTexture9 **ppVolumeTexture,
  [in]          HANDLE                  *pSharedHandle
);

パラメーター

[in] Width

型: UINT

ボリュームテクスチャの最上位レベルの幅 (ピクセル単位)。 D3DCAPS9のD3DPTEXTURECAPS_VOLUMEMAP_POW2 メンバーが設定されている場合、この値は 2 の累乗である必要があります。後続のレベルのピクセルディメンションは、前のレベルのピクセルディメンションの半分の切り捨てられた値になります (個別)。各次元は1ピクセルのサイズで締め金で止める。したがって、2 による除算の結果が 0 (ゼロ) の場合は、代わりに 1 が取られます。ドライバーがサポートする最大ディメンション (幅、高さ、深さ) は、 D3DCAPS9の MaxVolumeExtent にあります。

[in] Height

型: UINT

ボリュームテクスチャの最上位レベルの高さ (ピクセル単位)。 D3DCAPS9のD3DPTEXTURECAPS_VOLUMEMAP_POW2 メンバーが設定されている場合、この値は 2 の累乗である必要があります。後続のレベルのピクセルディメンションは、前のレベルのピクセルディメンションの半分の切り捨てられた値になります (個別)。各次元は1ピクセルのサイズで締め金で止める。したがって、2 による除算の結果が 0 (ゼロ) の場合は、代わりに 1 が取られます。ドライバーがサポートする最大ディメンション (幅、高さ、深さ) は、 D3DCAPS9の MaxVolumeExtent にあります。

[in] Depth

型: UINT

ボリュームテクスチャの最上位レベルの深度 (ピクセル単位)。 D3DCAPS9のD3DPTEXTURECAPS_VOLUMEMAP_POW2 メンバーが設定されている場合、この値は 2 の累乗である必要があります。後続のレベルのピクセルディメンションは、前のレベルのピクセルディメンションの半分の切り捨てられた値になります (個別)。各次元は1ピクセルのサイズで締め金で止める。したがって、2 による除算の結果が 0 (ゼロ) の場合は、代わりに 1 が取られます。ドライバーがサポートする最大ディメンション (幅、高さ、深さ) は、 D3DCAPS9の MaxVolumeExtent にあります。

[in] Levels

型: UINT

テクスチャ内のレベルの数。この値が 0 の場合、Direct3D は、mipmapped ボリュームテクスチャをサポートするハードウェアに対して、1x1 ピクセルまでのすべてのテクスチャサブレベルを生成します。 IDirect3DBaseTexture9::GetLevelCount を呼び出して、生成されたレベルの数を確認します。

[in] Usage

型: DWORD

使用量には 0 を指定できます。これは、使用量の値がないことを示します。使用が必要な場合は、D3DUSAGE_DYNAMICまたはD3DUSAGE_SOFTWAREPROCESSINGを使用します。詳細については、「 D3DUSAGE」を参照してください。

[in] Format

種類: D3DFORMAT

D3DFORMAT列挙型のメンバー。ボリュームテクスチャ内のすべてのレベルの形式を記述します。

[in] Pool

種類: D3DPOOL

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

[out, retval] ppVolumeTexture

種類: IDirect3DVolumeTexture9**

作成されたボリュームテクスチャリソースを表す IDirect3DVolumeTexture9 インターフェイスへのポインターのアドレス。