text3d.html

java 3d帮助文档

<DL>
<DD>Specifies that this Text3D object allows
 reading the text alignment value.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.Text3D.ALLOW_ALIGNMENT_READ">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_ALIGNMENT_WRITE"><!-- --></A><H3>
ALLOW_ALIGNMENT_WRITE</H3>
<PRE>
public static final int <B>ALLOW_ALIGNMENT_WRITE</B></PRE>
<DL>
<DD>Specifies that this Text3D object allows
 writing the text alignment value.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.Text3D.ALLOW_ALIGNMENT_WRITE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_PATH_READ"><!-- --></A><H3>
ALLOW_PATH_READ</H3>
<PRE>
public static final int <B>ALLOW_PATH_READ</B></PRE>
<DL>
<DD>Specifies that this Text3D object allows
 reading the text path value.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.Text3D.ALLOW_PATH_READ">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_PATH_WRITE"><!-- --></A><H3>
ALLOW_PATH_WRITE</H3>
<PRE>
public static final int <B>ALLOW_PATH_WRITE</B></PRE>
<DL>
<DD>Specifies that this Text3D object allows
 writing the text path value.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.Text3D.ALLOW_PATH_WRITE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_CHARACTER_SPACING_READ"><!-- --></A><H3>
ALLOW_CHARACTER_SPACING_READ</H3>
<PRE>
public static final int <B>ALLOW_CHARACTER_SPACING_READ</B></PRE>
<DL>
<DD>Specifies that this Text3D object allows
 reading the text character spacing value.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.Text3D.ALLOW_CHARACTER_SPACING_READ">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_CHARACTER_SPACING_WRITE"><!-- --></A><H3>
ALLOW_CHARACTER_SPACING_WRITE</H3>
<PRE>
public static final int <B>ALLOW_CHARACTER_SPACING_WRITE</B></PRE>
<DL>
<DD>Specifies that this Text3D object allows
 writing the text character spacing value.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.Text3D.ALLOW_CHARACTER_SPACING_WRITE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALLOW_BOUNDING_BOX_READ"><!-- --></A><H3>
ALLOW_BOUNDING_BOX_READ</H3>
<PRE>
public static final int <B>ALLOW_BOUNDING_BOX_READ</B></PRE>
<DL>
<DD>Specifies that this Text3D object allows
 reading the text string bounding box value
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.Text3D.ALLOW_BOUNDING_BOX_READ">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALIGN_CENTER"><!-- --></A><H3>
ALIGN_CENTER</H3>
<PRE>
public static final int <B>ALIGN_CENTER</B></PRE>
<DL>
<DD><code>alignment</code>: the center of the string is placed on the
 <code>position</code> point.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Text3D.html#getAlignment()"><CODE>getAlignment()</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.Text3D.ALIGN_CENTER">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALIGN_FIRST"><!-- --></A><H3>
ALIGN_FIRST</H3>
<PRE>
public static final int <B>ALIGN_FIRST</B></PRE>
<DL>
<DD><code>alignment</code>: the first character of the string is placed
 on the <code>position</code> point.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Text3D.html#getAlignment()"><CODE>getAlignment()</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.Text3D.ALIGN_FIRST">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="ALIGN_LAST"><!-- --></A><H3>
ALIGN_LAST</H3>
<PRE>
public static final int <B>ALIGN_LAST</B></PRE>
<DL>
<DD><code>alignment</code>: the last character of the string is placed
 on the <code>position</code> point.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Text3D.html#getAlignment()"><CODE>getAlignment()</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.Text3D.ALIGN_LAST">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="PATH_LEFT"><!-- --></A><H3>
PATH_LEFT</H3>
<PRE>
public static final int <B>PATH_LEFT</B></PRE>
<DL>
<DD><code>path</code>: succeeding glyphs are placed to the left of
 the current glyph.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Text3D.html#getPath()"><CODE>getPath()</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.Text3D.PATH_LEFT">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="PATH_RIGHT"><!-- --></A><H3>
PATH_RIGHT</H3>
<PRE>
public static final int <B>PATH_RIGHT</B></PRE>
<DL>
<DD><code>path</code>: succeeding glyphs are placed to the left of
 the current glyph.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Text3D.html#getPath()"><CODE>getPath()</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.Text3D.PATH_RIGHT">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="PATH_UP"><!-- --></A><H3>
PATH_UP</H3>
<PRE>
public static final int <B>PATH_UP</B></PRE>
<DL>
<DD><code>path</code>: succeeding glyphs are placed above the
 current glyph.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Text3D.html#getPath()"><CODE>getPath()</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.Text3D.PATH_UP">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="PATH_DOWN"><!-- --></A><H3>
