orientedshape3d.html

JAVA多媒体开发类库说明

 allows writing its alignment mode information.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.OrientedShape3D.ALLOW_MODE_WRITE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_AXIS_READ"><!-- --></A><H3>
ALLOW_AXIS_READ</H3>
<PRE>
public static final int <B>ALLOW_AXIS_READ</B></PRE>
<DL>
<DD>Specifies that this OrientedShape3D node
 allows reading its alignment axis information.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.OrientedShape3D.ALLOW_AXIS_READ">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_AXIS_WRITE"><!-- --></A><H3>
ALLOW_AXIS_WRITE</H3>
<PRE>
public static final int <B>ALLOW_AXIS_WRITE</B></PRE>
<DL>
<DD>Specifies that this OrientedShape3D node
 allows writing its alignment axis information.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.OrientedShape3D.ALLOW_AXIS_WRITE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_POINT_READ"><!-- --></A><H3>
ALLOW_POINT_READ</H3>
<PRE>
public static final int <B>ALLOW_POINT_READ</B></PRE>
<DL>
<DD>Specifies that this OrientedShape3D node
 allows reading its rotation point information.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.OrientedShape3D.ALLOW_POINT_READ">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_POINT_WRITE"><!-- --></A><H3>
ALLOW_POINT_WRITE</H3>
<PRE>
public static final int <B>ALLOW_POINT_WRITE</B></PRE>
<DL>
<DD>Specifies that this OrientedShape3D node
 allows writing its rotation point information.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.OrientedShape3D.ALLOW_POINT_WRITE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_SCALE_READ"><!-- --></A><H3>
ALLOW_SCALE_READ</H3>
<PRE>
public static final int <B>ALLOW_SCALE_READ</B></PRE>
<DL>
<DD>Specifies that this OrientedShape3D node
 allows reading its scale and constant scale enable information.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.OrientedShape3D.ALLOW_SCALE_READ">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_SCALE_WRITE"><!-- --></A><H3>
ALLOW_SCALE_WRITE</H3>
<PRE>
public static final int <B>ALLOW_SCALE_WRITE</B></PRE>
<DL>
<DD>Specifies that this OrientedShape3D node
 allows writing its scale and constant scale enable information.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.OrientedShape3D.ALLOW_SCALE_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="OrientedShape3D()"><!-- --></A><H3>
OrientedShape3D</H3>
<PRE>
public <B>OrientedShape3D</B>()</PRE>
<DL>
<DD>Constructs an OrientedShape3D node with default parameters.
 The default values are as follows:
 <ul>
 alignment mode : ROTATE_ABOUT_AXIS<br>
 alignment axis : Y-axis (0,1,0)<br>
 rotation point : (0,0,1)<br>
 constant scale enable : false<br>
 scale : 1.0<br>
</ul>
<P>
</DL>
<HR>

<A NAME="OrientedShape3D(javax.media.j3d.Geometry, javax.media.j3d.Appearance, int, javax.vecmath.Vector3f)"><!-- --></A><H3>
OrientedShape3D</H3>
<PRE>
public <B>OrientedShape3D</B>(<A HREF="../../../javax/media/j3d/Geometry.html" title="class in javax.media.j3d">Geometry</A>&nbsp;geometry,
                       <A HREF="../../../javax/media/j3d/Appearance.html" title="class in javax.media.j3d">Appearance</A>&nbsp;appearance,
                       int&nbsp;mode,
                       <A HREF="../../../javax/vecmath/Vector3f.html" title="class in javax.vecmath">Vector3f</A>&nbsp;axis)</PRE>
<DL>
<DD>Constructs an OrientedShape3D node with the specified geometry
 component, appearance component, mode, and axis.
 The specified axis must not be parallel to the <i>Z</i>
 axis--(0,0,<i>z</i>) for any value of <i>z</i>.  It is not
 possible for the +<i>Z</i> axis to point at the viewer's eye
 position by rotating about itself.  The target transform will
 be set to the identity if the axis is (0,0,<i>z</i>).
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>geometry</CODE> - the geometry component with which to initialize
 this shape node<DD><CODE>appearance</CODE> - the appearance component of the shape node<DD><CODE>mode</CODE> - alignment mode, one of: ROTATE_ABOUT_AXIS,
 ROTATE_ABOUT_POINT, or ROTATE_NONE<DD><CODE>axis</CODE> - the ray about which the OrientedShape3D rotates</DL>
</DL>
<HR>

<A NAME="OrientedShape3D(javax.media.j3d.Geometry, javax.media.j3d.Appearance, int, javax.vecmath.Point3f)"><!-- --></A><H3>
OrientedShape3D</H3>
<PRE>
public <B>OrientedShape3D</B>(<A HREF="../../../javax/media/j3d/Geometry.html" title="class in javax.media.j3d">Geometry</A>&nbsp;geometry,
                       <A HREF="../../../javax/media/j3d/Appearance.html" title="class in javax.media.j3d">Appearance</A>&nbsp;appearance,
                       int&nbsp;mode,
                       <A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;point)</PRE>
<DL>
<DD>Constructs an OrientedShape3D node with the specified geometry
 component, appearance component, mode, and rotation point.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>geometry</CODE> - the geometry component with which to initialize
 this shape node<DD><CODE>appearance</CODE> - the appearance component of the shape node<DD><CODE>mode</CODE> - alignment mode, one of: ROTATE_ABOUT_AXIS,
 ROTATE_ABOUT_POINT, or ROTATE_NONE<DD><CODE>point</CODE> - the position about which the OrientedShape3D rotates</DL>
</DL>
<HR>

