All Packages  Class Hierarchy  This Package  Previous  Next  Index

Class java.media.j3d.Appearance

java.lang.Object
   |
   +----java.media.j3d.SceneGraphObject
           |
           +----java.media.j3d.NodeComponent
                   |
                   +----java.media.j3d.Appearance

public class Appearance
extends NodeComponent
The Appearance object defines all rendering state that can be set as a component object of a Shape3D node.


Variable Index

 o ALLOW_COLORING_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its coloringAttributes component information.
 o ALLOW_COLORING_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its coloringAttribues component informationt.
 o ALLOW_LINE_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its line component information.
 o ALLOW_LINE_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its line component information.
 o ALLOW_MATERIAL_READ
Specifies that this Appearance object allows reading its material component information.
 o ALLOW_MATERIAL_WRITE
Specifies that this Appearance object allows writing its material component information.
 o ALLOW_POINT_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its point component information.
 o ALLOW_POINT_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its point component information.
 o ALLOW_POLYGON_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its polygon component information.
 o ALLOW_POLYGON_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its polygon component information.
 o ALLOW_RENDERING_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its rendering/rasterization component information.
 o ALLOW_RENDERING_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its rendering/rasterization component information.
 o ALLOW_TEXGEN_READ
Specifies that this Appearance object allows reading its texture coordinate generation component information.
 o ALLOW_TEXGEN_WRITE
Specifies that this Appearance object allows writing its texture coordinate generation component information.
 o ALLOW_TEXTURE_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its textureAttributes component information.
 o ALLOW_TEXTURE_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its textureAttribues component informationt.
 o ALLOW_TEXTURE_READ
Specifies that this Appearance object allows reading its texture component information.
 o ALLOW_TEXTURE_WRITE
Specifies that this Appearance object allows writing its texture component information.
 o ALLOW_TRANSPARENCY_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its transparency component information.
 o ALLOW_TRANSPARENCY_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its transparency component information.

Constructor Index

 o Appearance()
Constructs an Appearance component object using defaults for all state variables.

Method Index

 o cloneNodeComponent()
Creates a new Appearance object.
 o duplicateNodeComponent(Node)
Copies the information found in originalNode to the current node.
 o getColoringAttributes()
Retrieves the current coloringAttributes object.
 o getLineAttributes()
Retrieves the current lineAttributes object.
 o getMaterial()
Retrieve the current material object.
 o getPointAttributes()
Retrieves the current pointAttributes object.
 o getPolygonAttributes()
Retrieves the current polygonAttributes object.
 o getRenderingAttributes()
Retrieves the current renderingAttributes object.
 o getTexCoordGeneration()
Retrieves the current texCoordGeneration object.
 o getTexture()
Retrieves the current texture object.
 o getTextureAttributes()
Retrieves the current textureAttributes object.
 o getTransparencyAttributes()
Retrieves the current transparencyAttributes object.
 o setColoringAttributes(ColoringAttributes)
Sets the coloringAttributes object to the specified object.
 o setLineAttributes(LineAttributes)
Sets the lineAttributes object to the specified object.
 o setMaterial(Material)
Set the material object to the specified object.
 o setPointAttributes(PointAttributes)
Sets the pointAttributes object to the specified object.
 o setPolygonAttributes(PolygonAttributes)
Sets the polygonAttributes object to the specified object.
 o setRenderingAttributes(RenderingAttributes)
Sets the renderingAttributes object to the specified object.
 o setTexCoordGeneration(TexCoordGeneration)
Sets the texCoordGeneration object to the specified object.
 o setTexture(Texture)
Sets the texture object to the specified object.
 o setTextureAttributes(TextureAttributes)
Sets the textureAttributes object to the specified object.
 o setTransparencyAttributes(TransparencyAttributes)
Sets the transparencyAttributes object to the specified object.

Variables

 o ALLOW_MATERIAL_READ
 public static final int ALLOW_MATERIAL_READ
