home *** CD-ROM | disk | FTP | other *** search
- /* $Id: glu.h,v 1.10 1999/09/19 10:04:01 tjump Exp $ */
-
- /*
- * Mesa 3-D graphics library
- * Version: 3.1
- * 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.
- */
-
-
- /*
- * $Log: glu.h,v $
- * Revision 1.10 1999/09/19 10:04:01 tjump
- * Changed name 'glGetProcAddressEXT' to 'gluGetProcAddressEXT'
- *
- * Revision 1.8 1999/09/17 12:21:36 brianp
- * glGetProcAddressEXT changes to accomodate Win32 and non-Win32
- *
- * Revision 1.7 1999/09/17 02:44:19 tjump
- * I changed the xxxGetProcAddressEXT function declarations to be more
- * MSVC friendly. Brianp - could you verify that they describe and operate
- * as intended on Linux/ETC platforms?
- *
- * Revision 1.6 1999/09/16 16:54:22 brianp
- * GLU_EXT_get_proc_address clean-up
- *
- * Revision 1.5 1999/09/14 03:23:08 gareth
- * Fixed GLUtriangulatorObj again (spelling).
- *
- * Revision 1.4 1999/09/14 01:32:58 gareth
- * Fixed definition of GLUtriangluatorObj for 1.3 tessellator.
- *
- * Revision 1.3 1999/09/11 11:34:21 brianp
- * added GLU_EXT_get_proc_address
- *
- * Revision 1.2 1999/09/10 02:08:18 gareth
- * Added GLU 1.3 tessellation (except winding rule code).
- *
- * Revision 1.1.1.1 1999/08/19 00:55:40 jtg
- * Imported sources
- *
- * Revision 3.6 1999/02/14 03:39:45 brianp
- * updated for BeOS R4
- *
- * Revision 3.5 1999/01/03 03:02:55 brianp
- * now using GLAPI and GLAPIENTRY keywords, misc Windows changes (Ted Jump)
- *
- * Revision 3.4 1998/12/01 02:34:27 brianp
- * applied Mark Kilgard's patches from November 30, 1998
- *
- * Revision 3.3 1998/11/17 01:14:02 brianp
- * minor changes for OpenStep compilation (pete@ohm.york.ac.uk)
- *
- * Revision 3.2 1998/07/26 01:36:27 brianp
- * changes for Windows compilation per Ted Jump
- *
- * Revision 3.1 1998/06/23 00:33:08 brianp
- * added some WIN32 APIENTRY, CALLBACK stuff (Eric Lassauge)
- *
- * Revision 3.0 1998/02/20 05:06:01 brianp
- * initial rev
- *
- */
-
-
- #ifndef GLU_H
- #define GLU_H
-
-
- #if defined(USE_MGL_NAMESPACE)
- #include "glu_mangle.h"
- #endif
-
-
- #ifdef __cplusplus
- extern "C" {
- #endif
-
-
- #include "GL/gl.h"
-
- /* 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
-
-
- #define GLU_VERSION_1_1 1
- #define GLU_VERSION_1_2 1
-
-
- #define GLU_TRUE GL_TRUE
- #define GLU_FALSE GL_FALSE
-
-
- enum {
- /* Normal vectors */
- GLU_SMOOTH = 100000,
- GLU_FLAT = 100001,
- GLU_NONE = 100002,
-
- /* Quadric draw styles */
- GLU_POINT = 100010,
- GLU_LINE = 100011,
- GLU_FILL = 100012,
- GLU_SILHOUETTE = 100013,
-
- /* Quadric orientation */
- GLU_OUTSIDE = 100020,
- GLU_INSIDE = 100021,
-
- /* Tessellator */
- GLU_TESS_BEGIN = 100100,
- GLU_TESS_VERTEX = 100101,
- GLU_TESS_END = 100102,
- GLU_TESS_ERROR = 100103,
- GLU_TESS_EDGE_FLAG = 100104,
- GLU_TESS_COMBINE = 100105,
-
- GLU_TESS_BEGIN_DATA = 100106,
- GLU_TESS_VERTEX_DATA = 100107,
- GLU_TESS_END_DATA = 100108,
- GLU_TESS_ERROR_DATA = 100109,
- GLU_TESS_EDGE_FLAG_DATA = 100110,
- GLU_TESS_COMBINE_DATA = 100111,
-
- /* Winding rules */
- GLU_TESS_WINDING_ODD = 100130,
- GLU_TESS_WINDING_NONZERO = 100131,
- GLU_TESS_WINDING_POSITIVE = 100132,
- GLU_TESS_WINDING_NEGATIVE = 100133,
- GLU_TESS_WINDING_ABS_GEQ_TWO = 100134,
-
- /* Tessellation properties */
- GLU_TESS_WINDING_RULE = 100140,
- GLU_TESS_BOUNDARY_ONLY = 100141,
- GLU_TESS_TOLERANCE = 100142,
-
- /* Tessellation errors */
- GLU_TESS_ERROR1 = 100151, /* Missing gluBeginPolygon */
- GLU_TESS_ERROR2 = 100152, /* Missing gluBeginContour */
- GLU_TESS_ERROR3 = 100153, /* Missing gluEndPolygon */
- GLU_TESS_ERROR4 = 100154, /* Missing gluEndContour */
- GLU_TESS_ERROR5 = 100155, /* */
- GLU_TESS_ERROR6 = 100156, /* */
- GLU_TESS_ERROR7 = 100157, /* */
- GLU_TESS_ERROR8 = 100158, /* */
-
- /* NURBS */
- GLU_AUTO_LOAD_MATRIX = 100200,
- GLU_CULLING = 100201,
- GLU_PARAMETRIC_TOLERANCE= 100202,
- GLU_SAMPLING_TOLERANCE = 100203,
- GLU_DISPLAY_MODE = 100204,
- GLU_SAMPLING_METHOD = 100205,
- GLU_U_STEP = 100206,
- GLU_V_STEP = 100207,
-
- GLU_PATH_LENGTH = 100215,
- GLU_PARAMETRIC_ERROR = 100216,
- GLU_DOMAIN_DISTANCE = 100217,
-
- GLU_MAP1_TRIM_2 = 100210,
- GLU_MAP1_TRIM_3 = 100211,
-
- GLU_OUTLINE_POLYGON = 100240,
- GLU_OUTLINE_PATCH = 100241,
-
- GLU_NURBS_ERROR1 = 100251, /* spline order un-supported */
- GLU_NURBS_ERROR2 = 100252, /* too few knots */
- GLU_NURBS_ERROR3 = 100253, /* valid knot range is empty */
- GLU_NURBS_ERROR4 = 100254, /* decreasing knot sequence */
- GLU_NURBS_ERROR5 = 100255, /* knot multiplicity > spline order */
- GLU_NURBS_ERROR6 = 100256, /* endcurve() must follow bgncurve() */
- GLU_NURBS_ERROR7 = 100257, /* bgncurve() must precede endcurve() */
- GLU_NURBS_ERROR8 = 100258, /* ctrlarray or knot vector is NULL */
- GLU_NURBS_ERROR9 = 100259, /* can't draw pwlcurves */
- GLU_NURBS_ERROR10 = 100260, /* missing gluNurbsCurve() */
- GLU_NURBS_ERROR11 = 100261, /* missing gluNurbsSurface() */
- GLU_NURBS_ERROR12 = 100262, /* endtrim() must precede endsurface() */
- GLU_NURBS_ERROR13 = 100263, /* bgnsurface() must precede endsurface() */
- GLU_NURBS_ERROR14 = 100264, /* curve of improper type passed as trim curve */
- GLU_NURBS_ERROR15 = 100265, /* bgnsurface() must precede bgntrim() */
- GLU_NURBS_ERROR16 = 100266, /* endtrim() must follow bgntrim() */
- GLU_NURBS_ERROR17 = 100267, /* bgntrim() must precede endtrim()*/
- GLU_NURBS_ERROR18 = 100268, /* invalid or missing trim curve*/
- GLU_NURBS_ERROR19 = 100269, /* bgntrim() must precede pwlcurve() */
- GLU_NURBS_ERROR20 = 100270, /* pwlcurve referenced twice*/
- GLU_NURBS_ERROR21 = 100271, /* pwlcurve and nurbscurve mixed */
- GLU_NURBS_ERROR22 = 100272, /* improper usage of trim data type */
- GLU_NURBS_ERROR23 = 100273, /* nurbscurve referenced twice */
- GLU_NURBS_ERROR24 = 100274, /* nurbscurve and pwlcurve mixed */
- GLU_NURBS_ERROR25 = 100275, /* nurbssurface referenced twice */
- GLU_NURBS_ERROR26 = 100276, /* invalid property */
- GLU_NURBS_ERROR27 = 100277, /* endsurface() must follow bgnsurface() */
- GLU_NURBS_ERROR28 = 100278, /* intersecting or misoriented trim curves */
- GLU_NURBS_ERROR29 = 100279, /* intersecting trim curves */
- GLU_NURBS_ERROR30 = 100280, /* UNUSED */
- GLU_NURBS_ERROR31 = 100281, /* unconnected trim curves */
- GLU_NURBS_ERROR32 = 100282, /* unknown knot error */
- GLU_NURBS_ERROR33 = 100283, /* negative vertex count encountered */
- GLU_NURBS_ERROR34 = 100284, /* negative byte-stride */
- GLU_NURBS_ERROR35 = 100285, /* unknown type descriptor */
- GLU_NURBS_ERROR36 = 100286, /* null control point reference */
- GLU_NURBS_ERROR37 = 100287, /* duplicate point on pwlcurve */
-
- /* Errors */
- GLU_INVALID_ENUM = 100900,
- GLU_INVALID_VALUE = 100901,
- GLU_OUT_OF_MEMORY = 100902,
- GLU_INCOMPATIBLE_GL_VERSION = 100903,
-
- /* New in GLU 1.1 */
- GLU_VERSION = 100800,
- GLU_EXTENSIONS = 100801,
-
- /*** GLU 1.0 tessellation - obsolete! ***/
-
- /* Contour types */
- GLU_CW = 100120,
- GLU_CCW = 100121,
- GLU_INTERIOR = 100122,
- GLU_EXTERIOR = 100123,
- GLU_UNKNOWN = 100124,
-
- /* Tessellator */
- GLU_BEGIN = GLU_TESS_BEGIN,
- GLU_VERTEX = GLU_TESS_VERTEX,
- GLU_END = GLU_TESS_END,
- GLU_ERROR = GLU_TESS_ERROR,
- 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_EXT_get_proc_address extension
- */
- /*
- * WARNING: this extension is not finalized yet! Do not release code
- * which uses this extension yet! It may change!
- */
- #define GLU_EXT_get_proc_address 1
- #ifdef GLU_EXT_get_proc_address
- GLUAPI void (GLAPIENTRY *gluGetProcAddressEXT(const GLubyte *procName))();
- #endif
-
-
- #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
-