1 #ifndef __FREEGLUT_EXT_H__
2 #define __FREEGLUT_EXT_H__
7 * The non-GLUT-compatible extensions to the freeglut library include file
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
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:
20 * The above copyright notice and this permission notice shall be included
21 * in all copies or substantial portions of the Software.
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.
36 * Additional GLUT Key definitions for the Special key function
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
49 * GLUT API Extension macro definitions -- behaviour when the user clicks on an "x" to close a window
51 #define GLUT_ACTION_EXIT 0
52 #define GLUT_ACTION_GLUTMAINLOOP_RETURNS 1
53 #define GLUT_ACTION_CONTINUE_EXECUTION 2
56 * Create a new rendering context when the user opens a new window?
58 #define GLUT_CREATE_NEW_CONTEXT 0
59 #define GLUT_USE_CURRENT_CONTEXT 1
62 * Direct/Indirect rendering context options (has meaning only in Unix/X11)
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
70 * GLUT API Extension macro definitions -- the glutGet parameters
72 #define GLUT_INIT_STATE 0x007C
74 #define GLUT_ACTION_ON_WINDOW_CLOSE 0x01F9
76 #define GLUT_WINDOW_BORDER_WIDTH 0x01FA
77 #define GLUT_WINDOW_HEADER_HEIGHT 0x01FB
79 #define GLUT_VERSION 0x01FC
81 #define GLUT_RENDERING_CONTEXT 0x01FD
82 #define GLUT_DIRECT_RENDERING 0x01FE
84 #define GLUT_FULL_SCREEN 0x01FF
87 * New tokens for glutInitDisplayMode.
88 * Only one GLUT_AUXn bit may be used at a time.
89 * Value 0x0400 is defined in OpenGLUT.
91 #define GLUT_AUX 0x1000
93 #define GLUT_AUX1 0x1000
94 #define GLUT_AUX2 0x2000
95 #define GLUT_AUX3 0x4000
96 #define GLUT_AUX4 0x8000
99 * Context-related flags, see freeglut_state.c
101 #define GLUT_INIT_MAJOR_VERSION 0x0200
102 #define GLUT_INIT_MINOR_VERSION 0x0201
103 #define GLUT_INIT_FLAGS 0x0202
104 #define GLUT_INIT_PROFILE 0x0203
107 * Flags for glutInitContextFlags, see freeglut_init.c
109 #define GLUT_DEBUG 0x0001
110 #define GLUT_FORWARD_COMPATIBLE 0x0002
114 * Flags for glutInitContextProfile, see freeglut_init.c
116 #define GLUT_CORE_PROFILE 0x0001
117 #define GLUT_COMPATIBILITY_PROFILE 0x0002
120 * Process loop function, see freeglut_main.c
122 FGAPI
void FGAPIENTRY
glutMainLoopEvent( void );
123 FGAPI
void FGAPIENTRY
glutLeaveMainLoop( void );
124 FGAPI
void FGAPIENTRY
glutExit ( void );
127 * Window management functions, see freeglut_window.c
129 FGAPI
void FGAPIENTRY
glutFullScreenToggle( void );
130 FGAPI
void FGAPIENTRY
glutLeaveFullScreen( void );
133 * Window-specific callback functions, see freeglut_callbacks.c
135 FGAPI
void FGAPIENTRY
glutMouseWheelFunc( void (* callback
)( int, int, int, int ) );
136 FGAPI
void FGAPIENTRY
glutCloseFunc( void (* callback
)( void ) );
137 FGAPI
void FGAPIENTRY
glutWMCloseFunc( void (* callback
)( void ) );
138 /* A. Donev: Also a destruction callback for menus */
139 FGAPI
void FGAPIENTRY
glutMenuDestroyFunc( void (* callback
)( void ) );
142 * State setting and retrieval functions, see freeglut_state.c
144 FGAPI
void FGAPIENTRY
glutSetOption ( GLenum option_flag
, int value
);
145 FGAPI
int * FGAPIENTRY
glutGetModeValues(GLenum mode
, int * size
);
146 /* A.Donev: User-data manipulation */
147 FGAPI
void* FGAPIENTRY
glutGetWindowData( void );
148 FGAPI
void FGAPIENTRY
glutSetWindowData(void* data
);
149 FGAPI
void* FGAPIENTRY
glutGetMenuData( void );
150 FGAPI
void FGAPIENTRY
glutSetMenuData(void* data
);
153 * Font stuff, see freeglut_font.c
155 FGAPI
int FGAPIENTRY
glutBitmapHeight( void* font
);
156 FGAPI GLfloat FGAPIENTRY
glutStrokeHeight( void* font
);
157 FGAPI
void FGAPIENTRY
glutBitmapString( void* font
, const unsigned char *string
);
158 FGAPI
void FGAPIENTRY
glutStrokeString( void* font
, const unsigned char *string
);
161 * Geometry functions, see freeglut_geometry.c
163 FGAPI
void FGAPIENTRY
glutWireRhombicDodecahedron( void );
164 FGAPI
void FGAPIENTRY
glutSolidRhombicDodecahedron( void );
165 FGAPI
void FGAPIENTRY
glutWireSierpinskiSponge ( int num_levels
, GLdouble offset
[3], GLdouble scale
);
166 FGAPI
void FGAPIENTRY
glutSolidSierpinskiSponge ( int num_levels
, GLdouble offset
[3], GLdouble scale
);
167 FGAPI
void FGAPIENTRY
glutWireCylinder( GLdouble radius
, GLdouble height
, GLint slices
, GLint stacks
);
168 FGAPI
void FGAPIENTRY
glutSolidCylinder( GLdouble radius
, GLdouble height
, GLint slices
, GLint stacks
);
171 * Extension functions, see freeglut_ext.c
173 typedef void (*GLUTproc
)();
174 FGAPI GLUTproc FGAPIENTRY
glutGetProcAddress( const char *procName
);
177 * Multi-touch/multi-pointer extensions
180 #define GLUT_HAS_MULTI 1
182 FGAPI
void FGAPIENTRY
glutMultiEntryFunc( void (* callback
)( int, int ) );
183 FGAPI
void FGAPIENTRY
glutMultiButtonFunc( void (* callback
)( int, int, int, int, int ) );
184 FGAPI
void FGAPIENTRY
glutMultiMotionFunc( void (* callback
)( int, int, int ) );
185 FGAPI
void FGAPIENTRY
glutMultiPassiveFunc( void (* callback
)( int, int, int ) );
188 * Joystick functions, see freeglut_joystick.c
190 /* USE OF THESE FUNCTIONS IS DEPRECATED !!!!! */
191 /* If you have a serious need for these functions in your application, please either
192 * contact the "freeglut" developer community at freeglut-developer@lists.sourceforge.net,
193 * switch to the OpenGLUT library, or else port your joystick functionality over to PLIB's
196 int glutJoystickGetNumAxes( int ident
);
197 int glutJoystickGetNumButtons( int ident
);
198 int glutJoystickNotWorking( int ident
);
199 float glutJoystickGetDeadBand( int ident
, int axis
);
200 void glutJoystickSetDeadBand( int ident
, int axis
, float db
);
201 float glutJoystickGetSaturation( int ident
, int axis
);
202 void glutJoystickSetSaturation( int ident
, int axis
, float st
);
203 void glutJoystickSetMinRange( int ident
, float *axes
);
204 void glutJoystickSetMaxRange( int ident
, float *axes
);
205 void glutJoystickSetCenter( int ident
, float *axes
);
206 void glutJoystickGetMinRange( int ident
, float *axes
);
207 void glutJoystickGetMaxRange( int ident
, float *axes
);
208 void glutJoystickGetCenter( int ident
, float *axes
);
211 * Initialization functions, see freeglut_init.c
213 FGAPI
void FGAPIENTRY
glutInitContextVersion( int majorVersion
, int minorVersion
);
214 FGAPI
void FGAPIENTRY
glutInitContextFlags( int flags
);
215 FGAPI
void FGAPIENTRY
glutInitContextProfile( int profile
);
217 /* to get the typedef for va_list */
220 FGAPI
void FGAPIENTRY
glutInitErrorFunc( void (* vError
)( const char *fmt
, va_list ap
) );
221 FGAPI
void FGAPIENTRY
glutInitWarningFunc( void (* vWarning
)( const char *fmt
, va_list ap
) );
224 * GLUT API macro definitions -- the display mode definitions
226 #define GLUT_CAPTIONLESS 0x0400
227 #define GLUT_BORDERLESS 0x0800
228 #define GLUT_SRGB 0x1000
234 /*** END OF FILE ***/
236 #endif /* __FREEGLUT_EXT_H__ */