2 * Mesa 3-D graphics library
4 * Copyright (C) 1999-2004 Brian Paul All Rights Reserved.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the "Software"),
8 * to deal in the Software without restriction, including without limitation
9 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
10 * and/or sell copies of the Software, and to permit persons to whom the
11 * Software is furnished to do so, subject to the following conditions:
13 * The above copyright notice and this permission notice shall be included
14 * in all copies or substantial portions of the Software.
16 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
17 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
18 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
19 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
20 * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
21 * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
22 * OTHER DEALINGS IN THE SOFTWARE.
27 * \file glapi_dispatch.c
29 * This file generates all the gl* function entrypoints. This code is not
30 * used if optimized assembly stubs are available (e.g., using
31 * glapi/glapi_x86.S on IA32 or glapi/glapi_sparc.S on SPARC).
34 * This file is also used to build the client-side libGL that loads DRI-based
35 * device drivers. At build-time it is symlinked to src/glx.
37 * \author Brian Paul <brian@precisioninsight.com>
40 #include "glapi/glapi_priv.h"
41 #include "glapitable.h"
44 #if !(defined(USE_X86_ASM) || defined(USE_X86_64_ASM) || defined(USE_SPARC_ASM))
47 #define KEYWORD1 GLAPI
49 #define KEYWORD1 PUBLIC
52 #define KEYWORD2 GLAPIENTRY
54 #define NAME(func) gl##func
56 #if 0 /* Use this to log GL calls to stdout (for DEBUG only!) */
59 #define DISPATCH(FUNC, ARGS, MESSAGE) \
61 GET_DISPATCH()->FUNC ARGS
63 #define RETURN_DISPATCH(FUNC, ARGS, MESSAGE) \
65 return GET_DISPATCH()->FUNC ARGS
69 #define DISPATCH(FUNC, ARGS, MESSAGE) \
70 GET_DISPATCH()->FUNC ARGS
72 #define RETURN_DISPATCH(FUNC, ARGS, MESSAGE) \
73 return GET_DISPATCH()->FUNC ARGS
82 #ifdef GLX_INDIRECT_RENDERING
83 /* those link to libglapi.a should provide the entry points */
84 #define _GLAPI_SKIP_PROTO_ENTRY_POINTS
87 /* These prototypes are necessary because GLES1 library builds will create
88 * dispatch functions for them. We can't directly include GLES/gl.h because
89 * it would conflict the previously-included GL/gl.h. Since GLES1 ABI is not
90 * expected to every add more functions, the path of least resistance is to
91 * just duplicate the prototypes for the functions that aren't already in
94 #include <GLES/glplatform.h>
97 /* Redefine GL_API to avoid MSVC/MinGW warnings about different dllimport
98 * attributes for these prototypes vs those in the GLES/gl.h header.
101 #define GL_API KEYWORD1
103 GL_API
void GL_APIENTRY
glClearDepthf (GLclampf depth
);
104 GL_API
void GL_APIENTRY
glClipPlanef (GLenum plane
, const GLfloat
*equation
);
105 GL_API
void GL_APIENTRY
glFrustumf (GLfloat left
, GLfloat right
, GLfloat bottom
, GLfloat top
, GLfloat zNear
, GLfloat zFar
);
106 GL_API
void GL_APIENTRY
glGetClipPlanef (GLenum pname
, GLfloat eqn
[4]);
107 GL_API
void GL_APIENTRY
glOrthof (GLfloat left
, GLfloat right
, GLfloat bottom
, GLfloat top
, GLfloat zNear
, GLfloat zFar
);
109 GL_API
void GL_APIENTRY
glAlphaFuncx (GLenum func
, GLclampx ref
);
110 GL_API
void GL_APIENTRY
glClearColorx (GLclampx red
, GLclampx green
, GLclampx blue
, GLclampx alpha
);
111 GL_API
void GL_APIENTRY
glClearDepthx (GLclampx depth
);
112 GL_API
void GL_APIENTRY
glClipPlanex (GLenum plane
, const GLfixed
*equation
);
113 GL_API
void GL_APIENTRY
glColor4x (GLfixed red
, GLfixed green
, GLfixed blue
, GLfixed alpha
);
114 GL_API
void GL_APIENTRY
glDepthRangex (GLclampx zNear
, GLclampx zFar
);
115 GL_API
void GL_APIENTRY
glFogx (GLenum pname
, GLfixed param
);
116 GL_API
void GL_APIENTRY
glFogxv (GLenum pname
, const GLfixed
*params
);
117 GL_API
void GL_APIENTRY
glFrustumx (GLfixed left
, GLfixed right
, GLfixed bottom
, GLfixed top
, GLfixed zNear
, GLfixed zFar
);
118 GL_API
void GL_APIENTRY
glGetClipPlanex (GLenum pname
, GLfixed eqn
[4]);
119 GL_API
void GL_APIENTRY
glGetFixedv (GLenum pname
, GLfixed
*params
);
120 GL_API
void GL_APIENTRY
glGetLightxv (GLenum light
, GLenum pname
, GLfixed
*params
);
121 GL_API
void GL_APIENTRY
glGetMaterialxv (GLenum face
, GLenum pname
, GLfixed
*params
);
122 GL_API
void GL_APIENTRY
glGetTexEnvxv (GLenum env
, GLenum pname
, GLfixed
*params
);
123 GL_API
void GL_APIENTRY
glGetTexParameterxv (GLenum target
, GLenum pname
, GLfixed
*params
);
124 GL_API
void GL_APIENTRY
glLightModelx (GLenum pname
, GLfixed param
);
125 GL_API
void GL_APIENTRY
glLightModelxv (GLenum pname
, const GLfixed
*params
);
126 GL_API
void GL_APIENTRY
glLightx (GLenum light
, GLenum pname
, GLfixed param
);
127 GL_API
void GL_APIENTRY
glLightxv (GLenum light
, GLenum pname
, const GLfixed
*params
);
128 GL_API
void GL_APIENTRY
glLineWidthx (GLfixed width
);
129 GL_API
void GL_APIENTRY
glLoadMatrixx (const GLfixed
*m
);
130 GL_API
void GL_APIENTRY
glMaterialx (GLenum face
, GLenum pname
, GLfixed param
);
131 GL_API
void GL_APIENTRY
glMaterialxv (GLenum face
, GLenum pname
, const GLfixed
*params
);
132 GL_API
void GL_APIENTRY
glMultMatrixx (const GLfixed
*m
);
133 GL_API
void GL_APIENTRY
glMultiTexCoord4x (GLenum target
, GLfixed s
, GLfixed t
, GLfixed r
, GLfixed q
);
134 GL_API
void GL_APIENTRY
glNormal3x (GLfixed nx
, GLfixed ny
, GLfixed nz
);
135 GL_API
void GL_APIENTRY
glOrthox (GLfixed left
, GLfixed right
, GLfixed bottom
, GLfixed top
, GLfixed zNear
, GLfixed zFar
);
136 GL_API
void GL_APIENTRY
glPointParameterx (GLenum pname
, GLfixed param
);
137 GL_API
void GL_APIENTRY
glPointParameterxv (GLenum pname
, const GLfixed
*params
);
138 GL_API
void GL_APIENTRY
glPointSizex (GLfixed size
);
139 GL_API
void GL_APIENTRY
glPolygonOffsetx (GLfixed factor
, GLfixed units
);
140 GL_API
void GL_APIENTRY
glRotatex (GLfixed angle
, GLfixed x
, GLfixed y
, GLfixed z
);
141 GL_API
void GL_APIENTRY
glSampleCoveragex (GLclampx value
, GLboolean invert
);
142 GL_API
void GL_APIENTRY
glScalex (GLfixed x
, GLfixed y
, GLfixed z
);
143 GL_API
void GL_APIENTRY
glTexEnvx (GLenum target
, GLenum pname
, GLfixed param
);
144 GL_API
void GL_APIENTRY
glTexEnvxv (GLenum target
, GLenum pname
, const GLfixed
*params
);
145 GL_API
void GL_APIENTRY
glTexParameterx (GLenum target
, GLenum pname
, GLfixed param
);
146 GL_API
void GL_APIENTRY
glTexParameterxv (GLenum target
, GLenum pname
, const GLfixed
*params
);
147 GL_API
void GL_APIENTRY
glTranslatex (GLfixed x
, GLfixed y
, GLfixed z
);
148 GL_API
void GL_APIENTRY
glPointSizePointerOES (GLenum type
, GLsizei stride
, const GLvoid
*pointer
);
149 GL_API
void GL_APIENTRY
glBlendBarrier (void);
150 GL_API
void GL_APIENTRY
glPrimitiveBoundingBox (GLfloat minX
, GLfloat minY
, GLfloat minZ
, GLfloat minW
, GLfloat maxX
, GLfloat maxY
, GLfloat maxZ
, GLfloat maxW
);
152 /* Enable frame pointer elimination on Windows, otherwise forgetting to add
153 * APIENTRY to _mesa_* entrypoints will not cause crashes on debug builds, as
154 * the initial ESP value is saved in the EBP in the function prologue, then
155 * restored on the epilogue, clobbering any corruption in the ESP pointer due
156 * to mismatch in the callee calling convention.
158 * On MSVC it's not sufficient to enable /Oy -- other optimizations must be
159 * enabled or frame pointer will be used regardless.
161 * We don't do this when NDEBUG is defined since, frame pointer omission
162 * optimization compiler flag are already specified on release builds, and
163 * because on profile builds we must have frame pointers or certain profilers
164 * might fail to unwind the stack.
166 #if defined(_WIN32) && !defined(NDEBUG)
167 # if defined(_MSC_VER)
168 # pragma optimize( "gty", on )
169 # elif defined(__GNUC__)
170 # pragma GCC optimize ("omit-frame-pointer")
174 #include "glapitemp.h"
176 #endif /* USE_X86_ASM */