javax.media.j3d

Class TransparencyAttributes

java.lang.Object

javax.media.j3d.SceneGraphObject

javax.media.j3d.NodeComponent

javax.media.j3d.TransparencyAttributes

public class TransparencyAttributes
extends NodeComponent

The TransparencyAttributes object defines all attributes affecting transparency of the object. The transparency attributes are:

• Transparency mode - defines how transparency is applied to this Appearance component object:
• FASTEST - uses the fastest available method for transparency.
• NICEST - uses the nicest available method for transparency.
• SCREEN_DOOR - uses screen-door transparency. This is done using an on/off stipple pattern in which the percentage of transparent pixels is approximately equal to the value specified by the transparency parameter.
• BLENDED - uses alpha blended transparency. The blend equation is specified by the srcBlendFunction and dstBlendFunction attributes. The default equation is:
  alphasrc*src + (1-alphasrc)*dst
  where alphasrc is 1-transparency. When this mode is used with a Raster object or with a Geometry that contains per-vertex colors with alpha, the alpha values in the Raster's image or in the Geometry's per-vertex colors are combined with the transparency value in this TransparencyAttributes object to perform blending. In this case, the alpha value used for blending at each pixel is:
  alphasrc = alphapix * (1-transparency).
• NONE - no transparency; opaque object.

• Transparency value - the amount of transparency to be applied to this Appearance component object. The transparency values are in the range [0.0, 1.0], with 0.0 being fully opaque and 1.0 being fully transparent.
• Blend function - used in blended transparency and antialiasing operations. The source function specifies the factor that is multiplied by the source color. This value is added to the product of the destination factor and the destination color. The default source blend function is BLEND_SRC_ALPHA. The source blend function is one of the following:
• BLEND_ZERO - the blend function is f = 0
• BLEND_ONE - the blend function is f = 1
• BLEND_SRC_ALPHA - the blend function is f = alphasrc
• BLEND_ONE_MINUS_SRC_ALPHA - the blend function is f = 1 - alphasrc
• BLEND_DST_COLOR - the blend function is f = colordst
• BLEND_ONE_MINUS_DST_COLOR - the blend function is f = 1 - colordst
• BLEND_SRC_COLOR - the blend function is f = colorsrc
• BLEND_ONE_MINUS_SRC_COLOR - the blend function is f = 1 - colorsrc

Field Summary

Fields

Modifier and Type	Field and Description
static int	ALLOW_BLEND_FUNCTION_READ Specifies that this TransparencyAttributes object allows reading its blend function.
static int	ALLOW_BLEND_FUNCTION_WRITE Specifies that this TransparencyAttributes object allows writing its blend function.
static int	ALLOW_MODE_READ Specifies that this TransparencyAttributes object allows reading its transparency mode component information.
static int	ALLOW_MODE_WRITE Specifies that this TransparencyAttributes object allows writing its transparency mode component information.
static int	ALLOW_VALUE_READ Specifies that this TransparencyAttributes object allows reading its transparency value.
static int	ALLOW_VALUE_WRITE Specifies that this TransparencyAttributes object allows writing its transparency value.
(package private) static int	BLEND_CONSTANT_COLOR
static int	BLEND_DST_COLOR Blend function: f = colordst.
static int	BLEND_ONE Blend function: f = 1.
static int	BLEND_ONE_MINUS_DST_COLOR Blend function: f = 1-colordst.
static int	BLEND_ONE_MINUS_SRC_ALPHA Blend function: f = 1-alphasrc.
static int	BLEND_ONE_MINUS_SRC_COLOR Blend function: f = 1-colorsrc.
static int	BLEND_SRC_ALPHA Blend function: f = alphasrc.
static int	BLEND_SRC_COLOR Blend function: f = colorsrc.
static int	BLEND_ZERO Blend function: f = 0.
static int	BLENDED Use alpha blended transparency.
static int	FASTEST Use the fastest available method for transparency.
(package private) static int	MAX_BLEND_FUNC_TABLE_SIZE
static int	NICEST Use the nicest available method for transparency.
static int	NONE No transparency, opaque object.
private static int[]	readCapabilities
static int	SCREEN_DOOR Use screen-door transparency.

Fields inherited from class javax.media.j3d.NodeComponent

forceDuplicate

Fields inherited from class javax.media.j3d.SceneGraphObject

nodeHashtable, retained

Constructor Summary

Constructors

