git.mutantstargoat.com Git - freeglut/blob - include/GL/freeglut_ext.h

   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  * GLUT API Extension macro definitions -- behaviour when the user clicks on an "x" to close a window
  37  */
  38 #define GLUT_ACTION_EXIT                         0
  39 #define GLUT_ACTION_GLUTMAINLOOP_RETURNS         1
  40 #define GLUT_ACTION_CONTINUE_EXECUTION           2
  41
  42 /*
  43  * Create a new rendering context when the user opens a new window?
  44  */
  45 #define GLUT_CREATE_NEW_CONTEXT                  0
  46 #define GLUT_USE_CURRENT_CONTEXT                 1
  47
  48 /*
  49  * Direct/Indirect rendering context options (has meaning only in Unix/X11)
  50  */
  51 #define GLUT_FORCE_INDIRECT_CONTEXT              0
  52 #define GLUT_ALLOW_DIRECT_CONTEXT                1
  53 #define GLUT_TRY_DIRECT_CONTEXT                  2
  54 #define GLUT_FORCE_DIRECT_CONTEXT                3
  55
  56 /*
  57  * GLUT API Extension macro definitions -- the glutGet parameters
  58  */
  59 #define  GLUT_INIT_STATE                    0x007C
  60
  61 #define  GLUT_ACTION_ON_WINDOW_CLOSE        0x01F9
  62
  63 #define  GLUT_WINDOW_BORDER_WIDTH           0x01FA
  64 #define  GLUT_WINDOW_HEADER_HEIGHT          0x01FB
  65
  66 #define  GLUT_VERSION                       0x01FC
  67
  68 #define  GLUT_RENDERING_CONTEXT             0x01FD
  69 #define  GLUT_DIRECT_RENDERING              0x01FE
  70
  71 /*
  72  * New tokens for glutInitDisplayMode.
  73  * Only one GLUT_AUXn bit may be used at a time.
  74  * Value 0x0400 is defined in OpenGLUT.
  75  */
  76 #define  GLUT_AUX1                          0x1000
  77 #define  GLUT_AUX2                          0x2000
  78 #define  GLUT_AUX3                          0x4000
  79 #define  GLUT_AUX4                          0x8000
  80
  81 /*
  82  * Process loop function, see freeglut_main.c
  83  */
  84 FGAPI void    FGAPIENTRY glutMainLoopEvent( void );
  85 FGAPI void    FGAPIENTRY glutLeaveMainLoop( void );
  86
  87 /*
  88  * Window-specific callback functions, see freeglut_callbacks.c
  89  */
  90 FGAPI void    FGAPIENTRY glutMouseWheelFunc( void (* callback)( int, int, int, int ) );
  91 FGAPI void    FGAPIENTRY glutCloseFunc( void (* callback)( void ) );
  92 FGAPI void    FGAPIENTRY glutWMCloseFunc( void (* callback)( void ) );
  93 /* A. Donev: Also a destruction callback for menus */
  94 FGAPI void    FGAPIENTRY glutMenuDestroyFunc( void (* callback)( void ) );
  95
  96 /*
  97  * State setting and retrieval functions, see freeglut_state.c
  98  */
  99 FGAPI void    FGAPIENTRY glutSetOption ( GLenum option_flag, int value );
 100 /* A.Donev: User-data manipulation */
 101 FGAPI void*   FGAPIENTRY glutGetWindowData( void );
 102 FGAPI void    FGAPIENTRY glutSetWindowData(void* data);
 103 FGAPI void*   FGAPIENTRY glutGetMenuData( void );
 104 FGAPI void    FGAPIENTRY glutSetMenuData(void* data);
 105
 106 /*
 107  * Font stuff, see freeglut_font.c
 108  */
 109 FGAPI int     FGAPIENTRY glutBitmapHeight( void* font );
 110 FGAPI GLfloat FGAPIENTRY glutStrokeHeight( void* font );
 111 FGAPI void    FGAPIENTRY glutBitmapString( void* font, const unsigned char *string );
 112 FGAPI void    FGAPIENTRY glutStrokeString( void* font, const unsigned char *string );
 113
 114 /*
 115  * Geometry functions, see freeglut_geometry.c
 116  */
 117 FGAPI void    FGAPIENTRY glutWireRhombicDodecahedron( void );
 118 FGAPI void    FGAPIENTRY glutSolidRhombicDodecahedron( void );
 119 FGAPI void    FGAPIENTRY glutWireSierpinskiSponge ( int num_levels, GLdouble offset[3], GLdouble scale );
 120 FGAPI void    FGAPIENTRY glutSolidSierpinskiSponge ( int num_levels, GLdouble offset[3], GLdouble scale );
 121 FGAPI void    FGAPIENTRY glutWireCylinder( GLdouble radius, GLdouble height, GLint slices, GLint stacks);
 122 FGAPI void    FGAPIENTRY glutSolidCylinder( GLdouble radius, GLdouble height, GLint slices, GLint stacks);
 123
 124 /*
 125  * Extension functions, see freeglut_ext.c
 126  */
 127 typedef void (*GLUTproc)();
 128 FGAPI GLUTproc FGAPIENTRY glutGetProcAddress( const char *procName );
 129
 130 /*
 131  * Joystick functions, see freeglut_joystick.c
 132  */
 133 /* USE OF THESE FUNCTIONS IS DEPRECATED !!!!! */
 134 /* If you have a serious need for these functions in your application, please either
 135  * contact the "freeglut" developer community at freeglut-developer@lists.sourceforge.net,
 136  * switch to the OpenGLUT library, or else port your joystick functionality over to PLIB's
 137  * "js" library.
 138  */
 139 int     glutJoystickGetNumAxes( int ident );
 140 int     glutJoystickGetNumButtons( int ident );
 141 int     glutJoystickNotWorking( int ident );
 142 float   glutJoystickGetDeadBand( int ident, int axis );
 143 void    glutJoystickSetDeadBand( int ident, int axis, float db );
 144 float   glutJoystickGetSaturation( int ident, int axis );
 145 void    glutJoystickSetSaturation( int ident, int axis, float st );
 146 void    glutJoystickSetMinRange( int ident, float *axes );
 147 void    glutJoystickSetMaxRange( int ident, float *axes );
 148 void    glutJoystickSetCenter( int ident, float *axes );
 149 void    glutJoystickGetMinRange( int ident, float *axes );
 150 void    glutJoystickGetMaxRange( int ident, float *axes );
 151 void    glutJoystickGetCenter( int ident, float *axes );
 152
 153 #ifdef __cplusplus
 154     }
 155 #endif
 156
 157 /*** END OF FILE ***/
 158
 159 #endif /* __FREEGLUT_EXT_H__ */