Specifies that this Appearance object allows reading its material component information.

 o ALLOW_MATERIAL_WRITE
 public static final int ALLOW_MATERIAL_WRITE
Specifies that this Appearance object allows writing its material component information.

 o ALLOW_TEXTURE_READ
 public static final int ALLOW_TEXTURE_READ
Specifies that this Appearance object allows reading its texture component information.

 o ALLOW_TEXTURE_WRITE
 public static final int ALLOW_TEXTURE_WRITE
Specifies that this Appearance object allows writing its texture component information.

 o ALLOW_TEXGEN_READ
 public static final int ALLOW_TEXGEN_READ
Specifies that this Appearance object allows reading its texture coordinate generation component information.

 o ALLOW_TEXGEN_WRITE
 public static final int ALLOW_TEXGEN_WRITE
Specifies that this Appearance object allows writing its texture coordinate generation component information.

 o ALLOW_TEXTURE_ATTRIBUTES_READ
 public static final int ALLOW_TEXTURE_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its textureAttributes component information.

 o ALLOW_TEXTURE_ATTRIBUTES_WRITE
 public static final int ALLOW_TEXTURE_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its textureAttribues component informationt.

 o ALLOW_COLORING_ATTRIBUTES_READ
 public static final int ALLOW_COLORING_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its coloringAttributes component information.

 o ALLOW_COLORING_ATTRIBUTES_WRITE
 public static final int ALLOW_COLORING_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its coloringAttribues component informationt.

 o ALLOW_TRANSPARENCY_ATTRIBUTES_READ
 public static final int ALLOW_TRANSPARENCY_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its transparency component information.

 o ALLOW_TRANSPARENCY_ATTRIBUTES_WRITE
 public static final int ALLOW_TRANSPARENCY_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its transparency component information.

 o ALLOW_RENDERING_ATTRIBUTES_READ
 public static final int ALLOW_RENDERING_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its rendering/rasterization component information.

 o ALLOW_RENDERING_ATTRIBUTES_WRITE
 public static final int ALLOW_RENDERING_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its rendering/rasterization component information.

 o ALLOW_POLYGON_ATTRIBUTES_READ
 public static final int ALLOW_POLYGON_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its polygon component information.

 o ALLOW_POLYGON_ATTRIBUTES_WRITE
 public static final int ALLOW_POLYGON_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its polygon component information.

 o ALLOW_LINE_ATTRIBUTES_READ
 public static final int ALLOW_LINE_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its line component information.

 o ALLOW_LINE_ATTRIBUTES_WRITE
 public static final int ALLOW_LINE_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its line component information.

 o ALLOW_POINT_ATTRIBUTES_READ
 public static final int ALLOW_POINT_ATTRIBUTES_READ
Specifies that this Appearance object allows reading its point component information.

 o ALLOW_POINT_ATTRIBUTES_WRITE
 public static final int ALLOW_POINT_ATTRIBUTES_WRITE
Specifies that this Appearance object allows writing its point component information.

Constructors

 o Appearance
 public Appearance()
Constructs an Appearance component object using defaults for all state variables. All component object references are initialized to null.

Methods

 o setMaterial
 public final void setMaterial(Material material)
Set the material object to the specified object. Setting it to null disables the lighting.

Parameters:
material - object that specifies the desired material properties
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o getMaterial
 public final Material getMaterial()
Retrieve the current material object.

Returns:
the material object
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o setTexture
 public final void setTexture(Texture texture)
Sets the texture object to the specified object. Setting it to null disables the texture mapping.

Parameters:
texture - object that specifies the desired texture map and texture parameters
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o getTexture
 public final Texture getTexture()
Retrieves the current texture object.

Returns:
the texture object
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o setTextureAttributes
 public final void setTextureAttributes(TextureAttributes textureAttributes)
Sets the textureAttributes object to the specified object. Setting it to null will result in default attribute usage.

Parameters:
textureAttributes - object that specifies the desired textureAttributes map and textureAttributes parameters
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o getTextureAttributes
 public final TextureAttributes getTextureAttributes()
