boundingpolytope.html

java 3d帮助文档

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Test for intersection with a ray.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;boolean</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/BoundingPolytope.html#isEmpty()">isEmpty</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Tests whether the bounding polytope is empty.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/BoundingPolytope.html#set(javax.media.j3d.Bounds)">set</A></B>(<A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A>&nbsp;boundsObject)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the planes for this BoundingPolytope by keeping its current
 number and position of planes and computing new planes positions
 to enclose the given bounds object.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/BoundingPolytope.html#setPlanes(javax.vecmath.Vector4d[])">setPlanes</A></B>(<A HREF="../../../javax/vecmath/Vector4d.html">Vector4d</A>[]&nbsp;planes)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Sets the bounding planes for this polytope.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;java.lang.String</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/BoundingPolytope.html#toString()">toString</A></B>()</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Returns a string representation of this class</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/BoundingPolytope.html#transform(javax.media.j3d.Bounds, javax.media.j3d.Transform3D)">transform</A></B>(<A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A>&nbsp;boundsObject,
          <A HREF="../../../javax/media/j3d/Transform3D.html">Transform3D</A>&nbsp;matrix)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Modifies the bounding polytope so that it bounds the volume
 generated by transforming the given bounding object.</TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
<CODE>&nbsp;void</CODE></FONT></TD>
<TD><CODE><B><A HREF="../../../javax/media/j3d/BoundingPolytope.html#transform(javax.media.j3d.Transform3D)">transform</A></B>(<A HREF="../../../javax/media/j3d/Transform3D.html">Transform3D</A>&nbsp;matrix)</CODE>

<BR>
&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;&nbsp;Transforms this  bounding polytope by the given transformation matrix.</TD>
</TR>
</TABLE>
&nbsp;<A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
<TD><B>Methods inherited from class java.lang.Object</B></TD>
</TR>
<TR BGCOLOR="white" CLASS="TableRowColor">
<TD><CODE>finalize, getClass, notify, notifyAll, wait, wait, wait</CODE></TD>
</TR>
</TABLE>
&nbsp;
<P>

<!-- ============ FIELD DETAIL =========== -->


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

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

<A NAME="BoundingPolytope(javax.vecmath.Vector4d[])"><!-- --></A><H3>
BoundingPolytope</H3>
<PRE>
public <B>BoundingPolytope</B>(<A HREF="../../../javax/vecmath/Vector4d.html">Vector4d</A>[]&nbsp;planes)</PRE>
<DL>
<DD>Constructs a BoundingPolytope using the specified planes.
<P>
<DT><B>Parameters:</B><DD><CODE>planes</CODE> - a set of planes defining the polytope.
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the length of the
 specified array of planes is less than 4.</DL>
<HR>

<A NAME="BoundingPolytope()"><!-- --></A><H3>
BoundingPolytope</H3>
<PRE>
public <B>BoundingPolytope</B>()</PRE>
<DL>
<DD>Constructs a BoundingPolytope and initializes it to a set of 6
 planes that defines a cube such that -1 <= x,y,z <= 1.  The
 values of the planes are as follows:
 <ul>
 planes[0] : x <= 1 (1,0,0,-1)<br>
 planes[1] : -x <= 1 (-1,0,0,-1)<br>
 planes[2] : y <= 1 (0,1,0,-1)<br>
 planes[3] : -y <= 1 (0,-1,0,-1)<br>
 planes[4] : z <= 1 (0,0,1,-1)<br>
 planes[5] : -z <= 1 (0,0,-1,-1)<br>
 </ul>
<P>
</DL>
<HR>

<A NAME="BoundingPolytope(javax.media.j3d.Bounds)"><!-- --></A><H3>
BoundingPolytope</H3>
<PRE>
public <B>BoundingPolytope</B>(<A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A>&nbsp;boundsObject)</PRE>
<DL>
<DD>Constructs a BoundingPolytope from the specified bounds object.
 The new polytope will circumscribe the region specified by the
 input bounds.
<P>
<DT><B>Parameters:</B><DD><CODE>boundsObject</CODE> - the bounds object from which this polytope
 is constructed.</DL>
<HR>

<A NAME="BoundingPolytope(javax.media.j3d.Bounds[])"><!-- --></A><H3>
BoundingPolytope</H3>
<PRE>
public <B>BoundingPolytope</B>(<A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A>[]&nbsp;boundsObjects)</PRE>
<DL>
<DD>Constructs a BoundingPolytope from the specified array of bounds
 objects.  The new polytope will circumscribe the union of the
 regions specified by the input bounds objects.
<P>
<DT><B>Parameters:</B><DD><CODE>boundsObjects</CODE> - the array bounds objects from which this
 polytope is constructed.</DL>

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

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

