2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2008 Brian Paul All Rights Reserved.
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the "Software"),
9 * to deal in the Software without restriction, including without limitation
10 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
21 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
22 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
25 #include "main/glheader.h"
26 #include "main/colormac.h"
27 #include "main/condrender.h"
28 #include "main/macros.h"
29 #include "main/imports.h"
30 #include "main/mtypes.h"
33 #include "s_context.h"
35 #include "s_masking.h"
36 #include "s_stencil.h"
40 * Clear the color buffer when glColorMask is in effect.
43 clear_rgba_buffer_with_masking(struct gl_context
*ctx
, struct gl_renderbuffer
*rb
,
46 const GLint x
= ctx
->DrawBuffer
->_Xmin
;
47 const GLint y
= ctx
->DrawBuffer
->_Ymin
;
48 const GLint height
= ctx
->DrawBuffer
->_Ymax
- ctx
->DrawBuffer
->_Ymin
;
49 const GLint width
= ctx
->DrawBuffer
->_Xmax
- ctx
->DrawBuffer
->_Xmin
;
55 /* Initialize color span with clear color */
56 /* XXX optimize for clearcolor == black/zero (bzero) */
57 INIT_SPAN(span
, GL_BITMAP
);
59 span
.arrayMask
= SPAN_RGBA
;
60 span
.array
->ChanType
= rb
->DataType
;
61 if (span
.array
->ChanType
== GL_UNSIGNED_BYTE
) {
62 GLubyte clearColor
[4];
63 UNCLAMPED_FLOAT_TO_UBYTE(clearColor
[RCOMP
], ctx
->Color
.ClearColor
.f
[0]);
64 UNCLAMPED_FLOAT_TO_UBYTE(clearColor
[GCOMP
], ctx
->Color
.ClearColor
.f
[1]);
65 UNCLAMPED_FLOAT_TO_UBYTE(clearColor
[BCOMP
], ctx
->Color
.ClearColor
.f
[2]);
66 UNCLAMPED_FLOAT_TO_UBYTE(clearColor
[ACOMP
], ctx
->Color
.ClearColor
.f
[3]);
67 for (i
= 0; i
< width
; i
++) {
68 COPY_4UBV(span
.array
->rgba
[i
], clearColor
);
71 else if (span
.array
->ChanType
== GL_UNSIGNED_SHORT
) {
72 GLushort clearColor
[4];
73 UNCLAMPED_FLOAT_TO_USHORT(clearColor
[RCOMP
], ctx
->Color
.ClearColor
.f
[0]);
74 UNCLAMPED_FLOAT_TO_USHORT(clearColor
[GCOMP
], ctx
->Color
.ClearColor
.f
[1]);
75 UNCLAMPED_FLOAT_TO_USHORT(clearColor
[BCOMP
], ctx
->Color
.ClearColor
.f
[2]);
76 UNCLAMPED_FLOAT_TO_USHORT(clearColor
[ACOMP
], ctx
->Color
.ClearColor
.f
[3]);
77 for (i
= 0; i
< width
; i
++) {
78 COPY_4V_CAST(span
.array
->rgba
[i
], clearColor
, GLchan
);
82 ASSERT(span
.array
->ChanType
== GL_FLOAT
);
83 for (i
= 0; i
< width
; i
++) {
84 UNCLAMPED_FLOAT_TO_CHAN(span
.array
->rgba
[i
][0], ctx
->Color
.ClearColor
.f
[0]);
85 UNCLAMPED_FLOAT_TO_CHAN(span
.array
->rgba
[i
][1], ctx
->Color
.ClearColor
.f
[1]);
86 UNCLAMPED_FLOAT_TO_CHAN(span
.array
->rgba
[i
][2], ctx
->Color
.ClearColor
.f
[2]);
87 UNCLAMPED_FLOAT_TO_CHAN(span
.array
->rgba
[i
][3], ctx
->Color
.ClearColor
.f
[3]);
91 /* Note that masking will change the color values, but only the
92 * channels for which the write mask is GL_FALSE. The channels
93 * which which are write-enabled won't get modified.
95 for (i
= 0; i
< height
; i
++) {
98 _swrast_mask_rgba_span(ctx
, rb
, &span
, buf
);
99 /* write masked row */
100 rb
->PutRow(ctx
, rb
, width
, x
, y
+ i
, span
.array
->rgba
, NULL
);
106 * Clear an rgba color buffer without channel masking.
109 clear_rgba_buffer(struct gl_context
*ctx
, struct gl_renderbuffer
*rb
, GLuint buf
)
111 const GLint x
= ctx
->DrawBuffer
->_Xmin
;
112 const GLint y
= ctx
->DrawBuffer
->_Ymin
;
113 const GLint height
= ctx
->DrawBuffer
->_Ymax
- ctx
->DrawBuffer
->_Ymin
;
114 const GLint width
= ctx
->DrawBuffer
->_Xmax
- ctx
->DrawBuffer
->_Xmin
;
118 GLfloat clearFloat
[4];
121 ASSERT(ctx
->Color
.ColorMask
[buf
][0] &&
122 ctx
->Color
.ColorMask
[buf
][1] &&
123 ctx
->Color
.ColorMask
[buf
][2] &&
124 ctx
->Color
.ColorMask
[buf
][3]);
126 ASSERT(rb
->PutMonoRow
);
128 switch (rb
->DataType
) {
129 case GL_UNSIGNED_BYTE
:
130 UNCLAMPED_FLOAT_TO_UBYTE(clear8
[0], ctx
->Color
.ClearColor
.f
[0]);
131 UNCLAMPED_FLOAT_TO_UBYTE(clear8
[1], ctx
->Color
.ClearColor
.f
[1]);
132 UNCLAMPED_FLOAT_TO_UBYTE(clear8
[2], ctx
->Color
.ClearColor
.f
[2]);
133 UNCLAMPED_FLOAT_TO_UBYTE(clear8
[3], ctx
->Color
.ClearColor
.f
[3]);
136 case GL_UNSIGNED_SHORT
:
137 UNCLAMPED_FLOAT_TO_USHORT(clear16
[0], ctx
->Color
.ClearColor
.f
[0]);
138 UNCLAMPED_FLOAT_TO_USHORT(clear16
[1], ctx
->Color
.ClearColor
.f
[1]);
139 UNCLAMPED_FLOAT_TO_USHORT(clear16
[2], ctx
->Color
.ClearColor
.f
[2]);
140 UNCLAMPED_FLOAT_TO_USHORT(clear16
[3], ctx
->Color
.ClearColor
.f
[3]);
144 clearFloat
[0] = CLAMP(ctx
->Color
.ClearColor
.f
[0], 0.0F
, 1.0F
);
145 clearFloat
[1] = CLAMP(ctx
->Color
.ClearColor
.f
[1], 0.0F
, 1.0F
);
146 clearFloat
[2] = CLAMP(ctx
->Color
.ClearColor
.f
[2], 0.0F
, 1.0F
);
147 clearFloat
[3] = CLAMP(ctx
->Color
.ClearColor
.f
[3], 0.0F
, 1.0F
);
148 clearVal
= clearFloat
;
151 _mesa_problem(ctx
, "Bad rb DataType in clear_color_buffer");
155 for (i
= 0; i
< height
; i
++) {
156 rb
->PutMonoRow(ctx
, rb
, width
, x
, y
+ i
, clearVal
, NULL
);
162 * Clear the front/back/left/right/aux color buffers.
163 * This function is usually only called if the device driver can't
164 * clear its own color buffers for some reason (such as with masking).
167 clear_color_buffers(struct gl_context
*ctx
)
171 for (buf
= 0; buf
< ctx
->DrawBuffer
->_NumColorDrawBuffers
; buf
++) {
172 struct gl_renderbuffer
*rb
= ctx
->DrawBuffer
->_ColorDrawBuffers
[buf
];
174 /* If this is an ES2 context or GL_ARB_ES2_compatibility is supported,
175 * the framebuffer can be complete with some attachments be missing. In
176 * this case the _ColorDrawBuffers pointer will be NULL.
181 if (ctx
->Color
.ColorMask
[buf
][0] == 0 ||
182 ctx
->Color
.ColorMask
[buf
][1] == 0 ||
183 ctx
->Color
.ColorMask
[buf
][2] == 0 ||
184 ctx
->Color
.ColorMask
[buf
][3] == 0) {
185 clear_rgba_buffer_with_masking(ctx
, rb
, buf
);
188 clear_rgba_buffer(ctx
, rb
, buf
);
195 * Called via the device driver's ctx->Driver.Clear() function if the
196 * device driver can't clear one or more of the buffers itself.
197 * \param buffers bitfield of BUFFER_BIT_* values indicating which
198 * renderbuffers are to be cleared.
199 * \param all if GL_TRUE, clear whole buffer, else clear specified region.
202 _swrast_Clear(struct gl_context
*ctx
, GLbitfield buffers
)
206 const GLbitfield legalBits
=
207 BUFFER_BIT_FRONT_LEFT
|
208 BUFFER_BIT_FRONT_RIGHT
|
209 BUFFER_BIT_BACK_LEFT
|
210 BUFFER_BIT_BACK_RIGHT
|
215 assert((buffers
& (~legalBits
)) == 0);
219 if (!_mesa_check_conditional_render(ctx
))
220 return; /* don't clear */
222 swrast_render_start(ctx
);
224 /* do software clearing here */
226 if ((buffers
& BUFFER_BITS_COLOR
)
227 && (ctx
->DrawBuffer
->_NumColorDrawBuffers
> 0)) {
228 clear_color_buffers(ctx
);
230 if (buffers
& BUFFER_BIT_DEPTH
) {
231 _swrast_clear_depth_buffer(ctx
, ctx
->DrawBuffer
->_DepthBuffer
);
233 if (buffers
& BUFFER_BIT_ACCUM
) {
234 _swrast_clear_accum_buffer(ctx
,
235 ctx
->DrawBuffer
->Attachment
[BUFFER_ACCUM
].Renderbuffer
);
237 if (buffers
& BUFFER_BIT_STENCIL
) {
238 _swrast_clear_stencil_buffer(ctx
, ctx
->DrawBuffer
->_StencilBuffer
);
242 swrast_render_finish(ctx
);