graphicscontext3d.html

JAVA多媒体开发类库说明

<PRE>
public static final int <B>STEREO_RIGHT</B></PRE>
<DL>
<DD>Specifies that rendering is done to the right eye.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.2</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#setStereoMode(int)"><CODE>setStereoMode(int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.GraphicsContext3D.STEREO_RIGHT">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="STEREO_BOTH"><!-- --></A><H3>
STEREO_BOTH</H3>
<PRE>
public static final int <B>STEREO_BOTH</B></PRE>
<DL>
<DD>Specifies that rendering is done to both eyes.  This is the
 default.
<P>
<DL>
<DT><B>Since:</B></DT>
  <DD>Java 3D 1.2</DD>
<DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#setStereoMode(int)"><CODE>setStereoMode(int)</CODE></A>, 
<A HREF="../../../constant-values.html#javax.media.j3d.GraphicsContext3D.STEREO_BOTH">Constant Field Values</A></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="getCanvas3D()"><!-- --></A><H3>
getCanvas3D</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Canvas3D.html" title="class in javax.media.j3d">Canvas3D</A> <B>getCanvas3D</B>()</PRE>
<DL>
<DD>Gets the Canvas3D that created this GraphicsContext3D.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the Canvas3D that created this GraphicsContext3D</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>Sets the current Appearance object to the specified
 Appearance component object.
 The graphics context stores a reference to the specified 
 Appearance object. This means that the application may modify 
 individual appearance attributes by using the appropriate 
 methods on the Appearance object.
 If the Appearance object is null, default values will be used 
 for all appearance attributes - it is as if an
 Appearance node were created using the default constructor.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>appearance</CODE> - the new Appearance object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if the specified appearance refers
 to an ImageComponent2D that is being used by a Canvas3D as
 an off-screen buffer.</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>Retrieves the current Appearance component object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the current Appearance object</DL>
</DD>
</DL>
<HR>

<A NAME="setBackground(javax.media.j3d.Background)"><!-- --></A><H3>
setBackground</H3>
<PRE>
public void <B>setBackground</B>(<A HREF="../../../javax/media/j3d/Background.html" title="class in javax.media.j3d">Background</A>&nbsp;background)</PRE>
<DL>
<DD>Sets the current Background to the specified Background
 leaf node object.
 The graphics context stores a reference to the specified 
 Background node. This means that the application may modify 
 the background color or image by using the appropriate 
 methods on the Background node. The Background node must 
 not be part of a live scene graph, nor may it subsequently 
 be made part of a live scene graph-an IllegalSharingException 
 is thrown in such cases. If the Background object is null, 
 the default background color of black (0,0,0) is used to clear
 the canvas prior to rendering a new frame. The Background 
 node's application region is ignored for immediate-mode 
 rendering.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>background</CODE> - the new Background object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if the Background node
 is part of or is subsequently made part of a live scene graph.
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if the specified background node
 refers to an ImageComponent2D that is being used by a Canvas3D as
 an off-screen buffer.</DL>
</DD>
</DL>
<HR>

<A NAME="getBackground()"><!-- --></A><H3>
getBackground</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Background.html" title="class in javax.media.j3d">Background</A> <B>getBackground</B>()</PRE>
<DL>
<DD>Retrieves the current Background leaf node object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the current Background object</DL>
</DD>
</DL>
<HR>

<A NAME="setFog(javax.media.j3d.Fog)"><!-- --></A><H3>
setFog</H3>
<PRE>
public void <B>setFog</B>(<A HREF="../../../javax/media/j3d/Fog.html" title="class in javax.media.j3d">Fog</A>&nbsp;fog)</PRE>
<DL>
<DD>Sets the current Fog to the specified Fog
 leaf node object.
 The graphics context stores a reference to the specified 
 Fog node. This means that the application may modify the 
 fog attributes using the appropriate methods on the Fog 
 node object. The Fog node must not be part of a live 
 scene graph, nor may it subsequently be made part of a
 live scene graph-an IllegalSharingException is thrown in 
 such cases. If the Fog object is null, fog is disabled. 
 Both the region of influence and the hierarchical scope 
 of the Fog node are ignored for immediate-mode rendering.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>fog</CODE> - the new Fog object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if the Fog node
 is part of or is subsequently made part of a live scene graph.</DL>
</DD>
</DL>
<HR>

