source: trunk/src/opengl/mesa/GL/glu.h

Last change on this file was 3086, checked in by sandervl, 25 years ago

update
File size: 17.8 KB
Line 
1/* $Id: glu.h,v 1.5 2000-03-11 17:06:35 sandervl Exp $ */
2
3/*
4 * Mesa 3-D graphics library
5 * Version: 3.1
6 * Copyright (C) 1995-1999 Brian Paul
7 *
8 * This library is free software; you can redistribute it and/or
9 * modify it under the terms of the GNU Library General Public
10 * License as published by the Free Software Foundation; either
11 * version 2 of the License, or (at your option) any later version.
12 *
13 * This library is distributed in the hope that it will be useful,
14 * but WITHOUT ANY WARRANTY; without even the implied warranty of
15 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
16 * Library General Public License for more details.
17 *
18 * You should have received a copy of the GNU Library General Public
19 * License along with this library; if not, write to the Free
20 * Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
21 */
22
23
24#ifndef GLU_H
25#define GLU_H
26
27
28#if defined(USE_MGL_NAMESPACE)
29#include "glu_mangle.h"
30#endif
31
32
33#ifdef __cplusplus
34extern "C" {
35#endif
36
37
38#include "GL/gl.h"
39
40 /* to facilitate clean DLL building ... */
41#if !defined(OPENSTEP) && (defined(__WIN32__) || defined(__CYGWIN32__))
42# if defined(_MSC_VER) && defined(BUILD_GLU32) /* tag specify we're building mesa as a DLL */
43# define GLUAPI __declspec(dllexport)
44# elif defined(_MSC_VER) && defined(_DLL) /* tag specifying we're building for DLL runtime support */
45# define GLUAPI __declspec(dllimport)
46# else /* for use with static link lib build of Win32 edition only */
47# define GLUAPI extern
48# endif /* _STATIC_MESA support */
49#else
50# define GLUAPI extern
51#endif /* WIN32 / CYGWIN32 bracket */
52
53#ifdef macintosh
54 #pragma enumsalwaysint on
55 #if PRAGMA_IMPORT_SUPPORTED
56 #pragma import on
57 #endif
58#endif
59
60#ifndef GLUAPI
61#define GLUAPI
62#endif
63
64#ifndef GLAPIENTRY
65#define GLAPIENTRY
66#endif
67
68#ifndef GLCALLBACK
69#define GLCALLBACK
70#endif
71
72
73#define GLU_VERSION_1_1 1
74#define GLU_VERSION_1_2 1
75
76
77#define GLU_TRUE GL_TRUE
78#define GLU_FALSE GL_FALSE
79
80#define GLU_TESS_MAX_COORD 1.0e150
81
82
83enum {
84 /* Normal vectors */
85 GLU_SMOOTH = 100000,
86 GLU_FLAT = 100001,
87 GLU_NONE = 100002,
88
89 /* Quadric draw styles */
90 GLU_POINT = 100010,
91 GLU_LINE = 100011,
92 GLU_FILL = 100012,
93 GLU_SILHOUETTE = 100013,
94
95 /* Quadric orientation */
96 GLU_OUTSIDE = 100020,
97 GLU_INSIDE = 100021,
98
99 /* Tessellator */
100 GLU_TESS_BEGIN = 100100,
101 GLU_TESS_VERTEX = 100101,
102 GLU_TESS_END = 100102,
103 GLU_TESS_ERROR = 100103,
104 GLU_TESS_EDGE_FLAG = 100104,
105 GLU_TESS_COMBINE = 100105,
106
107 GLU_TESS_BEGIN_DATA = 100106,
108 GLU_TESS_VERTEX_DATA = 100107,
109 GLU_TESS_END_DATA = 100108,
110 GLU_TESS_ERROR_DATA = 100109,
111 GLU_TESS_EDGE_FLAG_DATA = 100110,
112 GLU_TESS_COMBINE_DATA = 100111,
113
114 /* Winding rules */
115 GLU_TESS_WINDING_ODD = 100130,
116 GLU_TESS_WINDING_NONZERO = 100131,
117 GLU_TESS_WINDING_POSITIVE = 100132,
118 GLU_TESS_WINDING_NEGATIVE = 100133,
119 GLU_TESS_WINDING_ABS_GEQ_TWO = 100134,
120
121 /* Tessellation properties */
122 GLU_TESS_WINDING_RULE = 100140,
123 GLU_TESS_BOUNDARY_ONLY = 100141,
124 GLU_TESS_TOLERANCE = 100142,
125
126 /* Tessellation errors */
127 GLU_TESS_ERROR1 = 100151, /* Missing gluBeginPolygon */
128 GLU_TESS_ERROR2 = 100152, /* Missing gluBeginContour */
129 GLU_TESS_ERROR3 = 100153, /* Missing gluEndPolygon */
130 GLU_TESS_ERROR4 = 100154, /* Missing gluEndContour */
131 GLU_TESS_ERROR5 = 100155, /* */
132 GLU_TESS_ERROR6 = 100156, /* */
133 GLU_TESS_ERROR7 = 100157, /* */
134 GLU_TESS_ERROR8 = 100158, /* */
135
136 GLU_TESS_MISSING_BEGIN_POLYGON = GLU_TESS_ERROR1,
137 GLU_TESS_MISSING_BEGIN_CONTOUR = GLU_TESS_ERROR2,
138 GLU_TESS_MISSING_END_POLYGON = GLU_TESS_ERROR3,
139 GLU_TESS_MISSING_END_CONTOUR = GLU_TESS_ERROR4,
140 GLU_TESS_COORD_TOO_LARGE = GLU_TESS_ERROR5,
141 GLU_TESS_NEED_COMBINE_CALLBACK = GLU_TESS_ERROR6,
142
143 /* NURBS */
144 GLU_NURBS_MODE = 100160,
145 GLU_NURBS_TESSELLATOR = 100161,
146 GLU_NURBS_RENDERER = 100162,
147 GLU_NURBS_BEGIN = 100164,
148 GLU_NURBS_VERTEX = 100165,
149 GLU_NURBS_NORMAL = 100166,
150 GLU_NURBS_COLOR = 100167,
151 GLU_NURBS_TEXTURE_COORD = 100168,
152 GLU_NURBS_END = 100169,
153 GLU_NURBS_BEGIN_DATA = 100170,
154 GLU_NURBS_VERTEX_DATA = 100171,
155 GLU_NURBS_NORMAL_DATA = 100172,
156 GLU_NURBS_COLOR_DATA = 100173,
157 GLU_NURBS_TEXTURE_COORD_DATA = 100174,
158 GLU_NURBS_END_DATA = 100175,
159
160 GLU_AUTO_LOAD_MATRIX = 100200,
161 GLU_CULLING = 100201,
162 GLU_PARAMETRIC_TOLERANCE= 100202,
163 GLU_SAMPLING_TOLERANCE = 100203,
164 GLU_DISPLAY_MODE = 100204,
165 GLU_SAMPLING_METHOD = 100205,
166 GLU_U_STEP = 100206,
167 GLU_V_STEP = 100207,
168 GLU_OBJECT_PARAMETRIC_ERROR = 100208,
169 GLU_OBJECT_PATH_LENGTH = 100209,
170
171 GLU_MAP1_TRIM_2 = 100210,
172 GLU_MAP1_TRIM_3 = 100211,
173
174 GLU_PATH_LENGTH = 100215,
175 GLU_PARAMETRIC_ERROR = 100216,
176 GLU_DOMAIN_DISTANCE = 100217,
177
178 GLU_OUTLINE_POLYGON = 100240,
179 GLU_OUTLINE_PATCH = 100241,
180
181 GLU_ERROR = GLU_TESS_ERROR,
182 GLU_NURBS_ERROR = GLU_ERROR, /* FIXME: is this correct?? */
183
184 GLU_NURBS_ERROR1 = 100251, /* spline order un-supported */
185 GLU_NURBS_ERROR2 = 100252, /* too few knots */
186 GLU_NURBS_ERROR3 = 100253, /* valid knot range is empty */
187 GLU_NURBS_ERROR4 = 100254, /* decreasing knot sequence */
188 GLU_NURBS_ERROR5 = 100255, /* knot multiplicity > spline order */
189 GLU_NURBS_ERROR6 = 100256, /* endcurve() must follow bgncurve() */
190 GLU_NURBS_ERROR7 = 100257, /* bgncurve() must precede endcurve() */
191 GLU_NURBS_ERROR8 = 100258, /* ctrlarray or knot vector is NULL */
192 GLU_NURBS_ERROR9 = 100259, /* can't draw pwlcurves */
193 GLU_NURBS_ERROR10 = 100260, /* missing gluNurbsCurve() */
194 GLU_NURBS_ERROR11 = 100261, /* missing gluNurbsSurface() */
195 GLU_NURBS_ERROR12 = 100262, /* endtrim() must precede endsurface() */
196 GLU_NURBS_ERROR13 = 100263, /* bgnsurface() must precede endsurface() */
197 GLU_NURBS_ERROR14 = 100264, /* curve of improper type passed as trim curve */
198 GLU_NURBS_ERROR15 = 100265, /* bgnsurface() must precede bgntrim() */
199 GLU_NURBS_ERROR16 = 100266, /* endtrim() must follow bgntrim() */
200 GLU_NURBS_ERROR17 = 100267, /* bgntrim() must precede endtrim()*/
201 GLU_NURBS_ERROR18 = 100268, /* invalid or missing trim curve*/
202 GLU_NURBS_ERROR19 = 100269, /* bgntrim() must precede pwlcurve() */
203 GLU_NURBS_ERROR20 = 100270, /* pwlcurve referenced twice*/
204 GLU_NURBS_ERROR21 = 100271, /* pwlcurve and nurbscurve mixed */
205 GLU_NURBS_ERROR22 = 100272, /* improper usage of trim data type */
206 GLU_NURBS_ERROR23 = 100273, /* nurbscurve referenced twice */
207 GLU_NURBS_ERROR24 = 100274, /* nurbscurve and pwlcurve mixed */
208 GLU_NURBS_ERROR25 = 100275, /* nurbssurface referenced twice */
209 GLU_NURBS_ERROR26 = 100276, /* invalid property */
210 GLU_NURBS_ERROR27 = 100277, /* endsurface() must follow bgnsurface() */
211 GLU_NURBS_ERROR28 = 100278, /* intersecting or misoriented trim curves */
212 GLU_NURBS_ERROR29 = 100279, /* intersecting trim curves */
213 GLU_NURBS_ERROR30 = 100280, /* UNUSED */
214 GLU_NURBS_ERROR31 = 100281, /* unconnected trim curves */
215 GLU_NURBS_ERROR32 = 100282, /* unknown knot error */
216 GLU_NURBS_ERROR33 = 100283, /* negative vertex count encountered */
217 GLU_NURBS_ERROR34 = 100284, /* negative byte-stride */
218 GLU_NURBS_ERROR35 = 100285, /* unknown type descriptor */
219 GLU_NURBS_ERROR36 = 100286, /* null control point reference */
220 GLU_NURBS_ERROR37 = 100287, /* duplicate point on pwlcurve */
221
222 /* Errors */
223 GLU_INVALID_ENUM = 100900,
224 GLU_INVALID_VALUE = 100901,
225 GLU_OUT_OF_MEMORY = 100902,
226 GLU_INCOMPATIBLE_GL_VERSION = 100903,
227 GLU_INVALID_OPERATION = 100904,
228
229 /* New in GLU 1.1 */
230 GLU_VERSION = 100800,
231 GLU_EXTENSIONS = 100801,
232
233 /*** GLU 1.0 tessellation - obsolete! ***/
234
235 /* Contour types */
236 GLU_CW = 100120,
237 GLU_CCW = 100121,
238 GLU_INTERIOR = 100122,
239 GLU_EXTERIOR = 100123,
240 GLU_UNKNOWN = 100124,
241
242 /* Tessellator */
243 GLU_BEGIN = GLU_TESS_BEGIN,
244 GLU_VERTEX = GLU_TESS_VERTEX,
245 GLU_END = GLU_TESS_END,
246 GLU_EDGE_FLAG = GLU_TESS_EDGE_FLAG
247};
248
249
250/*
251 * These are the GLU 1.1 typedefs. GLU 1.3 has different ones!
252 */
253#if defined(__BEOS__)
254 /* The BeOS does something funky and makes these typedefs in one
255 * of its system headers.
256 */
257#else
258 typedef struct GLUquadric GLUquadricObj;
259 typedef struct GLUnurbs GLUnurbsObj;
260
261 /* FIXME: We need to implement the other 1.3 typedefs - GH */
262 typedef struct GLUtesselator GLUtesselator;
263 typedef GLUtesselator GLUtriangulatorObj;
264#endif
265
266
267
268#if defined(__BEOS__) || defined(__QUICKDRAW__)
269#pragma export on
270#endif
271
272
273/*
274 *
275 * Miscellaneous functions
276 *
277 */
278
279GLUAPI void GLAPIENTRY gluLookAt( GLdouble eyex, GLdouble eyey, GLdouble eyez,
280 GLdouble centerx, GLdouble centery,
281 GLdouble centerz,
282 GLdouble upx, GLdouble upy, GLdouble upz );
283
284
285GLUAPI void GLAPIENTRY gluOrtho2D( GLdouble left, GLdouble right,
286 GLdouble bottom, GLdouble top );
287
288
289GLUAPI void GLAPIENTRY gluPerspective( GLdouble fovy, GLdouble aspect,
290 GLdouble zNear, GLdouble zFar );
291
292
293GLUAPI void GLAPIENTRY gluPickMatrix( GLdouble x, GLdouble y,
294 GLdouble width, GLdouble height,
295 const GLint viewport[4] );
296
297GLUAPI GLint GLAPIENTRY gluProject( GLdouble objx, GLdouble objy, GLdouble objz,
298 const GLdouble modelMatrix[16],
299 const GLdouble projMatrix[16],
300 const GLint viewport[4],
301 GLdouble *winx, GLdouble *winy,
302 GLdouble *winz );
303
304GLUAPI GLint GLAPIENTRY gluUnProject( GLdouble winx, GLdouble winy,
305 GLdouble winz,
306 const GLdouble modelMatrix[16],
307 const GLdouble projMatrix[16],
308 const GLint viewport[4],
309 GLdouble *objx, GLdouble *objy,
310 GLdouble *objz );
311
312GLUAPI const GLubyte* GLAPIENTRY gluErrorString( GLenum errorCode );
313
314
315
316/*
317 *
318 * Mipmapping and image scaling
319 *
320 */
321
322GLUAPI GLint GLAPIENTRY gluScaleImage( GLenum format,
323 GLsizei widthin, GLsizei heightin,
324 GLenum typein, const void *datain,
325 GLsizei widthout, GLsizei heightout,
326 GLenum typeout, void *dataout );
327
328GLUAPI GLint GLAPIENTRY gluBuild1DMipmaps( GLenum target, GLint components,
329 GLsizei width, GLenum format,
330 GLenum type, const void *data );
331
332GLUAPI GLint GLAPIENTRY gluBuild2DMipmaps( GLenum target, GLint components,
333 GLsizei width, GLsizei height,
334 GLenum format,
335 GLenum type, const void *data );
336
337
338
339/*
340 *
341 * Quadrics
342 *
343 */
344
345GLUAPI GLUquadricObj* GLAPIENTRY gluNewQuadric( void );
346
347GLUAPI void GLAPIENTRY gluDeleteQuadric( GLUquadricObj *state );
348
349GLUAPI void GLAPIENTRY gluQuadricDrawStyle( GLUquadricObj *quadObject,
350 GLenum drawStyle );
351
352GLUAPI void GLAPIENTRY gluQuadricOrientation( GLUquadricObj *quadObject,
353 GLenum orientation );
354
355GLUAPI void GLAPIENTRY gluQuadricNormals( GLUquadricObj *quadObject,
356 GLenum normals );
357
358GLUAPI void GLAPIENTRY gluQuadricTexture( GLUquadricObj *quadObject,
359 GLboolean textureCoords );
360
361GLUAPI void GLAPIENTRY gluQuadricCallback( GLUquadricObj *qobj,
362 GLenum which,
363 void (* GLCALLBACK fn)() );
364
365GLUAPI void GLAPIENTRY gluCylinder( GLUquadricObj *qobj,
366 GLdouble baseRadius,
367 GLdouble topRadius,
368 GLdouble height,
369 GLint slices, GLint stacks );
370
371GLUAPI void GLAPIENTRY gluSphere( GLUquadricObj *qobj,
372 GLdouble radius, GLint slices, GLint stacks );
373
374GLUAPI void GLAPIENTRY gluDisk( GLUquadricObj *qobj,
375 GLdouble innerRadius, GLdouble outerRadius,
376 GLint slices, GLint loops );
377
378GLUAPI void GLAPIENTRY gluPartialDisk( GLUquadricObj *qobj, GLdouble innerRadius,
379 GLdouble outerRadius, GLint slices,
380 GLint loops, GLdouble startAngle,
381 GLdouble sweepAngle );
382
383
384
385/*
386 *
387 * Nurbs
388 *
389 */
390
391GLUAPI GLUnurbsObj* GLAPIENTRY gluNewNurbsRenderer( void );
392
393GLUAPI void GLAPIENTRY gluDeleteNurbsRenderer( GLUnurbsObj *nobj );
394
395GLUAPI void GLAPIENTRY gluLoadSamplingMatrices( GLUnurbsObj *nobj,
396 const GLfloat modelMatrix[16],
397 const GLfloat projMatrix[16],
398 const GLint viewport[4] );
399
400GLUAPI void GLAPIENTRY gluNurbsProperty( GLUnurbsObj *nobj, GLenum property,
401 GLfloat value );
402
403GLUAPI void GLAPIENTRY gluGetNurbsProperty( GLUnurbsObj *nobj, GLenum property,
404 GLfloat *value );
405
406GLUAPI void GLAPIENTRY gluBeginCurve( GLUnurbsObj *nobj );
407
408GLUAPI void GLAPIENTRY gluEndCurve( GLUnurbsObj * nobj );
409
410GLUAPI void GLAPIENTRY gluNurbsCurve( GLUnurbsObj *nobj, GLint nknots,
411 GLfloat *knot, GLint stride,
412 GLfloat *ctlarray, GLint order,
413 GLenum type );
414
415GLUAPI void GLAPIENTRY gluBeginSurface( GLUnurbsObj *nobj );
416
417GLUAPI void GLAPIENTRY gluEndSurface( GLUnurbsObj * nobj );
418
419GLUAPI void GLAPIENTRY gluNurbsSurface( GLUnurbsObj *nobj,
420 GLint sknot_count, GLfloat *sknot,
421 GLint tknot_count, GLfloat *tknot,
422 GLint s_stride, GLint t_stride,
423 GLfloat *ctlarray,
424 GLint sorder, GLint torder,
425 GLenum type );
426
427GLUAPI void GLAPIENTRY gluBeginTrim( GLUnurbsObj *nobj );
428
429GLUAPI void GLAPIENTRY gluEndTrim( GLUnurbsObj *nobj );
430
431GLUAPI void GLAPIENTRY gluPwlCurve( GLUnurbsObj *nobj, GLint count,
432 GLfloat *array, GLint stride, GLenum type );
433
434GLUAPI void GLAPIENTRY gluNurbsCallback( GLUnurbsObj *nobj, GLenum which,
435 void (* GLCALLBACK fn)() );
436
437GLUAPI GLboolean GLAPIENTRY gluCheckExtension(const GLubyte *extName,
438 const GLubyte *extString);
439
440
441/*
442 *
443 * Polygon tessellation
444 *
445 */
446
447GLUAPI GLUtesselator* GLAPIENTRY gluNewTess( void );
448
449GLUAPI void GLAPIENTRY gluDeleteTess( GLUtesselator *tobj );
450
451GLUAPI void GLAPIENTRY gluTessBeginPolygon( GLUtesselator *tobj,
452 void *polygon_data );
453
454GLUAPI void GLAPIENTRY gluTessBeginContour( GLUtesselator *tobj );
455
456GLUAPI void GLAPIENTRY gluTessVertex( GLUtesselator *tobj, GLdouble coords[3],
457 void *vertex_data );
458
459GLUAPI void GLAPIENTRY gluTessEndContour( GLUtesselator *tobj );
460
461GLUAPI void GLAPIENTRY gluTessEndPolygon( GLUtesselator *tobj );
462
463GLUAPI void GLAPIENTRY gluTessProperty( GLUtesselator *tobj, GLenum which,
464 GLdouble value );
465
466GLUAPI void GLAPIENTRY gluTessNormal( GLUtesselator *tobj, GLdouble x,
467 GLdouble y, GLdouble z );
468
469GLUAPI void GLAPIENTRY gluTessCallback( GLUtesselator *tobj, GLenum which,
470 void (* GLCALLBACK fn)() );
471
472GLUAPI void GLAPIENTRY gluGetTessProperty( GLUtesselator *tobj, GLenum which,
473 GLdouble *value );
474
475/*
476 *
477 * Obsolete 1.0 tessellation functions
478 *
479 */
480
481GLUAPI void GLAPIENTRY gluBeginPolygon( GLUtesselator *tobj );
482
483GLUAPI void GLAPIENTRY gluNextContour( GLUtesselator *tobj, GLenum type );
484
485GLUAPI void GLAPIENTRY gluEndPolygon( GLUtesselator *tobj );
486
487
488
489/*
490 *
491 * New functions in GLU 1.1
492 *
493 */
494
495GLUAPI const GLubyte* GLAPIENTRY gluGetString( GLenum name );
496
497
498
499#if defined(__BEOS__) || defined(__QUICKDRAW__)
500#pragma export off
501#endif
502
503
504#ifdef macintosh
505 #pragma enumsalwaysint reset
506 #if PRAGMA_IMPORT_SUPPORTED
507 #pragma import off
508 #endif
509#endif
510
511
512#ifdef __cplusplus
513}
514#endif
515
516
517#endif
Note: See TracBrowser for help on using the repository browser.