morph.html

JAVA多媒体开发类库说明

public static final int <B>ALLOW_COLLISION_BOUNDS_WRITE</B></PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Specifies the node allows writing its collision Bounds.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.Morph.ALLOW_COLLISION_BOUNDS_WRITE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_APPEARANCE_OVERRIDE_READ"><!-- --></A><H3>
ALLOW_APPEARANCE_OVERRIDE_READ</H3>
<PRE>
public static final int <B>ALLOW_APPEARANCE_OVERRIDE_READ</B></PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Specifies that this node allows reading its appearance override
 enable flag.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.2</DD>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.Morph.ALLOW_APPEARANCE_OVERRIDE_READ">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_APPEARANCE_OVERRIDE_WRITE"><!-- --></A><H3>
ALLOW_APPEARANCE_OVERRIDE_WRITE</H3>
<PRE>
public static final int <B>ALLOW_APPEARANCE_OVERRIDE_WRITE</B></PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Specifies that this node allows writing its appearance override
 enable flag.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.2</DD>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.Morph.ALLOW_APPEARANCE_OVERRIDE_WRITE">Constant Field Values</A></DL>
</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->

<A NAME="constructor_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Constructor Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="Morph(javax.media.j3d.GeometryArray[])"><!-- --></A><H3>
Morph</H3>
<PRE>
public <B>Morph</B>(<A HREF="../../../javax/media/j3d/GeometryArray.html" title="class in javax.media.j3d">GeometryArray</A>[]&nbsp;geometryArrays)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Constructs and initializes a Morph node with the specified array
 of GeometryArray objects.  Default values are used for all other
 parameters as follows:
 <ul>
 appearance : null<br>
 weights : [1, 0, 0, 0, ...]<br>
 collision bounds : null<br>
 appearance override enable : false<br>
 </ul><P>
 A null appearance object specifies that default values are used
 for all appearance attributes.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>geometryArrays</CODE> - the geometry components of the morph;
 a null or zero-length array of GeometryArray objects is
 permitted, and specifies that no geometry is drawn.  In this case,
 the array of weights is initialized to a zero-length array.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if any of the specified
 geometry array objects differ from each other in any of the
 following ways:
 <ul>
 <li>Type of geometry array object (subclass of GeometryArray)</li>
 <li>vertexFormat</li>
 <li>texCoordSetCount</li>
 <li>texCoordSetMap</li>
 <li>validVertexCount</li>
 <li>validIndexCount, for IndexedGeometryArray objects</li>
 <li>stripVertexCounts array, for GeometryStripArray objects</li>
 <li>stripIndexCounts array, for IndexedGeometryStripArray objects</li>
 <li>the array lengths of each enabled vertex component
 (coord, color, normal, texcoord),
 for indexed geometry by-reference</li>
 </ul>
<DD><CODE>java.lang.UnsupportedOperationException</CODE> - if the specified
 geometry arrays contain vertex attributes (that is, if their
 vertexFormat includes the <code>VERTEX_ATTRIBUTES</code> flag).</DL>
</DL>
<HR>

<A NAME="Morph(javax.media.j3d.GeometryArray[], javax.media.j3d.Appearance)"><!-- --></A><H3>
Morph</H3>
<PRE>
public <B>Morph</B>(<A HREF="../../../javax/media/j3d/GeometryArray.html" title="class in javax.media.j3d">GeometryArray</A>[]&nbsp;geometryArrays,
             <A HREF="../../../javax/media/j3d/Appearance.html" title="class in javax.media.j3d">Appearance</A>&nbsp;appearance)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Constructs and initializes a Morph node with the specified array
 of GeometryArray objects and the specified appearance object.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>geometryArrays</CODE> - the geometry components of the Morph node
 a null or zero-length array of GeometryArray objects is
 permitted, and specifies that no geometry is drawn.  In this case,
 the array of weights is initialized to a zero-length array.<DD><CODE>appearance</CODE> - the appearance component of the Morph node
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if any of the specified
 geometry array objects differ from each other in any of the
 following ways:
 <ul>
 <li>Type of geometry array object (subclass of GeometryArray)</li>
 <li>vertexFormat</li>
 <li>texCoordSetCount</li>
 <li>texCoordSetMap</li>
 <li>validVertexCount</li>
 <li>validIndexCount, for IndexedGeometryArray objects</li>
 <li>stripVertexCounts array, for GeometryStripArray objects</li>
 <li>stripIndexCounts array, for IndexedGeometryStripArray objects</li>
 <li>the array lengths of each enabled vertex component
 (coord, color, normal, texcoord),
 for indexed geometry by-reference</li>
 </ul>
<DD><CODE>java.lang.UnsupportedOperationException</CODE> - if the specified
 geometry arrays contain vertex attributes (that is, if their
 vertexFormat includes the <code>VERTEX_ATTRIBUTES</code> flag).</DL>
</DL>

