X-Git-Url: https://git.libre-soc.org/?a=blobdiff_plain;f=src%2Fmesa%2Fglapi%2Fglapi.h;h=c334203394f1203487316124662a792685c512e2;hb=c212abf99af494f024b0b981a83350f7ac9821ef;hp=e1114820faad4d7d279f33cdd7db81672bc35eac;hpb=bb72d326a0c5f24a05bb586d64fbacc6b8172048;p=mesa.git diff --git a/src/mesa/glapi/glapi.h b/src/mesa/glapi/glapi.h index e1114820faa..c334203394f 100644 --- a/src/mesa/glapi/glapi.h +++ b/src/mesa/glapi/glapi.h @@ -1,10 +1,8 @@ -/* $Id: glapi.h,v 1.9 1999/12/16 17:31:59 brianp Exp $ */ - /* * Mesa 3-D graphics library - * Version: 3.3 + * Version: 6.3 * - * Copyright (C) 1999 Brian Paul All Rights Reserved. + * Copyright (C) 1999-2004 Brian Paul All Rights Reserved. * * Permission is hereby granted, free of charge, to any person obtaining a * copy of this software and associated documentation files (the "Software"), @@ -25,20 +23,91 @@ */ +/** + * \mainpage Mesa GL API Module + * + * \section GLAPIIntroduction Introduction + * + * The Mesa GL API module is responsible for dispatching all the + * gl*() functions. All GL functions are dispatched by jumping through + * the current dispatch table (basically a struct full of function + * pointers.) + * + * A per-thread current dispatch table and per-thread current context + * pointer are managed by this module too. + * + * This module is intended to be non-Mesa-specific so it can be used + * with the X/DRI libGL also. + */ + + #ifndef _GLAPI_H #define _GLAPI_H #include "GL/gl.h" -/*#include "glapitable.h"*/ struct _glapi_table; +typedef void (*_glapi_warning_func)(void *ctx, const char *str, ...); + +typedef void (*_glapi_proc)(void); /* generic function pointer */ + + +#if defined (GLX_USE_TLS) + +const extern void *_glapi_Context; +const extern struct _glapi_table *_glapi_Dispatch; + +extern __thread void * _glapi_tls_Context + __attribute__((tls_model("initial-exec"))); + +# define GET_CURRENT_CONTEXT(C) GLcontext *C = (GLcontext *) _glapi_tls_Context + +#else + +extern void *_glapi_Context; +extern struct _glapi_table *_glapi_Dispatch; + +/** + * Macro for declaration and fetching the current context. + * + * \param C local variable which will hold the current context. + * + * It should be used in the variable declaration area of a function: + * \code + * ... + * { + * GET_CURRENT_CONTEXT(ctx); + * ... + * \endcode + */ +# ifdef THREADS +# define GET_CURRENT_CONTEXT(C) GLcontext *C = (GLcontext *) (_glapi_Context ? _glapi_Context : _glapi_get_context()) +# else +# define GET_CURRENT_CONTEXT(C) GLcontext *C = (GLcontext *) _glapi_Context +# endif + +#endif /* defined (GLX_USE_TLS) */ + +extern void +_glapi_noop_enable_warnings(GLboolean enable); + +extern void +_glapi_set_warning_func(_glapi_warning_func func); extern void _glapi_check_multithread(void); +extern void +_glapi_set_context(void *context); + + +extern void * +_glapi_get_context(void); + + extern void _glapi_set_dispatch(struct _glapi_table *dispatch); @@ -47,6 +116,18 @@ extern struct _glapi_table * _glapi_get_dispatch(void); +extern int +_glapi_begin_dispatch_override(struct _glapi_table *override); + + +extern void +_glapi_end_dispatch_override(int layer); + + +struct _glapi_table * +_glapi_get_override_dispatch(int layer); + + extern GLuint _glapi_get_dispatch_table_size(void); @@ -67,7 +148,7 @@ extern GLint _glapi_get_proc_offset(const char *funcName); -extern const GLvoid * +extern _glapi_proc _glapi_get_proc_address(const char *funcName);