Microsoft DirectX 8.0 (Visual Basic)

Direct3DDevice8.SetTexture

テクスチャをデバイスのステージに割り当てる。

object.SetTexture( _ 
    Stage As Long, _ 
    Texture As Direct3DBaseTexture8)

指定項目

object
Direct3DDevice8 オブジェクトを表すオブジェクト式。
Stage
テクスチャを設定するステージ識別子。ステージ識別子はゼロから始まる。デバイスは最大 8 セットまでテクスチャを持つことができるので、Stage に指定できる最大値は 7 である。
Texture
設定するテクスチャを表す Direct3DBaseTexture8 オブジェクト。ミップマップ テクスチャやキューブ テクスチャなどのように複雑なテクスチャの場合、このパラメータはトップレベルのサーフェスでなければならない。

エラー コード

失敗した場合はエラーが発生し、Err.NumberD3DERR_INVALIDCALL が設定される。

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

注意

このメソッドは、割り当てられているテクスチャ サーフェスの参照カウントをインクリメントし、以前に選択されたテクスチャがある場合にはその参照カウントをデクリメントする。テクスチャが不要になった場合、該当するステージのテクスチャを Nothing に設定する。この処理を行わないと、メモリ リークが発生する。

参照

Direct3DDevice8.GetTextureDirect3DDevice8.GetTextureStageStateDirect3DDevice8.SetTextureStageState