Platform SDK: DirectX

Direct3DDevice7.SetTexture

Direct3DDevice7.SetTexture メソッドは、デバイスの指定されたステージにテクスチャを割り当てる。

object.SetTexture( _ 
    stage As Long, _ 
    texture As DirectDrawSurface7)

パラメータ

object
Direct3DDevice7 オブジェクトを表すオブジェクト式。
stage
テクスチャを設定するステージ識別子。ステージ識別子はゼロをベースとする。現在、デバイスは 8 セットまでのテクスチャを持つことができるので、stage に許される最大値は 7 である。
texture
設定されるテクスチャの DirectDrawSurface7 オブジェクト。キューブ環境マップなどの複合テクスチャでは、最上位サーフェスでなければならない。

エラー コード

メソッドが失敗するとエラーが発生し、Err.Number に次のいずれかのエラー コードが設定される。

DDERR_INVALIDOBJECT
DDERR_INVALIDPARAMS

トラッピング エラーについては、「Visual Basic エラー トラッピング」を参照すること。

注意

テクスチャが不要になった場合、該当するステージのテクスチャを Nothing に設定する必要がある。この処理を行わないと、アプリケーションの終了時に、そのサーフェスのメモリが失われる。

ソフトウェア デバイスは、1 つのテクスチャを一度に複数のテクスチャ ステージに割り当てることはサポートしていない。

参照

Direct3DDevice7.GetTextureDirect3DDevice7.GetTextureStageStateDirect3DDevice7.SetTextureStageStateテクスチャ