Debian Codegraph @

nx-X11/extras/Mesa/src/mesa/glapi/glapi.h

raw
1 /*
2 * Mesa 3-D graphics library
3 * Version: 6.3
4 *
5 * Copyright (C) 1999-2004 Brian Paul All Rights Reserved.
6 *
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the "Software"),
9 * to deal in the Software without restriction, including without limitation
10 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
13 *
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
16 *
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
21 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
22 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
23 */
24
25
26 /**
27 * \mainpage Mesa GL API Module
28 *
29 * \section GLAPIIntroduction Introduction
30 *
31 * The Mesa GL API module is responsible for dispatching all the
32 * gl*() functions. All GL functions are dispatched by jumping through
33 * the current dispatch table (basically a struct full of function
34 * pointers.)
35 *
36 * A per-thread current dispatch table and per-thread current context
37 * pointer are managed by this module too.
38 *
39 * This module is intended to be non-Mesa-specific so it can be used
40 * with the X/DRI libGL also.
41 */
42
43
44 #ifndef _GLAPI_H
45 #define _GLAPI_H
46
47
48 #include "GL/gl.h"
49 #include "glapitable.h"
50
51 typedef void (*_glapi_warning_func)(void *ctx, const char *str, ...);
52
53
54 #if defined (GLX_USE_TLS)
55
56 const extern void *_glapi_Context;
57 const extern struct _glapi_table *_glapi_Dispatch;
58
59 extern __thread void * _glapi_tls_Context
60 __attribute__((tls_model("initial-exec")));
61
62 # define GET_CURRENT_CONTEXT(C) GLcontext *C = (GLcontext *) _glapi_tls_Context
63
64 #else
65
66 extern void *_glapi_Context;
67 extern struct _glapi_table *_glapi_Dispatch;
68
69 /**
70 * Macro for declaration and fetching the current context.
71 *
72 * \param C local variable which will hold the current context.
73 *
74 * It should be used in the variable declaration area of a function:
75 * \code
76 * ...
77 * {
78 * GET_CURRENT_CONTEXT(ctx);
79 * ...
80 * \endcode
81 */
82 # ifdef THREADS
83 # define GET_CURRENT_CONTEXT(C) GLcontext *C = (GLcontext *) (_glapi_Context ? _glapi_Context : _glapi_get_context())
84 # else
85 # define GET_CURRENT_CONTEXT(C) GLcontext *C = (GLcontext *) _glapi_Context
86 # endif
87
88 #endif /* defined (GLX_USE_TLS) */
89
90 extern void
91 _glapi_noop_enable_warnings(GLboolean enable);
92
93 extern void
94 _glapi_set_warning_func(_glapi_warning_func func);
95
96 extern void
97 _glapi_check_multithread(void);
98
99
100 extern void
101 _glapi_set_context(void *context);
102
103
104 extern void *
105 _glapi_get_context(void);
106
107
108 extern void
109 _glapi_set_dispatch(struct _glapi_table *dispatch);
110
111
112 extern struct _glapi_table *
113 _glapi_get_dispatch(void);
114
115
116 extern int
117 _glapi_begin_dispatch_override(struct _glapi_table *override);
118
119
120 extern void
121 _glapi_end_dispatch_override(int layer);
122
123
124 struct _glapi_table *
125 _glapi_get_override_dispatch(int layer);
126
127
128 extern GLuint
129 _glapi_get_dispatch_table_size(void);
130
131
132 extern void
133 _glapi_check_table(const struct _glapi_table *table);
134
135
136 extern int
137 _glapi_add_dispatch( const char * const * function_names,
138 const char * parameter_signature );
139
140 extern GLint
141 _glapi_get_proc_offset(const char *funcName);
142
143
144 extern _glapi_proc
145 _glapi_get_proc_address(const char *funcName);
146
147
148 extern const char *
149 _glapi_get_proc_name(GLuint offset);
150
151
152 #endif