viewinfo.html

JAVA多媒体开发类库说明

<DL>
<DD>Indicates that updates to a Screen3D associated with the View should
 be automatically checked with each call to a public method in this
 class.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../../constant-values.html#com.sun.j3d.utils.universe.ViewInfo.SCREEN_AUTO_UPDATE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="CANVAS_AUTO_UPDATE"><!-- --></A><H3>
CANVAS_AUTO_UPDATE</H3>
<PRE>
public static final int <B>CANVAS_AUTO_UPDATE</B></PRE>
<DL>
<DD>Indicates that updates to a Canvas3D associated with the View should
 be automatically checked with each call to a public method in this
 class.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../../constant-values.html#com.sun.j3d.utils.universe.ViewInfo.CANVAS_AUTO_UPDATE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="VIEW_AUTO_UPDATE"><!-- --></A><H3>
VIEW_AUTO_UPDATE</H3>
<PRE>
public static final int <B>VIEW_AUTO_UPDATE</B></PRE>
<DL>
<DD>Indicates that updates to the View should be automatically checked
 with each call to a public method in this class.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../../constant-values.html#com.sun.j3d.utils.universe.ViewInfo.VIEW_AUTO_UPDATE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="HEAD_AUTO_UPDATE"><!-- --></A><H3>
HEAD_AUTO_UPDATE</H3>
<PRE>
public static final int <B>HEAD_AUTO_UPDATE</B></PRE>
<DL>
<DD>Indicates that updates to the tracked head position should be
 automatically checked with each call to a public method in this class.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../../constant-values.html#com.sun.j3d.utils.universe.ViewInfo.HEAD_AUTO_UPDATE">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="PLATFORM_AUTO_UPDATE"><!-- --></A><H3>
PLATFORM_AUTO_UPDATE</H3>
<PRE>
public static final int <B>PLATFORM_AUTO_UPDATE</B></PRE>
<DL>
<DD>Indicates that updates to the ViewPlatform <code>localToVworld</code>
 transform should be automatically checked with each call to a public
 method in this class.  The View must be attached to a ViewPlatform
 which is part of a live scene graph, and the ViewPlatform node must
 have its <code>ALLOW_LOCAL_TO_VWORLD_READ</code> capability set.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../../../constant-values.html#com.sun.j3d.utils.universe.ViewInfo.PLATFORM_AUTO_UPDATE">Constant Field Values</A></DL>
</DL>

<!-- ========= 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="ViewInfo(javax.media.j3d.View)"><!-- --></A><H3>
ViewInfo</H3>
<PRE>
public <B>ViewInfo</B>(<A HREF="../../../../../javax/media/j3d/View.html" title="class in javax.media.j3d">View</A>&nbsp;view)</PRE>
<DL>
<DD>Creates a new ViewInfo for the specified View.<p>

 Applications are responsible for informing this class of changes to the
 View, its Canvas3D and Screen3D components, the tracked head position,
 and the ViewPlatform's <code>localToVworld</code> transform.  These
 notifications are performed with the <code>updateView</code>,
 <code>updateCanvas</code>, <code>updateScreen</code>,
 <code>updateHead</code>, and <code>updateViewPlatform</code>
 methods.<p>

 The View must be attached to a ViewPlatform.  If the ViewPlatform is
 attached to a live scene graph, then <code>ALLOW_POLICY_READ</code>
 capability must be set on the ViewPlatform node.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>view</CODE> - the View to use<DT><B>See Also:</B><DD><A HREF="../../../../../com/sun/j3d/utils/universe/ViewInfo.html#updateView"><CODE>updateView</CODE></A>, 
<A HREF="../../../../../com/sun/j3d/utils/universe/ViewInfo.html#updateCanvas(javax.media.j3d.Canvas3D)"><CODE>updateCanvas(Canvas3D)</CODE></A>, 
<A HREF="../../../../../com/sun/j3d/utils/universe/ViewInfo.html#updateScreen(javax.media.j3d.Screen3D)"><CODE>updateScreen(Screen3D)</CODE></A>, 
<A HREF="../../../../../com/sun/j3d/utils/universe/ViewInfo.html#updateHead"><CODE>updateHead</CODE></A>, 
<A HREF="../../../../../com/sun/j3d/utils/universe/ViewInfo.html#updateViewPlatform()"><CODE>updateViewPlatform()</CODE></A></DL>
</DL>
<HR>

<A NAME="ViewInfo(javax.media.j3d.View, int)"><!-- --></A><H3>
ViewInfo</H3>
<PRE>
public <B>ViewInfo</B>(<A HREF="../../../../../javax/media/j3d/View.html" title="class in javax.media.j3d">View</A>&nbsp;view,
                int&nbsp;autoUpdateFlags)</PRE>
<DL>
<DD>Creates a new ViewInfo for the specified View.  The View must be
 attached to a ViewPlatform.  If the ViewPlatform is attached to a live
 scene graph, then <code>ALLOW_POLICY_READ</code> capability must be set
 on the ViewPlatform node.
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>view</CODE> - the View to use<p><DD><CODE>autoUpdateFlags</CODE> - a logical <code>OR</code> of any of the
        <code>VIEW_AUTO_UPDATE</code>, <code>CANVAS_AUTO_UPDATE</code>,
        <code>SCREEN_AUTO_UPDATE</code>, <code>HEAD_AUTO_UPDATE</code>, or
        <code>PLATFORM_AUTO_UPDATE</code> flags to control whether changes to
        the View, its Canvas3D or Screen3D components, the tracked head
        position, or the ViewPlatform's <code>localToVworld</code> transform
        are checked automatically with each call to a public method of this
        class; if a flag is not set, then the application must inform this
        class of updates to the corresponding data</DL>
