|
| 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 | +#define GLUT_KEY_SUPER_L 0x0076 |
| 48 | +#define GLUT_KEY_SUPER_R 0x0077 |
| 49 | + |
| 50 | +/* |
| 51 | + * Additional GLUT modifiers |
| 52 | + */ |
| 53 | +#define GLUT_ACTIVE_SUPER 0x0008 |
| 54 | + |
| 55 | +/* |
| 56 | + * GLUT API Extension macro definitions -- behaviour when the user clicks on an "x" to close a window |
| 57 | + */ |
| 58 | +#define GLUT_ACTION_EXIT 0 |
| 59 | +#define GLUT_ACTION_GLUTMAINLOOP_RETURNS 1 |
| 60 | +#define GLUT_ACTION_CONTINUE_EXECUTION 2 |
| 61 | + |
| 62 | +/* |
| 63 | + * Create a new rendering context when the user opens a new window? |
| 64 | + */ |
| 65 | +#define GLUT_CREATE_NEW_CONTEXT 0 |
| 66 | +#define GLUT_USE_CURRENT_CONTEXT 1 |
| 67 | + |
| 68 | +/* |
| 69 | + * Direct/Indirect rendering context options (has meaning only in Unix/X11) |
| 70 | + */ |
| 71 | +#define GLUT_FORCE_INDIRECT_CONTEXT 0 |
| 72 | +#define GLUT_ALLOW_DIRECT_CONTEXT 1 |
| 73 | +#define GLUT_TRY_DIRECT_CONTEXT 2 |
| 74 | +#define GLUT_FORCE_DIRECT_CONTEXT 3 |
| 75 | + |
| 76 | +/* |
| 77 | + * GLUT API Extension macro definitions -- the glutGet parameters |
| 78 | + */ |
| 79 | +#define GLUT_INIT_STATE 0x007C |
| 80 | + |
| 81 | +#define GLUT_ACTION_ON_WINDOW_CLOSE 0x01F9 |
| 82 | + |
| 83 | +#define GLUT_WINDOW_BORDER_WIDTH 0x01FA |
| 84 | +#define GLUT_WINDOW_BORDER_HEIGHT 0x01FB |
| 85 | +#define GLUT_WINDOW_HEADER_HEIGHT 0x01FB /* Docs say it should always have been GLUT_WINDOW_BORDER_HEIGHT, keep this for backward compatibility */ |
| 86 | + |
| 87 | +#define GLUT_VERSION 0x01FC |
| 88 | + |
| 89 | +#define GLUT_RENDERING_CONTEXT 0x01FD |
| 90 | +#define GLUT_DIRECT_RENDERING 0x01FE |
| 91 | + |
| 92 | +#define GLUT_FULL_SCREEN 0x01FF |
| 93 | + |
| 94 | +#define GLUT_SKIP_STALE_MOTION_EVENTS 0x0204 |
| 95 | + |
| 96 | +#define GLUT_GEOMETRY_VISUALIZE_NORMALS 0x0205 |
| 97 | + |
| 98 | +#define GLUT_STROKE_FONT_DRAW_JOIN_DOTS 0x0206 /* Draw dots between line segments of stroke fonts? */ |
| 99 | + |
| 100 | +#define GLUT_ALLOW_NEGATIVE_WINDOW_POSITION 0x0207 /* GLUT doesn't allow negative window positions by default */ |
| 101 | + |
| 102 | +#define GLUT_WINDOW_SRGB 0x007D |
| 103 | + |
| 104 | +/* |
| 105 | + * New tokens for glutInitDisplayMode. |
| 106 | + * Only one GLUT_AUXn bit may be used at a time. |
| 107 | + * Value 0x0400 is defined in OpenGLUT. |
| 108 | + */ |
| 109 | +#define GLUT_AUX 0x1000 |
| 110 | + |
| 111 | +#define GLUT_AUX1 0x1000 |
| 112 | +#define GLUT_AUX2 0x2000 |
| 113 | +#define GLUT_AUX3 0x4000 |
| 114 | +#define GLUT_AUX4 0x8000 |
| 115 | + |
| 116 | +/* |
| 117 | + * Context-related flags, see fg_state.c |
| 118 | + * Set the requested OpenGL version |
| 119 | + */ |
| 120 | +#define GLUT_INIT_MAJOR_VERSION 0x0200 |
| 121 | +#define GLUT_INIT_MINOR_VERSION 0x0201 |
| 122 | +#define GLUT_INIT_FLAGS 0x0202 |
| 123 | +#define GLUT_INIT_PROFILE 0x0203 |
| 124 | + |
| 125 | +/* |
| 126 | + * Flags for glutInitContextFlags, see fg_init.c |
| 127 | + */ |
| 128 | +#define GLUT_DEBUG 0x0001 |
| 129 | +#define GLUT_FORWARD_COMPATIBLE 0x0002 |
| 130 | + |
| 131 | + |
| 132 | +/* |
| 133 | + * Flags for glutInitContextProfile, see fg_init.c |
| 134 | + */ |
| 135 | +#define GLUT_CORE_PROFILE 0x0001 |
| 136 | +#define GLUT_COMPATIBILITY_PROFILE 0x0002 |
| 137 | + |
| 138 | +/* |
| 139 | +* GLUT API Extension macro definitions -- Spaceball button definitions |
| 140 | +*/ |
| 141 | + |
| 142 | +#define GLUT_SPACEBALL_BUTTON_A 0x0001 |
| 143 | +#define GLUT_SPACEBALL_BUTTON_B 0x0002 |
| 144 | +#define GLUT_SPACEBALL_BUTTON_C 0x0004 |
| 145 | +#define GLUT_SPACEBALL_BUTTON_D 0x0008 |
| 146 | +#define GLUT_SPACEBALL_BUTTON_E 0x0010 |
| 147 | + |
| 148 | +/* |
| 149 | + * Process loop function, see fg_main.c |
| 150 | + */ |
| 151 | +FGAPI void FGAPIENTRY glutMainLoopEvent( void ); |
| 152 | +FGAPI void FGAPIENTRY glutLeaveMainLoop( void ); |
| 153 | +FGAPI void FGAPIENTRY glutExit ( void ); |
| 154 | + |
| 155 | +/* |
| 156 | + * Window management functions, see fg_window.c |
| 157 | + */ |
| 158 | +FGAPI void FGAPIENTRY glutFullScreenToggle( void ); |
| 159 | +FGAPI void FGAPIENTRY glutLeaveFullScreen( void ); |
| 160 | + |
| 161 | +/* |
| 162 | + * Menu functions |
| 163 | + */ |
| 164 | +FGAPI void FGAPIENTRY glutSetMenuFont( int menuID, void* font ); |
| 165 | + |
| 166 | +/* |
| 167 | + * Window-specific callback functions, see fg_callbacks.c |
| 168 | + */ |
| 169 | +FGAPI void FGAPIENTRY glutMouseWheelFunc( void (* callback)( int, int, int, int ) ); |
| 170 | +FGAPI void FGAPIENTRY glutPositionFunc( void (* callback)( int, int ) ); |
| 171 | +FGAPI void FGAPIENTRY glutCloseFunc( void (* callback)( void ) ); |
| 172 | +FGAPI void FGAPIENTRY glutWMCloseFunc( void (* callback)( void ) ); |
| 173 | +/* And also a destruction callback for menus */ |
| 174 | +FGAPI void FGAPIENTRY glutMenuDestroyFunc( void (* callback)( void ) ); |
| 175 | + |
| 176 | +/* |
| 177 | + * State setting and retrieval functions, see fg_state.c |
| 178 | + */ |
| 179 | +FGAPI void FGAPIENTRY glutSetOption ( GLenum option_flag, int value ); |
| 180 | +FGAPI int * FGAPIENTRY glutGetModeValues(GLenum mode, int * size); |
| 181 | +/* A.Donev: User-data manipulation */ |
| 182 | +FGAPI void* FGAPIENTRY glutGetWindowData( void ); |
| 183 | +FGAPI void FGAPIENTRY glutSetWindowData(void* data); |
| 184 | +FGAPI void* FGAPIENTRY glutGetMenuData( void ); |
| 185 | +FGAPI void FGAPIENTRY glutSetMenuData(void* data); |
| 186 | + |
| 187 | +/* |
| 188 | + * Font stuff, see fg_font.c |
| 189 | + */ |
| 190 | +FGAPI int FGAPIENTRY glutBitmapHeight( void* font ); |
| 191 | +FGAPI GLfloat FGAPIENTRY glutStrokeHeight( void* font ); |
| 192 | +FGAPI void FGAPIENTRY glutBitmapString( void* font, const unsigned char *string ); |
| 193 | +FGAPI void FGAPIENTRY glutStrokeString( void* font, const unsigned char *string ); |
| 194 | + |
| 195 | +/* |
| 196 | + * Geometry functions, see fg_geometry.c |
| 197 | + */ |
| 198 | +FGAPI void FGAPIENTRY glutWireRhombicDodecahedron( void ); |
| 199 | +FGAPI void FGAPIENTRY glutSolidRhombicDodecahedron( void ); |
| 200 | +FGAPI void FGAPIENTRY glutWireSierpinskiSponge ( int num_levels, double offset[3], double scale ); |
| 201 | +FGAPI void FGAPIENTRY glutSolidSierpinskiSponge ( int num_levels, double offset[3], double scale ); |
| 202 | +FGAPI void FGAPIENTRY glutWireCylinder( double radius, double height, GLint slices, GLint stacks); |
| 203 | +FGAPI void FGAPIENTRY glutSolidCylinder( double radius, double height, GLint slices, GLint stacks); |
| 204 | + |
| 205 | +/* |
| 206 | + * Rest of functions for rendering Newell's teaset, found in fg_teapot.c |
| 207 | + * NB: front facing polygons have clockwise winding, not counter clockwise |
| 208 | + */ |
| 209 | +FGAPI void FGAPIENTRY glutWireTeacup( double size ); |
| 210 | +FGAPI void FGAPIENTRY glutSolidTeacup( double size ); |
| 211 | +FGAPI void FGAPIENTRY glutWireTeaspoon( double size ); |
| 212 | +FGAPI void FGAPIENTRY glutSolidTeaspoon( double size ); |
| 213 | + |
| 214 | +/* |
| 215 | + * Extension functions, see fg_ext.c |
| 216 | + */ |
| 217 | +typedef void (*GLUTproc)(); |
| 218 | +FGAPI GLUTproc FGAPIENTRY glutGetProcAddress( const char *procName ); |
| 219 | + |
| 220 | +/* |
| 221 | + * Multi-touch/multi-pointer extensions |
| 222 | + */ |
| 223 | + |
| 224 | +#define GLUT_HAS_MULTI 1 |
| 225 | + |
| 226 | +/* TODO: add device_id parameter, |
| 227 | + cf. http://sourceforge.net/mailarchive/forum.php?thread_name=20120518071314.GA28061%40perso.beuc.net&forum_name=freeglut-developer */ |
| 228 | +FGAPI void FGAPIENTRY glutMultiEntryFunc( void (* callback)( int, int ) ); |
| 229 | +FGAPI void FGAPIENTRY glutMultiButtonFunc( void (* callback)( int, int, int, int, int ) ); |
| 230 | +FGAPI void FGAPIENTRY glutMultiMotionFunc( void (* callback)( int, int, int ) ); |
| 231 | +FGAPI void FGAPIENTRY glutMultiPassiveFunc( void (* callback)( int, int, int ) ); |
| 232 | + |
| 233 | +/* |
| 234 | + * Joystick functions, see fg_joystick.c |
| 235 | + */ |
| 236 | +/* USE OF THESE FUNCTIONS IS DEPRECATED !!!!! */ |
| 237 | +/* If you have a serious need for these functions in your application, please either |
| 238 | + * contact the "freeglut" developer community at freeglut-developer@lists.sourceforge.net, |
| 239 | + * switch to the OpenGLUT library, or else port your joystick functionality over to PLIB's |
| 240 | + * "js" library. |
| 241 | + */ |
| 242 | +int glutJoystickGetNumAxes( int ident ); |
| 243 | +int glutJoystickGetNumButtons( int ident ); |
| 244 | +int glutJoystickNotWorking( int ident ); |
| 245 | +float glutJoystickGetDeadBand( int ident, int axis ); |
| 246 | +void glutJoystickSetDeadBand( int ident, int axis, float db ); |
| 247 | +float glutJoystickGetSaturation( int ident, int axis ); |
| 248 | +void glutJoystickSetSaturation( int ident, int axis, float st ); |
| 249 | +void glutJoystickSetMinRange( int ident, float *axes ); |
| 250 | +void glutJoystickSetMaxRange( int ident, float *axes ); |
| 251 | +void glutJoystickSetCenter( int ident, float *axes ); |
| 252 | +void glutJoystickGetMinRange( int ident, float *axes ); |
| 253 | +void glutJoystickGetMaxRange( int ident, float *axes ); |
| 254 | +void glutJoystickGetCenter( int ident, float *axes ); |
| 255 | + |
| 256 | +/* |
| 257 | + * Initialization functions, see fg_init.c |
| 258 | + */ |
| 259 | +/* to get the typedef for va_list */ |
| 260 | +#include <stdarg.h> |
| 261 | +FGAPI void FGAPIENTRY glutInitContextVersion( int majorVersion, int minorVersion ); |
| 262 | +FGAPI void FGAPIENTRY glutInitContextFlags( int flags ); |
| 263 | +FGAPI void FGAPIENTRY glutInitContextProfile( int profile ); |
| 264 | +FGAPI void FGAPIENTRY glutInitErrorFunc( void (* callback)( const char *fmt, va_list ap ) ); |
| 265 | +FGAPI void FGAPIENTRY glutInitWarningFunc( void (* callback)( const char *fmt, va_list ap ) ); |
| 266 | + |
| 267 | +/* OpenGL >= 2.0 support */ |
| 268 | +FGAPI void FGAPIENTRY glutSetVertexAttribCoord3( GLint attrib ); |
| 269 | +FGAPI void FGAPIENTRY glutSetVertexAttribNormal( GLint attrib ); |
| 270 | +FGAPI void FGAPIENTRY glutSetVertexAttribTexCoord2( GLint attrib ); |
| 271 | + |
| 272 | +/* Mobile platforms lifecycle */ |
| 273 | +FGAPI void FGAPIENTRY glutInitContextFunc( void (* callback)( void ) ); |
| 274 | +FGAPI void FGAPIENTRY glutAppStatusFunc( void (* callback)( int ) ); |
| 275 | +/* state flags that can be passed to callback set by glutAppStatusFunc */ |
| 276 | +#define GLUT_APPSTATUS_PAUSE 0x0001 |
| 277 | +#define GLUT_APPSTATUS_RESUME 0x0002 |
| 278 | + |
| 279 | +/* |
| 280 | + * GLUT API macro definitions -- the display mode definitions |
| 281 | + */ |
| 282 | +#define GLUT_CAPTIONLESS 0x0400 |
| 283 | +#define GLUT_BORDERLESS 0x0800 |
| 284 | +#define GLUT_SRGB 0x1000 |
| 285 | + |
| 286 | +/* User-argument callbacks and implementation */ |
| 287 | +#include "freeglut_ucall.h" |
| 288 | + |
| 289 | +#ifdef __cplusplus |
| 290 | + } |
| 291 | +#endif |
| 292 | + |
| 293 | +/*** END OF FILE ***/ |
| 294 | + |
| 295 | +#endif /* __FREEGLUT_EXT_H__ */ |
0 commit comments