<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
<B>Method Detail</B></FONT></TH>
</TR>
</TABLE>

<A NAME="setCollisionBounds(javax.media.j3d.Bounds)"><!-- --></A><H3>
setCollisionBounds</H3>
<PRE>
public void <B>setCollisionBounds</B>(<A HREF="../../../javax/media/j3d/Bounds.html" title="class in javax.media.j3d">Bounds</A>&nbsp;bounds)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Sets the collision bounds of a node.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bounds</CODE> - the collision bounding object for a node
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">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="getCollisionBounds()"><!-- --></A><H3>
getCollisionBounds</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Bounds.html" title="class in javax.media.j3d">Bounds</A> <B>getCollisionBounds</B>()</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Returns the collision bounding object of this node.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the node's collision bounding object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">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="setGeometryArrays(javax.media.j3d.GeometryArray[])"><!-- --></A><H3>
setGeometryArrays</H3>
<PRE>
public void <B>setGeometryArrays</B>(<A HREF="../../../javax/media/j3d/GeometryArray.html" title="class in javax.media.j3d">GeometryArray</A>[]&nbsp;geometryArrays)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Sets the geometryArrays component of the Morph node.

 If the current array of GeometryArrays in this Morph object is
 non-null with a length greater than 0, the specified array of
 GeometryArrays must be the same length as the current array.
 If the current array of GeometryArrays in this Morph object is
 null or has a length of 0, and the specified array of
 GeometryArrays is non-null with a length greater than 0, the
 length of the incoming array defines the number of the geometry
 objects that will be morphed.  In this case, the weights array
 is allocated to be of the same length as the geometry array;
 the first element (weights[0]) is initialized to 1.0 and all of
 the other weights are initialized to 0.0.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>geometryArrays</CODE> - the new geometryArrays component
 for the Morph node.
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">CapabilityNotSetException</A></CODE> - if appropriate capability is
 not set and this object is part of live or compiled scene graph
 <p>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the length of the
 specified array of geometry arrays is not equal to the length
 of this Morph node's current array of geometry arrays (and the
 current array's length is non-zero), or if any of the specified
 geometry array objects differ from each other in any of the
 following ways:
 <ul>
 <li>Type of geometry array object (subclass of GeometryArray)</li>
 <li>vertexFormat</li>
 <li>texCoordSetCount</li>
 <li>texCoordSetMap</li>
 <li>validVertexCount</li>
 <li>validIndexCount, for IndexedGeometryArray objects</li>
 <li>stripVertexCounts array, for GeometryStripArray objects</li>
 <li>stripIndexCounts array, for IndexedGeometryStripArray objects</li>
 <li>the array lengths of each enabled vertex component
 (coord, color, normal, texcoord),
 for indexed geometry by-reference</li>
 </ul>
<DD><CODE>java.lang.UnsupportedOperationException</CODE> - if the specified
 geometry arrays contain vertex attributes (that is, if their
 vertexFormat includes the <code>VERTEX_ATTRIBUTES</code> flag).</DL>
</DD>
</DL>
<HR>

<A NAME="getGeometryArray(int)"><!-- --></A><H3>
getGeometryArray</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/GeometryArray.html" title="class in javax.media.j3d">GeometryArray</A> <B>getGeometryArray</B>(int&nbsp;index)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Retrieves the geometryArray component of this Morph node.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - the index of GeometryArray to be returned
<DT><B>Returns:</B><DD>the geometryArray component of this Morph node
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">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="setAppearance(javax.media.j3d.Appearance)"><!-- --></A><H3>
setAppearance</H3>
<PRE>
public void <B>setAppearance</B>(<A HREF="../../../javax/media/j3d/Appearance.html" title="class in javax.media.j3d">Appearance</A>&nbsp;appearance)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Sets the appearance component of this Morph node.  A null
 appearance component specifies that default values are used for all
 appearance attributes.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>appearance</CODE> - the new appearance component for this Morph node
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">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="getAppearance()"><!-- --></A><H3>
getAppearance</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Appearance.html" title="class in javax.media.j3d">Appearance</A> <B>getAppearance</B>()</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Retrieves the appearance component of this morph node.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the appearance component of this morph node
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/CapabilityNotSetException.html" title="class in javax.media.j3d">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="intersect(javax.media.j3d.SceneGraphPath, javax.media.j3d.PickShape)"><!-- --></A><H3>
intersect</H3>
<PRE>
public boolean <B>intersect</B>(<A HREF="../../../javax/media/j3d/SceneGraphPath.html" title="class in javax.media.j3d">SceneGraphPath</A>&nbsp;path,
                         <A HREF="../../../javax/media/j3d/PickShape.html" title="class in javax.media.j3d">PickShape</A>&nbsp;pickShape)</PRE>
<DL>
<DD><B>Deprecated.</B>&nbsp;<DD>Checks whether the geometry in this morph node intersects with
 the specified pickShape.