<A NAME="OrientedShape3D(javax.media.j3d.Geometry, javax.media.j3d.Appearance, int, javax.vecmath.Vector3f, boolean, double)"><!-- --></A><H3>
OrientedShape3D</H3>
<PRE>
public <B>OrientedShape3D</B>(<A HREF="../../../javax/media/j3d/Geometry.html" title="class in javax.media.j3d">Geometry</A>&nbsp;geometry,
                       <A HREF="../../../javax/media/j3d/Appearance.html" title="class in javax.media.j3d">Appearance</A>&nbsp;appearance,
                       int&nbsp;mode,
                       <A HREF="../../../javax/vecmath/Vector3f.html" title="class in javax.vecmath">Vector3f</A>&nbsp;axis,
                       boolean&nbsp;constantScaleEnable,
                       double&nbsp;scale)</PRE>
<DL>
<DD>Constructs an OrientedShape3D node with the specified geometry
 component, appearance component, mode, axis, constant scale
 enable flag, and scale
 The specified axis must not be parallel to the <i>Z</i>
 axis--(0,0,<i>z</i>) for any value of <i>z</i>.  It is not
 possible for the +<i>Z</i> axis to point at the viewer's eye
 position by rotating about itself.  The target transform will
 be set to the identity if the axis is (0,0,<i>z</i>).
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>geometry</CODE> - the geometry component with which to initialize
 this shape node<DD><CODE>appearance</CODE> - the appearance component of the shape node<DD><CODE>mode</CODE> - alignment mode, one of: ROTATE_ABOUT_AXIS,
 ROTATE_ABOUT_POINT, or ROTATE_NONE<DD><CODE>axis</CODE> - the ray about which the OrientedShape3D rotates<DD><CODE>constantScaleEnable</CODE> - a flag indicating whether to enable
 constant scale<DD><CODE>scale</CODE> - scale value used when constant scale is enabled<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
</DL>
</DL>
<HR>

<A NAME="OrientedShape3D(javax.media.j3d.Geometry, javax.media.j3d.Appearance, int, javax.vecmath.Point3f, boolean, double)"><!-- --></A><H3>
OrientedShape3D</H3>
<PRE>
public <B>OrientedShape3D</B>(<A HREF="../../../javax/media/j3d/Geometry.html" title="class in javax.media.j3d">Geometry</A>&nbsp;geometry,
                       <A HREF="../../../javax/media/j3d/Appearance.html" title="class in javax.media.j3d">Appearance</A>&nbsp;appearance,
                       int&nbsp;mode,
                       <A HREF="../../../javax/vecmath/Point3f.html" title="class in javax.vecmath">Point3f</A>&nbsp;point,
                       boolean&nbsp;constantScaleEnable,
                       double&nbsp;scale)</PRE>
<DL>
<DD>Constructs an OrientedShape3D node with the specified geometry
 component, appearance component, mode, and rotation point.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>geometry</CODE> - the geometry component with which to initialize
 this shape node<DD><CODE>appearance</CODE> - the appearance component of the shape node<DD><CODE>mode</CODE> - alignment mode, one of: ROTATE_ABOUT_AXIS,
 ROTATE_ABOUT_POINT, or ROTATE_NONE<DD><CODE>point</CODE> - the position about which the OrientedShape3D rotates<DD><CODE>constantScaleEnable</CODE> - a flag indicating whether to enable
 constant scale<DD><CODE>scale</CODE> - scale value used when constant scale is enabled<DT><B>Since:</B></DT>
  <DD>Java 3D 1.3</DD>
</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="setAlignmentMode(int)"><!-- --></A><H3>
setAlignmentMode</H3>
<PRE>
public void <B>setAlignmentMode</B>(int&nbsp;mode)</PRE>
<DL>
<DD>Sets the alignment mode.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>mode</CODE> - alignment mode, one of: ROTATE_ABOUT_AXIS,
 ROTATE_ABOUT_POINT, or ROTATE_NONE
<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="getAlignmentMode()"><!-- --></A><H3>
getAlignmentMode</H3>
<PRE>
public int <B>getAlignmentMode</B>()</PRE>
<DL>
<DD>Retrieves the alignment mode.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>one of: ROTATE_ABOUT_AXIS, ROTATE_ABOUT_POINT,
 or ROTATE_NONE
<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="setAlignmentAxis(javax.vecmath.Vector3f)"><!-- --></A><H3>
setAlignmentAxis</H3>
<PRE>
public void <B>setAlignmentAxis</B>(<A HREF="../../../javax/vecmath/Vector3f.html" title="class in javax.vecmath">Vector3f</A>&nbsp;axis)</PRE>
<DL>
<DD>Sets the new alignment axis.  This is the ray about which this
 OrientedShape3D rotates when the mode is ROTATE_ABOUT_AXIS.
 The specified axis must not be parallel to the <i>Z</i>
 axis--(0,0,<i>z</i>) for any value of <i>z</i>.  It is not
 possible for the +<i>Z</i> axis to point at the viewer's eye
 position by rotating about itself.  The target transform will
 be set to the identity if the axis is (0,0,<i>z</i>).
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>axis</CODE> - the new alignment axis
<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="setAlignmentAxis(float, float, float)"><!-- --></A><H3>
setAlignmentAxis</H3>
<PRE>
public void <B>setAlignmentAxis</B>(float&nbsp;x,
                             float&nbsp;y,
                             float&nbsp;z)</PRE>
<DL>
<DD>Sets the new alignment axis.  This is the ray about which this
 OrientedShape3D rotates when the mode is ROTATE_ABOUT_AXIS.
 The specified axis must not be parallel to the <i>Z</i>
 axis--(0,0,<i>z</i>) for any value of <i>z</i>.  It is not
 possible for the +<i>Z</i> axis to point at the viewer's eye
 position by rotating about itself.  The target transform will
 be set to the identity if the axis is (0,0,<i>z</i>).
<P>
<DD><DL>