1 <!DOCTYPE HTML PUBLIC "-//W3C//DTD HTML 4.01 Transitional//EN" "http://www.w3.org/TR/html4/loose.dtd">
5 <!-- Generated by javadoc (build 1.5.0_09) on Tue Jan 08 20:46:01 GMT 2008 -->
7 Poll (leJOS NXT API documentation)
10 <META NAME="keywords" CONTENT="lejos.nxt.Poll class">
12 <LINK REL ="stylesheet" TYPE="text/css" HREF="../../stylesheet.css" TITLE="Style">
14 <SCRIPT type="text/javascript">
15 function windowTitle()
17 parent.document.title="Poll (leJOS NXT API documentation)";
25 <BODY BGCOLOR="white" onload="windowTitle();">
28 <!-- ========= START OF TOP NAVBAR ======= -->
29 <A NAME="navbar_top"><!-- --></A>
30 <A HREF="#skip-navbar_top" title="Skip navigation links"></A>
31 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
33 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
34 <A NAME="navbar_top_firstrow"><!-- --></A>
35 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
36 <TR ALIGN="center" VALIGN="top">
37 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
38 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
39 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
40 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
41 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
42 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
43 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
47 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
53 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
54 <A HREF="../../lejos/nxt/NXTCam.html" title="class in lejos.nxt"><B>PREV CLASS</B></A>
55 <A HREF="../../lejos/nxt/RCXLightSensor.html" title="class in lejos.nxt"><B>NEXT CLASS</B></A></FONT></TD>
56 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
57 <A HREF="../../index.html?lejos/nxt/Poll.html" target="_top"><B>FRAMES</B></A>
58 <A HREF="Poll.html" target="_top"><B>NO FRAMES</B></A>
59 <SCRIPT type="text/javascript">
62 document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
67 <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
74 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
75 SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
76 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
77 DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
80 <A NAME="skip-navbar_top"></A>
81 <!-- ========= END OF TOP NAVBAR ========= -->
84 <!-- ======== START OF CLASS DATA ======== -->
91 <A HREF="../../java/lang/Object.html" title="class in java.lang">java.lang.Object</A>
92 <IMG SRC="../../resources/inherit.gif" ALT="extended by "><B>lejos.nxt.Poll</B>
96 <DT><PRE>public class <B>Poll</B><DT>extends <A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></DL>
100 Provides blocking access to events from the NXT. Poll is a bit
101 of a misnomer (since you don't 'poll' at all) but it takes its
102 name from the Unix call of the same name.
109 <!-- =========== FIELD SUMMARY =========== -->
111 <A NAME="field_summary"><!-- --></A>
112 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
113 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
114 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
115 <B>Field Summary</B></FONT></TH>
117 <TR BGCOLOR="white" CLASS="TableRowColor">
118 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
119 <CODE>static short</CODE></FONT></TD>
120 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#ALL_BUTTONS">ALL_BUTTONS</A></B></CODE>
123 </TD>
125 <TR BGCOLOR="white" CLASS="TableRowColor">
126 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
127 <CODE>static short</CODE></FONT></TD>
128 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#ALL_SENSORS">ALL_SENSORS</A></B></CODE>
131 </TD>
133 <TR BGCOLOR="white" CLASS="TableRowColor">
134 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
135 <CODE>static short</CODE></FONT></TD>
136 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#BUTTON_MASK_SHIFT">BUTTON_MASK_SHIFT</A></B></CODE>
139 </TD>
141 <TR BGCOLOR="white" CLASS="TableRowColor">
142 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
143 <CODE>static short</CODE></FONT></TD>
144 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#ENTER_MASK">ENTER_MASK</A></B></CODE>
147 </TD>
149 <TR BGCOLOR="white" CLASS="TableRowColor">
150 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
151 <CODE>static short</CODE></FONT></TD>
152 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#ESCAPE_MASK">ESCAPE_MASK</A></B></CODE>
155 </TD>
157 <TR BGCOLOR="white" CLASS="TableRowColor">
158 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
159 <CODE>static short</CODE></FONT></TD>
160 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#LEFT_MASK">LEFT_MASK</A></B></CODE>
163 </TD>
165 <TR BGCOLOR="white" CLASS="TableRowColor">
166 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
167 <CODE>static short</CODE></FONT></TD>
168 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#RIGHT_MASK">RIGHT_MASK</A></B></CODE>
171 </TD>
173 <TR BGCOLOR="white" CLASS="TableRowColor">
174 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
175 <CODE>static short</CODE></FONT></TD>
176 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#SENSOR1_MASK">SENSOR1_MASK</A></B></CODE>
179 </TD>
181 <TR BGCOLOR="white" CLASS="TableRowColor">
182 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
183 <CODE>static short</CODE></FONT></TD>
184 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#SENSOR2_MASK">SENSOR2_MASK</A></B></CODE>
187 </TD>
189 <TR BGCOLOR="white" CLASS="TableRowColor">
190 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
191 <CODE>static short</CODE></FONT></TD>
192 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#SENSOR3_MASK">SENSOR3_MASK</A></B></CODE>
195 </TD>
197 <TR BGCOLOR="white" CLASS="TableRowColor">
198 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
199 <CODE>static short</CODE></FONT></TD>
200 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#SENSOR4_MASK">SENSOR4_MASK</A></B></CODE>
203 </TD>
205 <TR BGCOLOR="white" CLASS="TableRowColor">
206 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
207 <CODE>static short</CODE></FONT></TD>
208 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#SERIAL_MASK">SERIAL_MASK</A></B></CODE>
211 </TD>
213 <TR BGCOLOR="white" CLASS="TableRowColor">
214 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
215 <CODE>static short</CODE></FONT></TD>
216 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#SERIAL_SHIFT">SERIAL_SHIFT</A></B></CODE>
219 </TD>
223 <!-- ======== CONSTRUCTOR SUMMARY ======== -->
225 <A NAME="constructor_summary"><!-- --></A>
226 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
227 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
228 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
229 <B>Constructor Summary</B></FONT></TH>
231 <TR BGCOLOR="white" CLASS="TableRowColor">
232 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#Poll()">Poll</A></B>()</CODE>
235 Constructor.</TD>
239 <!-- ========== METHOD SUMMARY =========== -->
241 <A NAME="method_summary"><!-- --></A>
242 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
243 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
244 <TH ALIGN="left" COLSPAN="2"><FONT SIZE="+2">
245 <B>Method Summary</B></FONT></TH>
247 <TR BGCOLOR="white" CLASS="TableRowColor">
248 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
249 <CODE> int</CODE></FONT></TD>
250 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#poll(int, int)">poll</A></B>(int mask,
251 int millis)</CODE>
254 Wait for the sensor/button values to change then return.</TD>
256 <TR BGCOLOR="white" CLASS="TableRowColor">
257 <TD ALIGN="right" VALIGN="top" WIDTH="1%"><FONT SIZE="-1">
258 <CODE> void</CODE></FONT></TD>
259 <TD><CODE><B><A HREF="../../lejos/nxt/Poll.html#setThrottle(int)">setThrottle</A></B>(int throttle)</CODE>
262 Set a throttle on the regularity with which inputs
266 <A NAME="methods_inherited_from_class_java.lang.Object"><!-- --></A>
267 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
268 <TR BGCOLOR="#EEEEFF" CLASS="TableSubHeadingColor">
269 <TH ALIGN="left"><B>Methods inherited from class java.lang.<A HREF="../../java/lang/Object.html" title="class in java.lang">Object</A></B></TH>
271 <TR BGCOLOR="white" CLASS="TableRowColor">
272 <TD><CODE><A HREF="../../java/lang/Object.html#equals(java.lang.Object)">equals</A>, <A HREF="../../java/lang/Object.html#getClass()">getClass</A>, <A HREF="../../java/lang/Object.html#hashCode()">hashCode</A>, <A HREF="../../java/lang/Object.html#notify()">notify</A>, <A HREF="../../java/lang/Object.html#notifyAll()">notifyAll</A>, <A HREF="../../java/lang/Object.html#toString()">toString</A>, <A HREF="../../java/lang/Object.html#wait()">wait</A>, <A HREF="../../java/lang/Object.html#wait(long)">wait</A></CODE></TD>
278 <!-- ============ FIELD DETAIL =========== -->
280 <A NAME="field_detail"><!-- --></A>
281 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
282 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
283 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
284 <B>Field Detail</B></FONT></TH>
288 <A NAME="SENSOR1_MASK"><!-- --></A><H3>
291 public static final short <B>SENSOR1_MASK</B></PRE>
294 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.SENSOR1_MASK">Constant Field Values</A></DL>
298 <A NAME="SENSOR2_MASK"><!-- --></A><H3>
301 public static final short <B>SENSOR2_MASK</B></PRE>
304 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.SENSOR2_MASK">Constant Field Values</A></DL>
308 <A NAME="SENSOR3_MASK"><!-- --></A><H3>
311 public static final short <B>SENSOR3_MASK</B></PRE>
314 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.SENSOR3_MASK">Constant Field Values</A></DL>
318 <A NAME="SENSOR4_MASK"><!-- --></A><H3>
321 public static final short <B>SENSOR4_MASK</B></PRE>
324 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.SENSOR4_MASK">Constant Field Values</A></DL>
328 <A NAME="ALL_SENSORS"><!-- --></A><H3>
331 public static final short <B>ALL_SENSORS</B></PRE>
334 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.ALL_SENSORS">Constant Field Values</A></DL>
338 <A NAME="ENTER_MASK"><!-- --></A><H3>
341 public static final short <B>ENTER_MASK</B></PRE>
344 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.ENTER_MASK">Constant Field Values</A></DL>
348 <A NAME="LEFT_MASK"><!-- --></A><H3>
351 public static final short <B>LEFT_MASK</B></PRE>
354 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.LEFT_MASK">Constant Field Values</A></DL>
358 <A NAME="RIGHT_MASK"><!-- --></A><H3>
361 public static final short <B>RIGHT_MASK</B></PRE>
364 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.RIGHT_MASK">Constant Field Values</A></DL>
368 <A NAME="ESCAPE_MASK"><!-- --></A><H3>
371 public static final short <B>ESCAPE_MASK</B></PRE>
374 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.ESCAPE_MASK">Constant Field Values</A></DL>
378 <A NAME="ALL_BUTTONS"><!-- --></A><H3>
381 public static final short <B>ALL_BUTTONS</B></PRE>
384 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.ALL_BUTTONS">Constant Field Values</A></DL>
388 <A NAME="BUTTON_MASK_SHIFT"><!-- --></A><H3>
389 BUTTON_MASK_SHIFT</H3>
391 public static final short <B>BUTTON_MASK_SHIFT</B></PRE>
394 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.BUTTON_MASK_SHIFT">Constant Field Values</A></DL>
398 <A NAME="SERIAL_MASK"><!-- --></A><H3>
401 public static final short <B>SERIAL_MASK</B></PRE>
404 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.SERIAL_MASK">Constant Field Values</A></DL>
408 <A NAME="SERIAL_SHIFT"><!-- --></A><H3>
411 public static final short <B>SERIAL_SHIFT</B></PRE>
414 <DT><B>See Also:</B><DD><A HREF="../../constant-values.html#lejos.nxt.Poll.SERIAL_SHIFT">Constant Field Values</A></DL>
417 <!-- ========= CONSTRUCTOR DETAIL ======== -->
419 <A NAME="constructor_detail"><!-- --></A>
420 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
421 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
422 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
423 <B>Constructor Detail</B></FONT></TH>
427 <A NAME="Poll()"><!-- --></A><H3>
430 public <B>Poll</B>()</PRE>
436 <!-- ============ METHOD DETAIL ========== -->
438 <A NAME="method_detail"><!-- --></A>
439 <TABLE BORDER="1" WIDTH="100%" CELLPADDING="3" CELLSPACING="0" SUMMARY="">
440 <TR BGCOLOR="#CCCCFF" CLASS="TableHeadingColor">
441 <TH ALIGN="left" COLSPAN="1"><FONT SIZE="+2">
442 <B>Method Detail</B></FONT></TH>
446 <A NAME="poll(int, int)"><!-- --></A><H3>
449 public final int <B>poll</B>(int mask,
451 throws <A HREF="../../java/lang/InterruptedException.html" title="class in java.lang">InterruptedException</A></PRE>
453 <DD>Wait for the sensor/button values to change then return.
456 <DT><B>Parameters:</B><DD><CODE>mask</CODE> - bit mask of values to monitor.<DD><CODE>millis</CODE> - wait for at most millis milliseconds. 0 = forever.
457 <DT><B>Returns:</B><DD>a bit mask of the values that have changed
459 <DD><CODE><A HREF="../../java/lang/InterruptedException.html" title="class in java.lang">InterruptedException</A></CODE></DL>
464 <A NAME="setThrottle(int)"><!-- --></A><H3>
467 public final void <B>setThrottle</B>(int throttle)</PRE>
469 <DD>Set a throttle on the regularity with which inputs
473 <DT><B>Parameters:</B><DD><CODE>throttle</CODE> - number of sensor reads between polls.
474 Default value is 1. 0 means poll as often as possible.
475 Sensor reads occur every 3ms.</DL>
478 <!-- ========= END OF CLASS DATA ========= -->
482 <!-- ======= START OF BOTTOM NAVBAR ====== -->
483 <A NAME="navbar_bottom"><!-- --></A>
484 <A HREF="#skip-navbar_bottom" title="Skip navigation links"></A>
485 <TABLE BORDER="0" WIDTH="100%" CELLPADDING="1" CELLSPACING="0" SUMMARY="">
487 <TD COLSPAN=2 BGCOLOR="#EEEEFF" CLASS="NavBarCell1">
488 <A NAME="navbar_bottom_firstrow"><!-- --></A>
489 <TABLE BORDER="0" CELLPADDING="0" CELLSPACING="3" SUMMARY="">
490 <TR ALIGN="center" VALIGN="top">
491 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../overview-summary.html"><FONT CLASS="NavBarFont1"><B>Overview</B></FONT></A> </TD>
492 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-summary.html"><FONT CLASS="NavBarFont1"><B>Package</B></FONT></A> </TD>
493 <TD BGCOLOR="#FFFFFF" CLASS="NavBarCell1Rev"> <FONT CLASS="NavBarFont1Rev"><B>Class</B></FONT> </TD>
494 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="package-tree.html"><FONT CLASS="NavBarFont1"><B>Tree</B></FONT></A> </TD>
495 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../deprecated-list.html"><FONT CLASS="NavBarFont1"><B>Deprecated</B></FONT></A> </TD>
496 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../index-all.html"><FONT CLASS="NavBarFont1"><B>Index</B></FONT></A> </TD>
497 <TD BGCOLOR="#EEEEFF" CLASS="NavBarCell1"> <A HREF="../../help-doc.html"><FONT CLASS="NavBarFont1"><B>Help</B></FONT></A> </TD>
501 <TD ALIGN="right" VALIGN="top" ROWSPAN=3><EM>
507 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
508 <A HREF="../../lejos/nxt/NXTCam.html" title="class in lejos.nxt"><B>PREV CLASS</B></A>
509 <A HREF="../../lejos/nxt/RCXLightSensor.html" title="class in lejos.nxt"><B>NEXT CLASS</B></A></FONT></TD>
510 <TD BGCOLOR="white" CLASS="NavBarCell2"><FONT SIZE="-2">
511 <A HREF="../../index.html?lejos/nxt/Poll.html" target="_top"><B>FRAMES</B></A>
512 <A HREF="Poll.html" target="_top"><B>NO FRAMES</B></A>
513 <SCRIPT type="text/javascript">
516 document.writeln('<A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>');
521 <A HREF="../../allclasses-noframe.html"><B>All Classes</B></A>
528 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
529 SUMMARY: NESTED | <A HREF="#field_summary">FIELD</A> | <A HREF="#constructor_summary">CONSTR</A> | <A HREF="#method_summary">METHOD</A></FONT></TD>
530 <TD VALIGN="top" CLASS="NavBarCell3"><FONT SIZE="-2">
531 DETAIL: <A HREF="#field_detail">FIELD</A> | <A HREF="#constructor_detail">CONSTR</A> | <A HREF="#method_detail">METHOD</A></FONT></TD>
534 <A NAME="skip-navbar_bottom"></A>
535 <!-- ======== END OF BOTTOM NAVBAR ======= -->