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 and Description
static class	SoTextureCombiner.CombineFunctions Texture Combiner Functions.
static class	SoTextureCombiner.OperandRGBAs Specifies the input mapping for the RGB and alpha portions of operand n.
static class	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 and Description
SoSFEnum<SoTextureCombiner.CombineFunctions>	combineAlpha Specifies the texture combiner function to apply on the source<n>Alpha transformed by the operand<n>Alpha.
SoSFEnum<SoTextureCombiner.CombineFunctions>	combineRGB Specifies the texture combiner function to apply on the source<n>RGB transformed by the operand<n>RGB.
SoSFVec4f	constantColor Specifies a constant color.
SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand0Alpha Specifies an operand to be applied on the source0Alpha before applying the combiner.
SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand0RGB Specifies an operand to be applied on the source0RGB before applying the combiner.
SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand1Alpha Specifies an operand to be applied on the source1Alpha before applying the combiner.
SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand1RGB Specifies an operand to be applied on the source1RGB before applying the combiner.
SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand2Alpha Specifies an operand to be applied on the source2Alpha before applying the combiner.
SoSFEnum<SoTextureCombiner.OperandRGBAs>	operand2RGB Specifies an operand to be applied on the source2RGB before applying the combiner.
SoSFFloat	scaleAlpha Specifies the alpha scale for the entire texture operation and may be 1.0, 2.0, or 4.0.
SoSFFloat	scaleRGB Specifies the RGB scale for the entire texture operation and may be 1.0, 2.0, or 4.0.
SoSFEnum<SoTextureCombiner.SourceParameters>	source0Alpha Specifies one of the three sources for the alpha components.
SoSFEnum<SoTextureCombiner.SourceParameters>	source0RGB Specifies one of the three sources for the RGB components.
SoSFEnum<SoTextureCombiner.SourceParameters>	source1Alpha Specifies one of the three sources for the alpha components.
SoSFEnum<SoTextureCombiner.SourceParameters>	source1RGB Specifies one of the three sources for the RGB components.
SoSFEnum<SoTextureCombiner.SourceParameters>	source2Alpha Specifies one of the three sources for the alpha components.
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 and 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 Detail

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 Detail

SoTextureCombiner

public SoTextureCombiner()

Constructor.