aboutsummaryrefslogtreecommitdiffstats
path: root/include/GL/dmesa.h
blob: bb7d9b0cc96438f653df06c1c894e9372c3e0394 (plain)
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
/*
 * Mesa 3-D graphics library
 * Version:  5.0
 * 
 * Copyright (C) 1999-2002  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"),
 * to deal in the Software without restriction, including without limitation
 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
 * and/or sell copies of the Software, and to permit persons to whom the
 * Software is furnished to do so, subject to the following conditions:
 * 
 * The above copyright notice and this permission notice shall be included
 * in all copies or substantial portions of the Software.
 * 
 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
 */

/*
 * DOS/DJGPP device driver v1.3 for Mesa
 *
 *  Copyright (C) 2002 - Borca Daniel
 *  Email : dborca@yahoo.com
 *  Web   : http://www.geocities.com/dborca
 */


#ifndef DMESA_H_included
#define DMESA_H_included

#define DMESA_MAJOR_VERSION 5
#define DMESA_MINOR_VERSION 0

/* Sample Usage:
 *
 * 1. Call DMesaCreateVisual() to initialize graphics.
 * 2. Call DMesaCreateContext() to create a DMesa rendering context.
 * 3. Call DMesaCreateBuffer() to define the window.
 * 4. Call DMesaMakeCurrent() to bind the DMesaBuffer to a DMesaContext.
 * 5. Make gl* calls to render your graphics.
 * 6. Use DMesaSwapBuffers() when double buffering to swap front/back buffers.
 * 7. Before exiting, destroy DMesaBuffer, DMesaContext and DMesaVisual.
 */

typedef struct dmesa_context *DMesaContext;
typedef struct dmesa_visual *DMesaVisual;
typedef struct dmesa_buffer *DMesaBuffer;

#ifdef __cplusplus
extern "C" {
#endif

/*
 * Create a new Visual and set graphics mode.
 */
DMesaVisual DMesaCreateVisual (GLint width,        /* X res */
                               GLint height,       /* Y res */
                               GLint colDepth,     /* BPP */
                               GLint refresh,      /* refresh rate: 0=default */
                               GLboolean dbFlag,   /* double-buffered */
                               GLboolean rgbFlag,  /* RGB mode */
                               GLboolean alphaFlag,/* alpha buffer requested */
                               GLint depthSize,    /* requested bits/depth */
                               GLint stencilSize,  /* requested bits/stencil */
                               GLint accumSize);   /* requested bits/accum */

/*
 * Destroy Visual and restore screen.
 */
void DMesaDestroyVisual (DMesaVisual v);



/*
 * Create a new Context for rendering.
 */
DMesaContext DMesaCreateContext (DMesaVisual visual, DMesaContext share);

/*
 * Destroy Context.
 */
void DMesaDestroyContext (DMesaContext c);

/*
 * Return a handle to the current context.
 */
DMesaContext DMesaGetCurrentContext (void);



/*
 * Create a new Buffer (window).
 */
DMesaBuffer DMesaCreateBuffer (DMesaVisual visual,
                               GLint xpos, GLint ypos,
                               GLint width, GLint height);

/*
 * Destroy Buffer.
 */
void DMesaDestroyBuffer (DMesaBuffer b);

/*
 * Swap the front and back buffers for the given Buffer.
 * No action is taken if the buffer is not double buffered.
 */
void DMesaSwapBuffers (DMesaBuffer b);

/*
 * Bind Buffer to Context and make the Context the current one.
 */
GLboolean DMesaMakeCurrent (DMesaContext c, DMesaBuffer b);



/*
 * Move/Resize current Buffer.
 */
GLboolean DMesaMoveBuffer (GLint xpos, GLint ypos);
GLboolean DMesaResizeBuffer (GLint width, GLint height);

/*
 * Set palette index, using normalized values.
 */
void DMesaSetCI (int ndx, GLfloat red, GLfloat green, GLfloat blue);

/*
 * DMesa state retrieval.
 */
#define DMESA_GET_SCREEN_SIZE 0x0100
#define DMESA_GET_DRIVER_CAPS 0x0200

#define DMESA_DRIVER_SWDB_BIT 0x1 /* software double-buffered */
#define DMESA_DRIVER_LLWO_BIT 0x2 /* lower-left window origin */
int DMesaGetIntegerv (GLenum pname, GLint *params);

#ifdef __cplusplus
}
#endif

#endif