Microsoft DirectX 8.0 (Visual Basic)

Direct3DDevice8.CreateVolumeTexture

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

object.CreateVolumeTexture( _ 
    Width As Long, _ 
    Height As Long, _ 
    Depth As Long, _ 
    Levels As Long, _ 
    Usage As Long, _ 
    Format As CONST_D3DFORMAT, _ 
    Pool As CONST_D3DPOOL) As Direct3DVolumeTexture8

指定項目

object
Direct3DDevice8 オブジェクトを表すオブジェクト式。
Width
ボリューム テクスチャの最上位レベルの幅 (ピクセル単位)。この値は 2 の累乗でなければならない。ミップマップ レベルが下のピクセル ディメンジョンは 1 つ上のレベルのピクセル ディメンジョンを (単純に) 半分にした値である。それぞれの大きさは、1 ピクセルのサイズに収められる。したがって、2 で除算した結果が 0 の場合、代わりに 1 が使用される。
Height
ボリューム テクスチャの最上位レベルの高さ (ピクセル単位)。この値は 2 の累乗でなければならない。ミップマップ レベルが下のピクセル ディメンジョンは 1 つ上のレベルのピクセル ディメンジョンを (単純に) 半分にした値である。それぞれの大きさは、1 ピクセルのサイズに収められる。したがって、2 で除算した結果が 0 の場合、代わりに 1 が使用される。
Depth
ボリューム テクスチャの最上位レベルの深度 (ピクセル単位)。この値は 2 の累乗でなければならない。ミップマップ レベルが下のピクセル ディメンジョンは 1 つ上のレベルのピクセル ディメンジョンを (単純に) 半分にした値である。それぞれの大きさは、1 ピクセルのサイズに収められる。したがって、2 で除算した結果が 0 の場合、代わりに 1 が使用される。
Levels
ボリューム テクスチャのレベルの数。0 (ゼロ) を指定すると、Microsoft® Direct3D® は、ミップマップ化ボリューム テクスチャをサポートするハードウェアに対し、1 × 1 × 1 ピクセルまでのすべてのテクスチャ サブレベルを生成する。その他の値を指定した場合は、1 レベルを生成する。Direct3DBaseTexture8.GetLevelCount を呼び出して、生成されるレベル数を確認する。
Usage
現在は使用されていない。0 に設定される。
Format
ボリューム テクスチャの全レベルのフォーマットを示す CONST_D3DFORMAT 列挙のメンバ。
Pool
ボリューム テクスチャを格納するメモリ クラスを示す CONST_D3DPOOL 列挙のメンバ。

戻り値

作成されたボリューム テクスチャ リソースを表す Direct3DVolumeTexture8 オブジェクト。

エラー コード

失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY
E_OUTOFMEMORY

エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。