SoTextureCombiner Class Reference
[Textures]

Texture combiner node. More...

#include <Inventor/nodes/SoTextureCombiner.h>

Inheritance diagram for SoTextureCombiner:

List of all members.

Public Types
enum	CombineFunction {   REPLACE = GL_REPLACE,   MODULATE = GL_MODULATE,   ADD = GL_ADD,   ADD_SIGNED = GL_ADD_SIGNED,   INTERPOLATE = GL_INTERPOLATE,   SUBTRACT = GL_SUBTRACT,   DOT3_RGB = GL_DOT3_RGB,   DOT3_RGBA = GL_DOT3_RGBA }
enum	SourceParameter {   CONSTANT = GL_CONSTANT,   PRIMARY_COLOR = GL_PRIMARY_COLOR,   PREVIOUS = GL_PREVIOUS,   TEXTURE = GL_TEXTURE,   TEXTURE0,   TEXTURE1,   TEXTURE2,   TEXTURE3,   TEXTURE4,   TEXTURE5,   TEXTURE6,   TEXTURE7 }
enum	OperandRGBA {   SRC_COLOR = GL_SRC_COLOR,   ONE_MINUS_SRC_COLOR = GL_ONE_MINUS_SRC_COLOR,   SRC_ALPHA = GL_SRC_ALPHA,   ONE_MINUS_SRC_ALPHA = GL_ONE_MINUS_SRC_ALPHA }
Public Member Functions
virtual SoType	getTypeId () const
	SoTextureCombiner ()
Static Public Member Functions
static SoType	getClassTypeId ()
Public Attributes
SoSFEnum	combineRGB
SoSFEnum	combineAlpha
SoSFEnum	source0RGB
SoSFEnum	source1RGB
SoSFEnum	source2RGB
SoSFEnum	source0Alpha
SoSFEnum	source1Alpha
SoSFEnum	source2Alpha
SoSFEnum	operand0RGB
SoSFEnum	operand1RGB
SoSFEnum	operand2RGB
SoSFEnum	operand0Alpha
SoSFEnum	operand1Alpha
SoSFEnum	operand2Alpha
SoSFFloat	scaleRGB
SoSFFloat	scaleAlpha
SoSFVec4f	constantColor

---

Detailed Description

Texture combiner node.

The Texture Combine Environment Mode is a texture environment function that provides a wide range of programmable combiner functions using the incoming fragment color, texture source color, texture constant color, and the result of the previous texture environment stage as possible parameters. Texture Dot3 Environment offers new combiner function to Texture Combine Environment Mode. Texture Crossbar Environment Mode extends the Texture Combine Environment Mode by allowing use of the texture color from different texture units as sources to the texture combine function.

FILE FORMAT/DEFAULT

TextureCombiner {

combineRGB	MODULATE
combineAlpha	MODULATE
source0RGB	TEXTURE
source1RGB	PREVIOUS
source2RGB	CONSTANT
source0Alpha	TEXTURE
source1Alpha	PREVIOUS
source2Alpha	CONSTANT
operand0RGB	SRC_COLOR
operand1RGB	SRC_COLOR
operand2RGB	SRC_ALPHA
operand0Alpha	SRC_ALPHA
operand1Alpha	SRC_ALPHA
operand2Alpha	SRC_ALPHA
scaleRGB	1.0
scaleAlpha	1.0
constantColor	0.0 0.0 0.0 0.0

}

ACTION BEHAVIOR

Sets: SoTextureCombinerElement

SEE ALSO

SoComplexity, SoExtTexture2, SoMaterial, SoTexture, SoTexture2, SoTexture2Transform, SoTexture3, SoTextureCoordinate2, SoTextureCoordinateBinding, SoTextureCoordinateFunction, SoTextureCubeMap, SoTextureUnit

---

Member Enumeration Documentation

enum SoTextureCombiner::CombineFunction

Texture Combiner Functions.

Enumerator:

REPLACE	Output fragment is source0.
MODULATE	Output fragment is source0 * source1.
ADD	Output fragment is source0 + source1.
ADD_SIGNED	Output fragment is source0 + source1 - 0.5.
INTERPOLATE	Output fragment is source0 * source2 + source1 * (1 - source2).
SUBTRACT	Output fragment is source0 - source1.
DOT3_RGB	Output fragment R = G = B = 4*((source0r - 0.5) * (source1r -0.5) + (source0g - 0.5) * (source1g -0.5) + (source0b - 0.5) * (source1b -0.5) ) Requires GL_ARB_TEXTURE_ENV_DOT3.
DOT3_RGBA	Output fragment R = G = B = A = 4*((source0r - 0.5) * (source1r -0.5) + (source0g - 0.5) * (source1g -0.5) + (source0b - 0.5) * (source1b -0.5) ) Requires GL_ARB_TEXTURE_ENV_DOT3.

enum SoTextureCombiner::OperandRGBA

Specifies the input mapping for the RGB and alpha portions of operand n.

See OpenGL documentation for details.

Enumerator:

SRC_COLOR	(Cred, Cgreen, Cblue). Not accepted for alpha operands.
ONE_MINUS_SRC_COLOR	(1 - Cred, 1 - Cgreen, 1 - Cblue). Not accepted for alpha operands.
SRC_ALPHA	(Calpha, Calpha, Calpha).
ONE_MINUS_SRC_ALPHA	(1 - Calpha, 1 - Calpha, 1 - Calpha).

