7d6528291b58c3b66ebd25e389e24fceafe22631
1 /* $Id: buffers.c,v 1.15 2000/10/28 18:34:48 brianp Exp $ */
4 * Mesa 3-D graphics library
7 * Copyright (C) 1999-2000 Brian Paul All Rights Reserved.
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:
16 * The above copyright notice and this permission notice shall be included
17 * in all copies or substantial portions of the Software.
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.
49 _mesa_ClearIndex( GLfloat c
)
51 GET_CURRENT_CONTEXT(ctx
);
52 ASSERT_OUTSIDE_BEGIN_END_AND_FLUSH(ctx
, "glClearIndex");
53 ctx
->Color
.ClearIndex
= (GLuint
) c
;
54 if (!ctx
->Visual
.RGBAflag
) {
55 /* it's OK to call glClearIndex in RGBA mode but it should be a NOP */
56 (*ctx
->Driver
.ClearIndex
)( ctx
, ctx
->Color
.ClearIndex
);
63 _mesa_ClearColor( GLclampf red
, GLclampf green
,
64 GLclampf blue
, GLclampf alpha
)
66 GET_CURRENT_CONTEXT(ctx
);
67 ASSERT_OUTSIDE_BEGIN_END_AND_FLUSH(ctx
, "glClearColor");
69 ctx
->Color
.ClearColor
[0] = CLAMP( red
, 0.0F
, 1.0F
);
70 ctx
->Color
.ClearColor
[1] = CLAMP( green
, 0.0F
, 1.0F
);
71 ctx
->Color
.ClearColor
[2] = CLAMP( blue
, 0.0F
, 1.0F
);
72 ctx
->Color
.ClearColor
[3] = CLAMP( alpha
, 0.0F
, 1.0F
);
74 if (ctx
->Visual
.RGBAflag
) {
75 GLchan r
= (GLint
) (ctx
->Color
.ClearColor
[0] * CHAN_MAXF
);
76 GLchan g
= (GLint
) (ctx
->Color
.ClearColor
[1] * CHAN_MAXF
);
77 GLchan b
= (GLint
) (ctx
->Color
.ClearColor
[2] * CHAN_MAXF
);
78 GLchan a
= (GLint
) (ctx
->Color
.ClearColor
[3] * CHAN_MAXF
);
79 (*ctx
->Driver
.ClearColor
)( ctx
, r
, g
, b
, a
);
87 * Clear the color buffer when glColorMask or glIndexMask is in effect.
90 clear_color_buffer_with_masking( GLcontext
*ctx
)
92 const GLint x
= ctx
->DrawBuffer
->Xmin
;
93 const GLint y
= ctx
->DrawBuffer
->Ymin
;
94 const GLint height
= ctx
->DrawBuffer
->Ymax
- ctx
->DrawBuffer
->Ymin
;
95 const GLint width
= ctx
->DrawBuffer
->Xmax
- ctx
->DrawBuffer
->Xmin
;
97 if (ctx
->Visual
.RGBAflag
) {
99 const GLchan r
= (GLint
) (ctx
->Color
.ClearColor
[0] * CHAN_MAXF
);
100 const GLchan g
= (GLint
) (ctx
->Color
.ClearColor
[1] * CHAN_MAXF
);
101 const GLchan b
= (GLint
) (ctx
->Color
.ClearColor
[2] * CHAN_MAXF
);
102 const GLchan a
= (GLint
) (ctx
->Color
.ClearColor
[3] * CHAN_MAXF
);
104 for (i
= 0; i
< height
; i
++) {
105 GLchan rgba
[MAX_WIDTH
][4];
107 for (j
=0; j
<width
; j
++) {
113 _mesa_mask_rgba_span( ctx
, width
, x
, y
+ i
, rgba
);
114 (*ctx
->Driver
.WriteRGBASpan
)( ctx
, width
, x
, y
+ i
,
115 (CONST
GLchan (*)[4]) rgba
, NULL
);
119 /* Color index mode */
120 GLuint span
[MAX_WIDTH
];
121 GLubyte mask
[MAX_WIDTH
];
123 MEMSET( mask
, 1, width
);
124 for (i
=0;i
<height
;i
++) {
125 for (j
=0;j
<width
;j
++) {
126 span
[j
] = ctx
->Color
.ClearIndex
;
128 _mesa_mask_index_span( ctx
, width
, x
, y
+ i
, span
);
129 (*ctx
->Driver
.WriteCI32Span
)( ctx
, width
, x
, y
+ i
, span
, mask
);
137 * Clear a color buffer without index/channel masking.
140 clear_color_buffer(GLcontext
*ctx
)
142 const GLint x
= ctx
->DrawBuffer
->Xmin
;
143 const GLint y
= ctx
->DrawBuffer
->Ymin
;
144 const GLint height
= ctx
->DrawBuffer
->Ymax
- ctx
->DrawBuffer
->Ymin
;
145 const GLint width
= ctx
->DrawBuffer
->Xmax
- ctx
->DrawBuffer
->Xmin
;
146 const GLuint colorMask
= *((GLuint
*) &ctx
->Color
.ColorMask
);
148 if (ctx
->Visual
.RGBAflag
) {
150 const GLchan r
= (GLint
) (ctx
->Color
.ClearColor
[0] * CHAN_MAXF
);
151 const GLchan g
= (GLint
) (ctx
->Color
.ClearColor
[1] * CHAN_MAXF
);
152 const GLchan b
= (GLint
) (ctx
->Color
.ClearColor
[2] * CHAN_MAXF
);
153 const GLchan a
= (GLint
) (ctx
->Color
.ClearColor
[3] * CHAN_MAXF
);
154 GLchan span
[MAX_WIDTH
][4];
157 ASSERT(colorMask
== 0xffffffff);
159 for (i
= 0; i
< width
; i
++) {
165 for (i
= 0; i
< height
; i
++) {
166 (*ctx
->Driver
.WriteRGBASpan
)( ctx
, width
, x
, y
+ i
,
167 (CONST
GLchan (*)[4]) span
, NULL
);
171 /* Color index mode */
172 ASSERT(ctx
->Color
.IndexMask
== ~0);
173 if (ctx
->Visual
.IndexBits
== 8) {
175 GLchan span
[MAX_WIDTH
];
177 MEMSET(span
, ctx
->Color
.ClearIndex
, width
);
178 for (i
= 0; i
< height
; i
++) {
179 (*ctx
->Driver
.WriteCI8Span
)( ctx
, width
, x
, y
+ i
, span
, NULL
);
183 /* non 8-bit clear */
184 GLuint span
[MAX_WIDTH
];
186 for (i
= 0; i
< width
; i
++) {
187 span
[i
] = ctx
->Color
.ClearIndex
;
189 for (i
= 0; i
< height
; i
++) {
190 (*ctx
->Driver
.WriteCI32Span
)( ctx
, width
, x
, y
+ i
, span
, NULL
);
199 * Clear the front/back/left/right color buffers.
200 * This function is usually only called if we need to clear the
201 * buffers with masking.
204 clear_color_buffers(GLcontext
*ctx
)
206 const GLuint colorMask
= *((GLuint
*) &ctx
->Color
.ColorMask
);
209 /* loop over four possible dest color buffers */
210 for (bufferBit
= 1; bufferBit
<= 8; bufferBit
= bufferBit
<< 1) {
211 if (bufferBit
& ctx
->Color
.DrawDestMask
) {
212 if (bufferBit
== FRONT_LEFT_BIT
) {
213 (void) (*ctx
->Driver
.SetDrawBuffer
)( ctx
, GL_FRONT_LEFT
);
214 (void) (*ctx
->Driver
.SetReadBuffer
)( ctx
, ctx
->DrawBuffer
, GL_FRONT_LEFT
);
216 else if (bufferBit
== FRONT_RIGHT_BIT
) {
217 (void) (*ctx
->Driver
.SetDrawBuffer
)( ctx
, GL_FRONT_RIGHT
);
218 (void) (*ctx
->Driver
.SetReadBuffer
)( ctx
, ctx
->DrawBuffer
, GL_FRONT_RIGHT
);
220 else if (bufferBit
== BACK_LEFT_BIT
) {
221 (void) (*ctx
->Driver
.SetDrawBuffer
)( ctx
, GL_BACK_LEFT
);
222 (void) (*ctx
->Driver
.SetReadBuffer
)( ctx
, ctx
->DrawBuffer
, GL_BACK_LEFT
);
225 (void) (*ctx
->Driver
.SetDrawBuffer
)( ctx
, GL_BACK_RIGHT
);
226 (void) (*ctx
->Driver
.SetReadBuffer
)( ctx
, ctx
->DrawBuffer
, GL_BACK_RIGHT
);
229 if (colorMask
!= 0xffffffff) {
230 clear_color_buffer_with_masking(ctx
);
233 clear_color_buffer(ctx
);
238 /* restore default read/draw buffers */
239 (void) (*ctx
->Driver
.SetDrawBuffer
)( ctx
, ctx
->Color
.DriverDrawBuffer
);
240 (void) (*ctx
->Driver
.SetReadBuffer
)( ctx
, ctx
->ReadBuffer
, ctx
->Pixel
.DriverReadBuffer
);
246 _mesa_Clear( GLbitfield mask
)
248 GET_CURRENT_CONTEXT(ctx
);
250 GLdouble t0
= gl_time();
252 ASSERT_OUTSIDE_BEGIN_END_AND_FLUSH(ctx
, "glClear");
254 if (MESA_VERBOSE
& VERBOSE_API
)
255 fprintf(stderr
, "glClear 0x%x\n", mask
);
258 gl_update_state( ctx
);
261 if (ctx
->RenderMode
==GL_RENDER
) {
262 const GLint x
= ctx
->DrawBuffer
->Xmin
;
263 const GLint y
= ctx
->DrawBuffer
->Ymin
;
264 const GLint height
= ctx
->DrawBuffer
->Ymax
- ctx
->DrawBuffer
->Ymin
;
265 const GLint width
= ctx
->DrawBuffer
->Xmax
- ctx
->DrawBuffer
->Xmin
;
269 /* don't clear depth buffer if depth writing disabled */
270 if (!ctx
->Depth
.Mask
)
271 CLEAR_BITS(mask
, GL_DEPTH_BUFFER_BIT
);
273 /* Build bitmask to send to driver Clear function */
274 ddMask
= mask
& (GL_DEPTH_BUFFER_BIT
|
275 GL_STENCIL_BUFFER_BIT
|
276 GL_ACCUM_BUFFER_BIT
);
277 if (mask
& GL_COLOR_BUFFER_BIT
) {
278 ddMask
|= ctx
->Color
.DrawDestMask
;
281 ASSERT(ctx
->Driver
.Clear
);
282 newMask
= (*ctx
->Driver
.Clear
)( ctx
, ddMask
, !ctx
->Scissor
.Enabled
,
283 x
, y
, width
, height
);
287 GLbitfield legalBits
= DD_FRONT_LEFT_BIT
|
294 assert((newMask
& (~legalBits
)) == 0);
300 /* do software clearing here */
302 if (newMask
& ctx
->Color
.DrawDestMask
) clear_color_buffers(ctx
);
303 if (newMask
& GL_DEPTH_BUFFER_BIT
) _mesa_clear_depth_buffer(ctx
);
304 if (newMask
& GL_ACCUM_BUFFER_BIT
) _mesa_clear_accum_buffer(ctx
);
305 if (newMask
& GL_STENCIL_BUFFER_BIT
) _mesa_clear_stencil_buffer(ctx
);
308 /* clear software-based alpha buffer(s) */
309 if ( (mask
& GL_COLOR_BUFFER_BIT
)
310 && ctx
->DrawBuffer
->UseSoftwareAlphaBuffers
311 && ctx
->Color
.ColorMask
[ACOMP
]) {
312 _mesa_clear_alpha_buffers( ctx
);
318 ctx
->ClearTime
+= gl_time() - t0
;
326 _mesa_DrawBuffer( GLenum mode
)
328 GET_CURRENT_CONTEXT(ctx
);
329 ASSERT_OUTSIDE_BEGIN_END_AND_FLUSH(ctx
, "glDrawBuffer");
331 if (MESA_VERBOSE
& VERBOSE_API
)
332 fprintf(stderr
, "glDrawBuffer %s\n", gl_lookup_enum_by_nr(mode
));
339 /* AUX buffers not implemented in Mesa at this time */
340 gl_error( ctx
, GL_INVALID_OPERATION
, "glDrawBuffer" );
343 if (!ctx
->Visual
.StereoFlag
) {
344 gl_error( ctx
, GL_INVALID_OPERATION
, "glDrawBuffer" );
346 if (ctx
->Visual
.DBflag
)
347 ctx
->Color
.DrawDestMask
= FRONT_RIGHT_BIT
| BACK_RIGHT_BIT
;
349 ctx
->Color
.DrawDestMask
= FRONT_RIGHT_BIT
;
352 if (!ctx
->Visual
.StereoFlag
) {
353 gl_error( ctx
, GL_INVALID_OPERATION
, "glDrawBuffer" );
356 ctx
->Color
.DrawDestMask
= FRONT_RIGHT_BIT
;
359 if (!ctx
->Visual
.StereoFlag
) {
360 gl_error( ctx
, GL_INVALID_OPERATION
, "glDrawBuffer" );
363 if (!ctx
->Visual
.DBflag
) {
364 gl_error( ctx
, GL_INVALID_OPERATION
, "glDrawBuffer" );
367 ctx
->Color
.DrawDestMask
= BACK_RIGHT_BIT
;
370 if (!ctx
->Visual
.DBflag
) {
371 gl_error( ctx
, GL_INVALID_OPERATION
, "glDrawBuffer" );
374 ctx
->Color
.DrawDestMask
= BACK_LEFT_BIT
;
376 case GL_FRONT_AND_BACK
:
377 if (!ctx
->Visual
.DBflag
) {
378 gl_error( ctx
, GL_INVALID_OPERATION
, "glDrawBuffer" );
381 if (ctx
->Visual
.StereoFlag
)
382 ctx
->Color
.DrawDestMask
= FRONT_LEFT_BIT
| BACK_LEFT_BIT
383 | FRONT_RIGHT_BIT
| BACK_RIGHT_BIT
;
385 ctx
->Color
.DrawDestMask
= FRONT_LEFT_BIT
| BACK_LEFT_BIT
;
388 if (!ctx
->Visual
.DBflag
) {
389 gl_error( ctx
, GL_INVALID_OPERATION
, "glDrawBuffer" );
392 if (ctx
->Visual
.StereoFlag
)
393 ctx
->Color
.DrawDestMask
= BACK_LEFT_BIT
| BACK_RIGHT_BIT
;
395 ctx
->Color
.DrawDestMask
= BACK_LEFT_BIT
;
399 if (ctx
->Visual
.DBflag
)
400 ctx
->Color
.DrawDestMask
= FRONT_LEFT_BIT
| BACK_LEFT_BIT
;
402 ctx
->Color
.DrawDestMask
= FRONT_LEFT_BIT
;
406 ctx
->Color
.DrawDestMask
= FRONT_LEFT_BIT
;
410 if (ctx
->Visual
.StereoFlag
)
411 ctx
->Color
.DrawDestMask
= FRONT_LEFT_BIT
| FRONT_RIGHT_BIT
;
413 ctx
->Color
.DrawDestMask
= FRONT_LEFT_BIT
;
417 ctx
->Color
.DrawDestMask
= 0;
420 gl_error( ctx
, GL_INVALID_ENUM
, "glDrawBuffer" );
425 * Make the dest buffer mode more precise if possible
427 if (mode
== GL_LEFT
&& !ctx
->Visual
.DBflag
)
428 ctx
->Color
.DriverDrawBuffer
= GL_FRONT_LEFT
;
429 else if (mode
== GL_RIGHT
&& !ctx
->Visual
.DBflag
)
430 ctx
->Color
.DriverDrawBuffer
= GL_FRONT_RIGHT
;
431 else if (mode
== GL_FRONT
&& !ctx
->Visual
.StereoFlag
)
432 ctx
->Color
.DriverDrawBuffer
= GL_FRONT_LEFT
;
433 else if (mode
== GL_BACK
&& !ctx
->Visual
.StereoFlag
)
434 ctx
->Color
.DriverDrawBuffer
= GL_BACK_LEFT
;
436 ctx
->Color
.DriverDrawBuffer
= mode
;
439 * Set current alpha buffer pointer
441 if (ctx
->DrawBuffer
->UseSoftwareAlphaBuffers
) {
442 if (ctx
->Color
.DriverDrawBuffer
== GL_FRONT_LEFT
)
443 ctx
->DrawBuffer
->Alpha
= ctx
->DrawBuffer
->FrontLeftAlpha
;
444 else if (ctx
->Color
.DriverDrawBuffer
== GL_BACK_LEFT
)
445 ctx
->DrawBuffer
->Alpha
= ctx
->DrawBuffer
->BackLeftAlpha
;
446 else if (ctx
->Color
.DriverDrawBuffer
== GL_FRONT_RIGHT
)
447 ctx
->DrawBuffer
->Alpha
= ctx
->DrawBuffer
->FrontRightAlpha
;
448 else if (ctx
->Color
.DriverDrawBuffer
== GL_BACK_RIGHT
)
449 ctx
->DrawBuffer
->Alpha
= ctx
->DrawBuffer
->BackRightAlpha
;
453 * If we get here there can't have been an error.
454 * Now see if device driver can implement the drawing to the target
455 * buffer(s). The driver may not be able to do GL_FRONT_AND_BACK mode
456 * for example. We'll take care of that in the core code by looping
457 * over the individual buffers.
459 ASSERT(ctx
->Driver
.SetDrawBuffer
);
460 if ( (*ctx
->Driver
.SetDrawBuffer
)(ctx
, ctx
->Color
.DriverDrawBuffer
) ) {
461 /* All OK, the driver will do all buffer writes */
462 ctx
->Color
.MultiDrawBuffer
= GL_FALSE
;
465 /* We'll have to loop over the multiple draw buffer targets */
466 ctx
->Color
.MultiDrawBuffer
= GL_TRUE
;
467 /* Set drawing buffer to front for now */
468 (void) (*ctx
->Driver
.SetDrawBuffer
)(ctx
, GL_FRONT_LEFT
);
471 ctx
->Color
.DrawBuffer
= mode
;
472 ctx
->NewState
|= NEW_RASTER_OPS
;
478 _mesa_ReadBuffer( GLenum mode
)
480 GET_CURRENT_CONTEXT(ctx
);
481 ASSERT_OUTSIDE_BEGIN_END_AND_FLUSH(ctx
, "glReadBuffer");
483 if (MESA_VERBOSE
& VERBOSE_API
)
484 fprintf(stderr
, "glReadBuffer %s\n", gl_lookup_enum_by_nr(mode
));
491 /* AUX buffers not implemented in Mesa at this time */
492 gl_error( ctx
, GL_INVALID_OPERATION
, "glReadBuffer" );
497 /* Front-Left buffer, always exists */
498 ctx
->Pixel
.DriverReadBuffer
= GL_FRONT_LEFT
;
502 /* Back-Left buffer, requires double buffering */
503 if (!ctx
->Visual
.DBflag
) {
504 gl_error( ctx
, GL_INVALID_OPERATION
, "glReadBuffer" );
507 ctx
->Pixel
.DriverReadBuffer
= GL_BACK_LEFT
;
511 if (!ctx
->Visual
.StereoFlag
) {
512 gl_error( ctx
, GL_INVALID_OPERATION
, "glReadBuffer" );
515 ctx
->Pixel
.DriverReadBuffer
= GL_FRONT_RIGHT
;
518 if (!ctx
->Visual
.StereoFlag
|| !ctx
->Visual
.DBflag
) {
519 gl_error( ctx
, GL_INVALID_OPERATION
, "glReadBuffer" );
522 ctx
->Pixel
.DriverReadBuffer
= GL_BACK_RIGHT
;
525 gl_error( ctx
, GL_INVALID_ENUM
, "glReadBuffer" );
529 ctx
->Pixel
.ReadBuffer
= mode
;
530 ctx
->NewState
|= NEW_RASTER_OPS
;
535 * GL_MESA_resize_buffers extension
538 _mesa_ResizeBuffersMESA( void )
540 GLcontext
*ctx
= _mesa_get_current_context();
542 GLuint buf_width
, buf_height
;
544 if (MESA_VERBOSE
& VERBOSE_API
)
545 fprintf(stderr
, "glResizeBuffersMESA\n");
547 /* ask device driver for size of output buffer */
548 (*ctx
->Driver
.GetBufferSize
)( ctx
, &buf_width
, &buf_height
);
550 /* see if size of device driver's color buffer (window) has changed */
551 if (ctx
->DrawBuffer
->Width
== (GLint
) buf_width
&&
552 ctx
->DrawBuffer
->Height
== (GLint
) buf_height
)
555 ctx
->NewState
|= NEW_RASTER_OPS
; /* to update scissor / window bounds */
557 /* save buffer size */
558 ctx
->DrawBuffer
->Width
= buf_width
;
559 ctx
->DrawBuffer
->Height
= buf_height
;
561 /* Reallocate other buffers if needed. */
562 if (ctx
->DrawBuffer
->UseSoftwareDepthBuffer
) {
563 _mesa_alloc_depth_buffer( ctx
);
565 if (ctx
->DrawBuffer
->UseSoftwareStencilBuffer
) {
566 _mesa_alloc_stencil_buffer( ctx
);
568 if (ctx
->DrawBuffer
->UseSoftwareAccumBuffer
) {
569 _mesa_alloc_accum_buffer( ctx
);
571 if (ctx
->DrawBuffer
->UseSoftwareAlphaBuffers
) {
572 _mesa_alloc_alpha_buffers( ctx
);