TextureOperation Enumeration (Microsoft.DirectX.Direct3D)

Article
06/29/2006

Defines per-stage texture-blending operations.

Definition

Visual Basic Public Enum TextureOperation

C# public enum TextureOperation

C++ public enum class TextureOperation

JScript public enum TextureOperation

Members

Member Value Description

Subtract 10 Subtracts the components of the second argument from those of the first argument.
S_RGBA = Arg1 - Arg2

Lerp 26 Performs linear interpolation between the second and third source arguments by a proportion specified in the first source argument.
S_RGBA = (Arg1) * Arg2 + (1- Arg1) * Arg3.

MultiplyAdd 25 Performs a multiply-accumulate operation, in which it multiplies the last two arguments, adds them to the remaining input/source argument, and places that into the result.
S_RGBA = Arg1 + Arg2 *Arg3

DotProduct3 24 Modulates the components of each argument as signed components, adds their products, and replicates the sum to all color channels, including alpha. This operation is supported for color and alpha operations.
S_RGBA = (Arg1_R * Arg2_R + Arg1_G * Arg2_G + Arg1_B * Arg2_B)

BumpEnvironmentMapLuminance 23 Performs per-pixel bump mapping, using the environment map in the next texture stage with luminance. This operation is supported only for color operations (TextureState.ColorOperation).

BumpEnvironmentMap 22 Performs bump mapping on each pixel, using the environment map in the next texture stage without luminance. This operation is supported only for color operations (TextureState.ColorOperation).

ModulateInvColorAddAlpha 21 Similar to ModulateColorAddAlpha, but uses the inverse of the color of the first argument. This operation is supported only for color operations (TextureState.ColorOperation).
S_RGBA = (1 - Arg1_RGB) * Arg2_RGB + Arg1_A

ModulateInvAlphaAddColor 20 Similar to ModulateAlphaAddColor, but uses the inverse of the alpha of the first argument. This operation is supported only for color operations (TextureState.ColorOperation).
S_RGBA = (1 - Arg1_A) * Arg2_RGB + Arg1_RGB

ModulateColorAddAlpha 19 Modulates the arguments, then adds the alpha of the first argument. This operation is supported only for color operations (TextureState.ColorOperation).
S_RGBA = Arg1_RGB * Arg2_RGB + Arg1_A

ModulateAlphaAddColor 18 Modulates the color of the second argument using the alpha of the first argument, then adds the result to argument one. This operation is supported only for color operations (TextureStateManager.ColorOperation).
S_RGBA = Arg1_RGB + Arg1_A * Arg2_RGB

PreModulate 17 This flag is set in stage n, the output of which is arg1. If stage n + 1 contains a texture, any Current value in stage n + 1 is premultiplied by that texture.

BlendCurrentAlpha 16 Performs linear blending on the current texture stage, using the alpha taken from the previous texture stage.
S_RGBA = Arg1 * (Alpha) + Arg2 * (1 - Alpha)

BlendTextureAlphaPM 15 Performs linear blending on the current texture stage that uses a premultiplied alpha.
S_RGBA = Arg1 + Arg2 * (1 - Alpha)

BlendFactorAlpha 14 Performs linear blending on the current texture stage, using a scalar alpha set with the RenderStateManager.TextureFactor property.
S_RGBA = Arg1 * (Alpha) + Arg2 * (1 - Alpha)

BlendTextureAlpha 13 Performs linear blending on the current texture stage, using the interpolated alpha from each vertex.
S_RGBA = Arg1 * (Alpha) + Arg2 * (1 - Alpha)

BlendDiffuseAlpha 12 Performs linear blending on the current texture stage, using the interpolated alpha from each vertex.
S_RGBA = Arg1 * (Alpha) + Arg2 * (1 - Alpha)

AddSmooth 11 Adds the first and second arguments, then subtracts their product from the sum.
S_RGBA = Arg1 + Arg2 - Arg1 * Arg2