Retrieves the current textureAttributes object.

Returns:
the textureAttributes object
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o setColoringAttributes
 public final void setColoringAttributes(ColoringAttributes coloringAttributes)
Sets the coloringAttributes object to the specified object. Setting it to null will result in default attribute usage.

Parameters:
coloringAttributes - object that specifies the desired coloringAttributes parameters
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o getColoringAttributes
 public final ColoringAttributes getColoringAttributes()
Retrieves the current coloringAttributes object.

Returns:
the coloringAttributes object
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o setTransparencyAttributes
 public final void setTransparencyAttributes(TransparencyAttributes transparencyAttributes)
Sets the transparencyAttributes object to the specified object. Setting it to null will result in default attribute usage.

Parameters:
transparencyAttributes - object that specifies the desired transparencyAttributes parameters
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o getTransparencyAttributes
 public final TransparencyAttributes getTransparencyAttributes()
Retrieves the current transparencyAttributes object.

Returns:
the transparencyAttributes object
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o setRenderingAttributes
 public final void setRenderingAttributes(RenderingAttributes renderingAttributes)
Sets the renderingAttributes object to the specified object. Setting it to null will result in default attribute usage.

Parameters:
renderingAttributes - object that specifies the desired renderingAttributes parameters
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o getRenderingAttributes
 public final RenderingAttributes getRenderingAttributes()
Retrieves the current renderingAttributes object.

Returns:
the renderingAttributes object
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o setPolygonAttributes
 public final void setPolygonAttributes(PolygonAttributes polygonAttributes)
Sets the polygonAttributes object to the specified object. Setting it to null will result in default attribute usage.

Parameters:
polygonAttributes - object that specifies the desired polygonAttributes parameters
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o getPolygonAttributes
 public final PolygonAttributes getPolygonAttributes()
Retrieves the current polygonAttributes object.

Returns:
the polygonAttributes object
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o setLineAttributes
 public final void setLineAttributes(LineAttributes lineAttributes)
Sets the lineAttributes object to the specified object. Setting it to null will result in default attribute usage.

Parameters:
lineAttributes - object that specifies the desired lineAttributes parameters
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o getLineAttributes
 public final LineAttributes getLineAttributes()
Retrieves the current lineAttributes object.

Returns:
the lineAttributes object
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o setPointAttributes
 public final void setPointAttributes(PointAttributes pointAttributes)
Sets the pointAttributes object to the specified object. Setting it to null will result in default attribute usage.

Parameters:
pointAttributes - object that specifies the desired pointAttributes parameters
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o getPointAttributes
 public final PointAttributes getPointAttributes()
Retrieves the current pointAttributes object.

Returns:
the pointAttributes object
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o setTexCoordGeneration
 public final void setTexCoordGeneration(TexCoordGeneration texCoordGeneration)
Sets the texCoordGeneration object to the specified object. Setting it to null disables the texture coordinate generation.

Parameters:
texCoordGeneration - object that specifies the texture coordinate generation parameters
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o getTexCoordGeneration
 public final TexCoordGeneration getTexCoordGeneration()
Retrieves the current texCoordGeneration object.

Returns:
the texCoordGeneration object
Throws: CapabilityNotSetException
if appropriate capability is not set and this object is part of live or compiled scene graph
 o cloneNodeComponent
 public NodeComponent cloneNodeComponent()
Creates a new Appearance object. Called from a Leaf node's duplicateNode method.

Returns:
a duplicate of the Appearance object.
Overrides:
cloneNodeComponent in class NodeComponent
See Also:
duplicateNode, cloneTree, setDuplicateOnCloneTree
 o duplicateNodeComponent
 public void duplicateNodeComponent(Node originalNode)
Copies the information found in originalNode to the current node. This routine is called as part of the cloneTree operation.

Parameters:
originalNode - the node to duplicate.
See Also:
cloneTree, duplicateNode, setDuplicateOnCloneTree

All Packages  Class Hierarchy  This Package  Previous  Next  Index