4c221b0da1816acf2ca302b10092df059484468dvboxsync/*
4c221b0da1816acf2ca302b10092df059484468dvboxsync * Mesa 3-D graphics library
4c221b0da1816acf2ca302b10092df059484468dvboxsync * Version: 7.1
4c221b0da1816acf2ca302b10092df059484468dvboxsync *
4c221b0da1816acf2ca302b10092df059484468dvboxsync * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
4c221b0da1816acf2ca302b10092df059484468dvboxsync *
4c221b0da1816acf2ca302b10092df059484468dvboxsync * Permission is hereby granted, free of charge, to any person obtaining a
4c221b0da1816acf2ca302b10092df059484468dvboxsync * copy of this software and associated documentation files (the "Software"),
4c221b0da1816acf2ca302b10092df059484468dvboxsync * to deal in the Software without restriction, including without limitation
4c221b0da1816acf2ca302b10092df059484468dvboxsync * the rights to use, copy, modify, merge, publish, distribute, sublicense,
4c221b0da1816acf2ca302b10092df059484468dvboxsync * and/or sell copies of the Software, and to permit persons to whom the
4c221b0da1816acf2ca302b10092df059484468dvboxsync * Software is furnished to do so, subject to the following conditions:
4c221b0da1816acf2ca302b10092df059484468dvboxsync *
4c221b0da1816acf2ca302b10092df059484468dvboxsync * The above copyright notice and this permission notice shall be included
4c221b0da1816acf2ca302b10092df059484468dvboxsync * in all copies or substantial portions of the Software.
4c221b0da1816acf2ca302b10092df059484468dvboxsync *
4c221b0da1816acf2ca302b10092df059484468dvboxsync * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
4c221b0da1816acf2ca302b10092df059484468dvboxsync * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
4c221b0da1816acf2ca302b10092df059484468dvboxsync * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
4c221b0da1816acf2ca302b10092df059484468dvboxsync * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
4c221b0da1816acf2ca302b10092df059484468dvboxsync * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
4c221b0da1816acf2ca302b10092df059484468dvboxsync * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
4c221b0da1816acf2ca302b10092df059484468dvboxsync */
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync/**
4c221b0da1816acf2ca302b10092df059484468dvboxsync * \mainpage Mesa GL API Module
4c221b0da1816acf2ca302b10092df059484468dvboxsync *
4c221b0da1816acf2ca302b10092df059484468dvboxsync * \section GLAPIIntroduction Introduction
4c221b0da1816acf2ca302b10092df059484468dvboxsync *
4c221b0da1816acf2ca302b10092df059484468dvboxsync * The Mesa GL API module is responsible for dispatching all the
4c221b0da1816acf2ca302b10092df059484468dvboxsync * gl*() functions. All GL functions are dispatched by jumping through
4c221b0da1816acf2ca302b10092df059484468dvboxsync * the current dispatch table (basically a struct full of function
4c221b0da1816acf2ca302b10092df059484468dvboxsync * pointers.)
4c221b0da1816acf2ca302b10092df059484468dvboxsync *
4c221b0da1816acf2ca302b10092df059484468dvboxsync * A per-thread current dispatch table and per-thread current context
4c221b0da1816acf2ca302b10092df059484468dvboxsync * pointer are managed by this module too.
4c221b0da1816acf2ca302b10092df059484468dvboxsync *
4c221b0da1816acf2ca302b10092df059484468dvboxsync * This module is intended to be non-Mesa-specific so it can be used
4c221b0da1816acf2ca302b10092df059484468dvboxsync * with the X/DRI libGL also.
4c221b0da1816acf2ca302b10092df059484468dvboxsync */
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync#ifndef _GLAPI_H
4c221b0da1816acf2ca302b10092df059484468dvboxsync#define _GLAPI_H
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync#define GL_GLEXT_PROTOTYPES
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync#include "GL/gl.h"
4c221b0da1816acf2ca302b10092df059484468dvboxsync#include "GL/glext.h"
4c221b0da1816acf2ca302b10092df059484468dvboxsync#include "glthread.h"
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncstruct _glapi_table;
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsynctypedef void (*_glapi_proc)(void); /* generic function pointer */
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsynctypedef void (*_glapi_warning_func)(void *ctx, const char *str, ...);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync#if defined(USE_MGL_NAMESPACE)
4c221b0da1816acf2ca302b10092df059484468dvboxsync#define _glapi_set_dispatch _mglapi_set_dispatch
4c221b0da1816acf2ca302b10092df059484468dvboxsync#define _glapi_get_dispatch _mglapi_get_dispatch
4c221b0da1816acf2ca302b10092df059484468dvboxsync#define _glapi_set_context _mglapi_set_context
4c221b0da1816acf2ca302b10092df059484468dvboxsync#define _glapi_get_context _mglapi_get_context
4c221b0da1816acf2ca302b10092df059484468dvboxsync#define _glapi_Context _mglapi_Context
4c221b0da1816acf2ca302b10092df059484468dvboxsync#define _glapi_Dispatch _mglapi_Dispatch
4c221b0da1816acf2ca302b10092df059484468dvboxsync#endif
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync/*
4c221b0da1816acf2ca302b10092df059484468dvboxsync * Number of extension functions which we can dynamically add at runtime.
4c221b0da1816acf2ca302b10092df059484468dvboxsync */
4c221b0da1816acf2ca302b10092df059484468dvboxsync#define MAX_EXTENSION_FUNCS 300
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync/**
4c221b0da1816acf2ca302b10092df059484468dvboxsync ** Define the GET_CURRENT_CONTEXT() macro.
4c221b0da1816acf2ca302b10092df059484468dvboxsync ** \param C local variable which will hold the current context.
4c221b0da1816acf2ca302b10092df059484468dvboxsync **/
4c221b0da1816acf2ca302b10092df059484468dvboxsync#if defined (GLX_USE_TLS)
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncconst extern void *_glapi_Context;
4c221b0da1816acf2ca302b10092df059484468dvboxsyncconst extern struct _glapi_table *_glapi_Dispatch;
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern __thread void * _glapi_tls_Context
4c221b0da1816acf2ca302b10092df059484468dvboxsync __attribute__((tls_model("initial-exec")));
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync# define GET_CURRENT_CONTEXT(C) GLcontext *C = (GLcontext *) _glapi_tls_Context
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync#else
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern void *_glapi_Context;
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern struct _glapi_table *_glapi_Dispatch;
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync# ifdef THREADS
4c221b0da1816acf2ca302b10092df059484468dvboxsync# define GET_CURRENT_CONTEXT(C) GLcontext *C = (GLcontext *) (_glapi_Context ? _glapi_Context : _glapi_get_context())
4c221b0da1816acf2ca302b10092df059484468dvboxsync# else
4c221b0da1816acf2ca302b10092df059484468dvboxsync# define GET_CURRENT_CONTEXT(C) GLcontext *C = (GLcontext *) _glapi_Context
4c221b0da1816acf2ca302b10092df059484468dvboxsync# endif
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync#endif /* defined (GLX_USE_TLS) */
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync/**
4c221b0da1816acf2ca302b10092df059484468dvboxsync ** GL API public functions
4c221b0da1816acf2ca302b10092df059484468dvboxsync **/
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern void
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_noop_enable_warnings(GLboolean enable);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern void
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_set_warning_func(_glapi_warning_func func);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern void
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_check_multithread(void);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern void
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_set_context(void *context);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern void *
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_get_context(void);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern void
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_set_dispatch(struct _glapi_table *dispatch);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern struct _glapi_table *
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_get_dispatch(void);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern int
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_begin_dispatch_override(struct _glapi_table *override);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern void
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_end_dispatch_override(int layer);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncstruct _glapi_table *
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_get_override_dispatch(int layer);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern GLuint
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_get_dispatch_table_size(void);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern void
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_check_table(const struct _glapi_table *table);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern int
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_add_dispatch( const char * const * function_names,
4c221b0da1816acf2ca302b10092df059484468dvboxsync const char * parameter_signature );
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern GLint
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_get_proc_offset(const char *funcName);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern _glapi_proc
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_get_proc_address(const char *funcName);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsyncextern const char *
4c221b0da1816acf2ca302b10092df059484468dvboxsync_glapi_get_proc_name(GLuint offset);
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync
4c221b0da1816acf2ca302b10092df059484468dvboxsync#endif