Microsoft DirectX 8.1 (C++)

Assigning the Current Textures

Microsoft® Direct3D® maintains a list of up to eight current textures. It blends these textures onto all the primitive it renders. Only textures created as texture interface pointers can be used in the set of current textures.

Applications call the IDirect3DDevice8::SetTexture method to assign textures into the set of current textures. The first parameter must be from the a number in the range of 0-7, inclusive. Pass the texture interface pointer as the second parameter.

The following C++ code example demonstrates how a texture can be assigned to the set of current textures.

// This code example assumes that the variable lpd3dDev is a
// valid pointer to an IDirect3DDevice8 interface and pTexture
// is a valid pointer to an IDirect3DBaseTexture8 interface.

// Set the third texture.
d3dDevice->SetTexture(2, pTexture);

Note  Software devices do not support assigning a texture to more than one texture stage at a time.