enum SoTextureCombiner::SourceParameter

Source Parameter enumeration values.

Enumerator:

CONSTANT	Texture environment constant color. Use the constantColor field to specify the color.
PRIMARY_COLOR	Primary color of the incoming fragment.
PREVIOUS	Result of previous texture combiner. On texture unit 0, corresponds to PRIMARY_COLOR.
TEXTURE	Texture color of the current texture unit.
TEXTURE0	Texture color of texture unit 0. Requires GL_ARB_texture_env_crossbar.
TEXTURE1	Texture color of texture unit 1. Requires GL_ARB_texture_env_crossbar.
TEXTURE2	Texture color of texture unit 2. Requires GL_ARB_texture_env_crossbar.
TEXTURE3	Texture color of texture unit 3. Requires GL_ARB_texture_env_crossbar.
TEXTURE4	Texture color of texture unit 4. Requires GL_ARB_texture_env_crossbar.
TEXTURE5	Texture color of texture unit 5. Requires GL_ARB_texture_env_crossbar.
TEXTURE6	Texture color of texture unit 6. Requires GL_ARB_texture_env_crossbar.
TEXTURE7	Texture color of texture unit 7. Requires GL_ARB_texture_env_crossbar.

---

Constructor & Destructor Documentation

SoTextureCombiner::SoTextureCombiner

(

)

Constructor.

---

Member Function Documentation

static SoType SoTextureCombiner::getClassTypeId

(

)

[static]

Returns the type identifier for this class.

Reimplemented from SoNode.

virtual SoType SoTextureCombiner::getTypeId

(

)

const [virtual]

Returns the type identifier for this specific instance.

Reimplemented from SoNode.

---

Member Data Documentation

SoSFEnum SoTextureCombiner::combineAlpha

Specifies the texture combiner function to apply on the source<n>Alpha transformed by the operand<n>Alpha.

Use enum CombineFunction. Default is MODULATE.

SoSFEnum SoTextureCombiner::combineRGB

Specifies the texture combiner function to apply on the source<n>RGB transformed by the operand<n>RGB.

Use enum CombineFunction. Default is MODULATE.

SoSFVec4f SoTextureCombiner::constantColor

Specifies a constant color.

Used when SourceParameter enum is CONSTANT.

SoSFEnum SoTextureCombiner::operand0Alpha

Specifies an operand to be applied on the source0Alpha before applying the combiner.

Use enum OperandRGBA but only the two last values: SRC_ALPHA or ONE_MINUS_SRC_ALPHA. Default is SRC_ALPHA.

SoSFEnum SoTextureCombiner::operand0RGB

Specifies an operand to be applied on the source0RGB before applying the combiner.

Use enum OperandRGBA. Default is SRC_COLOR.

SoSFEnum SoTextureCombiner::operand1Alpha

Specifies an operand to be applied on the source1Alpha before applying the combiner.

Use enum OperandRGBA but only the two last values: SRC_ALPHA or ONE_MINUS_SRC_ALPHA. Default is SRC_ALPHA.

SoSFEnum SoTextureCombiner::operand1RGB

Specifies an operand to be applied on the source1RGB before applying the combiner.

Use enum OperandRGBA. Default is SRC_COLOR.

SoSFEnum SoTextureCombiner::operand2Alpha

Specifies an operand to be applied on the source2Alpha before applying the combiner.

Use enum OperandRGBA but only the two last values: SRC_ALPHA or ONE_MINUS_SRC_ALPHA. Default is SRC_ALPHA.

SoSFEnum SoTextureCombiner::operand2RGB

Specifies an operand to be applied on the source2RGB before applying the combiner.

Use enum OperandRGBA. Default is SRC_ALPHA.

SoSFFloat SoTextureCombiner::scaleAlpha

Specifies the alpha scale for the entire texture operation and may be 1.0, 2.0, or 4.0.

SoSFFloat SoTextureCombiner::scaleRGB

Specifies the RGB scale for the entire texture operation and may be 1.0, 2.0, or 4.0.

SoSFEnum SoTextureCombiner::source0Alpha

Specifies one of the three sources for the alpha components.

Use enum SourceParameter. Default is TEXTURE.

SoSFEnum SoTextureCombiner::source0RGB

Specifies one of the three sources for the RGB components.

Use enum SourceParameter. Default is TEXTURE.

SoSFEnum SoTextureCombiner::source1Alpha

Specifies one of the three sources for the alpha components.

Use enum SourceParameter. Default is PREVIOUS .

SoSFEnum SoTextureCombiner::source1RGB

Specifies one of the three sources for the RGB components.

Use enum SourceParameter. Default is PREVIOUS .

SoSFEnum SoTextureCombiner::source2Alpha

Specifies one of the three sources for the alpha components.

Use enum SourceParameter. Default is CONSTANT.

SoSFEnum SoTextureCombiner::source2RGB

Specifies one of the three sources for the RGB components.

Use enum SourceParameter. Default is CONSTANT.

---

The documentation for this class was generated from the following file:

• Inventor/nodes/SoTextureCombiner.h