📄 virtualuniverse.html
字号:
<!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd"><!--NewPage--><HTML><HEAD><!-- Generated by javadoc (build 1.5.0_06) on Wed Dec 13 16:20:08 PST 2006 --><TITLE>VirtualUniverse (Java 3D 1.5.0)</TITLE><META NAME="keywords" CONTENT="javax.media.j3d.VirtualUniverse class"><LINK REL ="stylesheet" TYPE="text/css" HREF="../../../stylesheet.css" TITLE="Style"><SCRIPT type="text/javascript">function windowTitle(){ parent.document.title="VirtualUniverse (Java 3D 1.5.0)";}</SCRIPT><NOSCRIPT></NOSCRIPT></HEAD><BODY BGCOLOR="white" onload="windowTitle();"><!-- ========= START OF TOP NAVBAR ======= --><A NAME="navbar_top"><!-- --></A><A HREF="#skip-navbar_top" title="Skip navigation links"></A><TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY=""><TR><TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1"><A NAME="navbar_top_firstrow"><!-- --></A><TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY=""> <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/ViewSpecificGroup.html" title="class in javax.media.j3d"><B>PREV CLASS</B></A> <A HREF="../../../javax/media/j3d/WakeupAnd.html" title="class in javax.media.j3d"><B>NEXT CLASS</B></A></FONT></TD><TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2"> <A HREF="../../../index.html?javax/media/j3d/VirtualUniverse.html" target="_top"><B>FRAMES</B></A> <A HREF="VirtualUniverse.html" target="_top"><B>NO FRAMES</B></A> <SCRIPT type="text/javascript"> <!-- if(window==top) { document.writeln('<A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A>'); } //--></SCRIPT><NOSCRIPT> <A HREF="../../../allclasses-noframe.html"><B>All Classes</B></A></NOSCRIPT></FONT></TD></TR><TR><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2"> SUMMARY: NESTED | FIELD | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD><TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">DETAIL: FIELD | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD></TR></TABLE><A NAME="skip-navbar_top"></A><!-- ========= END OF TOP NAVBAR ========= --><HR><!-- ======== START OF CLASS DATA ======== --><H2><FONT SIZE="-1">javax.media.j3d</FONT><BR>Class VirtualUniverse</H2><PRE>java.lang.Object <IMG SRC="../../../resources/inherit.gif" ALT="extended by "><B>javax.media.j3d.VirtualUniverse</B></PRE><DL><DT><B>Direct Known Subclasses:</B> <DD><A HREF="../../../com/sun/j3d/utils/universe/SimpleUniverse.html" title="class in com.sun.j3d.utils.universe">SimpleUniverse</A></DD></DL><HR><DL><DT><PRE>public class <B>VirtualUniverse</B><DT>extends java.lang.Object</DL></PRE><P>A VirtualUniverse object is the top-level container for all scene graphs. A virtual universe consists of a set of Locale objects, each of which has a high-resolution position within the virtual universe. An application or applet may have more than one VirtualUniverse objects, but many applications will need only one. Virtual universes are separate entities in that no node object may exist in more than one virtual universe at any one time. Likewise, the objects in one virtual universe are not visible in, nor do they interact with objects in, any other virtual universe. <p> A VirtualUniverse object defines methods to enumerate its Locale objects and to remove them from the virtual universe. <p> For more information, see the <a href="doc-files/intro.html">Introduction to the Java 3D API</a> and <a href="doc-files/VirtualUniverse.html">Scene Graph Superstructure</a> documents.<P><P><DL><DT><B>See Also:</B><DD><A HREF="../../../javax/media/j3d/Locale.html" title="class in javax.media.j3d"><CODE>Locale</CODE></A></DL><HR><P><!-- ======== CONSTRUCTOR SUMMARY ======== --><A NAME="constructor_summary"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"><B>Constructor Summary</B></FONT></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE><B><A HREF="../../../javax/media/j3d/VirtualUniverse.html#VirtualUniverse()">VirtualUniverse</A></B>()</CODE><BR> Constructs a new VirtualUniverse.</TD></TR></TABLE> <!-- ========== METHOD SUMMARY =========== --><A NAME="method_summary"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor"><TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2"><B>Method Summary</B></FONT></TH></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/VirtualUniverse.html#addGraphStructureChangeListener(javax.media.j3d.GraphStructureChangeListener)">addGraphStructureChangeListener</A></B>(<A HREF="../../../javax/media/j3d/GraphStructureChangeListener.html" title="interface in javax.media.j3d">GraphStructureChangeListener</A> listener)</CODE><BR> Adds the specified GraphStructureChangeListener to the set of listeners that will be notified when the graph structure is changed on a live scene graph.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/VirtualUniverse.html#addRenderingErrorListener(javax.media.j3d.RenderingErrorListener)">addRenderingErrorListener</A></B>(<A HREF="../../../javax/media/j3d/RenderingErrorListener.html" title="interface in javax.media.j3d">RenderingErrorListener</A> listener)</CODE><BR> Adds the specified RenderingErrorListener to the set of listeners that will be notified when a rendering error is detected.</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/VirtualUniverse.html#addShaderErrorListener(javax.media.j3d.ShaderErrorListener)">addShaderErrorListener</A></B>(<A HREF="../../../javax/media/j3d/ShaderErrorListener.html" title="interface in javax.media.j3d">ShaderErrorListener</A> listener)</CODE><BR> Adds the specified ShaderErrorListener to the set of listeners that will be notified when a programmable shader error is detected on a live scene graph.</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/VirtualUniverse.html#getAllLocales()">getAllLocales</A></B>()</CODE><BR> Returns the enumeration object of all locales in this virtual universe.</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/VirtualUniverse.html#getJ3DThreadPriority()">getJ3DThreadPriority</A></B>()</CODE><BR> Retrieves that priority of Java 3D's threads.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static java.util.Map</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/VirtualUniverse.html#getProperties()">getProperties</A></B>()</CODE><BR> Returns a read-only Map object containing key-value pairs that define various global properties for Java 3D.</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/VirtualUniverse.html#numLocales()">numLocales</A></B>()</CODE><BR> Returns the number of locales.</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/VirtualUniverse.html#removeAllLocales()">removeAllLocales</A></B>()</CODE><BR> Removes all Locales and their associates branch graphs from this universe.</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/VirtualUniverse.html#removeGraphStructureChangeListener(javax.media.j3d.GraphStructureChangeListener)">removeGraphStructureChangeListener</A></B>(<A HREF="../../../javax/media/j3d/GraphStructureChangeListener.html" title="interface in javax.media.j3d">GraphStructureChangeListener</A> listener)</CODE><BR> Removes the specified GraphStructureChangeListener from the set of listeners.</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/VirtualUniverse.html#removeLocale(javax.media.j3d.Locale)">removeLocale</A></B>(<A HREF="../../../javax/media/j3d/Locale.html" title="class in javax.media.j3d">Locale</A> locale)</CODE><BR> Removes a Locale and its associates branch graphs from this universe.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/VirtualUniverse.html#removeRenderingErrorListener(javax.media.j3d.RenderingErrorListener)">removeRenderingErrorListener</A></B>(<A HREF="../../../javax/media/j3d/RenderingErrorListener.html" title="interface in javax.media.j3d">RenderingErrorListener</A> listener)</CODE><BR> Removes the specified RenderingErrorListener from the set of listeners.</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/VirtualUniverse.html#removeShaderErrorListener(javax.media.j3d.ShaderErrorListener)">removeShaderErrorListener</A></B>(<A HREF="../../../javax/media/j3d/ShaderErrorListener.html" title="interface in javax.media.j3d">ShaderErrorListener</A> listener)</CODE><BR> Removes the specified ShaderErrorListener from the set of listeners.</TD></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1"><CODE>static void</CODE></FONT></TD><TD><CODE><B><A HREF="../../../javax/media/j3d/VirtualUniverse.html#setJ3DThreadPriority(int)">setJ3DThreadPriority</A></B>(int priority)</CODE><BR> Sets the priority of all Java 3D threads to the specified value.</TD></TR></TABLE> <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A><TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY=""><TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor"><TH ALIGN="left"><B>Methods inherited from class java.lang.Object</B></TH></TR><TR BGCOLOR="white" CLASS="TableRowColor"><TD><CODE>clone, equals, finalize, getClass, hashCode, notify, notifyAll, toString, wait, wait, wait</CODE></TD></TR></TABLE> <P><!-- ========= 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="VirtualUniverse()"><!-- --></A><H3>VirtualUniverse</H3><PRE>public <B>VirtualUniverse</B>()</PRE><DL><DD>Constructs a new VirtualUniverse.<P></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="removeLocale(javax.media.j3d.Locale)"><!-- --></A><H3>removeLocale</H3><PRE>public void <B>removeLocale</B>(<A HREF="../../../javax/media/j3d/Locale.html" title="class in javax.media.j3d">Locale</A> locale)</PRE><DL><DD>Removes a Locale and its associates branch graphs from this universe. All branch graphs within the specified Locale are detached, regardless of whether their ALLOW_DETACH capability bits are set. The Locale is then marked as being dead: no branch graphs may subsequently be attached.<P><DD><DL><DT><B>Parameters:</B><DD><CODE>locale</CODE> - the Locale to be removed.<DT><B>Throws:</B><DD><CODE>java.lang.IllegalArgumentException</CODE> - if the specified Locale is not attached to this VirtualUniverse.<DT><B>Since:</B></DT> <DD>Java 3D 1.2</DD></DL></DD></DL><HR><A NAME="removeAllLocales()"><!-- --></A><H3>removeAllLocales</H3><PRE>public void <B>removeAllLocales</B>()</PRE><DL><DD>Removes all Locales and their associates branch graphs from this universe. All branch graphs within each Locale are detached, regardless of whether their ALLOW_DETACH capability bits are set. Each Locale is then marked as being dead: no branch graphs may subsequently be attached. This method should be called by applications and applets to allow Java 3D to cleanup its resources.<P><DD><DL><DT><B>Since:</B></DT> <DD>Java 3D 1.2</DD></DL></DD></DL><HR><A NAME="getAllLocales()"><!-- --></A><H3>getAllLocales</H3><PRE>public java.util.Enumeration <B>getAllLocales</B>()</PRE><DL><DD>Returns the enumeration object of all locales in this virtual universe.<P><DD><DL><DT><B>Returns:</B><DD>the enumeration object</DL></DD></DL><HR><A NAME="numLocales()"><!-- --></A><H3>numLocales</H3><PRE>public int <B>numLocales</B>()</PRE><DL><DD>Returns the number of locales.<P>⌨️ 快捷键说明
复制代码
Ctrl + C
搜索代码
Ctrl + F
全屏模式
F11
切换主题
Ctrl + Shift + D
显示快捷键
?
增大字号
Ctrl + =
减小字号
Ctrl + -