Constructor and Description
TransparencyAttributes() Constructs a TransparencyAttributes object with default parameters.
TransparencyAttributes(int tMode, float tVal) Construct TransparencyAttributes object with specified values.
TransparencyAttributes(int tMode, float tVal, int srcBlendFunction, int dstBlendFunction) Construct TransparencyAttributes object with specified values.

Method Summary

Methods

Modifier and Type	Method and Description
NodeComponent	cloneNodeComponent() Deprecated. replaced with cloneNodeComponent(boolean forceDuplicate)
(package private) void	createRetained() Creates a retained mode TransparencyAttributesRetained object that this TransparencyAttributes component object will point to.
(package private) void	duplicateAttributes(NodeComponent originalNodeComponent, boolean forceDuplicate) Copies all node information from originalNodeComponent into the current node.
int	getDstBlendFunction() Gets the destination blend function for this TransparencyAttributes object.
int	getSrcBlendFunction() Gets the source blend function for this TransparencyAttributes object.
float	getTransparency() Retrieves this appearance's transparency.
int	getTransparencyMode() Gets the transparency mode for this appearance component object.
void	setDstBlendFunction(int blendFunction) Sets the destination blend function used in blended transparency and antialiasing operations.
void	setSrcBlendFunction(int blendFunction) Sets the source blend function used in blended transparency and antialiasing operations.
void	setTransparency(float transparency) Sets this appearance's transparency.
void	setTransparencyMode(int transparencyMode) Sets the transparency mode for this appearance component object.

Methods inherited from class javax.media.j3d.NodeComponent

checkDuplicateNodeComponent, cloneNodeComponent, duplicateChild, duplicateNodeComponent, duplicateNodeComponent, getDuplicateOnCloneTree, setDuplicateOnCloneTree, validateImageIllegalSharing

Methods inherited from class javax.media.j3d.SceneGraphObject

capabilityBitsEmpty, checkForLiveOrCompiled, clearCapability, clearCapabilityIsFrequent, clearLive, duplicateSceneGraphObject, getCapability, getCapabilityIsFrequent, getName, getNamePrefix, getNodeComponent, getUserData, isCompiled, isLive, isLiveOrCompiled, setCapability, setCapabilityIsFrequent, setCompiled, setDefaultReadCapabilities, setLive, setName, setUserData, toString, updateNodeReferences

Methods inherited from class java.lang.Object

clone, equals, finalize, getClass, hashCode, notify, notifyAll, wait, wait, wait

Field Detail

ALLOW_MODE_READ

public static final int ALLOW_MODE_READ

Specifies that this TransparencyAttributes object allows reading its transparency mode component information.

See Also:

Constant Field Values

ALLOW_MODE_WRITE

public static final int ALLOW_MODE_WRITE

Specifies that this TransparencyAttributes object allows writing its transparency mode component information.

See Also:

Constant Field Values

ALLOW_VALUE_READ

public static final int ALLOW_VALUE_READ

Specifies that this TransparencyAttributes object allows reading its transparency value.

See Also:

Constant Field Values

ALLOW_VALUE_WRITE

public static final int ALLOW_VALUE_WRITE

Specifies that this TransparencyAttributes object allows writing its transparency value.

See Also:

Constant Field Values

ALLOW_BLEND_FUNCTION_READ

public static final int ALLOW_BLEND_FUNCTION_READ

Specifies that this TransparencyAttributes object allows reading its blend function.

Since:

Java 3D 1.2

See Also:

Constant Field Values

ALLOW_BLEND_FUNCTION_WRITE

public static final int ALLOW_BLEND_FUNCTION_WRITE

Specifies that this TransparencyAttributes object allows writing its blend function.

Since:

Java 3D 1.2

See Also:

Constant Field Values

FASTEST

public static final int FASTEST

Use the fastest available method for transparency.

See Also:

setTransparencyMode(int), Constant Field Values

NICEST

public static final int NICEST

Use the nicest available method for transparency.

See Also:

setTransparencyMode(int), Constant Field Values

BLENDED

public static final int BLENDED

Use alpha blended transparency. The blend equation is specified by the srcBlendFunction and dstBlendFunction attributes. The default equation is:

alphasrc*src + (1-alphasrc)*dst

where alphasrc is 1-transparency. When this mode is used with a Raster object or with a Geometry that contains per-vertex colors with alpha, the alpha values in the Raster's image or in the Geometry's per-vertex colors are combined with the transparency value in this TransparencyAttributes object to perform blending. In this case, the alpha value used for blending at each pixel is:

