Update documentation about spaceballs and dials&buttons callbacks

git-svn-id: https://svn.code.sf.net/p/freeglut/code/trunk@1294 7f0cb862-5218-0410-a997-914c9d46530a
This commit is contained in:
beuc 2012-05-04 10:30:58 +00:00
parent 85b0410084
commit 0bff1dd42e

View File

@ -346,8 +346,7 @@ but did not make it into the documentation. The new callbacks consist
of regular and special key release callbacks, a joystick callback, a menu of regular and special key release callbacks, a joystick callback, a menu
state callback (with one argument, distinct from the menu status callback state callback (with one argument, distinct from the menu status callback
which has three arguments), and a window status callback which has three arguments), and a window status callback
(also with one argument). Unsupported callbacks are the three Spaceball (also with one argument). Unsupported callbacks are the two Tablet
callbacks, the ButtonBox callback, the Dials callback, and the two Tablet
callbacks. If the user has a need for an unsupported callback he should callbacks. If the user has a need for an unsupported callback he should
contact the <i>freeglut</i> development team. contact the <i>freeglut</i> development team.
</p> </p>
@ -1030,10 +1029,10 @@ have them fixed.
<h2>12.14 glutSpaceballMotionFunc</h2> <h2>12.14 glutSpaceballMotionFunc</h2>
<p> <p>
The <tt>glutSpaceballMotionFunc</tt> function is not implemented in The <tt>glutSpaceballMotionFunc</tt> function is implemented in
<i>freeglut</i>, although the library does <i>freeglut</i> on X11 only. On other platforms, function stubs are
"answer the mail" to the extent that a call to the function will not produce provided so that GLUT-based programs can compile and link against
an error.. <i>freeglut</i> without modification.
</p> </p>
<p><b>Usage</b></p> <p><b>Usage</b></p>
@ -1043,21 +1042,15 @@ an error..
<p><b>Description</b></p> <p><b>Description</b></p>
<p> <p>TODO</p>
The <tt>glutSpaceballMotionFunc</tt> function is not implemented in <i>freeglut</i>.
</p>
<p><b>Changes From GLUT</b></p>
<p>GLUT implements this function. </p>
<h2>12.15 glutSpaceballRotateFunc</h2> <h2>12.15 glutSpaceballRotateFunc</h2>
<p> <p>
The <tt>glutSpaceballRotateFunc</tt> function is not implemented in The <tt>glutSpaceballRotateFunc</tt> function is implemented in
<i>freeglut</i>, although the library does <i>freeglut</i> on X11 only. On other platforms, function stubs are
"answer the mail" to the extent that a call to the function will not produce provided so that GLUT-based programs can compile and link against
an error.. <i>freeglut</i> without modification.
</p> </p>
<p><b>Usage</b></p> <p><b>Usage</b></p>
@ -1067,21 +1060,15 @@ an error..
<p><b>Description</b></p> <p><b>Description</b></p>
<p> <p>TODO</p>
The <tt>glutSpaceballRotateFunc</tt> function is not implemented in <i>freeglut</i>.
</p>
<p><b>Changes From GLUT</b></p>
<p>GLUT implements this function. </p>
<h2>12.16 glutSpaceballButtonFunc</h2> <h2>12.16 glutSpaceballButtonFunc</h2>
<p> <p>
The <tt>glutSpaceballButtonFunc</tt> function is not implemented in The <tt>glutSpaceballButtonFunc</tt> function is implemented in
<i>freeglut</i>, although the library does <i>freeglut</i> on X11 only. On other platforms, function stubs are
"answer the mail" to the extent that a call to the function will not produce provided so that GLUT-based programs can compile and link against
an error.. <i>freeglut</i> without modification.
</p> </p>
<p><b>Usage</b></p> <p><b>Usage</b></p>
@ -1091,42 +1078,37 @@ an error..
<p><b>Description</b></p> <p><b>Description</b></p>
<p>The <tt>glutSpaceballButtonFunc</tt> function is not implemented in <i>freeglut</i>. </p> <p>TODO</p>
<p><b>Changes From GLUT</b></p>
<p>GLUT implements this function. </p>
<h2>12.17 glutButtonBoxFunc</h2> <h2>12.17 glutButtonBoxFunc</h2>
<p> <p>
The <tt>glutSpaceballButtonBoxFunc</tt> function is not implemented The <tt>glutDialsFunc</tt> function sets the global dials&buttons box callback. Freeglut calls the callback when there is input from the box buttons.
in <i>freeglut</i>, although the library does "answer the mail" to the extent
that a call to the function will not produce an error..
</p> </p>
<p><b>Usage</b></p> <p><b>Usage</b></p>
<p> <p>
<tt>void glutSpaceballButtonBoxFunc ( void (* callback)( int button, int updown ) );</tt> <tt>void glutButtonBoxFunc ( void (* callback)( int button, int updown ) );</tt>
</p> </p>
<p><b>Description</b></p> <p><b>Description</b></p>
<p> <p>
The <tt>glutSpaceballButtonBoxFunc</tt> function is not implemented in <i>freeglut</i>. The Dials&Buttons box is an ancient device presenting several pushable
or rotatable buttons, sending the events to the computer via serial
I/O.<br />
See <a
href="http://www.reputable.com/sgipix/sgi-dialnbutton1.jpg">http://www.reputable.com/sgipix/sgi-dialnbutton1.jpg</a>
[<a href="http://www.nekochan.net/reputable/sgipix.html">1</a>]
for instance.
</p> </p>
<p><b>Changes From GLUT</b></p>
<p>GLUT implements this function. </p>
<h2>12.18 glutDialsFunc</h2> <h2>12.18 glutDialsFunc</h2>
<p> <p>
The <tt>glutDialsFunc</tt> function is not implemented in <i>freeglut</i>, The <tt>glutDialsFunc</tt> function sets the global dials&buttons box callback. Freeglut calls the callback when there is input from the box dials.
although the library does "answer the mail" to the extent that a call
to the function will not produce an error..
</p> </p>
<p><b>Usage</b></p> <p><b>Usage</b></p>
@ -1136,12 +1118,16 @@ int dial, int value )</tt><tt> );</tt></p>
<p><b>Description</b></p> <p><b>Description</b></p>
<p>The <tt>glutDialsFunc</tt> function <p>
is not implemented in <i>freeglut</i>. </p> The Dials&Buttons box is an ancient device presenting several pushable
or rotatable buttons, sending the events to the computer via serial
I/O.<br />
<p><b>Changes From GLUT</b></p> See <a
href="http://www.reputable.com/sgipix/sgi-dialnbutton1.jpg">http://www.reputable.com/sgipix/sgi-dialnbutton1.jpg</a>
<p>GLUT implements this function. </p> [<a href="http://www.nekochan.net/reputable/sgipix.html">1</a>]
for instance.
</p>
<h2>12.19 glutTabletMotionFunc</h2> <h2>12.19 glutTabletMotionFunc</h2>