<A NAME="setPlanes(javax.vecmath.Vector4d[])"><!-- --></A><H3>
setPlanes</H3>
<PRE>
public void <B>setPlanes</B>(<A HREF="../../../javax/vecmath/Vector4d.html">Vector4d</A>[]&nbsp;planes)</PRE>
<DL>
<DD>Sets the bounding planes for this polytope.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>planes</CODE> - the new set of planes for this  polytope
<DT><B>Throws:</B>
<DD><CODE>java.lang.IllegalArgumentException</CODE> - if the length of the
 specified array of planes is less than 4.</DL>
</DD>
</DL>
<HR>

<A NAME="getPlanes(javax.vecmath.Vector4d[])"><!-- --></A><H3>
getPlanes</H3>
<PRE>
public void <B>getPlanes</B>(<A HREF="../../../javax/vecmath/Vector4d.html">Vector4d</A>[]&nbsp;planes)</PRE>
<DL>
<DD>Returns the equations of the bounding planes for this bounding polytope.
 The equations are copied into the specified array.
 The array must be large enough to hold all of the vectors. 
 The individual array elements must be allocated by the caller.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>planes</CODE> - an array  Vector4d to receive the bounding planes</DL>
</DD>
</DL>
<HR>

<A NAME="getNumPlanes()"><!-- --></A><H3>
getNumPlanes</H3>
<PRE>
public int <B>getNumPlanes</B>()</PRE>
<DL>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="set(javax.media.j3d.Bounds)"><!-- --></A><H3>
set</H3>
<PRE>
public void <B>set</B>(<A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A>&nbsp;boundsObject)</PRE>
<DL>
<DD>Sets the planes for this BoundingPolytope by keeping its current
 number and position of planes and computing new planes positions
 to enclose the given bounds object.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/media/j3d/Bounds.html#set(javax.media.j3d.Bounds)">set</A></CODE> in class <CODE><A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>boundsObject</CODE> - another bounds object</DL>
</DD>
</DL>
<HR>

<A NAME="clone()"><!-- --></A><H3>
clone</H3>
<PRE>
public java.lang.Object <B>clone</B>()</PRE>
<DL>
<DD>Creates a copy of a polytope.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/media/j3d/Bounds.html#clone()">clone</A></CODE> in class <CODE><A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>a new BoundingPolytope</DL>
</DD>
</DL>
<HR>

<A NAME="equals(java.lang.Object)"><!-- --></A><H3>
equals</H3>
<PRE>
public boolean <B>equals</B>(java.lang.Object&nbsp;bounds)</PRE>
<DL>
<DD>Indicates whether the specified <code>bounds</code> object is
 equal to this BoundingPolytope object.  They are equal if the
 specified <code>bounds</code> object is an instance of
 BoundingPolytope and all of the data
 members of <code>bounds</code> are equal to the corresponding
 data members in this BoundingPolytope.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/media/j3d/Bounds.html#equals(java.lang.Object)">equals</A></CODE> in class <CODE><A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>bounds</CODE> - the object with which the comparison is made.
<DT><B>Returns:</B><DD>true if this BoundingPolytope is equal to <code>bounds</code>;
 otherwise false<DT><B>Since:</B><DD>Java 3D 1.2</DD>
</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="hashCode()"><!-- --></A><H3>
hashCode</H3>
<PRE>
public int <B>hashCode</B>()</PRE>
<DL>
<DD>Returns a hash code value for this BoundingPolytope object
 based on the data values in this object.  Two different
 BoundingPolytope objects with identical data values (i.e.,
 BoundingPolytope.equals returns true) will return the same hash
 code value.  Two BoundingPolytope objects with different data
 members may return the same hash code value, although this is
 not likely.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/media/j3d/Bounds.html#hashCode()">hashCode</A></CODE> in class <CODE><A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A></CODE></DL>
</DD>
<DD><DL>

<DT><B>Returns:</B><DD>a hash code value for this BoundingPolytope object.<DT><B>Since:</B><DD>Java 3D 1.2</DD>
</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="combine(javax.media.j3d.Bounds)"><!-- --></A><H3>
combine</H3>
<PRE>
public void <B>combine</B>(<A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A>&nbsp;boundsObject)</PRE>
<DL>
<DD>Combines this bounding polytope with a bounding object so that the
 resulting bounding polytope encloses the original bounding polytope and the
 given bounds object.
<P>
<DD><DL>
<DT><B>Specified by:</B><DD><CODE><A HREF="../../../javax/media/j3d/Bounds.html#combine(javax.media.j3d.Bounds)">combine</A></CODE> in class <CODE><A HREF="../../../javax/media/j3d/Bounds.html">Bounds</A></CODE></DL>
</DD>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>boundsObject</CODE> - another bounds object</DL>
</DD>
</DL>
<HR>

<A NAME="combine(javax.media.j3d.Bounds[])"><!-- --></A><H3>