appearance.html

java 3d帮助文档

<P>
<DD><DL>

<DT><B>Returns:</B><DD>the polygonAttributes object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="setLineAttributes(javax.media.j3d.LineAttributes)"><!-- --></A><H3>
setLineAttributes</H3>
<PRE>
public void <B>setLineAttributes</B>(<A HREF="../../../javax/media/j3d/LineAttributes.html">LineAttributes</A>&nbsp;lineAttributes)</PRE>
<DL>
<DD>Sets the lineAttributes object to the specified object.
 Setting it to null will result in default attribute usage.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>lineAttributes</CODE> - object that specifies the desired
 lineAttributes parameters
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="getLineAttributes()"><!-- --></A><H3>
getLineAttributes</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/LineAttributes.html">LineAttributes</A> <B>getLineAttributes</B>()</PRE>
<DL>
<DD>Retrieves the current lineAttributes object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the lineAttributes object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="setPointAttributes(javax.media.j3d.PointAttributes)"><!-- --></A><H3>
setPointAttributes</H3>
<PRE>
public void <B>setPointAttributes</B>(<A HREF="../../../javax/media/j3d/PointAttributes.html">PointAttributes</A>&nbsp;pointAttributes)</PRE>
<DL>
<DD>Sets the pointAttributes object to the specified object.
 Setting it to null will result in default attribute usage.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>pointAttributes</CODE> - object that specifies the desired
 pointAttributes parameters
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="getPointAttributes()"><!-- --></A><H3>
getPointAttributes</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/PointAttributes.html">PointAttributes</A> <B>getPointAttributes</B>()</PRE>
<DL>
<DD>Retrieves the current pointAttributes object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the pointAttributes object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="setTexture(javax.media.j3d.Texture)"><!-- --></A><H3>
setTexture</H3>
<PRE>
public void <B>setTexture</B>(<A HREF="../../../javax/media/j3d/Texture.html">Texture</A>&nbsp;texture)</PRE>
<DL>
<DD>Sets the texture object to the specified object.
 Setting it to null disables texture mapping.

 <p>
 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.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>texture</CODE> - object that specifies the desired texture
 map and texture parameters
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph
<DD><CODE>java.lang.IllegalStateException</CODE> - if the specified texture
 object is non-null and the texture unit state array in this
 appearance object is already non-null.</DL>
</DD>
</DL>
<HR>

<A NAME="getTexture()"><!-- --></A><H3>
getTexture</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Texture.html">Texture</A> <B>getTexture</B>()</PRE>
<DL>
<DD>Retrieves the current texture object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the texture object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="setTextureAttributes(javax.media.j3d.TextureAttributes)"><!-- --></A><H3>
setTextureAttributes</H3>
<PRE>
public void <B>setTextureAttributes</B>(<A HREF="../../../javax/media/j3d/TextureAttributes.html">TextureAttributes</A>&nbsp;textureAttributes)</PRE>
<DL>
<DD>Sets the textureAttributes object to the specified object.
 Setting it to null will result in default attribute usage.

 <p>
 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.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>textureAttributes</CODE> - object that specifies the desired
 textureAttributes map and textureAttributes parameters
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph
<DD><CODE>java.lang.IllegalStateException</CODE> - if the specified textureAttributes
 object is non-null and the texture unit state array in this
 appearance object is already non-null.</DL>
</DD>
</DL>
<HR>

