D3DSTATEBLOCKTYPE

This enumeration defines logical groups of device states.

typedef enum _D3DSTATEBLOCKTYPE {
  D3DSBT_ALL = 1,
  D3DSBT_PIXELSTATE = 2,
  D3DSBT_VERTEXSTATE = 3,
  D3DSBT_FORCE_DWORD = 0xffffffff
} D3DSTATEBLOCKTYPE;

Constants

• D3DSBT_ALL
  Capture all of the following device states.

  All current render states.	All current clip planes.
  All current texture stage states.	The current material.
  All current textures.	All current lights and enabled light parameters.
  The current palette.
  All current streams.
  The current viewport.	The current vertex shader.
  All current transforms.

• D3DSBT_PIXELSTATE
  Captures the following pixel-related device states.

  Render States

  D3DRS_ALPHABLENDENABLE	D3DRS_SRCBLEND
  D3DRS_ALPHAFUNC	D3DRS_STENCILENABLE
  D3DRS_ALPHAREF	D3DRS_STENCILFAIL
  D3DRS_ALPHATESTENABLE	D3DRS_STENCILFUNC
  D3DRS_BLENDOP	D3DRS_STENCILMASK
  D3DRS_COLORWRITEENABLE	D3DRS_STENCILPASS
  D3DRS_DESTBLEND	D3DRS_STENCILREF
  D3DRS_DITHERENABLE	D3DRS_STENCILWRITEMASK
  D3DRS_EDGEANTIALIAS	D3DRS_STENCILZFAIL
  D3DRS_FILLMODE	D3DRS_TEXTUREFACTOR
  D3DRS_FOGEND	D3DRS_WRAP0 through D3DRS_WRAP7
  D3DRS_FOGSTART	D3DRS_ZBIAS
  D3DRS_LASTPIXEL	D3DRS_ZENABLE
  D3DRS_LINEPATTERN	D3DRS_ZFUNC
  D3DRS_SHADEMODE	D3DRS_ZWRITEENABLE

  Texture Stage States

  D3DTSS_ADDRESSU	D3DTSS_COLOROP
  D3DTSS_ADDRESSV	D3DTSS_MAGFILTER
  D3DTSS_ADDRESSW	D3DTSS_MAXANISOTROPY
  D3DTSS_ALPHAARG0	D3DTSS_MAXMIPLEVEL
  D3DTSS_ALPHAARG1	D3DTSS_MINFILTER
  D3DTSS_ALPHAARG2	D3DTSS_MIPFILTER
  D3DTSS_ALPHAOP	D3DTSS_MIPMAPLODBIAS
  D3DTSS_BORDERCOLOR	D3DTSS_RESULTARG
  D3DTSS_COLORARG0	D3DTSS_TEXCOORDINDEX
  D3DTSS_COLORARG1	D3DTSS_TEXTURETRANSFORMFLAGS
  D3DTSS_COLORARG2

• D3DSBT_VERTEXSTATE
  Capture all the current lights, the current vertex shader, and the texture stage states specified by D3DTSS_TEXCOORDINDEX and D3DTSS_TEXTURETRANSFORMFLAGS. In addition, this flag captures all of the following vertex-related device states.

  Render States

  D3DRS_AMBIENT	D3DRS_MULTISAMPLEANTIALIAS
  D3DRS_AMBIENTMATERIALSOURCE	D3DRS_MULTISAMPLEMASK
  D3DRS_CLIPPING	D3DRS_NORMALIZENORMALS
  D3DRS_CLIPPLANEENABLE	D3DRS_POINTSCALE_A
  D3DRS_COLORVERTEX	D3DRS_POINTSCALE_B
  D3DRS_DIFFUSEMATERIALSOURCE	D3DRS_POINTSCALE_C
  D3DRS_EMISSIVEMATERIALSOURCE	D3DRS_POINTSCALEENABLE
  D3DRS_FOGEND	D3DRS_POINTSIZE_MAX
  D3DRS_FOGSTART	D3DRS_POINTSIZE_MIN
  D3DRS_FOGTABLEMODE	D3DRS_POINTSIZE
  D3DRS_FOGVERTEXMODE	D3DRS_RANGEFOGENABLE
  D3DRS_INDEXEDVERTEXBLENDENABLE	D3DRS_SOFTWAREVERTEXPROCESSING
  D3DRS_LIGHTING	D3DRS_SPECULARMATERIALSOURCE
  D3DRS_LOCALVIEWER

• D3DSBT_FORCE_DWORD
  Forces this enumeration to compile to 32 bits in size. This value is not used.

Remarks

The D3DSBT_PIXELSTATE and D3DSBT_VERTEXSTATE values identify different logical groups of device states, though some states are common to both groups. The union of D3DSBT_PIXELSTATE and D3DSBT_VERTEXSTATE is not equal to D3DSBT_ALL. The D3DSBT_PIXELSTATE and D3DSBT_VERTEXSTATE values enable the capture of these frequently modified states between calls to IDirect3DDevice8::DrawPrimitive without incurring the performance penalty of capturing the entire state.

Requirements

OS Versions: Windows CE .NET 4.0 and later.
Header: D3d8types.h.

See Also

IDirect3DDevice8::CreateStateBlock | IDirect3DDevice8::DrawPrimitive

 Last updated on Thursday, April 08, 2004

© 1992-2003 Microsoft Corporation. All rights reserved.