Partager via

D3DMTEXTURESTAGESTATETYPE

  • Article

A version of this page is also available for

Windows Embedded CE 6.0 R3

4/8/2010

This enumeration provides values that are used to identify texture stage states. Each texture stage is identified by one of these values. Members of this enumerated type are used with the IDirect3DMobileDevice::GetTextureStageState and IDirect3DMobileDevice::SetTextureStageState methods to retrieve and set texture state values.

Syntax

typedef enum _D3DMTEXTURESTAGESTATETYPE {
  D3DMTSS_COLOROP               =  1,
  D3DMTSS_COLORARG1             =  2,
  D3DMTSS_COLORARG2             =  3,
  D3DMTSS_ALPHAOP               =  4,
  D3DMTSS_ALPHAARG1             =  5,
  D3DMTSS_ALPHAARG2             =  6,
  D3DMTSS_TEXCOORDINDEX         =  7,
  D3DMTSS_ADDRESSU              =  8,
  D3DMTSS_ADDRESSV              =  9,
  D3DMTSS_BORDERCOLOR           = 10,
  D3DMTSS_MAGFILTER             = 11,
  D3DMTSS_MINFILTER             = 12,
  D3DMTSS_MIPFILTER             = 13,
  D3DMTSS_MIPMAPLODBIAS         = 14,
  D3DMTSS_MAXMIPLEVEL           = 15,
  D3DMTSS_MAXANISOTROPY         = 16,
  D3DMTSS_TEXTURETRANSFORMFLAGS = 17,
  D3DMTSS_ADDRESSW              = 18,
  D3DMTSS_COLORARG0             = 19,
  D3DMTSS_ALPHAARG0             = 20,
  D3DMTSS_RESULTARG             = 21,
  D3DMTSS_MAXTEXTURESTATES      = 22,
  D3DMTSS_FORCE_ULONG           = 0x7fffffff,
} D3DMTEXTURESTAGESTATETYPE;