PATH_DOWN</H3>
<PRE>
public static final int <B>PATH_DOWN</B></PRE>
<DL>
<DD><code>path</code>: succeeding glyphs are placed below the
 current glyph.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Text3D.html#getPath()"><CODE>getPath()</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.Text3D.PATH_DOWN">Constant Field Values</A></DL>
</DL>

<!-- ========= 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="Text3D()"><!-- --></A><H3>
Text3D</H3>
<PRE>
public <B>Text3D</B>()</PRE>
<DL>
<DD>Constructs a Text3D object with default parameters.
 The default values are as follows:
 <ul>
 font 3D : null<br>
 string : null<br>
 position : (0,0,0)<br>
 alignment : ALIGN_FIRST<br>
 path : PATH_RIGHT<br>
 character spacing : 0.0<br>
 </ul>
<P>
</DL>
<HR>

<A NAME="Text3D(javax.media.j3d.Font3D)"><!-- --></A><H3>
Text3D</H3>
<PRE>
public <B>Text3D</B>(<A HREF="../../../javax/media/j3d/Font3D.html">Font3D</A>&nbsp;font3D)</PRE>
<DL>
<DD>Creates a Text3D object with the given Font3D object.
<P>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Font3D.html"><CODE>Font3D</CODE></A></DL>
<HR>

<A NAME="Text3D(javax.media.j3d.Font3D, java.lang.String)"><!-- --></A><H3>
Text3D</H3>
<PRE>
public <B>Text3D</B>(<A HREF="../../../javax/media/j3d/Font3D.html">Font3D</A>&nbsp;font3D,
              java.lang.String&nbsp;string)</PRE>
<DL>
<DD>Creates a Text3D object given a Font3D object and a string.  The
 string is converted into 3D glyphs.  The first glyph from the
 string is placed at (0.0, 0.0, 0.0) and succeeding glyphs are
 placed to the right of the initial glyph.
<P>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Font3D.html"><CODE>Font3D</CODE></A></DL>
<HR>

<A NAME="Text3D(javax.media.j3d.Font3D, java.lang.String, javax.vecmath.Point3f)"><!-- --></A><H3>
Text3D</H3>
<PRE>
public <B>Text3D</B>(<A HREF="../../../javax/media/j3d/Font3D.html">Font3D</A>&nbsp;font3D,
              java.lang.String&nbsp;string,
              <A HREF="../../../javax/vecmath/Point3f.html">Point3f</A>&nbsp;position)</PRE>
<DL>
<DD>Creates a Text3D object given a Font3D, a string and position. The
 string is converted into 3D glyphs.  The first glyph from the
 string is placed at position <code>position</code> and succeeding
 glyphs are placed to the right of the initial glyph.
<P>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Font3D.html"><CODE>Font3D</CODE></A></DL>
<HR>

<A NAME="Text3D(javax.media.j3d.Font3D, java.lang.String, javax.vecmath.Point3f, int, int)"><!-- --></A><H3>
Text3D</H3>
<PRE>
public <B>Text3D</B>(<A HREF="../../../javax/media/j3d/Font3D.html">Font3D</A>&nbsp;font3D,
              java.lang.String&nbsp;string,
              <A HREF="../../../javax/vecmath/Point3f.html">Point3f</A>&nbsp;position,
              int&nbsp;alignment,
              int&nbsp;path)</PRE>
<DL>
<DD>Creates a Text3D object given a Font3D, string, position, alignment
 and path along which string is to be placed. The
 string is converted into 3D glyphs.  The placement of the glyphs
 with respect to the <code>position</code> position depends on
 the alignment parameter and the path parameter.
<P>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Font3D.html"><CODE>Font3D</CODE></A></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="getFont3D()"><!-- --></A><H3>
getFont3D</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Font3D.html">Font3D</A> <B>getFont3D</B>()</PRE>
<DL>
<DD>Returns the Font3D objects used by this Text3D NodeComponent object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the Font3D object of this Text3D node - null if no Font3D
  has been associated with this node.
<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="setFont3D(javax.media.j3d.Font3D)"><!-- --></A><H3>
setFont3D</H3>
<PRE>
public void <B>setFont3D</B>(<A HREF="../../../javax/media/j3d/Font3D.html">Font3D</A>&nbsp;font3d)</PRE>
<DL>
<DD>Sets the Font3D object used by this Text3D NodeComponent object.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>font3d</CODE> - the Font3D object to associate with this Text3D node.
<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="getString()"><!-- --></A><H3>
getString</H3>
<PRE>
public java.lang.String <B>getString</B>()</PRE>
<DL>
<DD>Copies the character string used in the construction of the