scenegraphfilereader.html

JAVA多媒体开发类库说明

public <A HREF="../../../../../../com/sun/j3d/utils/universe/ConfiguredUniverse.html" title="class in com.sun.j3d.utils.universe">ConfiguredUniverse</A> <B>readUniverse</B>(boolean&nbsp;attachBranchGraphs)
                                throws java.io.IOException</PRE>
<DL>
<DD>Create and return a ConfiguredUniverse with the PlatformGeometry, ViewerAvatar,
 and Locales saved in the file.  The MultiTransformGroup between the ViewingPlatform
 and the View is also restored.  Universe configuration information is retrieved
 via <code>ConfiguredUniverse.getConfigURL()</code>.<p>
 If the file does not contain universe information, null is returned.<p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>attachBranchGraphs</CODE> - load and attach all the branchgraphs
 to the universe.
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE><DT><B>See Also:</B><DD><A HREF="../../../../../../com/sun/j3d/utils/universe/ConfiguredUniverse.html#getConfigURL()"><CODE>ConfiguredUniverse.getConfigURL()</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="setClassLoader(java.lang.ClassLoader)"><!-- --></A><H3>
setClassLoader</H3>
<PRE>
public void <B>setClassLoader</B>(java.lang.ClassLoader&nbsp;classLoader)</PRE>
<DL>
<DD>Set the ClassLoader used to load the scene graph objects and
 deserialize user data
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getClassLoader()"><!-- --></A><H3>
getClassLoader</H3>
<PRE>
public java.lang.ClassLoader <B>getClassLoader</B>()</PRE>
<DL>
<DD>Get the ClassLoader used to load the scene graph objects and
 deserialize user data
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="readUniverse(boolean, javax.media.j3d.Canvas3D)"><!-- --></A><H3>
readUniverse</H3>
<PRE>
public <A HREF="../../../../../../com/sun/j3d/utils/universe/ConfiguredUniverse.html" title="class in com.sun.j3d.utils.universe">ConfiguredUniverse</A> <B>readUniverse</B>(boolean&nbsp;attachBranchGraphs,
                                       <A HREF="../../../../../../javax/media/j3d/Canvas3D.html" title="class in javax.media.j3d">Canvas3D</A>&nbsp;canvas)
                                throws java.io.IOException</PRE>
<DL>
<DD>Create and return a ConfiguredUniverse with the PlatformGeometry, ViewerAvatar,
 and Locales saved in the file.  The MultiTransformGroup between the ViewingPlatform
 and the View is also restored.<p>
 If the file does not contain universe information, null is returned.<p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>attachBranchGraphs</CODE> - load and attach all the branchgraphs
 to the universe.<DD><CODE>canvas</CODE> - The canvas to be associated with the Universe.
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="readUserData()"><!-- --></A><H3>
readUserData</H3>
<PRE>
public java.lang.Object <B>readUserData</B>()
                              throws java.io.IOException</PRE>
<DL>
<DD>Get the UserData in the File header
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="readDescription()"><!-- --></A><H3>
readDescription</H3>
<PRE>
public java.lang.String <B>readDescription</B>()
                                 throws java.io.IOException</PRE>
<DL>
<DD>Get the Description of this file's contents
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getBranchGraphCount()"><!-- --></A><H3>
getBranchGraphCount</H3>
<PRE>
public int <B>getBranchGraphCount</B>()</PRE>
<DL>
<DD>Return the number of BranchGraphs in the file
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="readBranchGraph(int)"><!-- --></A><H3>
readBranchGraph</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/BranchGroup.html" title="class in javax.media.j3d">BranchGroup</A>[] <B>readBranchGraph</B>(int&nbsp;index)
                              throws java.io.IOException</PRE>
<DL>
<DD>Read the BranchGraph at index in the file. If the graph
 contains references to nodes in other BranchGraphs that have not already been
 loaded, they will also be loaded and returned.<p>

 The requested graph will always be the first element in the array.<p>

 The file index of all the Graphs can be discovered using <code>getBranchGraphPosition</code>.<p>
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - The index of the Graph in the file. First graph is at index 0
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE><DT><B>See Also:</B><DD><A HREF="../../../../../../com/sun/j3d/utils/scenegraph/io/SceneGraphFileReader.html#getBranchGraphPosition(javax.media.j3d.BranchGroup)"><CODE>getBranchGraphPosition( BranchGroup graph )</CODE></A></DL>
</DD>
</DL>
<HR>

<A NAME="readAllBranchGraphs()"><!-- --></A><H3>
readAllBranchGraphs</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/BranchGroup.html" title="class in javax.media.j3d">BranchGroup</A>[] <B>readAllBranchGraphs</B>()
                                  throws java.io.IOException</PRE>
