inputdevice.html

java 3d帮助文档

<HR>

<A NAME="NON_BLOCKING"><!-- --></A><H3>
NON_BLOCKING</H3>
<PRE>
public static final int <B>NON_BLOCKING</B></PRE>
<DL>
<DD>Signifies that the driver for a device is a non-blocking driver and
 that it should be scheduled for regular reads by Java 3D.  A
 non-blocking driver is defined as a driver that does not cause the
 calling thread to block while data is being retrieved from the
 driver.  If no data is available from the device, pollAndProcessInput
 should return without updating the sensor read value.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.InputDevice.NON_BLOCKING">Constant Field Values</A></DL>
</DL>
<HR>

<A NAME="DEMAND_DRIVEN"><!-- --></A><H3>
DEMAND_DRIVEN</H3>
<PRE>
public static final int <B>DEMAND_DRIVEN</B></PRE>
<DL>
<DD>Signifies that the Java 3D implementation should not schedule
 regular reads on the sensors of this device; the Java 3D
 implementation will only call pollAndProcessInput when one of the
 device's sensors' getRead methods is called.  A DEMAND_DRIVEN driver
 must always provide the current value of the sensor on demand whenever
 pollAndProcessInput is called.  This means that DEMAND_DRIVEN drivers
 are non-blocking by definition.
<P>
<DL>
<DT><B>See Also:</B><DD><A HREF="../../../constant-values.html#javax.media.j3d.InputDevice.DEMAND_DRIVEN">Constant Field Values</A></DL>
</DL>

<!-- ========= CONSTRUCTOR DETAIL ======== -->


<!-- ============ METHOD DETAIL ========== -->

<A NAME="method_detail"><!-- --></A>
<TABLE BORDER="1" CELLPADDING="3" CELLSPACING="0" WIDTH="100%">
<TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
<TD COLSPAN=1><FONT SIZE="+2">
<B>Method Detail</B></FONT></TD>
</TR>
</TABLE>

<A NAME="initialize()"><!-- --></A><H3>
initialize</H3>
<PRE>
public boolean <B>initialize</B>()</PRE>
<DL>
<DD>This method initializes the device.  A device should be initialized 
 before it is registered with Java 3D via the 
 PhysicalEnvironment.addInputDevice(InputDevice) method call.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>return true for succesful initialization, false for failure</DL>
</DD>
</DL>
<HR>

<A NAME="setNominalPositionAndOrientation()"><!-- --></A><H3>
setNominalPositionAndOrientation</H3>
<PRE>
public void <B>setNominalPositionAndOrientation</B>()</PRE>
<DL>
<DD>This method sets the device's current position and orientation as the
 devices nominal position and orientation (establish its reference 
 frame relative to the "Tracker base" reference frame).
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="pollAndProcessInput()"><!-- --></A><H3>
pollAndProcessInput</H3>
<PRE>
public void <B>pollAndProcessInput</B>()</PRE>
<DL>
<DD>This method causes the device's sensor readings to be updated by the
 device driver.  For BLOCKING and NON_BLOCKING drivers, this method is 
 called regularly and the Java 3D implementation can cache the sensor 
 values.  For DEMAND_DRIVEN drivers this method is called each time one 
 of the Sensor.getRead methods is called, and is not otherwise called.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="processStreamInput()"><!-- --></A><H3>
processStreamInput</H3>
<PRE>
public void <B>processStreamInput</B>()</PRE>
<DL>
<DD>This method will not be called by the Java 3D implementation and 
 should be implemented as an empty method.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="close()"><!-- --></A><H3>
close</H3>
<PRE>
public void <B>close</B>()</PRE>
<DL>
<DD>Code to process the clean up of the device and relinquish associated 
 resources.  This method should be called after the device has been 
 unregistered from Java 3D via the
 PhysicalEnvironment.removeInputDevice(InputDevice) method call.
<P>
<DD><DL>
</DL>
</DD>
</DL>
<HR>

