Subversion Repositories shark

Rev

Rev 55 | Details | Compare with Previous | Last modification | View Log | RSS feed

Rev Author Line No. Line
55 pj 1
/* $Id: context.h,v 1.1 2003-02-28 11:41:59 pj Exp $ */
2
 
3
/*
4
 * Mesa 3-D graphics library
5
 * Version:  4.1
6
 *
7
 * Copyright (C) 1999-2001  Brian Paul   All Rights Reserved.
8
 *
9
 * Permission is hereby granted, free of charge, to any person obtaining a
10
 * copy of this software and associated documentation files (the "Software"),
11
 * to deal in the Software without restriction, including without limitation
12
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
13
 * and/or sell copies of the Software, and to permit persons to whom the
14
 * Software is furnished to do so, subject to the following conditions:
15
 *
16
 * The above copyright notice and this permission notice shall be included
17
 * in all copies or substantial portions of the Software.
18
 *
19
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
20
 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
21
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
22
 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
23
 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
24
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25
 */
26
 
27
 
28
#ifndef CONTEXT_H
29
#define CONTEXT_H
30
 
31
 
32
#include "glapi.h"
33
#include "mtypes.h"
34
 
35
 
36
/*
37
 * There are three Mesa datatypes which are meant to be used by device
38
 * drivers:
39
 *   GLcontext:  this contains the Mesa rendering state
40
 *   GLvisual:  this describes the color buffer (rgb vs. ci), whether
41
 *              or not there's a depth buffer, stencil buffer, etc.
42
 *   GLframebuffer:  contains pointers to the depth buffer, stencil
43
 *                   buffer, accum buffer and alpha buffers.
44
 *
45
 * These types should be encapsulated by corresponding device driver
46
 * datatypes.  See xmesa.h and xmesaP.h for an example.
47
 *
48
 * In OOP terms, GLcontext, GLvisual, and GLframebuffer are base classes
49
 * which the device driver must derive from.
50
 *
51
 * The following functions create and destroy these datatypes.
52
 */
53
 
54
 
55
/*
56
 * Create/destroy a GLvisual.
57
 */
58
extern GLvisual *
59
_mesa_create_visual( GLboolean rgbFlag,
60
                     GLboolean dbFlag,
61
                     GLboolean stereoFlag,
62
                     GLint redBits,
63
                     GLint greenBits,
64
                     GLint blueBits,
65
                     GLint alphaBits,
66
                     GLint indexBits,
67
                     GLint depthBits,
68
                     GLint stencilBits,
69
                     GLint accumRedBits,
70
                     GLint accumGreenBits,
71
                     GLint accumBlueBits,
72
                     GLint accumAlphaBits,
73
                     GLint numSamples );
74
 
75
extern GLboolean
76
_mesa_initialize_visual( GLvisual *v,
77
                         GLboolean rgbFlag,
78
                         GLboolean dbFlag,
79
                         GLboolean stereoFlag,
80
                         GLint redBits,
81
                         GLint greenBits,
82
                         GLint blueBits,
83
                         GLint alphaBits,
84
                         GLint indexBits,
85
                         GLint depthBits,
86
                         GLint stencilBits,
87
                         GLint accumRedBits,
88
                         GLint accumGreenBits,
89
                         GLint accumBlueBits,
90
                         GLint accumAlphaBits,
91
                         GLint numSamples );
92
 
93
extern void
94
_mesa_destroy_visual( GLvisual *vis );
95
 
96
 
97
 
98
/*
99
 * Create/destroy a GLframebuffer.
100
 */
101
extern GLframebuffer *
102
_mesa_create_framebuffer( const GLvisual *visual,
103
                          GLboolean softwareDepth,
104
                          GLboolean softwareStencil,
105
                          GLboolean softwareAccum,
106
                          GLboolean softwareAlpha );
107
 