<A NAME="getFog()"><!-- --></A><H3>
getFog</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Fog.html" title="class in javax.media.j3d">Fog</A> <B>getFog</B>()</PRE>
<DL>
<DD>Retrieves the current Fog leaf node object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the current Fog object</DL>
</DD>
</DL>
<HR>

<A NAME="setModelClip(javax.media.j3d.ModelClip)"><!-- --></A><H3>
setModelClip</H3>
<PRE>
public void <B>setModelClip</B>(<A HREF="../../../javax/media/j3d/ModelClip.html" title="class in javax.media.j3d">ModelClip</A>&nbsp;modelClip)</PRE>
<DL>
<DD>Sets the current ModelClip leaf node to the specified object.
 The graphics context stores a reference to the specified
 ModelClip node. This means that the application may modify the
 model clipping attributes using the appropriate methods on the
 ModelClip node object. The ModelClip node must not be part of a
 live scene graph, nor may it subsequently be made part of a
 live scene graph-an IllegalSharingException is thrown in such
 cases. If the ModelClip object is null, model clipping is
 disabled.  Both the region of influence and the hierarchical
 scope of the ModelClip node are ignored for immediate-mode
 rendering.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>modelClip</CODE> - the new ModelClip node
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if the ModelClip node
 is part of or is subsequently made part of a live scene graph.<DT><B>Since:</B></DT>
  <DD>Java 3D 1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="getModelClip()"><!-- --></A><H3>
getModelClip</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/ModelClip.html" title="class in javax.media.j3d">ModelClip</A> <B>getModelClip</B>()</PRE>
<DL>
<DD>Retrieves the current ModelClip leaf node object.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the current ModelClip object<DT><B>Since:</B></DT>
  <DD>Java 3D 1.2</DD>
</DL>
</DD>
</DL>
<HR>

<A NAME="setLight(javax.media.j3d.Light, int)"><!-- --></A><H3>
setLight</H3>
<PRE>
public void <B>setLight</B>(<A HREF="../../../javax/media/j3d/Light.html" title="class in javax.media.j3d">Light</A>&nbsp;light,
                     int&nbsp;index)</PRE>
<DL>
<DD>Replaces the specified light with the light provided.
 The graphics context stores a reference to each light 
 object in the list of lights. This means that the 
 application may modify the light attributes for
 any of the lights using the appropriate methods on that 
 Light node object. None of the Light nodes in the list 
 of lights may be part of a live scene graph, nor may 
 they subsequently be made part of a live scene graph -
 an IllegalSharingException is thrown in such cases.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>light</CODE> - the new light<DD><CODE>index</CODE> - which light to replace
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if the Light node
 is part of or is subsequently made part of a live scene graph.
<DD><CODE>java.lang.NullPointerException</CODE> - if the Light object is null.</DL>
</DD>
</DL>
<HR>

<A NAME="insertLight(javax.media.j3d.Light, int)"><!-- --></A><H3>
insertLight</H3>
<PRE>
public void <B>insertLight</B>(<A HREF="../../../javax/media/j3d/Light.html" title="class in javax.media.j3d">Light</A>&nbsp;light,
                        int&nbsp;index)</PRE>
<DL>
<DD>Inserts the specified light at the specified index location.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>light</CODE> - the new light<DD><CODE>index</CODE> - at which location to insert
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../javax/media/j3d/IllegalSharingException.html" title="class in javax.media.j3d">IllegalSharingException</A></CODE> - if the Light node
 is part of or is subsequently made part of a live scene graph.
<DD><CODE>java.lang.NullPointerException</CODE> - if the Light object is null.</DL>
</DD>
</DL>
<HR>

<A NAME="removeLight(int)"><!-- --></A><H3>
removeLight</H3>
<PRE>
public void <B>removeLight</B>(int&nbsp;index)</PRE>
<DL>
<DD>Removes the light at the specified index location.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - which light to remove</DL>
</DD>
</DL>
<HR>

<A NAME="getLight(int)"><!-- --></A><H3>
getLight</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Light.html" title="class in javax.media.j3d">Light</A> <B>getLight</B>(int&nbsp;index)</PRE>
<DL>
<DD>Retrieves the index selected light.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - which light to return
<DT><B>Returns:</B><DD>the light at location index</DL>
</DD>
</DL>
<HR>

<A NAME="getAllLights()"><!-- --></A><H3>
getAllLights</H3>
<PRE>
public java.util.Enumeration <B>getAllLights</B>()</PRE>
<DL>
<DD>Retrieves the enumeration object of all the lights.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the enumeration object of all the lights</DL>
</DD>