<A NAME="getProcessingMode()"><!-- --></A><H3>
getProcessingMode</H3>
<PRE>
public int <B>getProcessingMode</B>()</PRE>
<DL>
<DD>This method retrieves the device's processing mode: one of BLOCKING, 
 NON_BLOCKING, or DEMAND_DRIVEN.  The Java 3D implementation calls
 this method when PhysicalEnvironment.addInputDevice(InputDevice) is
 called to register the device with Java 3D.  If this method returns 
 any value other than BLOCKING, NON_BLOCKING, or DEMAND_DRIVEN,
 addInputDevice will throw an IllegalArgumentException.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>Returns the devices processing mode, one of BLOCKING, 
 NON_BLOCKING, or DEMAND_DRIVEN</DL>
</DD>
</DL>
<HR>

<A NAME="setProcessingMode(int)"><!-- --></A><H3>
setProcessingMode</H3>
<PRE>
public void <B>setProcessingMode</B>(int&nbsp;mode)</PRE>
<DL>
<DD>This method sets the device's processing mode to one of: BLOCKING,
 NON_BLOCKING, or DEMAND_DRIVEN.  Many drivers will be written to run 
 in only one mode.  Applications using such drivers should not attempt 
 to set the processing mode.  This method should throw an 
 IllegalArgumentException if there is an attempt to set the processing 
 mode to anything other than the aforementioned three values.

 <p>
 NOTE: this method should <i>not</i> be called after the input
 device has been added to a PhysicalEnvironment.  The
 processingMode must remain constant while a device is attached
 to a PhysicalEnvironment.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>mode</CODE> - One of BLOCKING, NON_BLOCKING, or DEMAND_DRIVEN</DL>
</DD>
</DL>
<HR>

<A NAME="getSensorCount()"><!-- --></A><H3>
getSensorCount</H3>
<PRE>
public int <B>getSensorCount</B>()</PRE>
<DL>
<DD>This method gets the number of sensors associated with the device.
<P>
<DD><DL>

<DT><B>Returns:</B><DD>the device's sensor count.</DL>
</DD>
</DL>
<HR>

<A NAME="getSensor(int)"><!-- --></A><H3>
getSensor</H3>
<PRE>
public <A HREF="../../../javax/media/j3d/Sensor.html">Sensor</A> <B>getSensor</B>(int&nbsp;sensorIndex)</PRE>
<DL>
<DD>Gets the specified Sensor associated with the device.  Each InputDevice
 implementation is responsible for creating and managing its own set of
 sensors.  The sensor indices begin at zero and end at number of 
 sensors minus one.  Each sensor should have had 
 Sensor.setDevice(InputDevice) set properly before addInputDevice
 is called.
<P>
<DD><DL>
<DT><B>Parameters:</B><DD><CODE>sensorIndex</CODE> - the sensor to retrieve
<DT><B>Returns:</B><DD>Returns the specified sensor.</DL>
</DD>
</DL>
<!-- ========= END OF CLASS DATA ========= -->
<HR>

<!-- ========== START OF NAVBAR ========== -->
<A NAME="navbar_bottom"><!-- --></A>
<TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0">
<TR>
<TD COLSPAN=3 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
<A NAME="navbar_bottom_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>&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="../../../javax/media/j3d/ImageComponent3D.Updater.html"><B>PREV CLASS</B></A>&nbsp;
&nbsp;NEXT CLASS</FONT></TD>
<TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
  <A HREF="../../../index.html" TARGET="_top"><B>FRAMES</B></A>  &nbsp;
&nbsp;<A HREF="InputDevice.html" TARGET="_top"><B>NO FRAMES</B></A>  &nbsp;
&nbsp;
<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:&nbsp;NESTED&nbsp;|&nbsp;<A HREF="#field_summary">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_summary">METHOD</A></FONT></TD>
<TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
DETAIL:&nbsp;<A HREF="#field_detail">FIELD</A>&nbsp;|&nbsp;CONSTR&nbsp;|&nbsp;<A HREF="#method_detail">METHOD</A></FONT></TD>
</TR>
</TABLE>
<!-- =========== END OF NAVBAR =========== -->

<HR>

</BODY>
</HTML>