include/GL/glu.h

0001 /*
0002  * SGI FREE SOFTWARE LICENSE B (Version 2.0, Sept. 18, 2008)
0003  * Copyright (C) 1991-2000 Silicon Graphics, Inc. All Rights Reserved.
0004  *
0005  * Permission is hereby granted, free of charge, to any person obtaining a
0006  * copy of this software and associated documentation files (the "Software"),
0007  * to deal in the Software without restriction, including without limitation
0008  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
0009  * and/or sell copies of the Software, and to permit persons to whom the
0010  * Software is furnished to do so, subject to the following conditions:
0011  *
0012  * The above copyright notice including the dates of first publication and
0013  * either this permission notice or a reference to
0014  * http://oss.sgi.com/projects/FreeB/
0015  * shall be included in all copies or substantial portions of the Software.
0016  *
0017  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
0018  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
0019  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
0020  * SILICON GRAPHICS, INC. BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
0021  * WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
0022  * OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
0023  * SOFTWARE.
0024  *
0025  * Except as contained in this notice, the name of Silicon Graphics, Inc.
0026  * shall not be used in advertising or otherwise to promote the sale, use or
0027  * other dealings in this Software without prior written authorization from
0028  * Silicon Graphics, Inc.
0029  */
0030
0031 #ifndef __glu_h__
0032 #define __glu_h__
0033
0034 #include <GL/gl.h>
0035
0036 #ifndef GLAPIENTRY
0037 #if defined(_MSC_VER) || defined(__MINGW32__)
0038 #define GLAPIENTRY __stdcall
0039 #else
0040 #define GLAPIENTRY
0041 #endif
0042 #endif
0043
0044 #ifndef GLAPIENTRYP
0045 #define GLAPIENTRYP GLAPIENTRY *
0046 #endif
0047
0048 #if (defined(_MSC_VER) || defined(__MINGW32__)) && defined(BUILD_GLU32)
0049 # undef GLAPI
0050 # define GLAPI __declspec(dllexport)
0051 #elif (defined(_MSC_VER) || defined(__MINGW32__)) && defined(_DLL)
0052 /* tag specifying we're building for DLL runtime support */
0053 # undef GLAPI
0054 # define GLAPI __declspec(dllimport)
0055 #elif !defined(GLAPI)
0056 /* for use with static link lib build of Win32 edition only */
0057 # define GLAPI extern
0058 #endif /* _STATIC_MESA support */
0059
0060 #ifdef __cplusplus
0061 extern "C" {
0062 #endif
0063
0064 /*************************************************************/
0065
0066 /* Extensions */
0067 #define GLU_EXT_object_space_tess          1
0068 #define GLU_EXT_nurbs_tessellator          1
0069
0070 /* Boolean */
0071 #define GLU_FALSE                          0
0072 #define GLU_TRUE                           1
0073
0074 /* Version */
0075 #define GLU_VERSION_1_1                    1
0076 #define GLU_VERSION_1_2                    1
0077 #define GLU_VERSION_1_3                    1
0078
0079 /* StringName */
0080 #define GLU_VERSION                        100800
0081 #define GLU_EXTENSIONS                     100801
0082
0083 /* ErrorCode */
0084 #define GLU_INVALID_ENUM                   100900
0085 #define GLU_INVALID_VALUE                  100901
0086 #define GLU_OUT_OF_MEMORY                  100902
0087 #define GLU_INCOMPATIBLE_GL_VERSION        100903
0088 #define GLU_INVALID_OPERATION              100904
0089
0090 /* NurbsDisplay */
0091 /*      GLU_FILL */
0092 #define GLU_OUTLINE_POLYGON                100240
0093 #define GLU_OUTLINE_PATCH                  100241
0094
0095 /* NurbsCallback */
0096 #define GLU_NURBS_ERROR                    100103
0097 #define GLU_ERROR                          100103
0098 #define GLU_NURBS_BEGIN                    100164
0099 #define GLU_NURBS_BEGIN_EXT                100164
0100 #define GLU_NURBS_VERTEX                   100165
0101 #define GLU_NURBS_VERTEX_EXT               100165
0102 #define GLU_NURBS_NORMAL                   100166
0103 #define GLU_NURBS_NORMAL_EXT               100166
0104 #define GLU_NURBS_COLOR                    100167
0105 #define GLU_NURBS_COLOR_EXT                100167
0106 #define GLU_NURBS_TEXTURE_COORD            100168
0107 #define GLU_NURBS_TEX_COORD_EXT            100168
0108 #define GLU_NURBS_END                      100169
0109 #define GLU_NURBS_END_EXT                  100169
0110 #define GLU_NURBS_BEGIN_DATA               100170
0111 #define GLU_NURBS_BEGIN_DATA_EXT           100170
0112 #define GLU_NURBS_VERTEX_DATA              100171
0113 #define GLU_NURBS_VERTEX_DATA_EXT          100171
0114 #define GLU_NURBS_NORMAL_DATA              100172
0115 #define GLU_NURBS_NORMAL_DATA_EXT          100172
0116 #define GLU_NURBS_COLOR_DATA               100173
0117 #define GLU_NURBS_COLOR_DATA_EXT           100173
0118 #define GLU_NURBS_TEXTURE_COORD_DATA       100174
0119 #define GLU_NURBS_TEX_COORD_DATA_EXT       100174
0120 #define GLU_NURBS_END_DATA                 100175
0121 #define GLU_NURBS_END_DATA_EXT             100175
0122
0123 /* NurbsError */
0124 #define GLU_NURBS_ERROR1                   100251
0125 #define GLU_NURBS_ERROR2                   100252
0126 #define GLU_NURBS_ERROR3                   100253
0127 #define GLU_NURBS_ERROR4                   100254
0128 #define GLU_NURBS_ERROR5                   100255
0129 #define GLU_NURBS_ERROR6                   100256
0130 #define GLU_NURBS_ERROR7                   100257
0131 #define GLU_NURBS_ERROR8                   100258
0132 #define GLU_NURBS_ERROR9                   100259
0133 #define GLU_NURBS_ERROR10                  100260
0134 #define GLU_NURBS_ERROR11                  100261
0135 #define GLU_NURBS_ERROR12                  100262
0136 #define GLU_NURBS_ERROR13                  100263
0137 #define GLU_NURBS_ERROR14                  100264
0138 #define GLU_NURBS_ERROR15                  100265
0139 #define GLU_NURBS_ERROR16                  100266
0140 #define GLU_NURBS_ERROR17                  100267
0141 #define GLU_NURBS_ERROR18                  100268
0142 #define GLU_NURBS_ERROR19                  100269
0143 #define GLU_NURBS_ERROR20                  100270
0144 #define GLU_NURBS_ERROR21                  100271
0145 #define GLU_NURBS_ERROR22                  100272
0146 #define GLU_NURBS_ERROR23                  100273
0147 #define GLU_NURBS_ERROR24                  100274
0148 #define GLU_NURBS_ERROR25                  100275
0149 #define GLU_NURBS_ERROR26                  100276
0150 #define GLU_NURBS_ERROR27                  100277
0151 #define GLU_NURBS_ERROR28                  100278
0152 #define GLU_NURBS_ERROR29                  100279
0153 #define GLU_NURBS_ERROR30                  100280
0154 #define GLU_NURBS_ERROR31                  100281
0155 #define GLU_NURBS_ERROR32                  100282
0156 #define GLU_NURBS_ERROR33                  100283
0157 #define GLU_NURBS_ERROR34                  100284
0158 #define GLU_NURBS_ERROR35                  100285
0159 #define GLU_NURBS_ERROR36                  100286
0160 #define GLU_NURBS_ERROR37                  100287
0161
0162 /* NurbsProperty */
0163 #define GLU_AUTO_LOAD_MATRIX               100200
0164 #define GLU_CULLING                        100201
0165 #define GLU_SAMPLING_TOLERANCE             100203
0166 #define GLU_DISPLAY_MODE                   100204
0167 #define GLU_PARAMETRIC_TOLERANCE           100202
0168 #define GLU_SAMPLING_METHOD                100205
0169 #define GLU_U_STEP                         100206
0170 #define GLU_V_STEP                         100207
0171 #define GLU_NURBS_MODE                     100160
0172 #define GLU_NURBS_MODE_EXT                 100160
0173 #define GLU_NURBS_TESSELLATOR              100161
0174 #define GLU_NURBS_TESSELLATOR_EXT          100161
0175 #define GLU_NURBS_RENDERER                 100162
0176 #define GLU_NURBS_RENDERER_EXT             100162
0177
0178 /* NurbsSampling */
0179 #define GLU_OBJECT_PARAMETRIC_ERROR        100208
0180 #define GLU_OBJECT_PARAMETRIC_ERROR_EXT    100208
0181 #define GLU_OBJECT_PATH_LENGTH             100209
0182 #define GLU_OBJECT_PATH_LENGTH_EXT         100209
0183 #define GLU_PATH_LENGTH                    100215
0184 #define GLU_PARAMETRIC_ERROR               100216
0185 #define GLU_DOMAIN_DISTANCE                100217
0186
0187 /* NurbsTrim */
0188 #define GLU_MAP1_TRIM_2                    100210
0189 #define GLU_MAP1_TRIM_3                    100211
0190
0191 /* QuadricDrawStyle */
0192 #define GLU_POINT                          100010
0193 #define GLU_LINE                           100011
0194 #define GLU_FILL                           100012
0195 #define GLU_SILHOUETTE                     100013
0196
0197 /* QuadricCallback */
0198 /*      GLU_ERROR */
0199
0200 /* QuadricNormal */
0201 #define GLU_SMOOTH                         100000
0202 #define GLU_FLAT                           100001
0203 #define GLU_NONE                           100002
0204
0205 /* QuadricOrientation */
0206 #define GLU_OUTSIDE                        100020
0207 #define GLU_INSIDE                         100021
0208
0209 /* TessCallback */
0210 #define GLU_TESS_BEGIN                     100100
0211 #define GLU_BEGIN                          100100
0212 #define GLU_TESS_VERTEX                    100101
0213 #define GLU_VERTEX                         100101
0214 #define GLU_TESS_END                       100102
0215 #define GLU_END                            100102
0216 #define GLU_TESS_ERROR                     100103
0217 #define GLU_TESS_EDGE_FLAG                 100104
0218 #define GLU_EDGE_FLAG                      100104
0219 #define GLU_TESS_COMBINE                   100105
0220 #define GLU_TESS_BEGIN_DATA                100106
0221 #define GLU_TESS_VERTEX_DATA               100107
0222 #define GLU_TESS_END_DATA                  100108
0223 #define GLU_TESS_ERROR_DATA                100109
0224 #define GLU_TESS_EDGE_FLAG_DATA            100110
0225 #define GLU_TESS_COMBINE_DATA              100111
0226
0227 /* TessContour */
0228 #define GLU_CW                             100120
0229 #define GLU_CCW                            100121
0230 #define GLU_INTERIOR                       100122
0231 #define GLU_EXTERIOR                       100123
0232 #define GLU_UNKNOWN                        100124
0233
0234 /* TessProperty */
0235 #define GLU_TESS_WINDING_RULE              100140
0236 #define GLU_TESS_BOUNDARY_ONLY             100141
0237 #define GLU_TESS_TOLERANCE                 100142
0238
0239 /* TessError */
0240 #define GLU_TESS_ERROR1                    100151
0241 #define GLU_TESS_ERROR2                    100152
0242 #define GLU_TESS_ERROR3                    100153
0243 #define GLU_TESS_ERROR4                    100154
0244 #define GLU_TESS_ERROR5                    100155
0245 #define GLU_TESS_ERROR6                    100156
0246 #define GLU_TESS_ERROR7                    100157
0247 #define GLU_TESS_ERROR8                    100158
0248 #define GLU_TESS_MISSING_BEGIN_POLYGON     100151
0249 #define GLU_TESS_MISSING_BEGIN_CONTOUR     100152
0250 #define GLU_TESS_MISSING_END_POLYGON       100153
0251 #define GLU_TESS_MISSING_END_CONTOUR       100154
0252 #define GLU_TESS_COORD_TOO_LARGE           100155
0253 #define GLU_TESS_NEED_COMBINE_CALLBACK     100156
0254
0255 /* TessWinding */
0256 #define GLU_TESS_WINDING_ODD               100130
0257 #define GLU_TESS_WINDING_NONZERO           100131
0258 #define GLU_TESS_WINDING_POSITIVE          100132
0259 #define GLU_TESS_WINDING_NEGATIVE          100133
0260 #define GLU_TESS_WINDING_ABS_GEQ_TWO       100134
0261
0262 /*************************************************************/
0263
0264
0265 #ifdef __cplusplus
0266 class GLUnurbs;
0267 class GLUquadric;
0268 class GLUtesselator;
0269 #else
0270 typedef struct GLUnurbs GLUnurbs;
0271 typedef struct GLUquadric GLUquadric;
0272 typedef struct GLUtesselator GLUtesselator;
0273 #endif
0274
0275 typedef GLUnurbs GLUnurbsObj;
0276 typedef GLUquadric GLUquadricObj;
0277 typedef GLUtesselator GLUtesselatorObj;
0278 typedef GLUtesselator GLUtriangulatorObj;
0279
0280 #define GLU_TESS_MAX_COORD 1.0e150
0281
0282 /* Internal convenience typedefs */
0283 typedef void (GLAPIENTRYP _GLUfuncptr)(void);
0284
0285 GLAPI void GLAPIENTRY gluBeginCurve (GLUnurbs* nurb);
0286 GLAPI void GLAPIENTRY gluBeginPolygon (GLUtesselator* tess);
0287 GLAPI void GLAPIENTRY gluBeginSurface (GLUnurbs* nurb);
0288 GLAPI void GLAPIENTRY gluBeginTrim (GLUnurbs* nurb);
0289 GLAPI GLint GLAPIENTRY gluBuild1DMipmapLevels (GLenum target, GLint internalFormat, GLsizei width, GLenum format, GLenum type, GLint level, GLint base, GLint max, const void *data);
0290 GLAPI GLint GLAPIENTRY gluBuild1DMipmaps (GLenum target, GLint internalFormat, GLsizei width, GLenum format, GLenum type, const void *data);
0291 GLAPI GLint GLAPIENTRY gluBuild2DMipmapLevels (GLenum target, GLint internalFormat, GLsizei width, GLsizei height, GLenum format, GLenum type, GLint level, GLint base, GLint max, const void *data);
0292 GLAPI GLint GLAPIENTRY gluBuild2DMipmaps (GLenum target, GLint internalFormat, GLsizei width, GLsizei height, GLenum format, GLenum type, const void *data);
0293 GLAPI GLint GLAPIENTRY gluBuild3DMipmapLevels (GLenum target, GLint internalFormat, GLsizei width, GLsizei height, GLsizei depth, GLenum format, GLenum type, GLint level, GLint base, GLint max, const void *data);
0294 GLAPI GLint GLAPIENTRY gluBuild3DMipmaps (GLenum target, GLint internalFormat, GLsizei width, GLsizei height, GLsizei depth, GLenum format, GLenum type, const void *data);
0295 GLAPI GLboolean GLAPIENTRY gluCheckExtension (const GLubyte *extName, const GLubyte *extString);
0296 GLAPI void GLAPIENTRY gluCylinder (GLUquadric* quad, GLdouble base, GLdouble top, GLdouble height, GLint slices, GLint stacks);
0297 GLAPI void GLAPIENTRY gluDeleteNurbsRenderer (GLUnurbs* nurb);
0298 GLAPI void GLAPIENTRY gluDeleteQuadric (GLUquadric* quad);
0299 GLAPI void GLAPIENTRY gluDeleteTess (GLUtesselator* tess);
0300 GLAPI void GLAPIENTRY gluDisk (GLUquadric* quad, GLdouble inner, GLdouble outer, GLint slices, GLint loops);
0301 GLAPI void GLAPIENTRY gluEndCurve (GLUnurbs* nurb);
0302 GLAPI void GLAPIENTRY gluEndPolygon (GLUtesselator* tess);
0303 GLAPI void GLAPIENTRY gluEndSurface (GLUnurbs* nurb);
0304 GLAPI void GLAPIENTRY gluEndTrim (GLUnurbs* nurb);
0305 GLAPI const GLubyte * GLAPIENTRY gluErrorString (GLenum error);
0306 GLAPI void GLAPIENTRY gluGetNurbsProperty (GLUnurbs* nurb, GLenum property, GLfloat* data);
0307 GLAPI const GLubyte * GLAPIENTRY gluGetString (GLenum name);
0308 GLAPI void GLAPIENTRY gluGetTessProperty (GLUtesselator* tess, GLenum which, GLdouble* data);
0309 GLAPI void GLAPIENTRY gluLoadSamplingMatrices (GLUnurbs* nurb, const GLfloat *model, const GLfloat *perspective, const GLint *view);
0310 GLAPI void GLAPIENTRY gluLookAt (GLdouble eyeX, GLdouble eyeY, GLdouble eyeZ, GLdouble centerX, GLdouble centerY, GLdouble centerZ, GLdouble upX, GLdouble upY, GLdouble upZ);
0311 GLAPI GLUnurbs* GLAPIENTRY gluNewNurbsRenderer (void);
0312 GLAPI GLUquadric* GLAPIENTRY gluNewQuadric (void);
0313 GLAPI GLUtesselator* GLAPIENTRY gluNewTess (void);
0314 GLAPI void GLAPIENTRY gluNextContour (GLUtesselator* tess, GLenum type);
0315 GLAPI void GLAPIENTRY gluNurbsCallback (GLUnurbs* nurb, GLenum which, _GLUfuncptr CallBackFunc);
0316 GLAPI void GLAPIENTRY gluNurbsCallbackData (GLUnurbs* nurb, GLvoid* userData);
0317 GLAPI void GLAPIENTRY gluNurbsCallbackDataEXT (GLUnurbs* nurb, GLvoid* userData);
0318 GLAPI void GLAPIENTRY gluNurbsCurve (GLUnurbs* nurb, GLint knotCount, GLfloat *knots, GLint stride, GLfloat *control, GLint order, GLenum type);
0319 GLAPI void GLAPIENTRY gluNurbsProperty (GLUnurbs* nurb, GLenum property, GLfloat value);
0320 GLAPI void GLAPIENTRY gluNurbsSurface (GLUnurbs* nurb, GLint sKnotCount, GLfloat* sKnots, GLint tKnotCount, GLfloat* tKnots, GLint sStride, GLint tStride, GLfloat* control, GLint sOrder, GLint tOrder, GLenum type);
0321 GLAPI void GLAPIENTRY gluOrtho2D (GLdouble left, GLdouble right, GLdouble bottom, GLdouble top);
0322 GLAPI void GLAPIENTRY gluPartialDisk (GLUquadric* quad, GLdouble inner, GLdouble outer, GLint slices, GLint loops, GLdouble start, GLdouble sweep);
0323 GLAPI void GLAPIENTRY gluPerspective (GLdouble fovy, GLdouble aspect, GLdouble zNear, GLdouble zFar);
0324 GLAPI void GLAPIENTRY gluPickMatrix (GLdouble x, GLdouble y, GLdouble delX, GLdouble delY, GLint *viewport);
0325 GLAPI GLint GLAPIENTRY gluProject (GLdouble objX, GLdouble objY, GLdouble objZ, const GLdouble *model, const GLdouble *proj, const GLint *view, GLdouble* winX, GLdouble* winY, GLdouble* winZ);
0326 GLAPI void GLAPIENTRY gluPwlCurve (GLUnurbs* nurb, GLint count, GLfloat* data, GLint stride, GLenum type);
0327 GLAPI void GLAPIENTRY gluQuadricCallback (GLUquadric* quad, GLenum which, _GLUfuncptr CallBackFunc);
0328 GLAPI void GLAPIENTRY gluQuadricDrawStyle (GLUquadric* quad, GLenum draw);
0329 GLAPI void GLAPIENTRY gluQuadricNormals (GLUquadric* quad, GLenum normal);
0330 GLAPI void GLAPIENTRY gluQuadricOrientation (GLUquadric* quad, GLenum orientation);
0331 GLAPI void GLAPIENTRY gluQuadricTexture (GLUquadric* quad, GLboolean texture);
0332 GLAPI GLint GLAPIENTRY gluScaleImage (GLenum format, GLsizei wIn, GLsizei hIn, GLenum typeIn, const void *dataIn, GLsizei wOut, GLsizei hOut, GLenum typeOut, GLvoid* dataOut);
0333 GLAPI void GLAPIENTRY gluSphere (GLUquadric* quad, GLdouble radius, GLint slices, GLint stacks);
0334 GLAPI void GLAPIENTRY gluTessBeginContour (GLUtesselator* tess);
0335 GLAPI void GLAPIENTRY gluTessBeginPolygon (GLUtesselator* tess, GLvoid* data);
0336 GLAPI void GLAPIENTRY gluTessCallback (GLUtesselator* tess, GLenum which, _GLUfuncptr CallBackFunc);
0337 GLAPI void GLAPIENTRY gluTessEndContour (GLUtesselator* tess);
0338 GLAPI void GLAPIENTRY gluTessEndPolygon (GLUtesselator* tess);
0339 GLAPI void GLAPIENTRY gluTessNormal (GLUtesselator* tess, GLdouble valueX, GLdouble valueY, GLdouble valueZ);
0340 GLAPI void GLAPIENTRY gluTessProperty (GLUtesselator* tess, GLenum which, GLdouble data);
0341 GLAPI void GLAPIENTRY gluTessVertex (GLUtesselator* tess, GLdouble *location, GLvoid* data);
0342 GLAPI GLint GLAPIENTRY gluUnProject (GLdouble winX, GLdouble winY, GLdouble winZ, const GLdouble *model, const GLdouble *proj, const GLint *view, GLdouble* objX, GLdouble* objY, GLdouble* objZ);
0343 GLAPI GLint GLAPIENTRY gluUnProject4 (GLdouble winX, GLdouble winY, GLdouble winZ, GLdouble clipW, const GLdouble *model, const GLdouble *proj, const GLint *view, GLdouble nearVal, GLdouble farVal, GLdouble* objX, GLdouble* objY, GLdouble* objZ, GLdouble* objW);
0344
0345 #ifdef __cplusplus
0346 }
0347 #endif
0348
0349 #endif /* __glu_h__ */