Direct3DDevice8.CreateTexture
テクスチャ リソースを作成する。
object.CreateTexture( _
Width As Long, _
Height As Long, _
Levels As Long, _
Usage As Long, _
Format As CONST_D3DFORMAT, _
Pool As CONST_D3DPOOL) As Direct3DTexture8
指定項目
- object
- Direct3DDevice8 オブジェクトを表すオブジェクト式。
- Width
- テクスチャの最上位レベルの幅 (ピクセル単位)。各サーフェスのミップマップ レベルが下のピクセル ディメンジョンは 1 つ上のレベルのピクセル ディメンジョンを (単純に) 半分にした値である。それぞれの大きさは、1 ピクセルのサイズに収められる。2 で除算した結果が 0 の場合、代わりに 1 が使用される。
- Height
- テクスチャの最上位レベルの高さ (ピクセル単位)。各サーフェスのミップマップ レベルが下のピクセル ディメンジョンは 1 つ上のレベルのピクセル ディメンジョンを (単純に) 半分にした値である。それぞれの大きさは、1 ピクセルのサイズに収められる。2 で除算した結果が 0 の場合、代わりに 1 が使用される。
- Levels
- テクスチャのレベルの数。0 (ゼロ) を指定すると、Microsoft® Direct3D® は、ミップマップ化テクスチャをサポートするハードウェアに対し、1 × 1 ピクセルまでのすべてのテクスチャ サブレベルを生成する。その他の値を指定した場合は、1 レベルを生成する。Direct3DBaseTexture8.GetLevelCount を呼び出して、生成されたレベル数を確認する。
- Usage
- このリソースの使用方法を記述する CONST_D3DUSAGEFLAGS 列挙で定義される次の 1 つ以上のフラグの組み合わせ。
- D3DUSAGE_DEPTHSTENCIL
- サーフェスが深度ステンシル サーフェスとして使用されることを示す。リソースは、Direct3DDevice8.SetRenderTarget メソッドの NewDepthStencil パラメータに渡すことができる。
- D3DUSAGE_RENDERTARGET
- サーフェスがレンダリング ターゲットとして使用されることを示す。リソースは、SetRenderTarget メソッドの NewRenderTarget パラメータに渡すことができる。
D3DUSAGE_RENDERTARGET または D3DUSAGE_DEPTHSTENCIL のいずれかが指定された場合は、アプリケーションで Direct3D8.CheckDeviceFormat を呼び出して、デバイスがこれらの処理をサポートするかどうかを確認しなければならない。
- Format
- テクスチャの全レベルのフォーマットを示す CONST_D3DFORMAT 列挙のメンバ。
- Pool
- テクスチャを格納するメモリ クラスを示す CONST_D3DPOOL 列挙のメンバ。
戻り値
作成されたテクスチャ リソースを表す Direct3DTexture8 オブジェクト。
エラー コード
失敗した場合はエラーが発生し、Err.Number に次のいずれかの値が設定される。
エラー トラッピングの詳細については、Microsoft® Visual Basic® の「エラー処理」を参照すること。
注意
テクスチャを指定して Direct3DDevice8.SetRenderTarget を呼び出すには、Direct3DTexture8.GetSurfaceLevel を使ってレベルを選択し、選択したサーフェスを SetRenderTarget に渡さなければならない。