108
extern void
109
_mesa_initialize_framebuffer( GLframebuffer *fb,
110
                              const GLvisual *visual,
111
                              GLboolean softwareDepth,
112
                              GLboolean softwareStencil,
113
                              GLboolean softwareAccum,
114
                              GLboolean softwareAlpha );
115
 
116
extern void
117
_mesa_free_framebuffer_data( GLframebuffer *buffer );
118
 
119
extern void
120
_mesa_destroy_framebuffer( GLframebuffer *buffer );
121
 
122
 
123
 
124
/*
125
 * Create/destroy a GLcontext.
126
 */
127
extern GLcontext *
128
_mesa_create_context( const GLvisual *visual,
129
                      GLcontext *share_list,
130
                      void *driver_ctx,
131
                      GLboolean direct );
132
 
133
extern GLboolean
134
_mesa_initialize_context( GLcontext *ctx,
135
                          const GLvisual *visual,
136
                          GLcontext *share_list,
137
                          void *driver_ctx,
138
                          GLboolean direct );
139
 
140
extern void
141
_mesa_free_context_data( GLcontext *ctx );
142
 
143
extern void
144
_mesa_destroy_context( GLcontext *ctx );
145
 
146
 
147
extern void
148
_mesa_copy_context(const GLcontext *src, GLcontext *dst, GLuint mask);
149
 
150
 
151
extern void
152
_mesa_make_current( GLcontext *ctx, GLframebuffer *buffer );
153
 
154
 
155
extern void
156
_mesa_make_current2( GLcontext *ctx, GLframebuffer *drawBuffer,
157
                     GLframebuffer *readBuffer );
158
 
159
 
160
extern GLcontext *
161
_mesa_get_current_context(void);
162
 
163
 
164
 
165
/*
166
 * Macros for fetching current context.
167
 */
168
#ifdef THREADS
169
 
170
#define GET_CURRENT_CONTEXT(C)  GLcontext *C = (GLcontext *) (_glapi_Context ? _glapi_Context : _glapi_get_context())
171
 
172
#else
173
 
174
#define GET_CURRENT_CONTEXT(C)  GLcontext *C = (GLcontext *) _glapi_Context
175
 
176
#endif
177
 
178
 
179
 
180
/* OpenGL SI-style export functions. */
181
 
182
extern GLboolean
183
_mesa_destroyContext(__GLcontext *gc);
184
 
185
extern GLboolean
186
_mesa_loseCurrent(__GLcontext *gc);
187
 
188
extern GLboolean
189
_mesa_makeCurrent(__GLcontext *gc);
190
 
191
extern GLboolean
192
_mesa_shareContext(__GLcontext *gc, __GLcontext *gcShare);
193
 
194
extern GLboolean
195
_mesa_copyContext(__GLcontext *dst, const __GLcontext *src, GLuint mask);
196
 
197
extern GLboolean
198
_mesa_forceCurrent(__GLcontext *gc);
199
 
200
extern GLboolean
201
_mesa_notifyResize(__GLcontext *gc);
202
 
203
extern void
204
_mesa_notifyDestroy(__GLcontext *gc);
205
 
206
extern void
207
_mesa_notifySwapBuffers(__GLcontext *gc);
208
 
209
extern struct __GLdispatchStateRec *
210
_mesa_dispatchExec(__GLcontext *gc);
211
 
212
extern void
213
_mesa_beginDispatchOverride(__GLcontext *gc);
214
 
215
extern void
216
_mesa_endDispatchOverride(__GLcontext *gc);
217
 
218
 
219
 
220
extern struct _glapi_table *
221
_mesa_get_dispatch(GLcontext *ctx);
222
 
223
 
224
 
225
/*
226
 * Miscellaneous
227
 */
228
 
229
extern void
230
_mesa_record_error( GLcontext *ctx, GLenum error );
231
 
232
 
233
extern void
234
_mesa_Finish( void );
235
 
236
extern void
237
_mesa_Flush( void );
238
 
239
 
240
#endif