</DL>
<HR>

<A NAME="ViewInfo(javax.media.j3d.View, int, java.util.Map, java.util.Map)"><!-- --></A><H3>
ViewInfo</H3>
<PRE>
public <B>ViewInfo</B>(<A HREF="../../../../../javax/media/j3d/View.html" title="class in javax.media.j3d">View</A>&nbsp;view,
                int&nbsp;autoUpdateFlags,
                java.util.Map&nbsp;screenMap,
                java.util.Map&nbsp;viewPlatformMap)</PRE>
<DL>
<DD>Creates a new ViewInfo for the specified View.  The View must be
 attached to a ViewPlatform.  If the ViewPlatform is attached to a live
 scene graph, then <code>ALLOW_POLICY_READ</code> capability must be set
 on the ViewPlatform node.<p>

 ViewInfo caches Screen3D and ViewPlatform data, but Screen3D and
 ViewPlatform instances are shared across multiple Views in the Java 3D
 view model.  Since ViewInfo is per-View, all ViewInfo constructors
 except for this one use static references to manage the shared Screen3D
 and ViewPlatform objects.  In this constructor, however, the caller
 supplies two Map instances to hold these references for all ViewInfo
 instances, so static references can be avoided; it can be used to wrap
 this class into a multi-view context that provides the required
 maps.<p>

 Alternatively, the other constructors can be used by calling
 <code>ViewInfo.clear</code> when done with ViewInfo, or by simply
 retaining the static references until the JVM exits.<p>
<P>
<DL>
<DT><B>Parameters:</B><DD><CODE>view</CODE> - the View to use<p><DD><CODE>autoUpdateFlags</CODE> - a logical <code>OR</code> of any of the
        <code>VIEW_AUTO_UPDATE</code>, <code>CANVAS_AUTO_UPDATE</code>,
        <code>SCREEN_AUTO_UPDATE</code>, <code>HEAD_AUTO_UPDATE</code>, or
        <code>PLATFORM_AUTO_UPDATE</code> flags to control whether changes to
        the View, its Canvas3D or Screen3D components, the tracked head
        position, or the ViewPlatform's <code>localToVworld</code> transform
        are checked automatically with each call to a public method of this
        class; if a flag is not set, then the application must inform this
        class of updates to the corresponding data<p><DD><CODE>screenMap</CODE> - a writeable Map to hold Screen3D information<DD><CODE>viewPlatformMap</CODE> - a writeable Map to hold ViewPlatform information</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="getImagePlateToViewPlatform(javax.media.j3d.Canvas3D, javax.media.j3d.Transform3D, javax.media.j3d.Transform3D)"><!-- --></A><H3>
getImagePlateToViewPlatform</H3>
<PRE>
public void <B>getImagePlateToViewPlatform</B>(<A HREF="../../../../../javax/media/j3d/Canvas3D.html" title="class in javax.media.j3d">Canvas3D</A>&nbsp;c3d,
                                        <A HREF="../../../../../javax/media/j3d/Transform3D.html" title="class in javax.media.j3d">Transform3D</A>&nbsp;ip2vpl,
                                        <A HREF="../../../../../javax/media/j3d/Transform3D.html" title="class in javax.media.j3d">Transform3D</A>&nbsp;ip2vpr)</PRE>
<DL>
<DD>Gets the current transforms from image plate coordinates to view
 platform coordinates and copies them into the given Transform3Ds.<p>
 
 With a monoscopic canvas the image plate transform is copied to the
 first argument and the second argument is not used.  For a stereo
 canvas the first argument receives the left image plate transform, and
 if the second argument is non-null it receives the right image plate
 transform.  These transforms are always the same unless a head mounted
 display driven by a single stereo canvas is in use.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>c3d</CODE> - the Canvas3D associated with the image plate<DD><CODE>ip2vpl</CODE> - the Transform3D to receive the left transform<DD><CODE>ip2vpr</CODE> - the Transform3D to receive the right transform, or null</DL>
</DD>
</DL>
<HR>

<A NAME="getImagePlateToVworld(javax.media.j3d.Canvas3D, javax.media.j3d.Transform3D, javax.media.j3d.Transform3D)"><!-- --></A><H3>
getImagePlateToVworld</H3>
<PRE>
public void <B>getImagePlateToVworld</B>(<A HREF="../../../../../javax/media/j3d/Canvas3D.html" title="class in javax.media.j3d">Canvas3D</A>&nbsp;c3d,
                                  <A HREF="../../../../../javax/media/j3d/Transform3D.html" title="class in javax.media.j3d">Transform3D</A>&nbsp;ip2vwl,
                                  <A HREF="../../../../../javax/media/j3d/Transform3D.html" title="class in javax.media.j3d">Transform3D</A>&nbsp;ip2vwr)</PRE>
<DL>
<DD>Gets the current transforms from image plate coordinates to virtual
 world coordinates and copies them into the given Transform3Ds.<p>
 
 With a monoscopic canvas the image plate transform is copied to the
 first argument and the second argument is not used.  For a stereo
 canvas the first argument receives the left image plate transform, and
 if the second argument is non-null it receives the right image plate
 transform.  These transforms are always the same unless a head mounted
 display driven by a single stereo canvas is in use.<p>

 The View must be attached to a ViewPlatform which is part of a live
 scene graph, and the ViewPlatform node must have its
 <code>ALLOW_LOCAL_TO_VWORLD_READ</code> capability set.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>c3d</CODE> - the Canvas3D associated with the image plate<DD><CODE>ip2vwl</CODE> - the Transform3D to receive the left transform<DD><CODE>ip2vwr</CODE> - the Transform3D to receive the right transform, or null</DL>
</DD>
</DL>
<HR>