Microsoft DirectX 8.0 (Visual Basic)

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 に次のいずれかの値が設定される。

D3DERR_INVALIDCALL
D3DERR_OUTOFVIDEOMEMORY
E_OUTOFMEMORY

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

注意

テクスチャを指定して Direct3DDevice8.SetRenderTarget を呼び出すには、Direct3DTexture8.GetSurfaceLevel を使ってレベルを選択し、選択したサーフェスを SetRenderTarget に渡さなければならない。