<DL>
<DD>Read and return all the branchgraphs in the file
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="dereferenceBranchGraph(javax.media.j3d.BranchGroup)"><!-- --></A><H3>
dereferenceBranchGraph</H3>
<PRE>
public void <B>dereferenceBranchGraph</B>(<A HREF="../../../../../../javax/media/j3d/BranchGroup.html" title="class in javax.media.j3d">BranchGroup</A>&nbsp;graph)</PRE>
<DL>
<DD>Remove the IO system's reference to this branchgraph and all its nodes.<p>

 References to all loaded graphs are maintained by the IO system in
 order to facilitate node and component sharing between the graphs.<p>

 This call removes the references to graph <code>index</code><p>

 NOT CURRENTLY IMPLEMENTED
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getBranchGraphPosition(javax.media.j3d.BranchGroup)"><!-- --></A><H3>
getBranchGraphPosition</H3>
<PRE>
public int <B>getBranchGraphPosition</B>(<A HREF="../../../../../../javax/media/j3d/BranchGroup.html" title="class in javax.media.j3d">BranchGroup</A>&nbsp;graph)</PRE>
<DL>
<DD>Given a BranchGraph that has been loaded return the index of the
 graph in the file.  The the Branchgroup isn't found, -1 is returned.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="readBranchGraphUserData(int)"><!-- --></A><H3>
readBranchGraphUserData</H3>
<PRE>
public java.lang.Object <B>readBranchGraphUserData</B>(int&nbsp;index)
                                         throws java.io.IOException</PRE>
<DL>
<DD>Read the userdata for the branchgraph at 'index' in the file
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>index</CODE> - the index of the graph in the file
<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<HR>

<A NAME="getNames()"><!-- --></A><H3>
getNames</H3>
<PRE>
public java.lang.String[] <B>getNames</B>()</PRE>
<DL>
<DD>Return the names of all the named objects
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getNamedObject(java.lang.String)"><!-- --></A><H3>
getNamedObject</H3>
<PRE>
public <A HREF="../../../../../../javax/media/j3d/SceneGraphObject.html" title="class in javax.media.j3d">SceneGraphObject</A> <B>getNamedObject</B>(java.lang.String&nbsp;name)
                                throws <A HREF="../../../../../../com/sun/j3d/utils/scenegraph/io/NamedObjectException.html" title="class in com.sun.j3d.utils.scenegraph.io">NamedObjectException</A>,
                                       <A HREF="../../../../../../com/sun/j3d/utils/scenegraph/io/ObjectNotLoadedException.html" title="class in com.sun.j3d.utils.scenegraph.io">ObjectNotLoadedException</A></PRE>
<DL>
<DD>Return the named object.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>name</CODE> - The name of the object
<DT><B>Throws:</B>
<DD><CODE><A HREF="../../../../../../com/sun/j3d/utils/scenegraph/io/NamedObjectException.html" title="class in com.sun.j3d.utils.scenegraph.io">NamedObjectException</A></CODE> - is thrown if the name is not known to the system
<DD><CODE><A HREF="../../../../../../com/sun/j3d/utils/scenegraph/io/ObjectNotLoadedException.html" title="class in com.sun.j3d.utils.scenegraph.io">ObjectNotLoadedException</A></CODE> - is thrown if the named object has not been loaded yet</DL>
</DD>
</DL>
<HR>

<A NAME="close()"><!-- --></A><H3>
close</H3>
<PRE>
public void <B>close</B>()
           throws java.io.IOException</PRE>
<DL>
<DD>Close the file and cleanup internal data structures
<P>
<DD><DL>

<DT><B>Throws:</B>
<DD><CODE>java.io.IOException</CODE></DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>


<!-- ======= START OF BOTTOM NAVBAR ====== -->
<A NAME="navbar_bottom"><!-- --></A>
<A HREF="#skip-navbar_bottom" 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_bottom_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>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> &nbsp;<FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A>&nbsp;</TD>
  <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1">    <A HREF="../../../../../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A>&nbsp;</TD>
  </TR>
</TABLE>
</TD>
<TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
</EM>
</TD>
</TR>

<TR>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
&nbsp;<A HREF="../../../../../../com/sun/j3d/utils/scenegraph/io/ObjectNotLoadedException.html" title="class in com.sun.j3d.utils.scenegraph.io"><B>PREV CLASS</B></A>&nbsp;
&nbsp;<A HREF="../../../../../../com/sun/j3d/utils/scenegraph/io/SceneGraphFileWriter.html" title="class in com.sun.j3d.utils.scenegraph.io"><B>NEXT CLASS</B></A></FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../../../../index.html?com/sun/j3d/utils/scenegraph/io/SceneGraphFileReader.html" target="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="SceneGraphFileReader.html" target="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;<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:&nbsp;NESTED&nbsp;|&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_summary">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;FIELD&nbsp;|&nbsp;<A HREF="#constructor_detail">CONSTR</A>&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<A NAME="skip-navbar_bottom"></A>
<!-- ======== END OF BOTTOM NAVBAR ======= -->

<HR>
<font size="-1">Copyright (c) 2006 Sun Microsystems, Inc. All rights reserved. Use is subject to <a href="../../../../../../LICENSE-SPEC.html">license terms</a>.
</BODY>
</HTML>