📄 graphicscontext3d.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.0 Transitional//EN""http://www.w3.org/TR/REC-html40/loose.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc on Sun Jun 23 01:50:24 PDT 2002 --><TITLE>GraphicsContext3D (Java 3D API)</TITLE><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"></HEAD><SCRIPT>function asd(){parent.document.title="GraphicsContext3D (Java 3D API)";}</SCRIPT><BODY BGCOLOR="white" onload="asd();"><!-- ========== START OF NAVBAR ========== --><A NAME="navbar_top"><!-- --></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0"><TR><TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3"> <TR ALIGN="center" VALIGN="top"> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD> <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD> <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD> </TR></TABLE></TD><TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM></EM></TD></TR><TR><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../javax/media/j3d/GraphicsConfigTemplate3D.html"><B>PREV CLASS</B></A> <A HREF="../../../javax/media/j3d/Group.html"><B>NEXT CLASS</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A> <A HREF="GraphicsContext3D.html" TARGET="_top"><B>NO FRAMES</B></A> <SCRIPT> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A>'); } //--></SCRIPT><NOSCRIPT><A HREF="../../../allclasses-noframe.html" TARGET=""><B>All Classes</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | CONSTR | <A HREF="#method_summary">METHOD</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">DETAIL: <A HREF="#field_detail">FIELD</A> | CONSTR | <A HREF="#method_detail">METHOD</A></FONT></TD></TR></TABLE><!-- =========== END OF NAVBAR =========== --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">javax.media.j3d</FONT><BR>Class GraphicsContext3D</H2><PRE>java.lang.Object | +--<B>javax.media.j3d.GraphicsContext3D</B></PRE><HR><DL><DT>public class <B>GraphicsContext3D</B><DT>extends java.lang.Object</DL><P>A GraphicsContext3D object is used for immediate mode rendering into a 3D canvas. It is created by, and associated with, a specific Canvas3D object. A GraphicsContext3D defines methods to set 3D graphics state and draw 3D geometric primitives. There are no public constructors of GraphicsContext3D. An application obtains a 3D graphics context object from the Canvas3D object that the application wishes to render into by using the getGraphicsContext3D method. A new graphics context is created if one does not already exist. A new GraphicsContext3D initializes its state variables to the following defaults: <UL> <LI> Background object: null </LI> <LI> Fog object: null </LI> <LI> ModelClip object: null </LI> <LI> Appearance object: null </LI> <LI> List of Light objects: empty </LI> <LI> high-res coordinate: (0, 0, 0) </LI> <LI> modelTransform: identity </LI> <LI> AuralAttributes object: null </LI> <LI> List of Sound objects: empty </LI> <LI> buffer override: false </LI> <LI> front buffer rendering: false </LI> <LI> stereo mode: <code>STEREO_BOTH</code> </LI> </UL> <p> Note that the drawing methods in this class are not necessarily executed immediately. They may be buffered up for future execution. Applications must call the <code><a href="#flush(boolean)">flush</a>(boolean)</code> method to ensure that the rendering actually happens. The flush method is implicitly called in the following cases: <ul> <li>The <code>readRaster</code> method calls <code>flush(true)</code></li> <li>The <code>Canvas3D.swap</code> method calls <code>flush(true)</code></li> <li>The Java 3D renderer calls <code>flush(true)</code> prior to swapping the buffer for a double buffered on-screen Canvas3D</li> <li>The Java 3D renderer calls <code>flush(true)</code> prior to copying into the off-screen buffer of an off-screen Canvas3D</li> <li>The Java 3D renderer calls <code>flush(false)</code> after calling the preRender, renderField, postRender, and postSwap Canvas3D callback methods.</li> </ul> <p> A single-buffered, pure-immediate mode application must explicitly call flush to ensure that the graphics will be rendered to the Canvas3D.<P><P><DL><DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Canvas3D.html#getGraphicsContext3D()"><CODE>Canvas3D.getGraphicsContext3D()</CODE></A></DL><HR><P><!-- ======== NESTED CLASS SUMMARY ======== --><!-- =========== FIELD SUMMARY =========== --><A NAME="field_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Field Summary</B></FONT></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static int</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#STEREO_BOTH">STEREO_BOTH</A></B></CODE><BR> Specifies that rendering is done to both eyes.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static int</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#STEREO_LEFT">STEREO_LEFT</A></B></CODE><BR> Specifies that rendering is done to the left eye.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static int</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#STEREO_RIGHT">STEREO_RIGHT</A></B></CODE><BR> Specifies that rendering is done to the right eye.</TD></TR></TABLE> <!-- ======== CONSTRUCTOR SUMMARY ======== --><!-- ========== METHOD SUMMARY =========== --><A NAME="method_summary"><!-- --></A><TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%"><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TD COLSPAN=2><FONT SIZE="+2"><B>Method Summary</B></FONT></TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#addLight(javax.media.j3d.Light)">addLight</A></B>(<A HREF="../../../javax/media/j3d/Light.html">Light</A> light)</CODE><BR> Appends the specified light to this graphics context's list of lights.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#addSound(javax.media.j3d.Sound)">addSound</A></B>(<A HREF="../../../javax/media/j3d/Sound.html">Sound</A> sound)</CODE><BR> Appends the specified sound to this graphics context's list of sounds.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#clear()">clear</A></B>()</CODE><BR> Clear the Canvas3D to the color or image specified by the current background node.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#draw(javax.media.j3d.Geometry)">draw</A></B>(<A HREF="../../../javax/media/j3d/Geometry.html">Geometry</A> geometry)</CODE><BR> Draw the specified Geometry component object.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#draw(javax.media.j3d.Shape3D)">draw</A></B>(<A HREF="../../../javax/media/j3d/Shape3D.html">Shape3D</A> shape)</CODE><BR> Draw the specified Shape3D leaf node object.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#flush(boolean)">flush</A></B>(boolean wait)</CODE><BR> Flushes all previously executed rendering operations to the drawing buffer for this 3D graphics context.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> java.util.Enumeration</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getAllLights()">getAllLights</A></B>()</CODE><BR> Retrieves the enumeration object of all the lights.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> java.util.Enumeration</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getAllSounds()">getAllSounds</A></B>()</CODE><BR> Retrieves the enumeration object of all the sounds.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../javax/media/j3d/Appearance.html">Appearance</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getAppearance()">getAppearance</A></B>()</CODE><BR> Retrieves the current Appearance component object.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../javax/media/j3d/AuralAttributes.html">AuralAttributes</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getAuralAttributes()">getAuralAttributes</A></B>()</CODE><BR> Retrieves the current AuralAttributes component object.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../javax/media/j3d/Background.html">Background</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getBackground()">getBackground</A></B>()</CODE><BR> Retrieves the current Background leaf node object.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> boolean</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getBufferOverride()">getBufferOverride</A></B>()</CODE><BR> Returns the current buffer override flag.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../javax/media/j3d/Canvas3D.html">Canvas3D</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getCanvas3D()">getCanvas3D</A></B>()</CODE><BR> Gets the Canvas3D that created this GraphicsContext3D.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../javax/media/j3d/Fog.html">Fog</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getFog()">getFog</A></B>()</CODE><BR> Retrieves the current Fog leaf node object.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> boolean</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getFrontBufferRendering()">getFrontBufferRendering</A></B>()</CODE><BR> Returns the current front buffer rendering flag.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getHiRes(javax.media.j3d.HiResCoord)">getHiRes</A></B>(<A HREF="../../../javax/media/j3d/HiResCoord.html">HiResCoord</A> hiRes)</CODE><BR> Retrieves the current HiRes coordinate of this context.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../javax/media/j3d/Light.html">Light</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getLight(int)">getLight</A></B>(int index)</CODE><BR> Retrieves the index selected light.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../javax/media/j3d/ModelClip.html">ModelClip</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getModelClip()">getModelClip</A></B>()</CODE><BR> Retrieves the current ModelClip leaf node object.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getModelTransform(javax.media.j3d.Transform3D)">getModelTransform</A></B>(<A HREF="../../../javax/media/j3d/Transform3D.html">Transform3D</A> t)</CODE><BR> Retrieves the current model transform.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> <A HREF="../../../javax/media/j3d/Sound.html">Sound</A></CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getSound(int)">getSound</A></B>(int index)</CODE><BR> Retrieves the index selected sound.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> int</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#getStereoMode()">getStereoMode</A></B>()</CODE><BR> Returns the current stereo mode.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE> void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/GraphicsContext3D.html#insertLight(javax.media.j3d.Light, int)">insertLight</A></B>(<A HREF="../../../javax/media/j3d/Light.html">Light</A> light, int index)</CODE><BR>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -