1 #ifndef __FREEGLUT_EXT_H__ 2 #define __FREEGLUT_EXT_H__ 3 4 /* 5 * freeglut_ext.h 6 * 7 * The non-GLUT-compatible extensions to the freeglut library include file 8 * 9 * Copyright (c) 1999-2000 Pawel W. Olszta. All Rights Reserved. 10 * Written by Pawel W. Olszta, <olszta@sourceforge.net> 11 * Creation date: Thu Dec 2 1999 12 * 13 * Permission is hereby granted, free of charge, to any person obtaining a 14 * copy of this software and associated documentation files (the "Software"), 15 * to deal in the Software without restriction, including without limitation 16 * the rights to use, copy, modify, merge, publish, distribute, sublicense, 17 * and/or sell copies of the Software, and to permit persons to whom the 18 * Software is furnished to do so, subject to the following conditions: 19 * 20 * The above copyright notice and this permission notice shall be included 21 * in all copies or substantial portions of the Software. 22 * 23 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS 24 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, 25 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL 26 * PAWEL W. OLSZTA BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER 27 * IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN 28 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. 29 */ 30 31 #ifdef __cplusplus 32 extern "C" { 33 #endif 34 35 /* 36 * Additional GLUT Key definitions for the Special key function 37 */ 38 #define GLUT_KEY_NUM_LOCK 0x006D 39 #define GLUT_KEY_BEGIN 0x006E 40 #define GLUT_KEY_DELETE 0x006F 41 #define GLUT_KEY_SHIFT_L 0x0070 42 #define GLUT_KEY_SHIFT_R 0x0071 43 #define GLUT_KEY_CTRL_L 0x0072 44 #define GLUT_KEY_CTRL_R 0x0073 45 #define GLUT_KEY_ALT_L 0x0074 46 #define GLUT_KEY_ALT_R 0x0075 47 48 /* 49 * GLUT API Extension macro definitions -- behaviour when the user clicks on an "x" to close a window 50 */ 51 #define GLUT_ACTION_EXIT 0 52 #define GLUT_ACTION_GLUTMAINLOOP_RETURNS 1 53 #define GLUT_ACTION_CONTINUE_EXECUTION 2 54 55 /* 56 * Create a new rendering context when the user opens a new window? 57 */ 58 #define GLUT_CREATE_NEW_CONTEXT 0 59 #define GLUT_USE_CURRENT_CONTEXT 1 60 61 /* 62 * Direct/Indirect rendering context options (has meaning only in Unix/X11) 63 */ 64 #define GLUT_FORCE_INDIRECT_CONTEXT 0 65 #define GLUT_ALLOW_DIRECT_CONTEXT 1 66 #define GLUT_TRY_DIRECT_CONTEXT 2 67 #define GLUT_FORCE_DIRECT_CONTEXT 3 68 69 /* 70 * GLUT API Extension macro definitions -- the glutGet parameters 71 */ 72 #define GLUT_INIT_STATE 0x007C 73 74 #define GLUT_ACTION_ON_WINDOW_CLOSE 0x01F9 75 76 #define GLUT_WINDOW_BORDER_WIDTH 0x01FA 77 #define GLUT_WINDOW_BORDER_HEIGHT 0x01FB 78 #define GLUT_WINDOW_HEADER_HEIGHT 0x01FB /* Docs say it should always have been GLUT_WINDOW_BORDER_HEIGHT, keep this for backward compatibility */ 79 80 #define GLUT_VERSION 0x01FC 81 82 #define GLUT_RENDERING_CONTEXT 0x01FD 83 #define GLUT_DIRECT_RENDERING 0x01FE 84 85 #define GLUT_FULL_SCREEN 0x01FF 86 87 #define GLUT_SKIP_STALE_MOTION_EVENTS 0x0204 88 89 #define GLUT_GEOMETRY_VISUALIZE_NORMALS 0x0205 90 91 #define GLUT_STROKE_FONT_DRAW_JOIN_DOTS 0x0206 /* Draw dots between line segments of stroke fonts? */ 92 93 #define GLUT_ALLOW_NEGATIVE_WINDOW_POSITION 0x0207 /* GLUT doesn't allow negative window positions by default */ 94 95 #define GLUT_WINDOW_SRGB 0x007D 96 97 /* 98 * New tokens for glutInitDisplayMode. 99 * Only one GLUT_AUXn bit may be used at a time. 100 * Value 0x0400 is defined in OpenGLUT. 101 */ 102 #define GLUT_AUX 0x1000 103 104 #define GLUT_AUX1 0x1000 105 #define GLUT_AUX2 0x2000 106 #define GLUT_AUX3 0x4000 107 #define GLUT_AUX4 0x8000 108 109 /* 110 * Context-related flags, see fg_state.c 111 * Set the requested OpenGL version 112 */ 113 #define GLUT_INIT_MAJOR_VERSION 0x0200 114 #define GLUT_INIT_MINOR_VERSION 0x0201 115 #define GLUT_INIT_FLAGS 0x0202 116 #define GLUT_INIT_PROFILE 0x0203 117 118 /* 119 * Flags for glutInitContextFlags, see fg_init.c 120 */ 121 #define GLUT_DEBUG 0x0001 122 #define GLUT_FORWARD_COMPATIBLE 0x0002 123 124 125 /* 126 * Flags for glutInitContextProfile, see fg_init.c 127 */ 128 #define GLUT_CORE_PROFILE 0x0001 129 #define GLUT_COMPATIBILITY_PROFILE 0x0002 130 131 /* 132 * GLUT API Extension macro definitions -- Spaceball button definitions 133 */ 134 135 #define GLUT_SPACEBALL_BUTTON_A 0x0001 136 #define GLUT_SPACEBALL_BUTTON_B 0x0002 137 #define GLUT_SPACEBALL_BUTTON_C 0x0004 138 #define GLUT_SPACEBALL_BUTTON_D 0x0008 139 #define GLUT_SPACEBALL_BUTTON_E 0x0010 140 141 /* 142 * Process loop function, see fg_main.c 143 */ 144 FGAPI void FGAPIENTRY glutMainLoopEvent( void ); 145 FGAPI void FGAPIENTRY glutLeaveMainLoop( void ); 146 FGAPI void FGAPIENTRY glutExit ( void ); 147 148 /* 149 * Window management functions, see fg_window.c 150 */ 151 FGAPI void FGAPIENTRY glutFullScreenToggle( void ); 152 FGAPI void FGAPIENTRY glutLeaveFullScreen( void ); 153 154 /* 155 * Menu functions 156 */ 157 FGAPI void FGAPIENTRY glutSetMenuFont( int menuID, void* font ); 158 159 /* 160 * Window-specific callback functions, see fg_callbacks.c 161 */ 162 FGAPI void FGAPIENTRY glutMouseWheelFunc( void (* callback)( int, int, int, int ) ); 163 FGAPI void FGAPIENTRY glutPositionFunc( void (* callback)( int, int ) ); 164 FGAPI void FGAPIENTRY glutCloseFunc( void (* callback)( void ) ); 165 FGAPI void FGAPIENTRY glutWMCloseFunc( void (* callback)( void ) ); 166 /* And also a destruction callback for menus */ 167 FGAPI void FGAPIENTRY glutMenuDestroyFunc( void (* callback)( void ) ); 168 169 /* 170 * State setting and retrieval functions, see fg_state.c 171 */ 172 FGAPI void FGAPIENTRY glutSetOption ( GLenum option_flag, int value ); 173 FGAPI int * FGAPIENTRY glutGetModeValues(GLenum mode, int * size); 174 /* A.Donev: User-data manipulation */ 175 FGAPI void* FGAPIENTRY glutGetWindowData( void ); 176 FGAPI void FGAPIENTRY glutSetWindowData(void* data); 177 FGAPI void* FGAPIENTRY glutGetMenuData( void ); 178 FGAPI void FGAPIENTRY glutSetMenuData(void* data); 179 180 /* 181 * Font stuff, see fg_font.c 182 */ 183 FGAPI int FGAPIENTRY glutBitmapHeight( void* font ); 184 FGAPI GLfloat FGAPIENTRY glutStrokeHeight( void* font ); 185 FGAPI void FGAPIENTRY glutBitmapString( void* font, const unsigned char *string ); 186 FGAPI void FGAPIENTRY glutStrokeString( void* font, const unsigned char *string ); 187 188 /* 189 * Geometry functions, see fg_geometry.c 190 */ 191 FGAPI void FGAPIENTRY glutWireRhombicDodecahedron( void ); 192 FGAPI void FGAPIENTRY glutSolidRhombicDodecahedron( void ); 193 FGAPI void FGAPIENTRY glutWireSierpinskiSponge ( int num_levels, double offset[3], double scale ); 194 FGAPI void FGAPIENTRY glutSolidSierpinskiSponge ( int num_levels, double offset[3], double scale ); 195 FGAPI void FGAPIENTRY glutWireCylinder( double radius, double height, GLint slices, GLint stacks); 196 FGAPI void FGAPIENTRY glutSolidCylinder( double radius, double height, GLint slices, GLint stacks); 197 198 /* 199 * Rest of functions for rendering Newell's teaset, found in fg_teapot.c 200 * NB: front facing polygons have clockwise winding, not counter clockwise 201 */ 202 FGAPI void FGAPIENTRY glutWireTeacup( double size ); 203 FGAPI void FGAPIENTRY glutSolidTeacup( double size ); 204 FGAPI void FGAPIENTRY glutWireTeaspoon( double size ); 205 FGAPI void FGAPIENTRY glutSolidTeaspoon( double size ); 206 207 /* 208 * Extension functions, see fg_ext.c 209 */ 210 typedef void (*GLUTproc)(); 211 FGAPI GLUTproc FGAPIENTRY glutGetProcAddress( const char *procName ); 212 213 /* 214 * Multi-touch/multi-pointer extensions 215 */ 216 217 #define GLUT_HAS_MULTI 1 218 219 /* TODO: add device_id parameter, 220 cf. http://sourceforge.net/mailarchive/forum.php?thread_name=20120518071314.GA28061%40perso.beuc.net&forum_name=freeglut-developer */ 221 FGAPI void FGAPIENTRY glutMultiEntryFunc( void (* callback)( int, int ) ); 222 FGAPI void FGAPIENTRY glutMultiButtonFunc( void (* callback)( int, int, int, int, int ) ); 223 FGAPI void FGAPIENTRY glutMultiMotionFunc( void (* callback)( int, int, int ) ); 224 FGAPI void FGAPIENTRY glutMultiPassiveFunc( void (* callback)( int, int, int ) ); 225 226 /* 227 * Joystick functions, see fg_joystick.c 228 */ 229 /* USE OF THESE FUNCTIONS IS DEPRECATED !!!!! */ 230 /* If you have a serious need for these functions in your application, please either 231 * contact the "freeglut" developer community at freeglut-developer@lists.sourceforge.net, 232 * switch to the OpenGLUT library, or else port your joystick functionality over to PLIB's 233 * "js" library. 234 */ 235 int glutJoystickGetNumAxes( int ident ); 236 int glutJoystickGetNumButtons( int ident ); 237 int glutJoystickNotWorking( int ident ); 238 float glutJoystickGetDeadBand( int ident, int axis ); 239 void glutJoystickSetDeadBand( int ident, int axis, float db ); 240 float glutJoystickGetSaturation( int ident, int axis ); 241 void glutJoystickSetSaturation( int ident, int axis, float st ); 242 void glutJoystickSetMinRange( int ident, float *axes ); 243 void glutJoystickSetMaxRange( int ident, float *axes ); 244 void glutJoystickSetCenter( int ident, float *axes ); 245 void glutJoystickGetMinRange( int ident, float *axes ); 246 void glutJoystickGetMaxRange( int ident, float *axes ); 247 void glutJoystickGetCenter( int ident, float *axes ); 248 249 /* 250 * Initialization functions, see fg_init.c 251 */ 252 /* to get the typedef for va_list */ 253 #include <stdarg.h> 254 FGAPI void FGAPIENTRY glutInitContextVersion( int majorVersion, int minorVersion ); 255 FGAPI void FGAPIENTRY glutInitContextFlags( int flags ); 256 FGAPI void FGAPIENTRY glutInitContextProfile( int profile ); 257 FGAPI void FGAPIENTRY glutInitErrorFunc( void (* callback)( const char *fmt, va_list ap ) ); 258 FGAPI void FGAPIENTRY glutInitWarningFunc( void (* callback)( const char *fmt, va_list ap ) ); 259 260 /* OpenGL >= 2.0 support */ 261 FGAPI void FGAPIENTRY glutSetVertexAttribCoord3( GLint attrib ); 262 FGAPI void FGAPIENTRY glutSetVertexAttribNormal( GLint attrib ); 263 FGAPI void FGAPIENTRY glutSetVertexAttribTexCoord2( GLint attrib ); 264 265 /* Mobile platforms lifecycle */ 266 FGAPI void FGAPIENTRY glutInitContextFunc( void (* callback)( void ) ); 267 FGAPI void FGAPIENTRY glutAppStatusFunc( void (* callback)( int ) ); 268 /* state flags that can be passed to callback set by glutAppStatusFunc */ 269 #define GLUT_APPSTATUS_PAUSE 0x0001 270 #define GLUT_APPSTATUS_RESUME 0x0002 271 272 /* 273 * GLUT API macro definitions -- the display mode definitions 274 */ 275 #define GLUT_CAPTIONLESS 0x0400 276 #define GLUT_BORDERLESS 0x0800 277 #define GLUT_SRGB 0x1000 278 279 /* User-argument callbacks and implementation */ 280 #include "freeglut_ucall.h" 281 282 #ifdef __cplusplus 283 } 284 #endif 285 286 /*** END OF FILE ***/ 287 288 #endif /* __FREEGLUT_EXT_H__ */ 289