Merge pull request #45 from stonexjr/Jinrong
Spaceball API documentation and macros updates
This commit is contained in:
commit
b9633f0ec9
@ -126,6 +126,16 @@
|
||||
#define GLUT_CORE_PROFILE 0x0001
|
||||
#define GLUT_COMPATIBILITY_PROFILE 0x0002
|
||||
|
||||
/*
|
||||
* GLUT API Extension macro definitions -- Spaceball button definitions
|
||||
*/
|
||||
|
||||
#define GLUT_SPACEBALL_BUTTON_A 0x0001
|
||||
#define GLUT_SPACEBALL_BUTTON_B 0x0002
|
||||
#define GLUT_SPACEBALL_BUTTON_C 0x0004
|
||||
#define GLUT_SPACEBALL_BUTTON_D 0x0008
|
||||
#define GLUT_SPACEBALL_BUTTON_E 0x0010
|
||||
|
||||
/*
|
||||
* Process loop function, see fg_main.c
|
||||
*/
|
||||
|
@ -632,9 +632,9 @@ enum
|
||||
/* Presently ignored */
|
||||
WCB_Select,
|
||||
WCB_OverlayDisplay,
|
||||
WCB_SpaceMotion, /* presently implemented only on UNIX/X11 */
|
||||
WCB_SpaceRotation, /* presently implemented only on UNIX/X11 */
|
||||
WCB_SpaceButton, /* presently implemented only on UNIX/X11 */
|
||||
WCB_SpaceMotion, /* presently implemented only on UNIX/X11 and Windows */
|
||||
WCB_SpaceRotation, /* presently implemented only on UNIX/X11 and Windows */
|
||||
WCB_SpaceButton, /* presently implemented only on UNIX/X11 and Windows */
|
||||
WCB_Dials,
|
||||
WCB_ButtonBox,
|
||||
WCB_TabletMotion,
|
||||
|
@ -184,9 +184,9 @@ void fgSpaceballHandleWinEvent(HWND hwnd, WPARAM wParam, LPARAM lParam)
|
||||
unsigned long stateNow = dwKeystate&(1 << i);
|
||||
|
||||
if (stateBefore && !stateNow)
|
||||
INVOKE_WCB(*window, SpaceButton, (stateBefore, GLUT_DOWN));
|
||||
INVOKE_WCB(*window, SpaceButton, (stateBefore, GLUT_UP));
|
||||
if (!stateBefore && stateNow)
|
||||
INVOKE_WCB(*window, SpaceButton, (stateNow, GLUT_UP));
|
||||
INVOKE_WCB(*window, SpaceButton, (stateNow, GLUT_DOWN));
|
||||
|
||||
}
|
||||
}
|
||||
|
@ -1326,46 +1326,53 @@ as mouse buttons.
|
||||
|
||||
<p>
|
||||
The <tt>glutSpaceballMotionFunc</tt> function is implemented in
|
||||
<i>freeglut</i> on X11 only. On other platforms, function stubs are
|
||||
<i>freeglut</i> on X11 and Windows only. On other platforms, function stubs are
|
||||
provided so that GLUT-based programs can compile and link against
|
||||
<i>freeglut</i> without modification.
|
||||
</p>
|
||||
<p>The <tt>glutSpaceballMotionFunc</tt> function sets the window's Spaceball motion callback. <i>Freeglut</i> invokes this callback when the user push/pull Spaceball cap in <i>x</i>, <i>y</i>, and <i>z</i> directions.
|
||||
</p>
|
||||
|
||||
<p><b>Usage</b></p>
|
||||
|
||||
<p><tt>void glutSpaceballMotionFunc ( void
|
||||
(* callback)( int x, int y, int z )</tt><tt> );</tt></p>
|
||||
<p><tt>void glutSpaceballMotionFunc ( void (* callback)( int x, int y, int z ) );</tt></p>
|
||||
|
||||
<p><b>Description</b></p>
|
||||
|
||||
<p>TODO</p>
|
||||
<p>The <i>x</i>, <i>y</i>, and <i>z</i> arguments indicate the amount of translation in integer along x, y, and z axis respectively.</p>
|
||||
<p>The x, y, and z axes form a common OpenGL right-handed coordinate system. A positive value of <i>x</i>, <i>y</i>, or <i>z</i> indicates movement along the positive direction of the respective axis, while the negative one denotes movement along negative direction.</p>
|
||||
|
||||
<h2>12.16 glutSpaceballRotateFunc</h2>
|
||||
|
||||
<p>
|
||||
The <tt>glutSpaceballRotateFunc</tt> function is implemented in
|
||||
<i>freeglut</i> on X11 only. On other platforms, function stubs are
|
||||
<i>freeglut</i> on X11 and Windows only. On other platforms, function stubs are
|
||||
provided so that GLUT-based programs can compile and link against
|
||||
<i>freeglut</i> without modification.
|
||||
</p>
|
||||
<p>The <tt>glutSpaceballRotateFunc</tt> function sets the window's Spaceball rotation callback. <i>Freeglut</i> invokes this callback when the user rotates/twists Spaceball cap.
|
||||
</p>
|
||||
|
||||
<p><b>Usage</b></p>
|
||||
|
||||
<p><tt>void glutSpaceballRotateFunc ( void
|
||||
(* callback)( int x, int y, int z )</tt><tt> );</tt></p>
|
||||
<p><tt>void glutSpaceballRotateFunc ( void (* callback)( int rx, int ry, int rz ) );</tt></p>
|
||||
|
||||
<p><b>Description</b></p>
|
||||
|
||||
<p>TODO</p>
|
||||
<p>The <i>rx</i>, <i>ry</i>, and <i>rz</i> arguments indicate the amount of rotation in integer with respect to x, y, and z axis respectively.</p>
|
||||
<p>The x, y, and z axes form a common OpenGL right-handed coordinate system. Positive value of <i>rx</i>, <i>ry</i>, or <i>rz</i> indicates counter-clock wise rotation along the respective axis, while negative one denotes clock wise rotation.</p>
|
||||
|
||||
<h2>12.17 glutSpaceballButtonFunc</h2>
|
||||
|
||||
<p>
|
||||
The <tt>glutSpaceballButtonFunc</tt> function is implemented in
|
||||
<i>freeglut</i> on X11 only. On other platforms, function stubs are
|
||||
<i>freeglut</i> on X11 and Windows only. On other platforms, function stubs are
|
||||
provided so that GLUT-based programs can compile and link against
|
||||
<i>freeglut</i> without modification.
|
||||
</p>
|
||||
<p>
|
||||
The <tt>glutSpaceballButtonFunc</tt> function sets the window's Spaceball button callback. <i>Freeglut</i> invokes this callback when the user presses/releases one of the Spaceball buttons.
|
||||
</p>
|
||||
|
||||
<p><b>Usage</b></p>
|
||||
|
||||
@ -1374,7 +1381,18 @@ provided so that GLUT-based programs can compile and link against
|
||||
|
||||
<p><b>Description</b></p>
|
||||
|
||||
<p>TODO</p>
|
||||
<p>The <i>button</i> argument may take one of the following defined constant values</p>
|
||||
<ul>
|
||||
<li>
|
||||
GLUT_SPACEBALL_BUTTON_A(0x00000001), GLUT_SPACEBALL_BUTTON_B(0x00000002),..., GLUT_SPACEBALL_BUTTON_E(0x00000010)
|
||||
</li>
|
||||
</ul>
|
||||
<p>The <i>updown</i> argument may take one of the two defined constant values</p>
|
||||
<ul>
|
||||
<li>
|
||||
GLUT_DOWN, GLUT_UP indicating if button is pressed or released.
|
||||
</li>
|
||||
</ul>
|
||||
|
||||
<h2>12.18 glutButtonBoxFunc</h2>
|
||||
|
||||
|
@ -40,7 +40,7 @@ function generateHeader($self)
|
||||
<title><? echo $title ?></title>
|
||||
</head>
|
||||
<body>
|
||||
<?
|
||||
<?php
|
||||
generateSideBar($self);
|
||||
}
|
||||
|
||||
@ -49,7 +49,7 @@ function generateFooter()
|
||||
?>
|
||||
</body>
|
||||
</html>
|
||||
<?
|
||||
<?php
|
||||
}
|
||||
|
||||
function printMenuItem($item, $current_page)
|
||||
@ -71,7 +71,7 @@ function generateSideBar($current_page)
|
||||
<div class="navbar-left">
|
||||
<span class="navbar-header"><a href="/"><img src="/images/freeglut_logo.png" alt="freeglut logo" style="border: 0;" /></a></span><br/>
|
||||
<span class="navbar-smalltext">The Free OpenGL Utility Toolkit</span><br/><br/>
|
||||
<?
|
||||
<?php
|
||||
# Print out each sidebar entry one by one...
|
||||
reset($sidebarentries);
|
||||
while (next($sidebarentries))
|
||||
@ -101,7 +101,7 @@ function generateSideBar($current_page)
|
||||
<? echo "\t<a href=\"$svn_location\">View PHP Source</a>"; ?>
|
||||
</span>
|
||||
</div>
|
||||
<?
|
||||
<?php
|
||||
}
|
||||
|
||||
function setPageTitle($title_inc)
|
||||
|
Reference in New Issue
Block a user