2 * Mesa 3-D graphics library
4 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
5 * Copyright (C) 2010 LunarG Inc.
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:
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
18 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
21 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
22 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
23 * DEALINGS IN THE SOFTWARE.
26 * Chia-I Wu <olv@lunarg.com>
31 #include "glapi/glapi.h"
32 #include "u_current.h"
33 #include "table.h" /* for MAPI_TABLE_NUM_SLOTS */
37 * Global variables, _glapi_get_context, and _glapi_get_dispatch are defined in
42 /* not used, but defined for compatibility */
43 const struct _glapi_table
*_glapi_Dispatch
;
44 const void *_glapi_Context
;
45 #endif /* GLX_USE_TLS */
48 _glapi_destroy_multithread(void)
54 _glapi_check_multithread(void)
60 _glapi_set_context(void *context
)
62 u_current_set_context((const void *) context
);
66 _glapi_set_dispatch(struct _glapi_table
*dispatch
)
68 u_current_set_table((const struct mapi_table
*) dispatch
);
72 * Return size of dispatch table struct as number of functions (or
76 _glapi_get_dispatch_table_size(void)
78 return MAPI_TABLE_NUM_SLOTS
;
82 * Fill-in the dispatch stub for the named function.
84 * This function is intended to be called by a hardware driver. When called,
85 * a dispatch stub may be created created for the function. A pointer to this
86 * dispatch function will be returned by glXGetProcAddress.
88 * \param function_names Array of pointers to function names that should
89 * share a common dispatch offset.
90 * \param parameter_signature String representing the types of the parameters
91 * passed to the named function. Parameter types
92 * are converted to characters using the following
94 * - 'i' for \c GLint, \c GLuint, and \c GLenum
95 * - 'p' for any pointer type
96 * - 'f' for \c GLfloat and \c GLclampf
97 * - 'd' for \c GLdouble and \c GLclampd
100 * The offset in the dispatch table of the named function. A pointer to the
101 * driver's implementation of the named function should be stored at
102 * \c dispatch_table[\c offset]. Return -1 if error/problem.
104 * \sa glXGetProcAddress
107 * This function can only handle up to 8 names at a time. As far as I know,
108 * the maximum number of names ever associated with an existing GL function is
109 * 4 (\c glPointParameterfSGIS, \c glPointParameterfEXT,
110 * \c glPointParameterfARB, and \c glPointParameterf), so this should not be
111 * too painful of a limitation.
114 * Check parameter_signature.
117 _glapi_add_dispatch( const char * const * function_names
,
118 const char * parameter_signature
)
120 const struct mapi_stub
*function_stubs
[8];
121 const struct mapi_stub
*alias
= NULL
;
124 (void) memset(function_stubs
, 0, sizeof(function_stubs
));
126 /* find the missing stubs, and decide the alias */
127 for (i
= 0; function_names
[i
] != NULL
&& i
< 8; i
++) {
128 const char * funcName
= function_names
[i
];
129 const struct mapi_stub
*stub
;
132 if (!funcName
|| funcName
[0] != 'g' || funcName
[1] != 'l')
136 stub
= stub_find_public(funcName
);
138 stub
= stub_find_dynamic(funcName
, 0);
140 slot
= (stub
) ? stub_get_slot(stub
) : -1;
142 if (alias
&& stub_get_slot(alias
) != slot
)
144 /* use the first existing stub as the alias */
148 function_stubs
[i
] = stub
;
152 /* generate missing stubs */
153 for (i
= 0; function_names
[i
] != NULL
&& i
< 8; i
++) {
154 const char * funcName
= function_names
[i
] + 2;
155 struct mapi_stub
*stub
;
157 if (function_stubs
[i
])
160 stub
= stub_find_dynamic(funcName
, 1);
164 stub_fix_dynamic(stub
, alias
);
169 return (alias
) ? stub_get_slot(alias
) : -1;
172 static const struct mapi_stub
*
173 _glapi_get_stub(const char *name
, int generate
)
175 const struct mapi_stub
*stub
;
177 #ifdef USE_MGL_NAMESPACE
178 if (name
&& name
[0] == 'm')
182 if (!name
|| name
[0] != 'g' || name
[1] != 'l')
186 stub
= stub_find_public(name
);
188 stub
= stub_find_dynamic(name
, generate
);
194 * Return offset of entrypoint for named function within dispatch table.
197 _glapi_get_proc_offset(const char *funcName
)
199 const struct mapi_stub
*stub
= _glapi_get_stub(funcName
, 0);
200 return (stub
) ? stub_get_slot(stub
) : -1;
204 * Return pointer to the named function. If the function name isn't found
205 * in the name of static functions, try generating a new API entrypoint on
206 * the fly with assembly language.
209 _glapi_get_proc_address(const char *funcName
)
211 const struct mapi_stub
*stub
= _glapi_get_stub(funcName
, 1);
212 return (stub
) ? (_glapi_proc
) stub_get_addr(stub
) : NULL
;
216 * Return the name of the function at the given dispatch offset.
217 * This is only intended for debugging.
220 _glapi_get_proc_name(unsigned int offset
)
222 const struct mapi_stub
*stub
= stub_find_by_slot(offset
);
223 return stub
? stub_get_name(stub
) : NULL
;
226 /** Return pointer to new dispatch table filled with no-op functions */
227 struct _glapi_table
*
228 _glapi_new_nop_table(unsigned num_entries
)
230 struct _glapi_table
*table
;
232 if (num_entries
> MAPI_TABLE_NUM_SLOTS
)
233 num_entries
= MAPI_TABLE_NUM_SLOTS
;
235 table
= malloc(num_entries
* sizeof(mapi_func
));
237 memcpy(table
, table_noop_array
, num_entries
* sizeof(mapi_func
));
243 _glapi_set_nop_handler(_glapi_nop_handler_proc func
)
245 table_set_noop_handler(func
);
249 * This is a deprecated function which should not be used anymore.
250 * It's only present to satisfy linking with older versions of libGL.
253 _glthread_GetID(void)
259 _glapi_noop_enable_warnings(unsigned char enable
)
264 _glapi_set_warning_func(_glapi_proc func
)