1/* 2 * Mesa 3-D graphics library 3 * 4 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved. 5 * 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: 12 * 13 * The above copyright notice and this permission notice shall be included 14 * in all copies or substantial portions of the Software. 15 * 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. 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#include "util/macros.h" 48#include "util/u_thread.h" 49#include "util/detect_os.h" 50 51 52#ifdef __cplusplus 53extern "C" { 54#endif 55 56 57#ifdef _GLAPI_NO_EXPORTS 58# define _GLAPI_EXPORT 59#else /* _GLAPI_NO_EXPORTS */ 60# ifdef _WIN32 61# ifdef _GLAPI_DLL_EXPORTS 62# define _GLAPI_EXPORT __declspec(dllexport) 63# else 64# define _GLAPI_EXPORT __declspec(dllimport) 65# endif 66# elif defined(__GNUC__) 67# define _GLAPI_EXPORT __attribute__((visibility("default"))) 68# else 69# define _GLAPI_EXPORT 70# endif 71#endif /* _GLAPI_NO_EXPORTS */ 72 73 74typedef void (*_glapi_proc)(void); 75 76typedef void (*_glapi_nop_handler_proc)(const char *name); 77 78struct _glapi_table; 79 80#if DETECT_OS_WINDOWS 81extern __THREAD_INITIAL_EXEC struct _glapi_table * _glapi_tls_Dispatch; 82extern __THREAD_INITIAL_EXEC void * _glapi_tls_Context; 83#else 84_GLAPI_EXPORT extern __THREAD_INITIAL_EXEC struct _glapi_table * _glapi_tls_Dispatch; 85_GLAPI_EXPORT extern __THREAD_INITIAL_EXEC void * _glapi_tls_Context; 86#endif 87 88_GLAPI_EXPORT extern const struct _glapi_table *_glapi_Dispatch; 89_GLAPI_EXPORT extern const void *_glapi_Context; 90 91#if DETECT_OS_WINDOWS && !defined(MAPI_MODE_UTIL) && !defined(MAPI_MODE_GLAPI) 92# define GET_DISPATCH() _glapi_get_dispatch() 93# define GET_CURRENT_CONTEXT(C) struct gl_context *C = (struct gl_context *) _glapi_get_context() 94#else 95# define GET_DISPATCH() _glapi_tls_Dispatch 96# define GET_CURRENT_CONTEXT(C) struct gl_context *C = (struct gl_context *) _glapi_tls_Context 97#endif 98 99_GLAPI_EXPORT void 100_glapi_destroy_multithread(void); 101 102 103_GLAPI_EXPORT void 104_glapi_check_multithread(void); 105 106 107_GLAPI_EXPORT void 108_glapi_set_context(void *context); 109 110 111_GLAPI_EXPORT void * 112_glapi_get_context(void); 113 114 115_GLAPI_EXPORT void 116_glapi_set_dispatch(struct _glapi_table *dispatch); 117 118 119_GLAPI_EXPORT struct _glapi_table * 120_glapi_get_dispatch(void); 121 122 123_GLAPI_EXPORT unsigned int 124_glapi_get_dispatch_table_size(void); 125 126 127_GLAPI_EXPORT int 128_glapi_add_dispatch( const char * const * function_names, 129 const char * parameter_signature ); 130 131_GLAPI_EXPORT int 132_glapi_get_proc_offset(const char *funcName); 133 134 135_GLAPI_EXPORT _glapi_proc 136_glapi_get_proc_address(const char *funcName); 137 138 139_GLAPI_EXPORT const char * 140_glapi_get_proc_name(unsigned int offset); 141 142 143#if defined(GLX_USE_APPLEGL) || defined(GLX_USE_WINDOWSGL) 144_GLAPI_EXPORT struct _glapi_table * 145_glapi_create_table_from_handle(void *handle, const char *symbol_prefix); 146 147_GLAPI_EXPORT void 148_glapi_table_patch(struct _glapi_table *, const char *name, void *wrapper); 149#endif 150 151 152_GLAPI_EXPORT void 153_glapi_set_nop_handler(_glapi_nop_handler_proc func); 154 155/** Return pointer to new dispatch table filled with no-op functions */ 156_GLAPI_EXPORT struct _glapi_table * 157_glapi_new_nop_table(unsigned num_entries); 158 159 160/** Deprecated function */ 161_GLAPI_EXPORT unsigned long 162_glthread_GetID(void); 163 164 165/* 166 * These stubs are kept so that the old DRI drivers still load. 167 */ 168_GLAPI_EXPORT void 169_glapi_noop_enable_warnings(unsigned char enable); 170 171 172_GLAPI_EXPORT void 173_glapi_set_warning_func(_glapi_proc func); 174 175 176#ifdef __cplusplus 177} 178#endif 179 180#endif /* _GLAPI_H */ 181