Package com.openinventor.inventor.nodes

Class SoTextureCombiner

java.lang.Object

com.openinventor.inventor.Inventor

com.openinventor.inventor.misc.SoBase

com.openinventor.inventor.fields.SoFieldContainer

com.openinventor.inventor.nodes.SoNode

com.openinventor.inventor.nodes.SoTextureCombiner

All Implemented Interfaces:

SafeDisposable

public class SoTextureCombiner
extends SoNode

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

Nested Class Summary

Nested Classes

Modifier and Type	Class	Description
static enum	SoTextureCombiner.CombineFunctions	Texture Combiner Functions.
static enum	SoTextureCombiner.OperandRGBAs	Specifies the input mapping for the RGB and alpha portions of operand n.
static enum	SoTextureCombiner.SourceParameters	Source Parameter enumeration values.

Nested classes/interfaces inherited from class com.openinventor.inventor.nodes.SoNode

SoNode.RenderModes

Nested classes/interfaces inherited from class com.openinventor.inventor.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field	Description
final SoSFEnum<SoTextureCombiner.CombineFunctions>	combineAlpha	Specifies the texture combiner function to apply on the source<n>Alpha transformed by the operand<n>Alpha.
final SoSFEnum<SoTextureCombiner.CombineFunctions>	combineRGB	Specifies the texture combiner function to apply on the source<n>RGB transformed by the operand<n>RGB.
final SoSFVec4f	constantColor	Specifies a constant color.
final SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand0Alpha	Specifies an operand to be applied on the source0Alpha before applying the combiner.
final SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand0RGB	Specifies an operand to be applied on the source0RGB before applying the combiner.
final SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand1Alpha	Specifies an operand to be applied on the source1Alpha before applying the combiner.
final SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand1RGB	Specifies an operand to be applied on the source1RGB before applying the combiner.
final SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand2Alpha	Specifies an operand to be applied on the source2Alpha before applying the combiner.
final SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand2RGB	Specifies an operand to be applied on the source2RGB before applying the combiner.
final SoSFFloat	scaleAlpha	Specifies the alpha scale for the entire texture operation and may be 1.0, 2.0, or 4.0.
final SoSFFloat	scaleRGB	Specifies the RGB scale for the entire texture operation and may be 1.0, 2.0, or 4.0.
final SoSFEnum<SoTextureCombiner.SourceParameters>	source0Alpha	Specifies one of the three sources for the alpha components.
final SoSFEnum<SoTextureCombiner.SourceParameters>	source0RGB	Specifies one of the three sources for the RGB components.
final SoSFEnum<SoTextureCombiner.SourceParameters>	source1Alpha	Specifies one of the three sources for the alpha components.
final SoSFEnum<SoTextureCombiner.SourceParameters>	source1RGB	Specifies one of the three sources for the RGB components.
final SoSFEnum<SoTextureCombiner.SourceParameters>	source2Alpha	Specifies one of the three sources for the alpha components.
final SoSFEnum<SoTextureCombiner.SourceParameters>	source2RGB	Specifies one of the three sources for the RGB components.

Fields inherited from class com.openinventor.inventor.Inventor

VERBOSE_LEVEL, ZeroHandle

Constructor Summary

Constructors

Constructor	Description
SoTextureCombiner()	Constructor.

Method Summary

Methods inherited from class com.openinventor.inventor.nodes.SoNode

affectsState, callback, copy, copy, distribute, doAction, getAlternateRep, getBoundingBox, getByName, getMatrix, getPrimitiveCount, getRenderEngineMode, getRenderUnitID, GLRender, GLRenderBelowPath, GLRenderInPath, GLRenderOffPath, grabEventsCleanup, grabEventsSetup, handleEvent, isBoundingBoxIgnoring, isOverride, pick, rayPick, search, setOverride, touch, write

Methods inherited from class com.openinventor.inventor.fields.SoFieldContainer

copyFieldValues, copyFieldValues, enableNotify, fieldsAreEqual, get, getAllFields, getEventIn, getEventOut, getField, getFieldName, hasDefaultValues, isNotifyEnabled, set, setToDefaults

Methods inherited from class com.openinventor.inventor.misc.SoBase

dispose, getName, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getNativeResourceHandle

Methods inherited from class java.lang.Object

equals, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait

Field Details

combineRGB

public final SoSFEnum<SoTextureCombiner.CombineFunctions> combineRGB

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

combineAlpha

public final SoSFEnum<SoTextureCombiner.CombineFunctions> combineAlpha

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

source0RGB

public final SoSFEnum<SoTextureCombiner.SourceParameters> source0RGB

Specifies one of the three sources for the RGB components. . Default is TEXTURE.

source1RGB

public final SoSFEnum<SoTextureCombiner.SourceParameters> source1RGB

Specifies one of the three sources for the RGB components. . Default is PREVIOUS .

source2RGB

public final SoSFEnum<SoTextureCombiner.SourceParameters> source2RGB

Specifies one of the three sources for the RGB components. . Default is CONSTANT.

source0Alpha

public final SoSFEnum<SoTextureCombiner.SourceParameters> source0Alpha

Specifies one of the three sources for the alpha components. . Default is TEXTURE.

source1Alpha

public final SoSFEnum<SoTextureCombiner.SourceParameters> source1Alpha

Specifies one of the three sources for the alpha components. . Default is PREVIOUS .

source2Alpha

public final SoSFEnum<SoTextureCombiner.SourceParameters> source2Alpha

Specifies one of the three sources for the alpha components. . Default is CONSTANT.

operand0RGB

public final SoSFEnum<SoTextureCombiner.OperandRGBAs> operand0RGB

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

operand1RGB

public final SoSFEnum<SoTextureCombiner.OperandRGBAs> operand1RGB

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

operand2RGB

public final SoSFEnum<SoTextureCombiner.OperandRGBAs> operand2RGB

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

operand0Alpha

public final SoSFEnum<SoTextureCombiner.OperandRGBAs> operand0Alpha

Specifies an operand to be applied on the source0Alpha before applying the combiner. but only the two last values: SRC_ALPHA or ONE_MINUS_SRC_ALPHA. Default is SRC_ALPHA.

operand1Alpha

public final SoSFEnum<SoTextureCombiner.OperandRGBAs> operand1Alpha

Specifies an operand to be applied on the source1Alpha before applying the combiner. but only the two last values: SRC_ALPHA or ONE_MINUS_SRC_ALPHA. Default is SRC_ALPHA.

operand2Alpha

public final SoSFEnum<SoTextureCombiner.OperandRGBAs> operand2Alpha

Specifies an operand to be applied on the source2Alpha before applying the combiner. but only the two last values: SRC_ALPHA or ONE_MINUS_SRC_ALPHA. Default is SRC_ALPHA.

scaleRGB

public final SoSFFloat scaleRGB

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

scaleAlpha

public final SoSFFloat scaleAlpha

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

constantColor

public final SoSFVec4f constantColor

Specifies a constant color. Used when SourceParameter enum is CONSTANT.

Constructor Details

SoTextureCombiner

public SoTextureCombiner()

Constructor.