AddSigned2X 9 Adds the components of the arguments with a -0.5 bias and shifts the products 1 bit to the left.
S_RGBA = (Arg1 + Arg2 - 0.5) << 1

AddSigned 8 Adds the components of the arguments with a -0.5 bias, making the effective range of values -0.5 through 0.5.
S_RGBA = Arg1 + Arg2 -0.5

Add 7 Adds the components of the arguments.
S_RGBA = Arg1 + Arg2

Modulate4X 6 Multiplies the components of the arguments, then shifts the products 2 bits to the left (effectively multiplying them by 4) for brightening.
S_RGBA = (Arg1 * Arg2) << 2

Modulate2X 5 Multiplies the components of the arguments, then shifts the products 1 bit to the left (effectively multiplying them by 2) for brightening.
S_RGBA = (Arg1 * Arg2) << 1

Modulate 4 Multiplies the components of the arguments.
S_RGBA = Arg1 * Arg2

SelectArg2 3 Uses this texture stage's second color or alpha argument, unmodified, as the output. This operation affects the color argument when used with the TextureStateManager.ColorOperation property, and the alpha argument when used with the TextureStateManager.AlphaOperation property.
S_RGBA = Arg2

SelectArg1 2 Uses this texture stage's first color or alpha argument, unmodified, as the output. This operation affects the color argument when used with the TextureStateManager.ColorOperation property, and the alpha argument when used with the TextureStateManager.AlphaOperation property.
S_RGBA = Arg1

Disable 1 Disables output from the texture stage and all stages with a higher index. To disable texture mapping, set this flag as the color operation for the first texture stage (stage 0). Alpha operations cannot be disabled when color operations are enabled. Setting the alpha operation to Disable when color blending is enabled causes undefined behavior.

