Saving Vertex States With a StateBlock (Direct3D 9)

A state block can be used to capture only vertex state (see State Blocks Save and Restore State (Direct3D 9)). The following state is vertex state:

• Vertex render state (see Vertex Pipeline: Render State).
• Vertex sampler state (see Vertex Pipeline: Sampler State).
• Vertex texture state (see Vertex Pipeline: Texture State).
• The NPatch mode segments from IDirect3DDevice9::SetNPatchMode.
• Each light from IDirect3DDevice9::SetLight, as well as whether or not the light is enabled with IDirect3DDevice9::LightEnable.
• The current vertex shader and each of the vertex shader constants.
• For each vertex stream, store the divider value from IDirect3DDevice9::SetStreamSourceFreq.
• The current vertex declaration.

To capture vertex state with a state block, specify D3DSBT_VERTEXSTATE when calling IDirect3DDevice9::CreateStateBlock.

Vertex Pipeline: Render State

Device render states affect the behavior of almost every part of the pipeline. Render states are set by calling IDirect3DDevice9::SetRenderState.

The following table includes all render states that set-up vertex state:

Vertex Pipeline: Sampler State

Sampler states control sampling related topics such as filtering, tiling, and texture coordinate address modes. Use IDirect3DDevice9::SetSamplerState to set up the sampler state (including the one used in the tessellator unit to sample displacement maps). The sampler states have been renamed with a "D3DSAMP_" prefix to enable compile time error detection when porting from DirectX 8.

The following table includes all sampler states that set-up vertex state:

Vertex Pipeline: Texture State

Texture states control texture blending operations of the multi-texture blender. Use IDirect3DDevice9::SetTextureStageState to set-up texture states. Use IDirect3DDevice9::SetTexture to associate a texture with a sampler stage.

The following table includes all the texture states that set-up vertex state:

D3DTSS_TEXCOORDINDEX is a fixed function vertex processing state. If a programmable vertex shader is used, this state is ignored.

Related topics

State Blocks Save and Restore State