alphasrc = alphapix * (1-transparency).

See Also:

setTransparencyMode(int), setSrcBlendFunction(int), setDstBlendFunction(int), Constant Field Values

SCREEN_DOOR

public static final int SCREEN_DOOR

Use screen-door transparency. This is done using an on/off stipple pattern where the percentage of pixels that are transparent is approximately equal to the value specified by the transparency parameter.

See Also:

setTransparencyMode(int), Constant Field Values

NONE

public static final int NONE

No transparency, opaque object.

See Also:

setTransparencyMode(int), Constant Field Values

BLEND_ZERO

public static final int BLEND_ZERO

Blend function: f = 0.

Since:

Java 3D 1.2

See Also:

setSrcBlendFunction(int), setDstBlendFunction(int), Constant Field Values

BLEND_ONE

public static final int BLEND_ONE

Blend function: f = 1.

Since:

Java 3D 1.2

See Also:

setSrcBlendFunction(int), setDstBlendFunction(int), Constant Field Values

BLEND_SRC_ALPHA

public static final int BLEND_SRC_ALPHA

Blend function: f = alphasrc.

Since:

Java 3D 1.2

See Also:

setSrcBlendFunction(int), setDstBlendFunction(int), Constant Field Values

BLEND_ONE_MINUS_SRC_ALPHA

public static final int BLEND_ONE_MINUS_SRC_ALPHA

Blend function: f = 1-alphasrc.

Since:

Java 3D 1.2

See Also:

setSrcBlendFunction(int), setDstBlendFunction(int), Constant Field Values

BLEND_DST_COLOR

public static final int BLEND_DST_COLOR

Blend function: f = colordst.

Note that this function may only be used as a source blend function.

Since:

Java 3D 1.4

See Also:

setSrcBlendFunction(int), Constant Field Values

BLEND_ONE_MINUS_DST_COLOR

public static final int BLEND_ONE_MINUS_DST_COLOR

Blend function: f = 1-colordst.

Note that this function may only be used as a source blend function.

Since:

Java 3D 1.4

See Also:

setSrcBlendFunction(int), Constant Field Values

BLEND_SRC_COLOR

public static final int BLEND_SRC_COLOR

Blend function: f = colorsrc.

Note that this function may only be used as a destination blend function.

Since:

Java 3D 1.4

See Also:

setDstBlendFunction(int), Constant Field Values

BLEND_ONE_MINUS_SRC_COLOR

public static final int BLEND_ONE_MINUS_SRC_COLOR

Blend function: f = 1-colorsrc.

Note that this function may only be used as a destination blend function.

Since:

Java 3D 1.4

See Also:

setDstBlendFunction(int), Constant Field Values

BLEND_CONSTANT_COLOR

static final int BLEND_CONSTANT_COLOR

See Also:

Constant Field Values

MAX_BLEND_FUNC_TABLE_SIZE

static final int MAX_BLEND_FUNC_TABLE_SIZE

See Also:

Constant Field Values

readCapabilities

private static final int[] readCapabilities

Constructor Detail

TransparencyAttributes

public TransparencyAttributes()

Constructs a TransparencyAttributes object with default parameters. The default values are as follows:

transparency mode : NONE
transparency value : 0.0
source blend function : BLEND_SRC_ALPHA
destination blend function : BLEND_ONE_MINUS_SRC_ALPHA

TransparencyAttributes

public TransparencyAttributes(int tMode,
                      float tVal)

Construct TransparencyAttributes object with specified values.

Parameters:

tMode - the transparency mode

tVal - the transparency value

Throws:

java.lang.IllegalArgumentException - if tMode is a value other than NONE, FASTEST, NICEST, SCREEN_DOOR, or BLENDED

TransparencyAttributes

public TransparencyAttributes(int tMode,
                      float tVal,
                      int srcBlendFunction,
                      int dstBlendFunction)

Construct TransparencyAttributes object with specified values.

Parameters:

tMode - the transparency mode

tVal - the transparency value

srcBlendFunction - the blend function to be used for the source color, one of BLEND_ZERO, BLEND_ONE, BLEND_SRC_ALPHA, BLEND_ONE_MINUS_SRC_ALPHA, BLEND_DST_COLOR, or BLEND_ONE_MINUS_DST_COLOR.

dstBlendFunction - the blend function to be used for the destination color, one of BLEND_ZERO, BLEND_ONE, BLEND_SRC_ALPHA, BLEND_ONE_MINUS_SRC_ALPHA, BLEND_SRC_COLOR, or BLEND_ONE_MINUS_SRC_COLOR.

