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.Inventor

Inventor.ConstructorCommand

Field Summary

Fields

Modifier and Type	Field and Description
static int	ADD Deprecated. Use SoTextureCombiner.CombineFunctions.ADD instead.
static int	ADD_SIGNED Deprecated. Use SoTextureCombiner.CombineFunctions.ADD_SIGNED instead.
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.
static int	CONSTANT Deprecated. Use SoTextureCombiner.SourceParameters.CONSTANT instead.
SoSFVec4f	constantColor Specifies a constant color.
static int	DOT3_RGB Deprecated. Use SoTextureCombiner.CombineFunctions.DOT3_RGB instead.
static int	DOT3_RGBA Deprecated. Use SoTextureCombiner.CombineFunctions.DOT3_RGBA instead.
static int	INTERPOLATE Deprecated. Use SoTextureCombiner.CombineFunctions.INTERPOLATE instead.
static int	MODULATE Deprecated. Use SoTextureCombiner.CombineFunctions.MODULATE instead.
static int	ONE_MINUS_SRC_ALPHA Deprecated. Use SoTextureCombiner.OperandRGBAs.ONE_MINUS_SRC_ALPHA instead.
static int	ONE_MINUS_SRC_COLOR Deprecated. Use SoTextureCombiner.OperandRGBAs.ONE_MINUS_SRC_COLOR instead.
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.
static int	PREVIOUS Deprecated. Use SoTextureCombiner.SourceParameters.PREVIOUS instead.
static int	PRIMARY_COLOR Deprecated. Use SoTextureCombiner.SourceParameters.PRIMARY_COLOR instead.
static int	REPLACE Deprecated. Use SoTextureCombiner.CombineFunctions.REPLACE instead.
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.
static int	SRC_ALPHA Deprecated. Use SoTextureCombiner.OperandRGBAs.SRC_ALPHA instead.
static int	SRC_COLOR Deprecated. Use SoTextureCombiner.OperandRGBAs.SRC_COLOR instead.
static int	SUBTRACT Deprecated. Use SoTextureCombiner.CombineFunctions.SUBTRACT instead.
static int	TEXTURE Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE instead.
static int	TEXTURE0 Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE0 instead.
static int	TEXTURE1 Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE1 instead.
static int	TEXTURE2 Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE2 instead.
static int	TEXTURE3 Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE3 instead.
static int	TEXTURE4 Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE4 instead.
static int	TEXTURE5 Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE5 instead.
static int	TEXTURE6 Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE6 instead.
static int	TEXTURE7 Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE7 instead.

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, 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, getEXTERNPROTO, getName, getPROTO, isDisposable, isSynchronizable, setName, setSynchronizable

Methods inherited from class com.openinventor.inventor.Inventor

getAddress, getNativeResourceHandle, startInternalThreads, stopInternalThreads

Methods inherited from class java.lang.Object

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

Field Detail

REPLACE

@Deprecated
public static final int REPLACE

Deprecated. Use SoTextureCombiner.CombineFunctions.REPLACE instead.

MODULATE

@Deprecated
public static final int MODULATE

Deprecated. Use SoTextureCombiner.CombineFunctions.MODULATE instead.

ADD

@Deprecated
public static final int ADD

Deprecated. Use SoTextureCombiner.CombineFunctions.ADD instead.

ADD_SIGNED

@Deprecated
public static final int ADD_SIGNED

Deprecated. Use SoTextureCombiner.CombineFunctions.ADD_SIGNED instead.

INTERPOLATE

@Deprecated
public static final int INTERPOLATE

Deprecated. Use SoTextureCombiner.CombineFunctions.INTERPOLATE instead.

SUBTRACT

@Deprecated
public static final int SUBTRACT

Deprecated. Use SoTextureCombiner.CombineFunctions.SUBTRACT instead.

DOT3_RGB

@Deprecated
public static final int DOT3_RGB

Deprecated. Use SoTextureCombiner.CombineFunctions.DOT3_RGB instead.

DOT3_RGBA

@Deprecated
public static final int DOT3_RGBA

Deprecated. Use SoTextureCombiner.CombineFunctions.DOT3_RGBA instead.

CONSTANT

@Deprecated
public static final int CONSTANT

Deprecated. Use SoTextureCombiner.SourceParameters.CONSTANT instead.

PRIMARY_COLOR

@Deprecated
public static final int PRIMARY_COLOR

Deprecated. Use SoTextureCombiner.SourceParameters.PRIMARY_COLOR instead.

PREVIOUS

@Deprecated
public static final int PREVIOUS

Deprecated. Use SoTextureCombiner.SourceParameters.PREVIOUS instead.

TEXTURE

@Deprecated
public static final int TEXTURE

Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE instead.

TEXTURE0

@Deprecated
public static final int TEXTURE0

Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE0 instead.

TEXTURE1

@Deprecated
public static final int TEXTURE1

Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE1 instead.

TEXTURE2

@Deprecated
public static final int TEXTURE2

Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE2 instead.

TEXTURE3

@Deprecated
public static final int TEXTURE3

Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE3 instead.

TEXTURE4

@Deprecated
public static final int TEXTURE4

Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE4 instead.

TEXTURE5

@Deprecated
public static final int TEXTURE5

Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE5 instead.

TEXTURE6

@Deprecated
public static final int TEXTURE6

Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE6 instead.

TEXTURE7

@Deprecated
public static final int TEXTURE7

Deprecated. Use SoTextureCombiner.SourceParameters.TEXTURE7 instead.

SRC_COLOR

@Deprecated
public static final int SRC_COLOR

Deprecated. Use SoTextureCombiner.OperandRGBAs.SRC_COLOR instead.

ONE_MINUS_SRC_COLOR

@Deprecated
public static final int ONE_MINUS_SRC_COLOR

Deprecated. Use SoTextureCombiner.OperandRGBAs.ONE_MINUS_SRC_COLOR instead.

SRC_ALPHA

@Deprecated
public static final int SRC_ALPHA

Deprecated. Use SoTextureCombiner.OperandRGBAs.SRC_ALPHA instead.

ONE_MINUS_SRC_ALPHA

@Deprecated
public static final int ONE_MINUS_SRC_ALPHA

Deprecated. Use SoTextureCombiner.OperandRGBAs.ONE_MINUS_SRC_ALPHA instead.

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.