Elements

  • D3DMTSS_COLOROP
    The texture-stage state is a texture color blending operation identified by one member of the D3DMTEXTUREOP enumerated type. The default value for the first texture stage (stage 0) is D3DMTOP_MODULATE, and for all other stages the default is D3DMTOP_DISABLE.
  • D3DMTSS_COLORARG1
    Identifies one of the basic texture stage states used to specify color input for a texture stage. All stages use this state as an input along with D3DMTSS_COLORARG2. Operations with three inputs also use D3DMTSS_COLORARG0.
  • D3DMTSS_COLORARG2
    Identifies one of the basic texture stage states used to specify color input for a texture stage. All stages use this state as an input along with D3DMTSS_COLORARG1. Operations with three inputs also use D3DMTSS_COLORARG0.
  • D3DMTSS_ALPHAOP
    The texture-stage state is a texture alpha blending operation identified by one member of the D3DMTEXTUREOP enumerated type. The default value for the first texture stage (stage 0) is D3DMTOP_SELECTARG1, and for all other stages the default is D3DMTOP_DISABLE.
  • D3DMTSS_ALPHAARG1
    Identifies one of the basic texture stage states used to specify alpha input for a texture stage. All stages use this state as an input along with D3DMTSS_ALPHAARG2. Operations with three inputs also use D3DMTSS_ALPHAARG0.
  • D3DMTSS_ALPHAARG2
    Identifies one of the basic texture stage states used to specify alpha input for a texture stage. All stages use this state as an input along with D3DMTSS_ALPHAARG1. Operations with three inputs also use D3DMTSS_ALPHAARG0.
  • D3DMTSS_TEXCOORDINDEX
    Identifies a texture stage that allows you to specify texture coordinates. Adding a flag from the D3DMTSS_TCI Values specifies the type of coordinate generation algorithm to use.
  • D3DMTSS_ADDRESSU
    Indicates how the u values for texture coordinates are to be addressed in this stage. The values for this state must be from the D3DMTEXTUREADDRESS enumeration.
  • D3DMTSS_ADDRESSV
    Indicates how the v values for texture coordinates are to be addressed in this stage. The values for this state must be from the D3DMTEXTUREADDRESS enumeration.
  • D3DMTSS_BORDERCOLOR
    D3DMCOLOR value that describes the color to use for rasterizing texture coordinates outside the [0.0,1.0] range. The default color is 0x00000000.
  • D3DMTSS_MAGFILTER
    Identifies a texture stage state that applies a magnification filter when sampling a texture. The values for this state must be from the D3DMTEXTUREFILTERTYPE enumeration.
  • D3DMTSS_MINFILTER
    Identifies a texture stage state that applies a reduction filter when sampling a texture. The values for this state must be from the D3DMTEXTUREFILTERTYPE enumeration.
  • D3DMTSS_MIPFILTER
    Identifies that the texture values for a stage should be taken from a mipmap. The values for this state must be from the D3DMTEXTUREFILTER enumeration. Setting this state to the value D3DMTEXF_NONE instructs Direct3D Mobile to automatically select the appropriate and sample it. Setting this state to some other value instructs Direct3D Mobile to interpolate values from the two mipmap levels that screen area falls between.
  • D3DMTSS_MIPMAPLODBIAS
    Identifies the texture stage state used to influence the mipmap level selection process. When the value of this texture stage state is 0, no biasing is applied. Setting this value to a positive number causes lower resolution levels to be selected. Setting this bias to a negative number causes higher resolution levels to be selected. This value is bound by the number of mipmap levels present.
  • D3DMTSS_MAXMIPLEVEL
    Identifies the texture stage state that allows you to limit maximum level of detail that the rasterizer can use. Set the value of this state to 0 to allow Direct3D Mobile to use all available mipmap levels. Setting this value to an integer greater than 0 limits Direct3D Mobile from using that number of mipmap levels with the highest level of detail in them.
  • D3DMTSS_MAXANISOTROPY
    Maximum level of anisotropy. The default value is 1.
  • D3DMTSS_TEXTURETRANSFORMFLAGS
    Identifies a texture stage state that contains flags from the D3DMTEXTURETRANSFORMFLAGS enumeration specifying when the transformation matrix is applied.
  • D3DMTSS_ADDRESSW
    Indicates how the w values for texture coordinates are to be addressed in this stage. The values for this state must be from the D3DMTEXTUREADDRESS enumeration.
  • D3DMTSS_COLORARG0
    Identifies the third texture stage state input for operations that require three color inputs. The first two inputs are provided by the D3DMTSS_COLORARG1 and D3DMTSS_COLORARG2 states.
  • D3DMTSS_ALPHAARG0
    Identifies the third texture stage state input for operations that require three alpha inputs. The first two inputs are provided by the D3DMTSS_ALPHAARG1 and D3DMTSS_ALPHAARG2 states.
  • D3DMTSS_RESULTARG
    Identifies the type of output from a texture stage state. The possible values for this state are D3DMTA_CURRENT, which is the default value, and D3DMTA_TEMP (see D3DMTA Values).
  • D3DMTSS_MAXTEXTURESTATES
    Identifies the total number of texture stage states.
  • D3DMTSS_FORCE_ULONG
    Forces the compiler to interpret the enumeration as a ULONG value. This value is not used directly in Direct3D Mobile programming.

Requirements

Header d3dmtypes.h
Windows Embedded CE Windows CE 5.0 and later
Windows Mobile Windows Mobile Version 5.0 and later

See Also

Reference

Direct3D Mobile Enumerations
IDirect3DMobileDevice::GetTextureStageState
IDirect3DMobileDevice::SetTextureStageState
D3DMTEXTUREOP
D3DMTSS_TCI Values
D3DMTEXTUREADDRESS
D3DMCOLOR
D3DMTEXTUREFILTERTYPE
D3DMTEXTURETRANSFORMFLAGS
D3DMTA Values