Member	Value	Description
Subtract	10	Subtracts the components of the second argument from those of the first argument. S_RGBA = Arg1 - Arg2
Lerp	26	Performs linear interpolation between the second and third source arguments by a proportion specified in the first source argument. S_RGBA = (Arg1) * Arg2 + (1- Arg1) * Arg3.
MultiplyAdd	25	Performs a multiply-accumulate operation, in which it multiplies the last two arguments, adds them to the remaining input/source argument, and places that into the result. S_RGBA = Arg1 + Arg2 Arg3*
DotProduct3	24	Modulates the components of each argument as signed components, adds their products, and replicates the sum to all color channels, including alpha. This operation is supported for color and alpha operations. S_RGBA = (Arg1_R * Arg2_R + Arg1_G * Arg2_G + Arg1_B * Arg2_B)
BumpEnvironmentMapLuminance	23	Performs per-pixel bump mapping, using the environment map in the next texture stage with luminance. This operation is supported only for color operations (TextureState.ColorOperation).
BumpEnvironmentMap	22	Performs bump mapping on each pixel, using the environment map in the next texture stage without luminance. This operation is supported only for color operations (TextureState.ColorOperation).
ModulateInvColorAddAlpha	21	Similar to ModulateColorAddAlpha, but uses the inverse of the color of the first argument. This operation is supported only for color operations (TextureState.ColorOperation). S_RGBA = (1 - Arg1_RGB) * Arg2_RGB + Arg1_A
ModulateInvAlphaAddColor	20	Similar to ModulateAlphaAddColor, but uses the inverse of the alpha of the first argument. This operation is supported only for color operations (TextureState.ColorOperation). S_RGBA = (1 - Arg1_A) * Arg2_RGB + Arg1_RGB
ModulateColorAddAlpha	19	Modulates the arguments, then adds the alpha of the first argument. This operation is supported only for color operations (TextureState.ColorOperation). S_RGBA = Arg1_RGB * Arg2_RGB + Arg1_A
ModulateAlphaAddColor	18	Modulates the color of the second argument using the alpha of the first argument, then adds the result to argument one. This operation is supported only for color operations (TextureStateManager.ColorOperation). S_RGBA = Arg1_RGB + Arg1_A * Arg2_RGB
PreModulate	17	This flag is set in stage n, the output of which is arg1. If stage n + 1 contains a texture, any Current value in stage n + 1 is premultiplied by that texture.
BlendCurrentAlpha	16	Performs linear blending on the current texture stage, using the alpha taken from the previous texture stage. S_RGBA = Arg1 * (Alpha) + Arg2 * (1 - Alpha)
BlendTextureAlphaPM	15	Performs linear blending on the current texture stage that uses a premultiplied alpha. S_RGBA = Arg1 + Arg2 * (1 - Alpha)
BlendFactorAlpha	14	Performs linear blending on the current texture stage, using a scalar alpha set with the RenderStateManager.TextureFactor property. S_RGBA = Arg1 * (Alpha) + Arg2 * (1 - Alpha)
BlendTextureAlpha	13	Performs linear blending on the current texture stage, using the interpolated alpha from each vertex. S_RGBA = Arg1 * (Alpha) + Arg2 * (1 - Alpha)
BlendDiffuseAlpha	12	Performs linear blending on the current texture stage, using the interpolated alpha from each vertex. S_RGBA = Arg1 * (Alpha) + Arg2 * (1 - Alpha)
AddSmooth	11	Adds the first and second arguments, then subtracts their product from the sum. S_RGBA = Arg1 + Arg2 - Arg1 * Arg2
AddSigned2X	9	Adds the components of the arguments with a -0.5 bias and shifts the products 1 bit to the left. S_RGBA = (Arg1 + Arg2 - 0.5) << 1
AddSigned	8	Adds the components of the arguments with a -0.5 bias, making the effective range of values -0.5 through 0.5. S_RGBA = Arg1 + Arg2 -0.5
Add	7	Adds the components of the arguments. S_RGBA = Arg1 + Arg2
Modulate4X	6	Multiplies the components of the arguments, then shifts the products 2 bits to the left (effectively multiplying them by 4) for brightening. S_RGBA = (Arg1 * Arg2) << 2
Modulate2X	5	Multiplies the components of the arguments, then shifts the products 1 bit to the left (effectively multiplying them by 2) for brightening. S_RGBA = (Arg1 * Arg2) << 1
Modulate	4	Multiplies the components of the arguments. S_RGBA = Arg1 * Arg2
SelectArg2	3	Uses this texture stage's second color or alpha argument, unmodified, as the output. This operation affects the color argument when used with the TextureStateManager.ColorOperation property, and the alpha argument when used with the TextureStateManager.AlphaOperation property. S_RGBA = Arg2
SelectArg1	2	Uses this texture stage's first color or alpha argument, unmodified, as the output. This operation affects the color argument when used with the TextureStateManager.ColorOperation property, and the alpha argument when used with the TextureStateManager.AlphaOperation property. S_RGBA = Arg1
Disable	1	Disables output from the texture stage and all stages with a higher index. To disable texture mapping, set this flag as the color operation for the first texture stage (stage 0). Alpha operations cannot be disabled when color operations are enabled. Setting the alpha operation to Disable when color blending is enabled causes undefined behavior.

Enumeration Information

Namespace Microsoft.DirectX.Direct3D

Assembly Microsoft.DirectX.Direct3D (microsoft.directx.direct3d.dll)

Strong Name Microsoft.DirectX.Direct3D, Version=1.0.900.0, Culture=neutral, PublicKeyToken=d3231b57b74a1492

Share via

TextureOperation Enumeration (Microsoft.DirectX.Direct3D)

Additional resources

Visual Basic	Public Enum TextureOperation
C#	public enum TextureOperation
C++	public enum class TextureOperation
JScript	public enum TextureOperation

Namespace	Microsoft.DirectX.Direct3D
Assembly	Microsoft.DirectX.Direct3D (microsoft.directx.direct3d.dll)
Strong Name	Microsoft.DirectX.Direct3D, Version=1.0.900.0, Culture=neutral, PublicKeyToken=d3231b57b74a1492