Throws:

java.lang.IllegalArgumentException - if tMode is a value other than NONE, FASTEST, NICEST, SCREEN_DOOR, or BLENDED

java.lang.IllegalArgumentException - if srcBlendFunction or dstBlendFunction is a value other than one of the supported functions listed above.

Since:

Java 3D 1.2

Method Detail

setTransparencyMode

public void setTransparencyMode(int transparencyMode)

Sets the transparency mode for this appearance component object.

Parameters:

transparencyMode - the transparency mode to be used, one of NONE, FASTEST, NICEST, SCREEN_DOOR, or BLENDED

Throws:

CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph

java.lang.IllegalArgumentException - if transparencyMode is a value other than NONE, FASTEST, NICEST, SCREEN_DOOR, or BLENDED

getTransparencyMode

public int getTransparencyMode()

Gets the transparency mode for this appearance component object.

Returns:

transparencyMode the transparency mode

Throws:

CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph

setTransparency

public void setTransparency(float transparency)

Sets this appearance's transparency.

Parameters:

transparency - the appearance's transparency in the range [0.0, 1.0] with 0.0 being fully opaque and 1.0 being fully transparent

Throws:

CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph

getTransparency

public float getTransparency()

Retrieves this appearance's transparency.

Returns:

the appearance's transparency

Throws:

CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph

setSrcBlendFunction

public void setSrcBlendFunction(int blendFunction)

Sets the source blend function used in blended transparency and antialiasing operations. The source function specifies the factor that is multiplied by the source color; this value is added to the product of the destination factor and the destination color. The default source blend function is BLEND_SRC_ALPHA.

Parameters:

blendFunction - the blend function to be used for the source color, one of BLEND_ZERO, BLEND_ONE, BLEND_SRC_ALPHA, BLEND_ONE_MINUS_SRC_ALPHA, BLEND_DST_COLOR, or BLEND_ONE_MINUS_DST_COLOR.

Throws:

CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph

java.lang.IllegalArgumentException - if blendFunction is a value other than one of the supported functions listed above.

Since:

Java 3D 1.2

getSrcBlendFunction

public int getSrcBlendFunction()

Gets the source blend function for this TransparencyAttributes object.

Returns:

the source blend function.

Throws:

CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph

Since:

Java 3D 1.2

setDstBlendFunction

public void setDstBlendFunction(int blendFunction)

Sets the destination blend function used in blended transparency and antialiasing operations. The destination function specifies the factor that is multiplied by the destination color; this value is added to the product of the source factor and the source color. The default destination blend function is BLEND_ONE_MINUS_SRC_ALPHA.

Parameters:

blendFunction - the blend function to be used for the destination color, one of BLEND_ZERO, BLEND_ONE, BLEND_SRC_ALPHA, BLEND_ONE_MINUS_SRC_ALPHA, BLEND_SRC_COLOR, or BLEND_ONE_MINUS_SRC_COLOR.

Throws:

CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph

java.lang.IllegalArgumentException - if blendFunction is a value other than one of the supported functions listed above.

Since:

Java 3D 1.2

getDstBlendFunction

public int getDstBlendFunction()

Gets the destination blend function for this TransparencyAttributes object.

Returns:

the destination blend function.

Throws:

CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph

Since:

Java 3D 1.2

createRetained

void createRetained()

Creates a retained mode TransparencyAttributesRetained object that this TransparencyAttributes component object will point to.

Overrides:

createRetained in class NodeComponent

cloneNodeComponent

public NodeComponent cloneNodeComponent()

Deprecated. replaced with cloneNodeComponent(boolean forceDuplicate)

Overrides:

cloneNodeComponent in class NodeComponent

duplicateAttributes

void duplicateAttributes(NodeComponent originalNodeComponent,
                       boolean forceDuplicate)

Copies all node information from originalNodeComponent into the current node. This method is called from the duplicateNode method. This routine does the actual duplication of all "local data" (any data defined in this object).

Overrides:

duplicateAttributes in class NodeComponent

Parameters:

originalNodeComponent - the original node to duplicate.

forceDuplicate - when set to true, causes the duplicateOnCloneTree flag to be ignored. When false, the value of each node's duplicateOnCloneTree variable determines whether NodeComponent data is duplicated or copied.

See Also:

Node.cloneTree(), NodeComponent.setDuplicateOnCloneTree(boolean)