<A NAME="getTextureAttributes()"><!-- --></A><H3>
getTextureAttributes</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/TextureAttributes.html">TextureAttributes</A> <B>getTextureAttributes</B>()</PRE>
<DL>
<DD>Retrieves the current textureAttributes object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the textureAttributes object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="setTexCoordGeneration(javax.media.j3d.TexCoordGeneration)"><!-- --></A><H3>
setTexCoordGeneration</H3>
<PRE>
public void <B>setTexCoordGeneration</B>(<A HREF="../../../javax/media/j3d/TexCoordGeneration.html">TexCoordGeneration</A>&nbsp;texCoordGeneration)</PRE>
<DL>
<DD>Sets the texCoordGeneration object to the specified object.
 Setting it to null disables texture coordinate generation.

 <p>
 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.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>texCoordGeneration</CODE> - object that specifies the texture coordinate
 generation parameters
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph
<DD><CODE>java.lang.IllegalStateException</CODE> - if the specified texCoordGeneration
 object is non-null and the texture unit state array in this
 appearance object is already non-null.</DL>
</DD>
</DL>
<HR>

<A NAME="getTexCoordGeneration()"><!-- --></A><H3>
getTexCoordGeneration</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/TexCoordGeneration.html">TexCoordGeneration</A> <B>getTexCoordGeneration</B>()</PRE>
<DL>
<DD>Retrieves the current texCoordGeneration object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the texCoordGeneration object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph</DL>
</DD>
</DL>
<HR>

<A NAME="setTextureUnitState(javax.media.j3d.TextureUnitState[])"><!-- --></A><H3>
setTextureUnitState</H3>
<PRE>
public void <B>setTextureUnitState</B>(<A HREF="../../../javax/media/j3d/TextureUnitState.html">TextureUnitState</A>[]&nbsp;stateArray)</PRE>
<DL>
<DD>Sets the texture unit state array for this appearance object to the
 specified array.  A shallow copy of the array of references to
 the TextureUnitState objects is made.  If the specified array
 is null or if the length of the array is 0, multi-texture is
 disabled.  Within the array, a null TextureUnitState element
 disables the corresponding texture unit.

 <p>
 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.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>stateArray</CODE> - array of TextureUnitState objects that
 specify the desired texture state for each unit.  The length of
 this array specifies the maximum number of texture units that
 will be used by this appearance object.  The texture units are
 numbered from <code>0</code> through
 <code>stateArray.length-1</code>.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph
<DD><CODE>java.lang.IllegalStateException</CODE> - if the specified array is
 non-null and any of the texture object, textureAttributes
 object, or texCoordGeneration object in this appearance object
 is already non-null.<DT><B>Since:</B><DD>Java 3D 1.2</DD>
</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setTextureUnitState(int, javax.media.j3d.TextureUnitState)"><!-- --></A><H3>
setTextureUnitState</H3>
<PRE>
public void <B>setTextureUnitState</B>(int&nbsp;index,
                                <A HREF="../../../javax/media/j3d/TextureUnitState.html">TextureUnitState</A>&nbsp;state)</PRE>
<DL>
<DD>Sets the texture unit state object at the specified index
 within the texture unit state array to the specified object.
 If the specified object is null, the corresponding texture unit
 is disabled.  The index must be within the range
 <code>[0,&nbsp;stateArray.length-1]</code>.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - the array index of the object to be set<DD><CODE>state</CODE> - new texture unit state object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph
<DD><CODE>java.lang.NullPointerException</CODE> - if the texture unit state array is
 null.
<DD><CODE>java.lang.ArrayIndexOutOfBoundsException</CODE> - if <code>index >=
 stateArray.length</code>.<DT><B>Since:</B><DD>Java 3D 1.2</DD>
</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getTextureUnitState()"><!-- --></A><H3>
getTextureUnitState</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/TextureUnitState.html">TextureUnitState</A>[] <B>getTextureUnitState</B>()</PRE>
<DL>
<DD>Retrieves the array of texture unit state objects from this
 Appearance object.  A shallow copy of the array of references to
 the TextureUnitState objects is returned.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the array of texture unit state objects
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html">CapabilityNotSetException</A></CODE> - if appropriate capability is 
 not set and this object is part of live or compiled scene graph<DT><B>Since:</B><DD>Java 3D 1.2</DD>
</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getTextureUnitState(int)"><!-- --></A><H3>
getTextureUnitSta