Direct3DDevice7.SetTextureStageState

The Direct3DDevice7.SetTextureStageState method sets the state value for a currently assigned texture.

object.SetTextureStageState( _ 
    stage As Long, _ 
    state As CONST_D3DTEXTURESTAGESTATETYPE, _ 
    value As Long)

Parameters

object

Object expression that resolves to a Direct3DDevice7 object.

stage

Stage identifier of the texture for which the state value will be set. Stage identifiers are zero-based. Currently, devices can have up to 8 set textures, so the maximum allowable value for stage is 7.

state

Texture state to be set. This parameter can be any constant of the CONST_D3DTEXTURESTAGESTATETYPE enumeration.

value

State value to be set. The meaning of this value is determined by the state parameter.

Error Codes

If the method fails, an error is raised and Err.Number may be set to one of the following values:

Remarks

Applications should use this method to set texture states in favor of the legacy texture-related render states. For more information, see About Render States.

See Also

Direct3DDevice7.GetTextureStageState, Direct3DDevice7.GetTexture, Direct3DDevice7.SetTexture, Textures