Java Doc for Appearance.java in  » 6.0-JDK-Modules » java-3d » javax » media » j3d » Java Source Code / Java DocumentationJava Source Code and Java Documentation

• Coloring attributes - defines attributes used in color selection and shading. These attributes are defined in a ColoringAttributes object.
• Line attributes - defines attributes used to define lines, including the pattern, width, and whether antialiasing is to be used. These attributes are defined in a LineAttributes object.
• Point attributes - defines attributes used to define points, including the size and whether antialiasing is to be used. These attributes are defined in a PointAttributes object.
• Polygon attributes - defines the attributes used to define polygons, including culling, rasterization mode (filled, lines, or points), constant offset, offset factor, and whether back back facing normals are flipped. These attributes are defined in a PolygonAttributes object.
• Rendering attributes - defines rendering operations, including the alpha test function and test value, the raster operation, whether vertex colors are ignored, whether invisible objects are rendered, and whether the depth buffer is enabled. These attributes are defined in a RenderingAttributes object.
• Transparency attributes - defines the attributes that affect transparency of the object, such as the transparency mode (blended, screen-door), blending function (used in transparency and antialiasing operations), and a blend value that defines the amount of transparency to be applied to this Appearance component object.
• Material - defines the appearance of an object under illumination, such as the ambient color, diffuse color, specular color, emissive color, and shininess. These attributes are defined in a Material object.
• Texture - defines the texture image and filtering parameters used when texture mapping is enabled. These attributes are defined in a Texture object.
• Texture attributes - defines the attributes that apply to texture mapping, such as the texture mode, texture transform, blend color, and perspective correction mode. These attributes are defined in a TextureAttributes object.
• Texture coordinate generation - defines the attributes that apply to texture coordinate generation, such as whether texture coordinate generation is enabled, coordinate format (2D or 3D coordinates), coordinate generation mode (object linear, eye linear, or spherical reflection mapping), and the R, S, and T coordinate plane equations. These attributes are defined in a TexCoordGeneration object.
• Texture unit state - array that defines texture state for each of N separate texture units. This allows multiple textures to be applied to geometry. Each TextureUnitState object contains a Texture object, TextureAttributes, and TexCoordGeneration object for one texture unit. If the length of the texture unit state array is greater than 0, then the array is used for all texture state; the individual Texture, TextureAttributes, and TexCoordGeneration objects in this Appearance object are not used and and must not be set by an application. If the length of the texture unit state array is 0, the multi-texture is disabled and the Texture, TextureAttributes, and TexCoordGeneration objects in the Appearance object are used. If the application sets the existing Texture, TextureAttributes, and TexCoordGeneration objects to non-null values, they effectively define the state for texture unit 0. If the TextureUnitState array is set to a non-null, non-empty array, the individual TextureUnitState objects define the state for texture units 0 through n -1. If both the old and new values are set, an exception is thrown.

Parameters:
  originalNodeComponent - the original node to duplicate.
Parameters:
  forceDuplicate - when set to true, causes theduplicateOnCloneTree flag to be ignored. Whenfalse, the value of each node'sduplicateOnCloneTree variable determines whetherNodeComponent data is duplicated or copied.
exception:
  RestrictedAccessException - if this object is part of a liveor compiled scenegraph.
See Also:   Node.cloneTree
See Also:   NodeComponent.setDuplicateOnCloneTree

Applications must not set individual texture component objects (texture, textureAttributes, or texCoordGeneration) and the texture unit state array in the same Appearance object. Doing so will result in an exception being thrown.
Parameters:
  texCoordGeneration - object that specifies the texture coordinategeneration parameters
exception:
  CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
exception:
  IllegalStateException - if the specified texCoordGenerationobject is non-null and the texture unit state array in thisappearance object is already non-null.

Applications must not set individual texture component objects (texture, textureAttributes, or texCoordGeneration) and the texture unit state array in the same Appearance object. Doing so will result in an exception being thrown.
Parameters:
  texture - object that specifies the desired texturemap and texture parameters
exception:
  CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
exception:
  IllegalStateException - if the specified textureobject is non-null and the texture unit state array in thisappearance object is already non-null.
exception:
  IllegalSharingException - if this Appearance is live andthe specified texture refers to an ImageComponent2D that is being usedby a Canvas3D as an off-screen buffer.
exception:
  IllegalSharingException - if this Appearance isbeing used by an immediate mode context andthe specified texture refers to an ImageComponent2D that is being usedby a Canvas3D as an off-screen buffer.

Applications must not set individual texture component objects (texture, textureAttributes, or texCoordGeneration) and the texture unit state array in the same Appearance object. Doing so will result in an exception being thrown.
Parameters:
  textureAttributes - object that specifies the desiredtextureAttributes map and textureAttributes parameters
exception:
  CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
exception:
  IllegalStateException - if the specified textureAttributesobject is non-null and the texture unit state array in thisappearance object is already non-null.

Applications must not set individual texture component objects (texture, textureAttributes, or texCoordGeneration) and the texture unit state array in the same Appearance object. Doing so will result in an exception being thrown.
Parameters:
  stateArray - array of TextureUnitState objects thatspecify the desired texture state for each unit. The length ofthis array specifies the maximum number of texture units thatwill be used by this appearance object. The texture units arenumbered from 0 throughstateArray.length-1.
exception:
  CapabilityNotSetException - if appropriate capability is not set and this object is part of live or compiled scene graph
exception:
  IllegalStateException - if the specified array isnon-null and any of the texture object, textureAttributesobject, or texCoordGeneration object in this appearance objectis already non-null.
exception:
  IllegalSharingException - if this Appearance is live andany of the specified textures refers to an ImageComponent2D that isbeing used by a Canvas3D as an off-screen buffer.
exception:
  IllegalSharingException - if this Appearance isbeing used by an immediate mode context andany of the specified textures refers to an ImageComponent2D that isbeing used by a Canvas3D as an off-screen buffer.
since:
   Java 3D 1.2