534 lines
17 KiB
C
534 lines
17 KiB
C
/* $Id: glu.h,v 1.19 1999/11/24 13:06:48 brianp Exp $ */
|
|
|
|
/*
|
|
* Mesa 3-D graphics library
|
|
* Version: 3.3
|
|
*
|
|
* Copyright (C) 1995-1999 Brian Paul
|
|
*
|
|
* This library is free software; you can redistribute it and/or
|
|
* modify it under the terms of the GNU Library General Public
|
|
* License as published by the Free Software Foundation; either
|
|
* version 2 of the License, or (at your option) any later version.
|
|
*
|
|
* This library is distributed in the hope that it will be useful,
|
|
* but WITHOUT ANY WARRANTY; without even the implied warranty of
|
|
* MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
|
|
* Library General Public License for more details.
|
|
*
|
|
* You should have received a copy of the GNU Library General Public
|
|
* License along with this library; if not, write to the Free
|
|
* Software Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
|
|
*/
|
|
|
|
|
|
#ifndef __glu_h__
|
|
#define __glu_h__
|
|
|
|
|
|
#if defined(USE_MGL_NAMESPACE)
|
|
#include "glu_mangle.h"
|
|
#endif
|
|
|
|
#include "GL/gl.h"
|
|
|
|
|
|
#ifdef __cplusplus
|
|
extern "C" {
|
|
#endif
|
|
|
|
|
|
/* to facilitate clean DLL building ... */
|
|
#if !defined(OPENSTEP) && (defined(__WIN32__) || defined(__CYGWIN32__))
|
|
# if defined(_MSC_VER) && defined(BUILD_GLU32) /* tag specify we're building mesa as a DLL */
|
|
# define GLUAPI __declspec(dllexport)
|
|
# elif defined(_MSC_VER) && defined(_DLL) /* tag specifying we're building for DLL runtime support */
|
|
# define GLUAPI __declspec(dllimport)
|
|
# else /* for use with static link lib build of Win32 edition only */
|
|
# define GLUAPI extern
|
|
# endif /* _STATIC_MESA support */
|
|
#else
|
|
# define GLUAPI extern
|
|
#endif /* WIN32 / CYGWIN32 bracket */
|
|
|
|
#ifdef macintosh
|
|
#pragma enumsalwaysint on
|
|
#if PRAGMA_IMPORT_SUPPORTED
|
|
#pragma import on
|
|
#endif
|
|
#endif
|
|
|
|
#ifndef GLUAPI
|
|
#define GLUAPI
|
|
#endif
|
|
|
|
#ifndef GLAPIENTRY
|
|
#define GLAPIENTRY
|
|
#endif
|
|
|
|
#ifndef GLCALLBACK
|
|
#define GLCALLBACK
|
|
#endif
|
|
|
|
|
|
#define GLU_VERSION_1_1 1
|
|
#define GLU_VERSION_1_2 1
|
|
|
|
|
|
#define GLU_TRUE 1
|
|
#define GLU_FALSE 0
|
|
|
|
|
|
/* Normal vectors */
|
|
#define GLU_SMOOTH 100000
|
|
#define GLU_FLAT 100001
|
|
#define GLU_NONE 100002
|
|
|
|
/* Quadric draw styles */
|
|
#define GLU_POINT 100010
|
|
#define GLU_LINE 100011
|
|
#define GLU_FILL 100012
|
|
#define GLU_SILHOUETTE 100013
|
|
|
|
/* Quadric orientation */
|
|
#define GLU_OUTSIDE 100020
|
|
#define GLU_INSIDE 100021
|
|
|
|
/* Tessellator */
|
|
#define GLU_TESS_BEGIN 100100
|
|
#define GLU_TESS_VERTEX 100101
|
|
#define GLU_TESS_END 100102
|
|
#define GLU_TESS_ERROR 100103
|
|
#define GLU_TESS_EDGE_FLAG 100104
|
|
#define GLU_TESS_COMBINE 100105
|
|
|
|
#define GLU_TESS_BEGIN_DATA 100106
|
|
#define GLU_TESS_VERTEX_DATA 100107
|
|
#define GLU_TESS_END_DATA 100108
|
|
#define GLU_TESS_ERROR_DATA 100109
|
|
#define GLU_TESS_EDGE_FLAG_DATA 100110
|
|
#define GLU_TESS_COMBINE_DATA 100111
|
|
|
|
/* Winding rules */
|
|
#define GLU_TESS_WINDING_ODD 100130
|
|
#define GLU_TESS_WINDING_NONZERO 100131
|
|
#define GLU_TESS_WINDING_POSITIVE 100132
|
|
#define GLU_TESS_WINDING_NEGATIVE 100133
|
|
#define GLU_TESS_WINDING_ABS_GEQ_TWO 100134
|
|
|
|
/* Tessellation properties */
|
|
#define GLU_TESS_WINDING_RULE 100140
|
|
#define GLU_TESS_BOUNDARY_ONLY 100141
|
|
#define GLU_TESS_TOLERANCE 100142
|
|
|
|
/* Tessellation errors */
|
|
#define GLU_TESS_ERROR1 100151 /* Missing gluBeginPolygon */
|
|
#define GLU_TESS_ERROR2 100152 /* Missing gluBeginContour */
|
|
#define GLU_TESS_ERROR3 100153 /* Missing gluEndPolygon */
|
|
#define GLU_TESS_ERROR4 100154 /* Missing gluEndContour */
|
|
#define GLU_TESS_ERROR5 100155 /* */
|
|
#define GLU_TESS_ERROR6 100156 /* */
|
|
#define GLU_TESS_ERROR7 100157 /* */
|
|
#define GLU_TESS_ERROR8 100158 /* */
|
|
|
|
/* NURBS */
|
|
#define GLU_AUTO_LOAD_MATRIX 100200
|
|
#define GLU_CULLING 100201
|
|
#define GLU_PARAMETRIC_TOLERANCE 100202
|
|
#define GLU_SAMPLING_TOLERANCE 100203
|
|
#define GLU_DISPLAY_MODE 100204
|
|
#define GLU_SAMPLING_METHOD 100205
|
|
#define GLU_U_STEP 100206
|
|
#define GLU_V_STEP 100207
|
|
|
|
#define GLU_PATH_LENGTH 100215
|
|
#define GLU_PARAMETRIC_ERROR 100216
|
|
#define GLU_DOMAIN_DISTANCE 100217
|
|
|
|
#define GLU_MAP1_TRIM_2 100210
|
|
#define GLU_MAP1_TRIM_3 100211
|
|
|
|
#define GLU_OUTLINE_POLYGON 100240
|
|
#define GLU_OUTLINE_PATCH 100241
|
|
|
|
#define GLU_NURBS_ERROR1 100251 /* spline order un-supported */
|
|
#define GLU_NURBS_ERROR2 100252 /* too few knots */
|
|
#define GLU_NURBS_ERROR3 100253 /* valid knot range is empty */
|
|
#define GLU_NURBS_ERROR4 100254 /* decreasing knot sequence */
|
|
#define GLU_NURBS_ERROR5 100255 /* knot multiplicity > spline order */
|
|
#define GLU_NURBS_ERROR6 100256 /* endcurve() must follow bgncurve() */
|
|
#define GLU_NURBS_ERROR7 100257 /* bgncurve() must precede endcurve() */
|
|
#define GLU_NURBS_ERROR8 100258 /* ctrlarray or knot vector is NULL */
|
|
#define GLU_NURBS_ERROR9 100259 /* can't draw pwlcurves */
|
|
#define GLU_NURBS_ERROR10 100260 /* missing gluNurbsCurve() */
|
|
#define GLU_NURBS_ERROR11 100261 /* missing gluNurbsSurface() */
|
|
#define GLU_NURBS_ERROR12 100262 /* endtrim() must precede endsurface() */
|
|
#define GLU_NURBS_ERROR13 100263 /* bgnsurface() must precede endsurface() */
|
|
#define GLU_NURBS_ERROR14 100264 /* curve of improper type passed as trim curve */
|
|
#define GLU_NURBS_ERROR15 100265 /* bgnsurface() must precede bgntrim() */
|
|
#define GLU_NURBS_ERROR16 100266 /* endtrim() must follow bgntrim() */
|
|
#define GLU_NURBS_ERROR17 100267 /* bgntrim() must precede endtrim()*/
|
|
#define GLU_NURBS_ERROR18 100268 /* invalid or missing trim curve*/
|
|
#define GLU_NURBS_ERROR19 100269 /* bgntrim() must precede pwlcurve() */
|
|
#define GLU_NURBS_ERROR20 100270 /* pwlcurve referenced twice*/
|
|
#define GLU_NURBS_ERROR21 100271 /* pwlcurve and nurbscurve mixed */
|
|
#define GLU_NURBS_ERROR22 100272 /* improper usage of trim data type */
|
|
#define GLU_NURBS_ERROR23 100273 /* nurbscurve referenced twice */
|
|
#define GLU_NURBS_ERROR24 100274 /* nurbscurve and pwlcurve mixed */
|
|
#define GLU_NURBS_ERROR25 100275 /* nurbssurface referenced twice */
|
|
#define GLU_NURBS_ERROR26 100276 /* invalid property */
|
|
#define GLU_NURBS_ERROR27 100277 /* endsurface() must follow bgnsurface() */
|
|
#define GLU_NURBS_ERROR28 100278 /* intersecting or misoriented trim curves */
|
|
#define GLU_NURBS_ERROR29 100279 /* intersecting trim curves */
|
|
#define GLU_NURBS_ERROR30 100280 /* UNUSED */
|
|
#define GLU_NURBS_ERROR31 100281 /* unconnected trim curves */
|
|
#define GLU_NURBS_ERROR32 100282 /* unknown knot error */
|
|
#define GLU_NURBS_ERROR33 100283 /* negative vertex count encountered */
|
|
#define GLU_NURBS_ERROR34 100284 /* negative byte-stride */
|
|
#define GLU_NURBS_ERROR35 100285 /* unknown type descriptor */
|
|
#define GLU_NURBS_ERROR36 100286 /* null control point reference */
|
|
#define GLU_NURBS_ERROR37 100287 /* duplicate point on pwlcurve */
|
|
|
|
/* GLU 1.3 and later */
|
|
#define GLU_NURBS_MODE ?
|
|
|
|
|
|
/* Errors */
|
|
#define GLU_INVALID_ENUM 100900
|
|
#define GLU_INVALID_VALUE 100901
|
|
#define GLU_OUT_OF_MEMORY 100902
|
|
#define GLU_INCOMPATIBLE_GL_VERSION 100903
|
|
|
|
/* GLU 1.1 and later */
|
|
#define GLU_VERSION 100800
|
|
#define GLU_EXTENSIONS 100801
|
|
|
|
|
|
|
|
/*** GLU 1.0 tessellation - obsolete! ***/
|
|
|
|
/* Contour types */
|
|
#define GLU_CW 100120
|
|
#define GLU_CCW 100121
|
|
#define GLU_INTERIOR 100122
|
|
#define GLU_EXTERIOR 100123
|
|
#define GLU_UNKNOWN 100124
|
|
|
|
/* Tessellator */
|
|
#define GLU_BEGIN GLU_TESS_BEGIN
|
|
#define GLU_VERTEX GLU_TESS_VERTEX
|
|
#define GLU_END GLU_TESS_END
|
|
#define GLU_ERROR GLU_TESS_ERROR
|
|
#define GLU_EDGE_FLAG GLU_TESS_EDGE_FLAG
|
|
|
|
|
|
/*
|
|
* These are the GLU 1.1 typedefs. GLU 1.3 has different ones!
|
|
*/
|
|
#if defined(__BEOS__)
|
|
/* The BeOS does something funky and makes these typedefs in one
|
|
* of its system headers.
|
|
*/
|
|
#else
|
|
typedef struct GLUquadric GLUquadricObj;
|
|
typedef struct GLUnurbs GLUnurbsObj;
|
|
|
|
/* FIXME: We need to implement the other 1.3 typedefs - GH */
|
|
typedef struct GLUtesselator GLUtesselator;
|
|
typedef GLUtesselator GLUtriangulatorObj;
|
|
#endif
|
|
|
|
|
|
|
|
#if defined(__BEOS__) || defined(__QUICKDRAW__)
|
|
#pragma export on
|
|
#endif
|
|
|
|
|
|
/*
|
|
*
|
|
* Miscellaneous functions
|
|
*
|
|
*/
|
|
|
|
GLUAPI void GLAPIENTRY gluLookAt( GLdouble eyex, GLdouble eyey, GLdouble eyez,
|
|
GLdouble centerx, GLdouble centery,
|
|
GLdouble centerz,
|
|
GLdouble upx, GLdouble upy, GLdouble upz );
|
|
|
|
|
|
GLUAPI void GLAPIENTRY gluOrtho2D( GLdouble left, GLdouble right,
|
|
GLdouble bottom, GLdouble top );
|
|
|
|
|
|
GLUAPI void GLAPIENTRY gluPerspective( GLdouble fovy, GLdouble aspect,
|
|
GLdouble zNear, GLdouble zFar );
|
|
|
|
|
|
GLUAPI void GLAPIENTRY gluPickMatrix( GLdouble x, GLdouble y,
|
|
GLdouble width, GLdouble height,
|
|
const GLint viewport[4] );
|
|
|
|
GLUAPI GLint GLAPIENTRY gluProject( GLdouble objx, GLdouble objy, GLdouble objz,
|
|
const GLdouble modelMatrix[16],
|
|
const GLdouble projMatrix[16],
|
|
const GLint viewport[4],
|
|
GLdouble *winx, GLdouble *winy,
|
|
GLdouble *winz );
|
|
|
|
GLUAPI GLint GLAPIENTRY gluUnProject( GLdouble winx, GLdouble winy,
|
|
GLdouble winz,
|
|
const GLdouble modelMatrix[16],
|
|
const GLdouble projMatrix[16],
|
|
const GLint viewport[4],
|
|
GLdouble *objx, GLdouble *objy,
|
|
GLdouble *objz );
|
|
|
|
GLUAPI const GLubyte* GLAPIENTRY gluErrorString( GLenum errorCode );
|
|
|
|
|
|
|
|
/*
|
|
*
|
|
* Mipmapping and image scaling
|
|
*
|
|
*/
|
|
|
|
GLUAPI GLint GLAPIENTRY gluScaleImage( GLenum format,
|
|
GLint widthin, GLint heightin,
|
|
GLenum typein, const void *datain,
|
|
GLint widthout, GLint heightout,
|
|
GLenum typeout, void *dataout );
|
|
|
|
GLUAPI GLint GLAPIENTRY gluBuild1DMipmaps( GLenum target, GLint components,
|
|
GLint width, GLenum format,
|
|
GLenum type, const void *data );
|
|
|
|
GLUAPI GLint GLAPIENTRY gluBuild2DMipmaps( GLenum target, GLint components,
|
|
GLint width, GLint height,
|
|
GLenum format,
|
|
GLenum type, const void *data );
|
|
|
|
|
|
|
|
/*
|
|
*
|
|
* Quadrics
|
|
*
|
|
*/
|
|
|
|
GLUAPI GLUquadricObj* GLAPIENTRY gluNewQuadric( void );
|
|
|
|
GLUAPI void GLAPIENTRY gluDeleteQuadric( GLUquadricObj *state );
|
|
|
|
GLUAPI void GLAPIENTRY gluQuadricDrawStyle( GLUquadricObj *quadObject,
|
|
GLenum drawStyle );
|
|
|
|
GLUAPI void GLAPIENTRY gluQuadricOrientation( GLUquadricObj *quadObject,
|
|
GLenum orientation );
|
|
|
|
GLUAPI void GLAPIENTRY gluQuadricNormals( GLUquadricObj *quadObject,
|
|
GLenum normals );
|
|
|
|
GLUAPI void GLAPIENTRY gluQuadricTexture( GLUquadricObj *quadObject,
|
|
GLboolean textureCoords );
|
|
|
|
GLUAPI void GLAPIENTRY gluQuadricCallback( GLUquadricObj *qobj,
|
|
GLenum which,
|
|
void (GLCALLBACK *fn)() );
|
|
|
|
GLUAPI void GLAPIENTRY gluCylinder( GLUquadricObj *qobj,
|
|
GLdouble baseRadius,
|
|
GLdouble topRadius,
|
|
GLdouble height,
|
|
GLint slices, GLint stacks );
|
|
|
|
GLUAPI void GLAPIENTRY gluSphere( GLUquadricObj *qobj,
|
|
GLdouble radius, GLint slices,
|
|
GLint stacks );
|
|
|
|
GLUAPI void GLAPIENTRY gluDisk( GLUquadricObj *qobj,
|
|
GLdouble innerRadius, GLdouble outerRadius,
|
|
GLint slices, GLint loops );
|
|
|
|
GLUAPI void GLAPIENTRY gluPartialDisk( GLUquadricObj *qobj, GLdouble innerRadius,
|
|
GLdouble outerRadius, GLint slices,
|
|
GLint loops, GLdouble startAngle,
|
|
GLdouble sweepAngle );
|
|
|
|
|
|
|
|
/*
|
|
*
|
|
* Nurbs
|
|
*
|
|
*/
|
|
|
|
GLUAPI GLUnurbsObj* GLAPIENTRY gluNewNurbsRenderer( void );
|
|
|
|
GLUAPI void GLAPIENTRY gluDeleteNurbsRenderer( GLUnurbsObj *nobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluLoadSamplingMatrices( GLUnurbsObj *nobj,
|
|
const GLfloat modelMatrix[16],
|
|
const GLfloat projMatrix[16],
|
|
const GLint viewport[4] );
|
|
|
|
GLUAPI void GLAPIENTRY gluNurbsProperty( GLUnurbsObj *nobj, GLenum property,
|
|
GLfloat value );
|
|
|
|
GLUAPI void GLAPIENTRY gluGetNurbsProperty( GLUnurbsObj *nobj, GLenum property,
|
|
GLfloat *value );
|
|
|
|
GLUAPI void GLAPIENTRY gluBeginCurve( GLUnurbsObj *nobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluEndCurve( GLUnurbsObj * nobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluNurbsCurve( GLUnurbsObj *nobj, GLint nknots,
|
|
GLfloat *knot, GLint stride,
|
|
GLfloat *ctlarray, GLint order,
|
|
GLenum type );
|
|
|
|
GLUAPI void GLAPIENTRY gluBeginSurface( GLUnurbsObj *nobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluEndSurface( GLUnurbsObj * nobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluNurbsSurface( GLUnurbsObj *nobj,
|
|
GLint sknot_count, GLfloat *sknot,
|
|
GLint tknot_count, GLfloat *tknot,
|
|
GLint s_stride, GLint t_stride,
|
|
GLfloat *ctlarray,
|
|
GLint sorder, GLint torder,
|
|
GLenum type );
|
|
|
|
GLUAPI void GLAPIENTRY gluBeginTrim( GLUnurbsObj *nobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluEndTrim( GLUnurbsObj *nobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluPwlCurve( GLUnurbsObj *nobj, GLint count,
|
|
GLfloat *array, GLint stride,
|
|
GLenum type );
|
|
|
|
GLUAPI void GLAPIENTRY gluNurbsCallback( GLUnurbsObj *nobj, GLenum which,
|
|
void (GLCALLBACK *fn)() );
|
|
|
|
|
|
|
|
/*
|
|
*
|
|
* Polygon tessellation
|
|
*
|
|
*/
|
|
|
|
GLUAPI GLUtesselator* GLAPIENTRY gluNewTess( void );
|
|
|
|
GLUAPI void GLAPIENTRY gluDeleteTess( GLUtesselator *tobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluTessBeginPolygon( GLUtesselator *tobj,
|
|
void *polygon_data );
|
|
|
|
GLUAPI void GLAPIENTRY gluTessBeginContour( GLUtesselator *tobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluTessVertex( GLUtesselator *tobj, GLdouble coords[3],
|
|
void *vertex_data );
|
|
|
|
GLUAPI void GLAPIENTRY gluTessEndContour( GLUtesselator *tobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluTessEndPolygon( GLUtesselator *tobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluTessProperty( GLUtesselator *tobj, GLenum which,
|
|
GLdouble value );
|
|
|
|
GLUAPI void GLAPIENTRY gluTessNormal( GLUtesselator *tobj, GLdouble x,
|
|
GLdouble y, GLdouble z );
|
|
|
|
GLUAPI void GLAPIENTRY gluTessCallback( GLUtesselator *tobj, GLenum which,
|
|
void (GLCALLBACK *fn)() );
|
|
|
|
GLUAPI void GLAPIENTRY gluGetTessProperty( GLUtesselator *tobj, GLenum which,
|
|
GLdouble *value );
|
|
|
|
/*
|
|
*
|
|
* Obsolete 1.0 tessellation functions
|
|
*
|
|
*/
|
|
|
|
GLUAPI void GLAPIENTRY gluBeginPolygon( GLUtesselator *tobj );
|
|
|
|
GLUAPI void GLAPIENTRY gluNextContour( GLUtesselator *tobj, GLenum type );
|
|
|
|
GLUAPI void GLAPIENTRY gluEndPolygon( GLUtesselator *tobj );
|
|
|
|
|
|
|
|
/*
|
|
*
|
|
* New functions in GLU 1.1
|
|
*
|
|
*/
|
|
|
|
GLUAPI const GLubyte* GLAPIENTRY gluGetString( GLenum name );
|
|
|
|
|
|
|
|
/*
|
|
*
|
|
* GLU 1.3 functions
|
|
*
|
|
*/
|
|
|
|
GLUAPI GLboolean GLAPIENTRY
|
|
gluCheckExtension(const char *extName, const GLubyte *extString);
|
|
|
|
|
|
GLUAPI GLint GLAPIENTRY
|
|
gluBuild3DMipmaps( GLenum target, GLint internalFormat, GLsizei width,
|
|
GLsizei height, GLsizei depth, GLenum format,
|
|
GLenum type, const void *data );
|
|
|
|
GLUAPI GLint GLAPIENTRY
|
|
gluBuild1DMipmapLevels( GLenum target, GLint internalFormat, GLsizei width,
|
|
GLenum format, GLenum type, GLint level, GLint base,
|
|
GLint max, const void *data );
|
|
|
|
GLUAPI GLint GLAPIENTRY
|
|
gluBuild2DMipmapLevels( GLenum target, GLint internalFormat, GLsizei width,
|
|
GLsizei height, GLenum format, GLenum type,
|
|
GLint level, GLint base, GLint max,
|
|
const void *data );
|
|
|
|
GLUAPI 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 );
|
|
|
|
GLUAPI GLint GLAPIENTRY
|
|
gluUnProject4( GLdouble winx, GLdouble winy, GLdouble winz, GLdouble clipw,
|
|
const GLdouble modelMatrix[16], const GLdouble projMatrix[16],
|
|
const GLint viewport[4], GLclampd zNear, GLclampd zFar,
|
|
GLdouble *objx, GLdouble *objy, GLdouble *objz,
|
|
GLdouble *objw );
|
|
|
|
|
|
|
|
#if defined(__BEOS__) || defined(__QUICKDRAW__)
|
|
#pragma export off
|
|
#endif
|
|
|
|
|
|
#ifdef macintosh
|
|
#pragma enumsalwaysint reset
|
|
#if PRAGMA_IMPORT_SUPPORTED
|
|
#pragma import off
|
|
#endif
|
|
#endif
|
|
|
|
|
|
#ifdef __cplusplus
|
|
}
|
|
#endif
|
|
|
|
|
|
#endif /* __glu_h__ */
|