renderbuffer.c revision 42aaa548a1020be5d40b3dce9448d8004b1ef947
1/*
2 * Mesa 3-D graphics library
3 * Version:  6.5
4 *
5 * Copyright (C) 1999-2006  Brian Paul   All Rights Reserved.
6 *
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:
13 *
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
16 *
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.
23 */
24
25
26/**
27 * Functions for allocating/managing renderbuffers.
28 * Also, routines for reading/writing software-based renderbuffer data as
29 * ubytes, ushorts, uints, etc.
30 *
31 * The 'alpha8' renderbuffer is interesting.  It's used to add a software-based
32 * alpha channel to RGB renderbuffers.  This is done by wrapping the RGB
33 * renderbuffer with the alpha renderbuffer.  We can do this because of the
34 * OO-nature of renderbuffers.
35 *
36 * Down the road we'll use this for run-time support of 8, 16 and 32-bit
37 * color channels.  For example, Mesa may use 32-bit/float color channels
38 * internally (swrast) and use wrapper renderbuffers to convert 32-bit
39 * values down to 16 or 8-bit values for whatever kind of framebuffer we have.
40 */
41
42
43#include "glheader.h"
44#include "imports.h"
45#include "context.h"
46#include "mtypes.h"
47#include "fbobject.h"
48#include "renderbuffer.h"
49
50#include "rbadaptors.h"
51
52
53/* 32-bit color index format.  Not a public format. */
54#define COLOR_INDEX32 0x424243
55
56
57/*
58 * Routines for get/put values in common buffer formats follow.
59 * Someday add support for arbitrary row stride to make them more
60 * flexible.
61 */
62
63/**********************************************************************
64 * Functions for buffers of 1 X GLubyte values.
65 * Typically stencil.
66 */
67
68static void *
69get_pointer_ubyte(GLcontext *ctx, struct gl_renderbuffer *rb,
70                  GLint x, GLint y)
71{
72   if (!rb->Data)
73      return NULL;
74   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
75   /* Can't assert _ActualFormat since these funcs may be used for serveral
76    * different formats (GL_ALPHA8, GL_STENCIL_INDEX8, etc).
77    */
78   return (GLubyte *) rb->Data + y * rb->Width + x;
79}
80
81
82static void
83get_row_ubyte(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
84              GLint x, GLint y, void *values)
85{
86   const GLubyte *src = (const GLubyte *) rb->Data + y * rb->Width + x;
87   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
88   _mesa_memcpy(values, src, count * sizeof(GLubyte));
89}
90
91
92static void
93get_values_ubyte(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
94                 const GLint x[], const GLint y[], void *values)
95{
96   GLubyte *dst = (GLubyte *) values;
97   GLuint i;
98   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
99   for (i = 0; i < count; i++) {
100      const GLubyte *src = (GLubyte *) rb->Data + y[i] * rb->Width + x[i];
101      dst[i] = *src;
102   }
103}
104
105
106static void
107put_row_ubyte(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
108              GLint x, GLint y, const void *values, const GLubyte *mask)
109{
110   const GLubyte *src = (const GLubyte *) values;
111   GLubyte *dst = (GLubyte *) rb->Data + y * rb->Width + x;
112   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
113   if (mask) {
114      GLuint i;
115      for (i = 0; i < count; i++) {
116         if (mask[i]) {
117            dst[i] = src[i];
118         }
119      }
120   }
121   else {
122      _mesa_memcpy(dst, values, count * sizeof(GLubyte));
123   }
124}
125
126
127static void
128put_mono_row_ubyte(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
129                   GLint x, GLint y, const void *value, const GLubyte *mask)
130{
131   const GLubyte val = *((const GLubyte *) value);
132   GLubyte *dst = (GLubyte *) rb->Data + y * rb->Width + x;
133   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
134   if (mask) {
135      GLuint i;
136      for (i = 0; i < count; i++) {
137         if (mask[i]) {
138            dst[i] = val;
139         }
140      }
141   }
142   else {
143      GLuint i;
144      for (i = 0; i < count; i++) {
145         dst[i] = val;
146      }
147   }
148}
149
150
151static void
152put_values_ubyte(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
153                 const GLint x[], const GLint y[],
154                 const void *values, const GLubyte *mask)
155{
156   const GLubyte *src = (const GLubyte *) values;
157   GLuint i;
158   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
159   for (i = 0; i < count; i++) {
160      if (!mask || mask[i]) {
161         GLubyte *dst = (GLubyte *) rb->Data + y[i] * rb->Width + x[i];
162         *dst = src[i];
163      }
164   }
165}
166
167
168static void
169put_mono_values_ubyte(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
170                      const GLint x[], const GLint y[],
171                      const void *value, const GLubyte *mask)
172{
173   const GLubyte val = *((const GLubyte *) value);
174   GLuint i;
175   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
176   for (i = 0; i < count; i++) {
177      if (!mask || mask[i]) {
178         GLubyte *dst = (GLubyte *) rb->Data + y[i] * rb->Width + x[i];
179         *dst = val;
180      }
181   }
182}
183
184
185/**********************************************************************
186 * Functions for buffers of 1 X GLushort values.
187 * Typically depth/Z.
188 */
189
190static void *
191get_pointer_ushort(GLcontext *ctx, struct gl_renderbuffer *rb,
192                   GLint x, GLint y)
193{
194   if (!rb->Data)
195      return NULL;
196   ASSERT(rb->DataType == GL_UNSIGNED_SHORT);
197   ASSERT(rb->Width > 0);
198   return (GLushort *) rb->Data + y * rb->Width + x;
199}
200
201
202static void
203get_row_ushort(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
204               GLint x, GLint y, void *values)
205{
206   const void *src = rb->GetPointer(ctx, rb, x, y);
207   ASSERT(rb->DataType == GL_UNSIGNED_SHORT);
208   _mesa_memcpy(values, src, count * sizeof(GLushort));
209}
210
211
212static void
213get_values_ushort(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
214                  const GLint x[], const GLint y[], void *values)
215{
216   GLushort *dst = (GLushort *) values;
217   GLuint i;
218   ASSERT(rb->DataType == GL_UNSIGNED_SHORT);
219   for (i = 0; i < count; i++) {
220      const GLushort *src = (GLushort *) rb->Data + y[i] * rb->Width + x[i];
221      dst[i] = *src;
222   }
223}
224
225
226static void
227put_row_ushort(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
228               GLint x, GLint y, const void *values, const GLubyte *mask)
229{
230   const GLushort *src = (const GLushort *) values;
231   GLushort *dst = (GLushort *) rb->Data + y * rb->Width + x;
232   ASSERT(rb->DataType == GL_UNSIGNED_SHORT);
233   if (mask) {
234      GLuint i;
235      for (i = 0; i < count; i++) {
236         if (mask[i]) {
237            dst[i] = src[i];
238         }
239      }
240   }
241   else {
242      _mesa_memcpy(dst, src, count * sizeof(GLushort));
243   }
244}
245
246
247static void
248put_mono_row_ushort(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
249                    GLint x, GLint y, const void *value, const GLubyte *mask)
250{
251   const GLushort val = *((const GLushort *) value);
252   GLushort *dst = (GLushort *) rb->Data + y * rb->Width + x;
253   ASSERT(rb->DataType == GL_UNSIGNED_SHORT);
254   if (mask) {
255      GLuint i;
256      for (i = 0; i < count; i++) {
257         if (mask[i]) {
258            dst[i] = val;
259         }
260      }
261   }
262   else {
263      GLuint i;
264      for (i = 0; i < count; i++) {
265         dst[i] = val;
266      }
267   }
268}
269
270
271static void
272put_values_ushort(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
273                  const GLint x[], const GLint y[], const void *values,
274                  const GLubyte *mask)
275{
276   const GLushort *src = (const GLushort *) values;
277   GLuint i;
278   ASSERT(rb->DataType == GL_UNSIGNED_SHORT);
279   for (i = 0; i < count; i++) {
280      if (!mask || mask[i]) {
281         GLushort *dst = (GLushort *) rb->Data + y[i] * rb->Width + x[i];
282         *dst = src[i];
283      }
284   }
285}
286
287
288static void
289put_mono_values_ushort(GLcontext *ctx, struct gl_renderbuffer *rb,
290                       GLuint count, const GLint x[], const GLint y[],
291                       const void *value, const GLubyte *mask)
292{
293   const GLushort val = *((const GLushort *) value);
294   ASSERT(rb->DataType == GL_UNSIGNED_SHORT);
295   if (mask) {
296      GLuint i;
297      for (i = 0; i < count; i++) {
298         if (mask[i]) {
299            GLushort *dst = (GLushort *) rb->Data + y[i] * rb->Width + x[i];
300            *dst = val;
301         }
302      }
303   }
304   else {
305      GLuint i;
306      for (i = 0; i < count; i++) {
307         GLushort *dst = (GLushort *) rb->Data + y[i] * rb->Width + x[i];
308         *dst = val;
309      }
310   }
311}
312
313
314/**********************************************************************
315 * Functions for buffers of 1 X GLuint values.
316 * Typically depth/Z or color index.
317 */
318
319static void *
320get_pointer_uint(GLcontext *ctx, struct gl_renderbuffer *rb,
321                 GLint x, GLint y)
322{
323   if (!rb->Data)
324      return NULL;
325   ASSERT(rb->DataType == GL_UNSIGNED_INT ||
326          rb->DataType == GL_UNSIGNED_INT_24_8_EXT);
327   return (GLuint *) rb->Data + y * rb->Width + x;
328}
329
330
331static void
332get_row_uint(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
333             GLint x, GLint y, void *values)
334{
335   const void *src = rb->GetPointer(ctx, rb, x, y);
336   ASSERT(rb->DataType == GL_UNSIGNED_INT ||
337          rb->DataType == GL_UNSIGNED_INT_24_8_EXT);
338   _mesa_memcpy(values, src, count * sizeof(GLuint));
339}
340
341
342static void
343get_values_uint(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
344                const GLint x[], const GLint y[], void *values)
345{
346   GLuint *dst = (GLuint *) values;
347   GLuint i;
348   ASSERT(rb->DataType == GL_UNSIGNED_INT ||
349          rb->DataType == GL_UNSIGNED_INT_24_8_EXT);
350   for (i = 0; i < count; i++) {
351      const GLuint *src = (GLuint *) rb->Data + y[i] * rb->Width + x[i];
352      dst[i] = *src;
353   }
354}
355
356
357static void
358put_row_uint(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
359             GLint x, GLint y, const void *values, const GLubyte *mask)
360{
361   const GLuint *src = (const GLuint *) values;
362   GLuint *dst = (GLuint *) rb->Data + y * rb->Width + x;
363   ASSERT(rb->DataType == GL_UNSIGNED_INT ||
364          rb->DataType == GL_UNSIGNED_INT_24_8_EXT);
365   if (mask) {
366      GLuint i;
367      for (i = 0; i < count; i++) {
368         if (mask[i]) {
369            dst[i] = src[i];
370         }
371      }
372   }
373   else {
374      _mesa_memcpy(dst, src, count * sizeof(GLuint));
375   }
376}
377
378
379static void
380put_mono_row_uint(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
381                  GLint x, GLint y, const void *value, const GLubyte *mask)
382{
383   const GLuint val = *((const GLuint *) value);
384   GLuint *dst = (GLuint *) rb->Data + y * rb->Width + x;
385   ASSERT(rb->DataType == GL_UNSIGNED_INT ||
386          rb->DataType == GL_UNSIGNED_INT_24_8_EXT);
387   if (mask) {
388      GLuint i;
389      for (i = 0; i < count; i++) {
390         if (mask[i]) {
391            dst[i] = val;
392         }
393      }
394   }
395   else {
396      GLuint i;
397      for (i = 0; i < count; i++) {
398         dst[i] = val;
399      }
400   }
401}
402
403
404static void
405put_values_uint(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
406                const GLint x[], const GLint y[], const void *values,
407                const GLubyte *mask)
408{
409   const GLuint *src = (const GLuint *) values;
410   GLuint i;
411   ASSERT(rb->DataType == GL_UNSIGNED_INT ||
412          rb->DataType == GL_UNSIGNED_INT_24_8_EXT);
413   for (i = 0; i < count; i++) {
414      if (!mask || mask[i]) {
415         GLuint *dst = (GLuint *) rb->Data + y[i] * rb->Width + x[i];
416         *dst = src[i];
417      }
418   }
419}
420
421
422static void
423put_mono_values_uint(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
424                     const GLint x[], const GLint y[], const void *value,
425                     const GLubyte *mask)
426{
427   const GLuint val = *((const GLuint *) value);
428   GLuint i;
429   ASSERT(rb->DataType == GL_UNSIGNED_INT ||
430          rb->DataType == GL_UNSIGNED_INT_24_8_EXT);
431   for (i = 0; i < count; i++) {
432      if (!mask || mask[i]) {
433         GLuint *dst = (GLuint *) rb->Data + y[i] * rb->Width + x[i];
434         *dst = val;
435      }
436   }
437}
438
439
440/**********************************************************************
441 * Functions for buffers of 3 X GLubyte (or GLbyte) values.
442 * Typically color buffers.
443 * NOTE: the incoming and outgoing colors are RGBA!  We ignore incoming
444 * alpha values and return 255 for outgoing alpha values.
445 */
446
447static void *
448get_pointer_ubyte3(GLcontext *ctx, struct gl_renderbuffer *rb,
449                   GLint x, GLint y)
450{
451   ASSERT(rb->_ActualFormat == GL_RGB8);
452   /* No direct access since this buffer is RGB but caller will be
453    * treating it as if it were RGBA.
454    */
455   return NULL;
456}
457
458
459static void
460get_row_ubyte3(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
461               GLint x, GLint y, void *values)
462{
463   const GLubyte *src = (const GLubyte *) rb->Data + 3 * (y * rb->Width + x);
464   GLubyte *dst = (GLubyte *) values;
465   GLuint i;
466   ASSERT(rb->_ActualFormat == GL_RGB8);
467   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
468   for (i = 0; i < count; i++) {
469      dst[i * 4 + 0] = src[i * 3 + 0];
470      dst[i * 4 + 1] = src[i * 3 + 1];
471      dst[i * 4 + 2] = src[i * 3 + 2];
472      dst[i * 4 + 3] = 255;
473   }
474}
475
476
477static void
478get_values_ubyte3(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
479                  const GLint x[], const GLint y[], void *values)
480{
481   GLubyte *dst = (GLubyte *) values;
482   GLuint i;
483   ASSERT(rb->_ActualFormat == GL_RGB8);
484   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
485   for (i = 0; i < count; i++) {
486      const GLubyte *src
487         = (GLubyte *) rb->Data + 3 * (y[i] * rb->Width + x[i]);
488      dst[i * 4 + 0] = src[0];
489      dst[i * 4 + 1] = src[1];
490      dst[i * 4 + 2] = src[2];
491      dst[i * 4 + 3] = 255;
492   }
493}
494
495
496static void
497put_row_ubyte3(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
498               GLint x, GLint y, const void *values, const GLubyte *mask)
499{
500   /* note: incoming values are RGB+A! */
501   const GLubyte *src = (const GLubyte *) values;
502   GLubyte *dst = (GLubyte *) rb->Data + 3 * (y * rb->Width + x);
503   GLuint i;
504   ASSERT(rb->_ActualFormat == GL_RGB8);
505   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
506   for (i = 0; i < count; i++) {
507      if (!mask || mask[i]) {
508         dst[i * 3 + 0] = src[i * 4 + 0];
509         dst[i * 3 + 1] = src[i * 4 + 1];
510         dst[i * 3 + 2] = src[i * 4 + 2];
511      }
512   }
513}
514
515
516static void
517put_row_rgb_ubyte3(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
518                   GLint x, GLint y, const void *values, const GLubyte *mask)
519{
520   /* note: incoming values are RGB+A! */
521   const GLubyte *src = (const GLubyte *) values;
522   GLubyte *dst = (GLubyte *) rb->Data + 3 * (y * rb->Width + x);
523   GLuint i;
524   ASSERT(rb->_ActualFormat == GL_RGB8);
525   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
526   for (i = 0; i < count; i++) {
527      if (!mask || mask[i]) {
528         dst[i * 3 + 0] = src[i * 3 + 0];
529         dst[i * 3 + 1] = src[i * 3 + 1];
530         dst[i * 3 + 2] = src[i * 3 + 2];
531      }
532   }
533}
534
535
536static void
537put_mono_row_ubyte3(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
538                    GLint x, GLint y, const void *value, const GLubyte *mask)
539{
540   /* note: incoming value is RGB+A! */
541   const GLubyte val0 = ((const GLubyte *) value)[0];
542   const GLubyte val1 = ((const GLubyte *) value)[1];
543   const GLubyte val2 = ((const GLubyte *) value)[2];
544   GLubyte *dst = (GLubyte *) rb->Data + 3 * (y * rb->Width + x);
545   ASSERT(rb->_ActualFormat == GL_RGB8);
546   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
547   if (!mask && val0 == val1 && val1 == val2) {
548      /* optimized case */
549      _mesa_memset(dst, val0, 3 * count);
550   }
551   else {
552      GLuint i;
553      for (i = 0; i < count; i++) {
554         if (!mask || mask[i]) {
555            dst[i * 3 + 0] = val0;
556            dst[i * 3 + 1] = val1;
557            dst[i * 3 + 2] = val2;
558         }
559      }
560   }
561}
562
563
564static void
565put_values_ubyte3(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
566                  const GLint x[], const GLint y[], const void *values,
567                  const GLubyte *mask)
568{
569   /* note: incoming values are RGB+A! */
570   const GLubyte *src = (const GLubyte *) values;
571   GLuint i;
572   ASSERT(rb->_ActualFormat == GL_RGB8);
573   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
574   for (i = 0; i < count; i++) {
575      if (!mask || mask[i]) {
576         GLubyte *dst = (GLubyte *) rb->Data + 3 * (y[i] * rb->Width + x[i]);
577         dst[0] = src[i * 4 + 0];
578         dst[1] = src[i * 4 + 1];
579         dst[2] = src[i * 4 + 2];
580      }
581   }
582}
583
584
585static void
586put_mono_values_ubyte3(GLcontext *ctx, struct gl_renderbuffer *rb,
587                       GLuint count, const GLint x[], const GLint y[],
588                       const void *value, const GLubyte *mask)
589{
590   /* note: incoming value is RGB+A! */
591   const GLubyte val0 = ((const GLubyte *) value)[0];
592   const GLubyte val1 = ((const GLubyte *) value)[1];
593   const GLubyte val2 = ((const GLubyte *) value)[2];
594   GLuint i;
595   ASSERT(rb->_ActualFormat == GL_RGB8);
596   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
597   for (i = 0; i < count; i++) {
598      if (!mask || mask[i]) {
599         GLubyte *dst = (GLubyte *) rb->Data + 3 * (y[i] * rb->Width + x[i]);
600         dst[0] = val0;
601         dst[1] = val1;
602         dst[2] = val2;
603      }
604   }
605}
606
607
608/**********************************************************************
609 * Functions for buffers of 4 X GLubyte (or GLbyte) values.
610 * Typically color buffers.
611 */
612
613static void *
614get_pointer_ubyte4(GLcontext *ctx, struct gl_renderbuffer *rb,
615                   GLint x, GLint y)
616{
617   if (!rb->Data)
618      return NULL;
619   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
620   ASSERT(rb->_ActualFormat == GL_RGBA8);
621   return (GLubyte *) rb->Data + 4 * (y * rb->Width + x);
622}
623
624
625static void
626get_row_ubyte4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
627               GLint x, GLint y, void *values)
628{
629   const GLubyte *src = (const GLubyte *) rb->Data + 4 * (y * rb->Width + x);
630   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
631   ASSERT(rb->_ActualFormat == GL_RGBA8);
632   _mesa_memcpy(values, src, 4 * count * sizeof(GLubyte));
633}
634
635
636static void
637get_values_ubyte4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
638                  const GLint x[], const GLint y[], void *values)
639{
640   /* treat 4*GLubyte as 1*GLuint */
641   GLuint *dst = (GLuint *) values;
642   GLuint i;
643   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
644   ASSERT(rb->_ActualFormat == GL_RGBA8);
645   for (i = 0; i < count; i++) {
646      const GLuint *src = (GLuint *) rb->Data + (y[i] * rb->Width + x[i]);
647      dst[i] = *src;
648   }
649}
650
651
652static void
653put_row_ubyte4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
654               GLint x, GLint y, const void *values, const GLubyte *mask)
655{
656   /* treat 4*GLubyte as 1*GLuint */
657   const GLuint *src = (const GLuint *) values;
658   GLuint *dst = (GLuint *) rb->Data + (y * rb->Width + x);
659   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
660   ASSERT(rb->_ActualFormat == GL_RGBA8);
661   if (mask) {
662      GLuint i;
663      for (i = 0; i < count; i++) {
664         if (mask[i]) {
665            dst[i] = src[i];
666         }
667      }
668   }
669   else {
670      _mesa_memcpy(dst, src, 4 * count * sizeof(GLubyte));
671   }
672}
673
674
675static void
676put_row_rgb_ubyte4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
677                   GLint x, GLint y, const void *values, const GLubyte *mask)
678{
679   /* Store RGB values in RGBA buffer */
680   const GLubyte *src = (const GLubyte *) values;
681   GLubyte *dst = (GLubyte *) rb->Data + 4 * (y * rb->Width + x);
682   GLuint i;
683   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
684   ASSERT(rb->_ActualFormat == GL_RGBA8);
685   for (i = 0; i < count; i++) {
686      if (!mask || mask[i]) {
687         dst[i * 4 + 0] = src[i * 3 + 0];
688         dst[i * 4 + 1] = src[i * 3 + 1];
689         dst[i * 4 + 2] = src[i * 3 + 2];
690         dst[i * 4 + 3] = 0xff;
691      }
692   }
693}
694
695
696static void
697put_mono_row_ubyte4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
698                    GLint x, GLint y, const void *value, const GLubyte *mask)
699{
700   /* treat 4*GLubyte as 1*GLuint */
701   const GLuint val = *((const GLuint *) value);
702   GLuint *dst = (GLuint *) rb->Data + (y * rb->Width + x);
703   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
704   ASSERT(rb->_ActualFormat == GL_RGBA8);
705   if (!mask && val == 0) {
706      /* common case */
707      _mesa_bzero(dst, count * 4 * sizeof(GLubyte));
708   }
709   else {
710      /* general case */
711      if (mask) {
712         GLuint i;
713         for (i = 0; i < count; i++) {
714            if (mask[i]) {
715               dst[i] = val;
716            }
717         }
718      }
719      else {
720         GLuint i;
721         for (i = 0; i < count; i++) {
722            dst[i] = val;
723         }
724      }
725   }
726}
727
728
729static void
730put_values_ubyte4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
731                  const GLint x[], const GLint y[], const void *values,
732                  const GLubyte *mask)
733{
734   /* treat 4*GLubyte as 1*GLuint */
735   const GLuint *src = (const GLuint *) values;
736   GLuint i;
737   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
738   ASSERT(rb->_ActualFormat == GL_RGBA8);
739   for (i = 0; i < count; i++) {
740      if (!mask || mask[i]) {
741         GLuint *dst = (GLuint *) rb->Data + (y[i] * rb->Width + x[i]);
742         *dst = src[i];
743      }
744   }
745}
746
747
748static void
749put_mono_values_ubyte4(GLcontext *ctx, struct gl_renderbuffer *rb,
750                       GLuint count, const GLint x[], const GLint y[],
751                       const void *value, const GLubyte *mask)
752{
753   /* treat 4*GLubyte as 1*GLuint */
754   const GLuint val = *((const GLuint *) value);
755   GLuint i;
756   ASSERT(rb->DataType == GL_UNSIGNED_BYTE);
757   ASSERT(rb->_ActualFormat == GL_RGBA8);
758   for (i = 0; i < count; i++) {
759      if (!mask || mask[i]) {
760         GLuint *dst = (GLuint *) rb->Data + (y[i] * rb->Width + x[i]);
761         *dst = val;
762      }
763   }
764}
765
766
767/**********************************************************************
768 * Functions for buffers of 4 X GLushort (or GLshort) values.
769 * Typically accum buffer.
770 */
771
772static void *
773get_pointer_ushort4(GLcontext *ctx, struct gl_renderbuffer *rb,
774                    GLint x, GLint y)
775{
776   if (!rb->Data)
777      return NULL;
778   ASSERT(rb->DataType == GL_UNSIGNED_SHORT || rb->DataType == GL_SHORT);
779   return (GLushort *) rb->Data + 4 * (y * rb->Width + x);
780}
781
782
783static void
784get_row_ushort4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
785                GLint x, GLint y, void *values)
786{
787   const GLshort *src = (const GLshort *) rb->Data + 4 * (y * rb->Width + x);
788   ASSERT(rb->DataType == GL_UNSIGNED_SHORT || rb->DataType == GL_SHORT);
789   _mesa_memcpy(values, src, 4 * count * sizeof(GLshort));
790}
791
792
793static void
794get_values_ushort4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
795                   const GLint x[], const GLint y[], void *values)
796{
797   GLushort *dst = (GLushort *) values;
798   GLuint i;
799   ASSERT(rb->DataType == GL_UNSIGNED_SHORT || rb->DataType == GL_SHORT);
800   for (i = 0; i < count; i++) {
801      const GLushort *src
802         = (GLushort *) rb->Data + 4 * (y[i] * rb->Width + x[i]);
803      dst[i] = *src;
804   }
805}
806
807
808static void
809put_row_ushort4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
810                GLint x, GLint y, const void *values, const GLubyte *mask)
811{
812   const GLushort *src = (const GLushort *) values;
813   GLushort *dst = (GLushort *) rb->Data + 4 * (y * rb->Width + x);
814   ASSERT(rb->DataType == GL_UNSIGNED_SHORT || rb->DataType == GL_SHORT);
815   if (mask) {
816      GLuint i;
817      for (i = 0; i < count; i++) {
818         if (mask[i]) {
819            dst[i * 4 + 0] = src[i * 4 + 0];
820            dst[i * 4 + 1] = src[i * 4 + 1];
821            dst[i * 4 + 2] = src[i * 4 + 2];
822            dst[i * 4 + 3] = src[i * 4 + 3];
823         }
824      }
825   }
826   else {
827      _mesa_memcpy(dst, src, 4 * count * sizeof(GLushort));
828   }
829}
830
831
832static void
833put_row_rgb_ushort4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
834                    GLint x, GLint y, const void *values, const GLubyte *mask)
835{
836   /* Put RGB values in RGBA buffer */
837   const GLushort *src = (const GLushort *) values;
838   GLushort *dst = (GLushort *) rb->Data + 4 * (y * rb->Width + x);
839   ASSERT(rb->DataType == GL_UNSIGNED_SHORT || rb->DataType == GL_SHORT);
840   if (mask) {
841      GLuint i;
842      for (i = 0; i < count; i++) {
843         if (mask[i]) {
844            dst[i * 4 + 0] = src[i * 3 + 0];
845            dst[i * 4 + 1] = src[i * 3 + 1];
846            dst[i * 4 + 2] = src[i * 3 + 2];
847            dst[i * 4 + 3] = 0xffff;
848         }
849      }
850   }
851   else {
852      _mesa_memcpy(dst, src, 4 * count * sizeof(GLushort));
853   }
854}
855
856
857static void
858put_mono_row_ushort4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
859                     GLint x, GLint y, const void *value, const GLubyte *mask)
860{
861   const GLushort val0 = ((const GLushort *) value)[0];
862   const GLushort val1 = ((const GLushort *) value)[1];
863   const GLushort val2 = ((const GLushort *) value)[2];
864   const GLushort val3 = ((const GLushort *) value)[3];
865   GLushort *dst = (GLushort *) rb->Data + 4 * (y * rb->Width + x);
866   ASSERT(rb->DataType == GL_UNSIGNED_SHORT || rb->DataType == GL_SHORT);
867   if (!mask && val0 == 0 && val1 == 0 && val2 == 0 && val3 == 0) {
868      /* common case for clearing accum buffer */
869      _mesa_bzero(dst, count * 4 * sizeof(GLushort));
870   }
871   else {
872      GLuint i;
873      for (i = 0; i < count; i++) {
874         if (!mask || mask[i]) {
875            dst[i * 4 + 0] = val0;
876            dst[i * 4 + 1] = val1;
877            dst[i * 4 + 2] = val2;
878            dst[i * 4 + 3] = val3;
879         }
880      }
881   }
882}
883
884
885static void
886put_values_ushort4(GLcontext *ctx, struct gl_renderbuffer *rb, GLuint count,
887                   const GLint x[], const GLint y[], const void *values,
888                   const GLubyte *mask)
889{
890   const GLushort *src = (const GLushort *) values;
891   GLuint i;
892   ASSERT(rb->DataType == GL_UNSIGNED_SHORT || rb->DataType == GL_SHORT);
893   for (i = 0; i < count; i++) {
894      if (!mask || mask[i]) {
895         GLushort *dst = (GLushort *) rb->Data + 4 * (y[i] * rb->Width + x[i]);
896         dst[0] = src[i * 4 + 0];
897         dst[1] = src[i * 4 + 1];
898         dst[2] = src[i * 4 + 2];
899         dst[3] = src[i * 4 + 3];
900      }
901   }
902}
903
904
905static void
906put_mono_values_ushort4(GLcontext *ctx, struct gl_renderbuffer *rb,
907                        GLuint count, const GLint x[], const GLint y[],
908                        const void *value, const GLubyte *mask)
909{
910   const GLushort val0 = ((const GLushort *) value)[0];
911   const GLushort val1 = ((const GLushort *) value)[1];
912   const GLushort val2 = ((const GLushort *) value)[2];
913   const GLushort val3 = ((const GLushort *) value)[3];
914   GLuint i;
915   ASSERT(rb->DataType == GL_UNSIGNED_SHORT || rb->DataType == GL_SHORT);
916   for (i = 0; i < count; i++) {
917      if (!mask || mask[i]) {
918         GLushort *dst = (GLushort *) rb->Data + 4 * (y[i] * rb->Width + x[i]);
919         dst[0] = val0;
920         dst[1] = val1;
921         dst[2] = val2;
922         dst[3] = val3;
923      }
924   }
925}
926
927
928
929/**
930 * This is a software fallback for the gl_renderbuffer->AllocStorage
931 * function.
932 * Device drivers will typically override this function for the buffers
933 * which it manages (typically color buffers, Z and stencil).
934 * Other buffers (like software accumulation and aux buffers) which the driver
935 * doesn't manage can be handled with this function.
936 *
937 * This one multi-purpose function can allocate stencil, depth, accum, color
938 * or color-index buffers!
939 *
940 * This function also plugs in the appropriate GetPointer, Get/PutRow and
941 * Get/PutValues functions.
942 */
943GLboolean
944_mesa_soft_renderbuffer_storage(GLcontext *ctx, struct gl_renderbuffer *rb,
945                                GLenum internalFormat,
946                                GLuint width, GLuint height)
947{
948   GLuint pixelSize;
949
950   /* first clear these fields */
951   rb->RedBits =
952   rb->GreenBits =
953   rb->BlueBits =
954   rb->AlphaBits =
955   rb->IndexBits =
956   rb->DepthBits =
957   rb->StencilBits = 0;
958
959   switch (internalFormat) {
960   case GL_RGB:
961   case GL_R3_G3_B2:
962   case GL_RGB4:
963   case GL_RGB5:
964   case GL_RGB8:
965   case GL_RGB10:
966   case GL_RGB12:
967   case GL_RGB16:
968      rb->_ActualFormat = GL_RGB8;
969      rb->_BaseFormat = GL_RGB;
970      rb->DataType = GL_UNSIGNED_BYTE;
971      rb->GetPointer = get_pointer_ubyte3;
972      rb->GetRow = get_row_ubyte3;
973      rb->GetValues = get_values_ubyte3;
974      rb->PutRow = put_row_ubyte3;
975      rb->PutRowRGB = put_row_rgb_ubyte3;
976      rb->PutMonoRow = put_mono_row_ubyte3;
977      rb->PutValues = put_values_ubyte3;
978      rb->PutMonoValues = put_mono_values_ubyte3;
979      rb->RedBits   = 8 * sizeof(GLubyte);
980      rb->GreenBits = 8 * sizeof(GLubyte);
981      rb->BlueBits  = 8 * sizeof(GLubyte);
982      rb->AlphaBits = 0;
983      pixelSize = 3 * sizeof(GLubyte);
984      break;
985   case GL_RGBA:
986   case GL_RGBA2:
987   case GL_RGBA4:
988   case GL_RGB5_A1:
989   case GL_RGBA8:
990      rb->_ActualFormat = GL_RGBA8;
991      rb->_BaseFormat = GL_RGBA;
992      rb->DataType = GL_UNSIGNED_BYTE;
993      rb->GetPointer = get_pointer_ubyte4;
994      rb->GetRow = get_row_ubyte4;
995      rb->GetValues = get_values_ubyte4;
996      rb->PutRow = put_row_ubyte4;
997      rb->PutRowRGB = put_row_rgb_ubyte4;
998      rb->PutMonoRow = put_mono_row_ubyte4;
999      rb->PutValues = put_values_ubyte4;
1000      rb->PutMonoValues = put_mono_values_ubyte4;
1001      rb->RedBits   = 8 * sizeof(GLubyte);
1002      rb->GreenBits = 8 * sizeof(GLubyte);
1003      rb->BlueBits  = 8 * sizeof(GLubyte);
1004      rb->AlphaBits = 8 * sizeof(GLubyte);
1005      pixelSize = 4 * sizeof(GLubyte);
1006      break;
1007   case GL_RGB10_A2:
1008   case GL_RGBA12:
1009   case GL_RGBA16:
1010      rb->_ActualFormat = GL_RGBA16;
1011      rb->_BaseFormat = GL_RGBA;
1012      rb->DataType = GL_UNSIGNED_SHORT;
1013      rb->GetPointer = get_pointer_ushort4;
1014      rb->GetRow = get_row_ushort4;
1015      rb->GetValues = get_values_ushort4;
1016      rb->PutRow = put_row_ushort4;
1017      rb->PutRowRGB = put_row_rgb_ushort4;
1018      rb->PutMonoRow = put_mono_row_ushort4;
1019      rb->PutValues = put_values_ushort4;
1020      rb->PutMonoValues = put_mono_values_ushort4;
1021      rb->RedBits   = 8 * sizeof(GLushort);
1022      rb->GreenBits = 8 * sizeof(GLushort);
1023      rb->BlueBits  = 8 * sizeof(GLushort);
1024      rb->AlphaBits = 8 * sizeof(GLushort);
1025      pixelSize = 4 * sizeof(GLushort);
1026      break;
1027#if 00
1028   case GL_ALPHA8:
1029      rb->_ActualFormat = GL_ALPHA8;
1030      rb->_BaseFormat = GL_RGBA; /* Yes, not GL_ALPHA! */
1031      rb->DataType = GL_UNSIGNED_BYTE;
1032      rb->GetPointer = get_pointer_alpha8;
1033      rb->GetRow = get_row_alpha8;
1034      rb->GetValues = get_values_alpha8;
1035      rb->PutRow = put_row_alpha8;
1036      rb->PutRowRGB = NULL;
1037      rb->PutMonoRow = put_mono_row_alpha8;
1038      rb->PutValues = put_values_alpha8;
1039      rb->PutMonoValues = put_mono_values_alpha8;
1040      rb->RedBits   = 0; /*red*/
1041      rb->GreenBits = 0; /*green*/
1042      rb->BlueBits  = 0; /*blue*/
1043      rb->AlphaBits = 8 * sizeof(GLubyte);
1044      pixelSize = sizeof(GLubyte);
1045      break;
1046#endif
1047   case GL_STENCIL_INDEX:
1048   case GL_STENCIL_INDEX1_EXT:
1049   case GL_STENCIL_INDEX4_EXT:
1050   case GL_STENCIL_INDEX8_EXT:
1051      rb->_ActualFormat = GL_STENCIL_INDEX8_EXT;
1052      rb->_BaseFormat = GL_STENCIL_INDEX;
1053      rb->DataType = GL_UNSIGNED_BYTE;
1054      rb->GetPointer = get_pointer_ubyte;
1055      rb->GetRow = get_row_ubyte;
1056      rb->GetValues = get_values_ubyte;
1057      rb->PutRow = put_row_ubyte;
1058      rb->PutRowRGB = NULL;
1059      rb->PutMonoRow = put_mono_row_ubyte;
1060      rb->PutValues = put_values_ubyte;
1061      rb->PutMonoValues = put_mono_values_ubyte;
1062      rb->StencilBits = 8 * sizeof(GLubyte);
1063      pixelSize = sizeof(GLubyte);
1064      break;
1065   case GL_STENCIL_INDEX16_EXT:
1066      rb->_ActualFormat = GL_STENCIL_INDEX16_EXT;
1067      rb->_BaseFormat = GL_STENCIL_INDEX;
1068      rb->DataType = GL_UNSIGNED_SHORT;
1069      rb->GetPointer = get_pointer_ushort;
1070      rb->GetRow = get_row_ushort;
1071      rb->GetValues = get_values_ushort;
1072      rb->PutRow = put_row_ushort;
1073      rb->PutRowRGB = NULL;
1074      rb->PutMonoRow = put_mono_row_ushort;
1075      rb->PutValues = put_values_ushort;
1076      rb->PutMonoValues = put_mono_values_ushort;
1077      rb->StencilBits = 8 * sizeof(GLushort);
1078      pixelSize = sizeof(GLushort);
1079      break;
1080   case GL_DEPTH_COMPONENT:
1081   case GL_DEPTH_COMPONENT16:
1082      rb->_ActualFormat = GL_DEPTH_COMPONENT16;
1083      rb->_BaseFormat = GL_DEPTH_COMPONENT;
1084      rb->DataType = GL_UNSIGNED_SHORT;
1085      rb->GetPointer = get_pointer_ushort;
1086      rb->GetRow = get_row_ushort;
1087      rb->GetValues = get_values_ushort;
1088      rb->PutRow = put_row_ushort;
1089      rb->PutRowRGB = NULL;
1090      rb->PutMonoRow = put_mono_row_ushort;
1091      rb->PutValues = put_values_ushort;
1092      rb->PutMonoValues = put_mono_values_ushort;
1093      rb->DepthBits = 8 * sizeof(GLushort);
1094      pixelSize = sizeof(GLushort);
1095      break;
1096   case GL_DEPTH_COMPONENT24:
1097   case GL_DEPTH_COMPONENT32:
1098      rb->_BaseFormat = GL_DEPTH_COMPONENT;
1099      rb->DataType = GL_UNSIGNED_INT;
1100      rb->GetPointer = get_pointer_uint;
1101      rb->GetRow = get_row_uint;
1102      rb->GetValues = get_values_uint;
1103      rb->PutRow = put_row_uint;
1104      rb->PutRowRGB = NULL;
1105      rb->PutMonoRow = put_mono_row_uint;
1106      rb->PutValues = put_values_uint;
1107      rb->PutMonoValues = put_mono_values_uint;
1108      if (internalFormat == GL_DEPTH_COMPONENT24) {
1109         rb->_ActualFormat = GL_DEPTH_COMPONENT24;
1110         rb->DepthBits = 24;
1111      }
1112      else {
1113         rb->_ActualFormat = GL_DEPTH_COMPONENT32;
1114         rb->DepthBits = 32;
1115      }
1116      pixelSize = sizeof(GLuint);
1117      break;
1118   case GL_DEPTH_STENCIL_EXT:
1119   case GL_DEPTH24_STENCIL8_EXT:
1120      rb->_ActualFormat = GL_DEPTH24_STENCIL8_EXT;
1121      rb->_BaseFormat = GL_DEPTH_STENCIL_EXT;
1122      rb->DataType = GL_UNSIGNED_INT_24_8_EXT;
1123      rb->GetPointer = get_pointer_uint;
1124      rb->GetRow = get_row_uint;
1125      rb->GetValues = get_values_uint;
1126      rb->PutRow = put_row_uint;
1127      rb->PutRowRGB = NULL;
1128      rb->PutMonoRow = put_mono_row_uint;
1129      rb->PutValues = put_values_uint;
1130      rb->PutMonoValues = put_mono_values_uint;
1131      rb->DepthBits = 24;
1132      rb->StencilBits = 8;
1133      pixelSize = sizeof(GLuint);
1134      break;
1135   case GL_COLOR_INDEX8_EXT:
1136      rb->_ActualFormat = GL_COLOR_INDEX8_EXT;
1137      rb->_BaseFormat = GL_COLOR_INDEX;
1138      rb->DataType = GL_UNSIGNED_BYTE;
1139      rb->GetPointer = get_pointer_ubyte;
1140      rb->GetRow = get_row_ubyte;
1141      rb->GetValues = get_values_ubyte;
1142      rb->PutRow = put_row_ubyte;
1143      rb->PutRowRGB = NULL;
1144      rb->PutMonoRow = put_mono_row_ubyte;
1145      rb->PutValues = put_values_ubyte;
1146      rb->PutMonoValues = put_mono_values_ubyte;
1147      rb->IndexBits = 8 * sizeof(GLubyte);
1148      pixelSize = sizeof(GLubyte);
1149      break;
1150   case GL_COLOR_INDEX16_EXT:
1151      rb->_ActualFormat = GL_COLOR_INDEX16_EXT;
1152      rb->_BaseFormat = GL_COLOR_INDEX;
1153      rb->DataType = GL_UNSIGNED_SHORT;
1154      rb->GetPointer = get_pointer_ushort;
1155      rb->GetRow = get_row_ushort;
1156      rb->GetValues = get_values_ushort;
1157      rb->PutRow = put_row_ushort;
1158      rb->PutRowRGB = NULL;
1159      rb->PutMonoRow = put_mono_row_ushort;
1160      rb->PutValues = put_values_ushort;
1161      rb->PutMonoValues = put_mono_values_ushort;
1162      rb->IndexBits = 8 * sizeof(GLushort);
1163      pixelSize = sizeof(GLushort);
1164      break;
1165   case COLOR_INDEX32:
1166      rb->_ActualFormat = COLOR_INDEX32;
1167      rb->_BaseFormat = GL_COLOR_INDEX;
1168      rb->DataType = GL_UNSIGNED_INT;
1169      rb->GetPointer = get_pointer_uint;
1170      rb->GetRow = get_row_uint;
1171      rb->GetValues = get_values_uint;
1172      rb->PutRow = put_row_uint;
1173      rb->PutRowRGB = NULL;
1174      rb->PutMonoRow = put_mono_row_uint;
1175      rb->PutValues = put_values_uint;
1176      rb->PutMonoValues = put_mono_values_uint;
1177      rb->IndexBits = 8 * sizeof(GLuint);
1178      pixelSize = sizeof(GLuint);
1179      break;
1180   default:
1181      _mesa_problem(ctx, "Bad internalFormat in _mesa_soft_renderbuffer_storage");
1182      return GL_FALSE;
1183   }
1184
1185   ASSERT(rb->DataType);
1186   ASSERT(rb->GetPointer);
1187   ASSERT(rb->GetRow);
1188   ASSERT(rb->GetValues);
1189   ASSERT(rb->PutRow);
1190   ASSERT(rb->PutMonoRow);
1191   ASSERT(rb->PutValues);
1192   ASSERT(rb->PutMonoValues);
1193
1194   /* free old buffer storage */
1195   if (rb->Data) {
1196      _mesa_free(rb->Data);
1197      rb->Data = NULL;
1198   }
1199
1200   if (width > 0 && height > 0) {
1201      /* allocate new buffer storage */
1202      rb->Data = _mesa_malloc(width * height * pixelSize);
1203      if (rb->Data == NULL) {
1204         rb->Width = 0;
1205         rb->Height = 0;
1206         _mesa_error(ctx, GL_OUT_OF_MEMORY,
1207                     "software renderbuffer allocation (%d x %d x %d)",
1208                     width, height, pixelSize);
1209         return GL_FALSE;
1210      }
1211   }
1212
1213   rb->Width = width;
1214   rb->Height = height;
1215
1216   return GL_TRUE;
1217}
1218
1219
1220
1221/**********************************************************************/
1222/**********************************************************************/
1223/**********************************************************************/
1224
1225
1226/**
1227 * Here we utilize the gl_renderbuffer->Wrapper field to put an alpha
1228 * buffer wrapper around an existing RGB renderbuffer (hw or sw).
1229 *
1230 * When PutRow is called (for example), we store the alpha values in
1231 * this buffer, then pass on the PutRow call to the wrapped RGB
1232 * buffer.
1233 */
1234
1235
1236static GLboolean
1237alloc_storage_alpha8(GLcontext *ctx, struct gl_renderbuffer *arb,
1238                     GLenum internalFormat, GLuint width, GLuint height)
1239{
1240   ASSERT(arb != arb->Wrapped);
1241   ASSERT(arb->_ActualFormat == GL_ALPHA8);
1242
1243   /* first, pass the call to the wrapped RGB buffer */
1244   if (!arb->Wrapped->AllocStorage(ctx, arb->Wrapped, internalFormat,
1245                                  width, height)) {
1246      return GL_FALSE;
1247   }
1248
1249   /* next, resize my alpha buffer */
1250   if (arb->Data) {
1251      _mesa_free(arb->Data);
1252   }
1253
1254   arb->Data = _mesa_malloc(width * height * sizeof(GLubyte));
1255   if (arb->Data == NULL) {
1256      arb->Width = 0;
1257      arb->Height = 0;
1258      _mesa_error(ctx, GL_OUT_OF_MEMORY, "software alpha buffer allocation");
1259      return GL_FALSE;
1260   }
1261
1262   arb->Width = width;
1263   arb->Height = height;
1264
1265   return GL_TRUE;
1266}
1267
1268
1269/**
1270 * Delete an alpha_renderbuffer object, as well as the wrapped RGB buffer.
1271 */
1272static void
1273delete_renderbuffer_alpha8(struct gl_renderbuffer *arb)
1274{
1275   if (arb->Data) {
1276      _mesa_free(arb->Data);
1277   }
1278   ASSERT(arb->Wrapped);
1279   ASSERT(arb != arb->Wrapped);
1280   arb->Wrapped->Delete(arb->Wrapped);
1281   arb->Wrapped = NULL;
1282   _mesa_free(arb);
1283}
1284
1285
1286static void *
1287get_pointer_alpha8(GLcontext *ctx, struct gl_renderbuffer *arb,
1288                   GLint x, GLint y)
1289{
1290   return NULL;   /* don't allow direct access! */
1291}
1292
1293
1294static void
1295get_row_alpha8(GLcontext *ctx, struct gl_renderbuffer *arb, GLuint count,
1296               GLint x, GLint y, void *values)
1297{
1298   /* NOTE: 'values' is RGBA format! */
1299   const GLubyte *src = (const GLubyte *) arb->Data + y * arb->Width + x;
1300   GLubyte *dst = (GLubyte *) values;
1301   GLuint i;
1302   ASSERT(arb != arb->Wrapped);
1303   ASSERT(arb->DataType == GL_UNSIGNED_BYTE);
1304   /* first, pass the call to the wrapped RGB buffer */
1305   arb->Wrapped->GetRow(ctx, arb->Wrapped, count, x, y, values);
1306   /* second, fill in alpha values from this buffer! */
1307   for (i = 0; i < count; i++) {
1308      dst[i * 4 + 3] = src[i];
1309   }
1310}
1311
1312
1313static void
1314get_values_alpha8(GLcontext *ctx, struct gl_renderbuffer *arb, GLuint count,
1315                  const GLint x[], const GLint y[], void *values)
1316{
1317   GLubyte *dst = (GLubyte *) values;
1318   GLuint i;
1319   ASSERT(arb != arb->Wrapped);
1320   ASSERT(arb->DataType == GL_UNSIGNED_BYTE);
1321   /* first, pass the call to the wrapped RGB buffer */
1322   arb->Wrapped->GetValues(ctx, arb->Wrapped, count, x, y, values);
1323   /* second, fill in alpha values from this buffer! */
1324   for (i = 0; i < count; i++) {
1325      const GLubyte *src = (GLubyte *) arb->Data + y[i] * arb->Width + x[i];
1326      dst[i * 4 + 3] = *src;
1327   }
1328}
1329
1330
1331static void
1332put_row_alpha8(GLcontext *ctx, struct gl_renderbuffer *arb, GLuint count,
1333               GLint x, GLint y, const void *values, const GLubyte *mask)
1334{
1335   const GLubyte *src = (const GLubyte *) values;
1336   GLubyte *dst = (GLubyte *) arb->Data + y * arb->Width + x;
1337   GLuint i;
1338   ASSERT(arb != arb->Wrapped);
1339   ASSERT(arb->DataType == GL_UNSIGNED_BYTE);
1340   /* first, pass the call to the wrapped RGB buffer */
1341   arb->Wrapped->PutRow(ctx, arb->Wrapped, count, x, y, values, mask);
1342   /* second, store alpha in our buffer */
1343   for (i = 0; i < count; i++) {
1344      if (!mask || mask[i]) {
1345         dst[i] = src[i * 4 + 3];
1346      }
1347   }
1348}
1349
1350
1351static void
1352put_row_rgb_alpha8(GLcontext *ctx, struct gl_renderbuffer *arb, GLuint count,
1353                   GLint x, GLint y, const void *values, const GLubyte *mask)
1354{
1355   const GLubyte *src = (const GLubyte *) values;
1356   GLubyte *dst = (GLubyte *) arb->Data + y * arb->Width + x;
1357   GLuint i;
1358   ASSERT(arb != arb->Wrapped);
1359   ASSERT(arb->DataType == GL_UNSIGNED_BYTE);
1360   /* first, pass the call to the wrapped RGB buffer */
1361   arb->Wrapped->PutRowRGB(ctx, arb->Wrapped, count, x, y, values, mask);
1362   /* second, store alpha in our buffer */
1363   for (i = 0; i < count; i++) {
1364      if (!mask || mask[i]) {
1365         dst[i] = src[i * 4 + 3];
1366      }
1367   }
1368}
1369
1370
1371static void
1372put_mono_row_alpha8(GLcontext *ctx, struct gl_renderbuffer *arb, GLuint count,
1373                    GLint x, GLint y, const void *value, const GLubyte *mask)
1374{
1375   const GLubyte val = ((const GLubyte *) value)[3];
1376   GLubyte *dst = (GLubyte *) arb->Data + y * arb->Width + x;
1377   ASSERT(arb != arb->Wrapped);
1378   ASSERT(arb->DataType == GL_UNSIGNED_BYTE);
1379   /* first, pass the call to the wrapped RGB buffer */
1380   arb->Wrapped->PutMonoRow(ctx, arb->Wrapped, count, x, y, value, mask);
1381   /* second, store alpha in our buffer */
1382   if (mask) {
1383      GLuint i;
1384      for (i = 0; i < count; i++) {
1385         if (mask[i]) {
1386            dst[i] = val;
1387         }
1388      }
1389   }
1390   else {
1391      _mesa_memset(dst, val, count);
1392   }
1393}
1394
1395
1396static void
1397put_values_alpha8(GLcontext *ctx, struct gl_renderbuffer *arb, GLuint count,
1398                  const GLint x[], const GLint y[],
1399                  const void *values, const GLubyte *mask)
1400{
1401   const GLubyte *src = (const GLubyte *) values;
1402   GLuint i;
1403   ASSERT(arb != arb->Wrapped);
1404   ASSERT(arb->DataType == GL_UNSIGNED_BYTE);
1405   /* first, pass the call to the wrapped RGB buffer */
1406   arb->Wrapped->PutValues(ctx, arb->Wrapped, count, x, y, values, mask);
1407   /* second, store alpha in our buffer */
1408   for (i = 0; i < count; i++) {
1409      if (!mask || mask[i]) {
1410         GLubyte *dst = (GLubyte *) arb->Data + y[i] * arb->Width + x[i];
1411         *dst = src[i * 4 + 3];
1412      }
1413   }
1414}
1415
1416
1417static void
1418put_mono_values_alpha8(GLcontext *ctx, struct gl_renderbuffer *arb,
1419                       GLuint count, const GLint x[], const GLint y[],
1420                       const void *value, const GLubyte *mask)
1421{
1422   const GLubyte val = ((const GLubyte *) value)[3];
1423   GLuint i;
1424   ASSERT(arb != arb->Wrapped);
1425   ASSERT(arb->DataType == GL_UNSIGNED_BYTE);
1426   /* first, pass the call to the wrapped RGB buffer */
1427   arb->Wrapped->PutValues(ctx, arb->Wrapped, count, x, y, value, mask);
1428   /* second, store alpha in our buffer */
1429   for (i = 0; i < count; i++) {
1430      if (!mask || mask[i]) {
1431         GLubyte *dst = (GLubyte *) arb->Data + y[i] * arb->Width + x[i];
1432         *dst = val;
1433      }
1434   }
1435}
1436
1437
1438static void
1439copy_buffer_alpha8(struct gl_renderbuffer* dst, struct gl_renderbuffer* src)
1440{
1441   ASSERT(dst->_ActualFormat == GL_ALPHA8);
1442   ASSERT(src->_ActualFormat == GL_ALPHA8);
1443   ASSERT(dst->Width == src->Width);
1444   ASSERT(dst->Height == src->Height);
1445
1446   _mesa_memcpy(dst->Data, src->Data, dst->Width * dst->Height * sizeof(GLubyte));
1447}
1448
1449
1450/**********************************************************************/
1451/**********************************************************************/
1452/**********************************************************************/
1453
1454
1455/**
1456 * Default GetPointer routine.  Always return NULL to indicate that
1457 * direct buffer access is not supported.
1458 */
1459static void *
1460nop_get_pointer(GLcontext *ctx, struct gl_renderbuffer *rb, GLint x, GLint y)
1461{
1462   return NULL;
1463}
1464
1465
1466/**
1467 * Initialize the fields of a gl_renderbuffer to default values.
1468 */
1469void
1470_mesa_init_renderbuffer(struct gl_renderbuffer *rb, GLuint name)
1471{
1472   _glthread_INIT_MUTEX(rb->Mutex);
1473
1474   rb->ClassID = 0;
1475   rb->Name = name;
1476   rb->RefCount = 0;
1477   rb->Delete = _mesa_delete_renderbuffer;
1478
1479   /* The rest of these should be set later by the caller of this function or
1480    * the AllocStorage method:
1481    */
1482   rb->AllocStorage = NULL;
1483
1484   rb->Width = 0;
1485   rb->Height = 0;
1486   rb->InternalFormat = GL_NONE;
1487   rb->_ActualFormat = GL_NONE;
1488   rb->_BaseFormat = GL_NONE;
1489   rb->DataType = GL_NONE;
1490   rb->RedBits = rb->GreenBits = rb->BlueBits = rb->AlphaBits = 0;
1491   rb->IndexBits = 0;
1492   rb->DepthBits = 0;
1493   rb->StencilBits = 0;
1494   rb->Data = NULL;
1495
1496   /* Point back to ourself so that we don't have to check for Wrapped==NULL
1497    * all over the drivers.
1498    */
1499   rb->Wrapped = rb;
1500
1501   rb->GetPointer = nop_get_pointer;
1502   rb->GetRow = NULL;
1503   rb->GetValues = NULL;
1504   rb->PutRow = NULL;
1505   rb->PutRowRGB = NULL;
1506   rb->PutMonoRow = NULL;
1507   rb->PutValues = NULL;
1508   rb->PutMonoValues = NULL;
1509}
1510
1511
1512/**
1513 * Allocate a new gl_renderbuffer object.  This can be used for user-created
1514 * renderbuffers or window-system renderbuffers.
1515 */
1516struct gl_renderbuffer *
1517_mesa_new_renderbuffer(GLcontext *ctx, GLuint name)
1518{
1519   struct gl_renderbuffer *rb = CALLOC_STRUCT(gl_renderbuffer);
1520   if (rb) {
1521      _mesa_init_renderbuffer(rb, name);
1522   }
1523   return rb;
1524}
1525
1526
1527/**
1528 * Delete a gl_framebuffer.
1529 * This is the default function for renderbuffer->Delete().
1530 */
1531void
1532_mesa_delete_renderbuffer(struct gl_renderbuffer *rb)
1533{
1534   if (rb->Data) {
1535      _mesa_free(rb->Data);
1536   }
1537   _mesa_free(rb);
1538}
1539
1540
1541/**
1542 * Allocate a software-based renderbuffer.  This is called via the
1543 * ctx->Driver.NewRenderbuffer() function when the user creates a new
1544 * renderbuffer.
1545 * This would not be used for hardware-based renderbuffers.
1546 */
1547struct gl_renderbuffer *
1548_mesa_new_soft_renderbuffer(GLcontext *ctx, GLuint name)
1549{
1550   struct gl_renderbuffer *rb = _mesa_new_renderbuffer(ctx, name);
1551   if (rb) {
1552      rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1553      /* Normally, one would setup the PutRow, GetRow, etc functions here.
1554       * But we're doing that in the _mesa_soft_renderbuffer_storage() function
1555       * instead.
1556       */
1557   }
1558   return rb;
1559}
1560
1561
1562/**
1563 * Add software-based color renderbuffers to the given framebuffer.
1564 * This is a helper routine for device drivers when creating a
1565 * window system framebuffer (not a user-created render/framebuffer).
1566 * Once this function is called, you can basically forget about this
1567 * renderbuffer; core Mesa will handle all the buffer management and
1568 * rendering!
1569 */
1570GLboolean
1571_mesa_add_color_renderbuffers(GLcontext *ctx, struct gl_framebuffer *fb,
1572                              GLuint rgbBits, GLuint alphaBits,
1573                              GLboolean frontLeft, GLboolean backLeft,
1574                              GLboolean frontRight, GLboolean backRight)
1575{
1576   GLuint b;
1577
1578   if (rgbBits > 16 || alphaBits > 16) {
1579      _mesa_problem(ctx,
1580                    "Unsupported bit depth in _mesa_add_color_renderbuffers");
1581      return GL_FALSE;
1582   }
1583
1584   assert(MAX_COLOR_ATTACHMENTS >= 4);
1585
1586   for (b = BUFFER_FRONT_LEFT; b <= BUFFER_BACK_RIGHT; b++) {
1587      struct gl_renderbuffer *rb;
1588
1589      if (b == BUFFER_FRONT_LEFT && !frontLeft)
1590         continue;
1591      else if (b == BUFFER_BACK_LEFT && !backLeft)
1592         continue;
1593      else if (b == BUFFER_FRONT_RIGHT && !frontRight)
1594         continue;
1595      else if (b == BUFFER_BACK_RIGHT && !backRight)
1596         continue;
1597
1598      assert(fb->Attachment[b].Renderbuffer == NULL);
1599
1600      rb = _mesa_new_renderbuffer(ctx, 0);
1601      if (!rb) {
1602         _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating color buffer");
1603         return GL_FALSE;
1604      }
1605
1606      if (rgbBits <= 8) {
1607         if (alphaBits)
1608            rb->_ActualFormat = GL_RGBA8;
1609         else
1610            rb->_ActualFormat = GL_RGB8;
1611      }
1612      else {
1613         assert(rgbBits <= 16);
1614         if (alphaBits)
1615            rb->_ActualFormat = GL_RGBA16;
1616         else
1617            rb->_ActualFormat = GL_RGBA16; /* don't really have RGB16 yet */
1618      }
1619      rb->InternalFormat = rb->_ActualFormat;
1620
1621      rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1622      _mesa_add_renderbuffer(fb, b, rb);
1623   }
1624
1625   return GL_TRUE;
1626}
1627
1628
1629/**
1630 * Add software-based color index renderbuffers to the given framebuffer.
1631 * This is a helper routine for device drivers when creating a
1632 * window system framebuffer (not a user-created render/framebuffer).
1633 * Once this function is called, you can basically forget about this
1634 * renderbuffer; core Mesa will handle all the buffer management and
1635 * rendering!
1636 */
1637GLboolean
1638_mesa_add_color_index_renderbuffers(GLcontext *ctx, struct gl_framebuffer *fb,
1639                                    GLuint indexBits,
1640                                    GLboolean frontLeft, GLboolean backLeft,
1641                                    GLboolean frontRight, GLboolean backRight)
1642{
1643   GLuint b;
1644
1645   if (indexBits > 8) {
1646      _mesa_problem(ctx,
1647                "Unsupported bit depth in _mesa_add_color_index_renderbuffers");
1648      return GL_FALSE;
1649   }
1650
1651   assert(MAX_COLOR_ATTACHMENTS >= 4);
1652
1653   for (b = BUFFER_FRONT_LEFT; b <= BUFFER_BACK_RIGHT; b++) {
1654      struct gl_renderbuffer *rb;
1655
1656      if (b == BUFFER_FRONT_LEFT && !frontLeft)
1657         continue;
1658      else if (b == BUFFER_BACK_LEFT && !backLeft)
1659         continue;
1660      else if (b == BUFFER_FRONT_RIGHT && !frontRight)
1661         continue;
1662      else if (b == BUFFER_BACK_RIGHT && !backRight)
1663         continue;
1664
1665      assert(fb->Attachment[b].Renderbuffer == NULL);
1666
1667      rb = _mesa_new_renderbuffer(ctx, 0);
1668      if (!rb) {
1669         _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating color buffer");
1670         return GL_FALSE;
1671      }
1672
1673      if (indexBits <= 8) {
1674         /* only support GLuint for now */
1675         /*rb->InternalFormat = GL_COLOR_INDEX8_EXT;*/
1676         rb->_ActualFormat = COLOR_INDEX32;
1677      }
1678      else {
1679         rb->_ActualFormat = COLOR_INDEX32;
1680      }
1681      rb->InternalFormat = rb->_ActualFormat;
1682
1683      rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1684      _mesa_add_renderbuffer(fb, b, rb);
1685   }
1686
1687   return GL_TRUE;
1688}
1689
1690
1691/**
1692 * Add software-based alpha renderbuffers to the given framebuffer.
1693 * This is a helper routine for device drivers when creating a
1694 * window system framebuffer (not a user-created render/framebuffer).
1695 * Once this function is called, you can basically forget about this
1696 * renderbuffer; core Mesa will handle all the buffer management and
1697 * rendering!
1698 */
1699GLboolean
1700_mesa_add_alpha_renderbuffers(GLcontext *ctx, struct gl_framebuffer *fb,
1701                              GLuint alphaBits,
1702                              GLboolean frontLeft, GLboolean backLeft,
1703                              GLboolean frontRight, GLboolean backRight)
1704{
1705   GLuint b;
1706
1707   /* for window system framebuffers only! */
1708   assert(fb->Name == 0);
1709
1710   if (alphaBits > 8) {
1711      _mesa_problem(ctx,
1712                    "Unsupported bit depth in _mesa_add_alpha_renderbuffers");
1713      return GL_FALSE;
1714   }
1715
1716   assert(MAX_COLOR_ATTACHMENTS >= 4);
1717
1718   /* Wrap each of the RGB color buffers with an alpha renderbuffer.
1719    */
1720   for (b = BUFFER_FRONT_LEFT; b <= BUFFER_BACK_RIGHT; b++) {
1721      struct gl_renderbuffer *arb;
1722
1723      if (b == BUFFER_FRONT_LEFT && !frontLeft)
1724         continue;
1725      else if (b == BUFFER_BACK_LEFT && !backLeft)
1726         continue;
1727      else if (b == BUFFER_FRONT_RIGHT && !frontRight)
1728         continue;
1729      else if (b == BUFFER_BACK_RIGHT && !backRight)
1730         continue;
1731
1732      /* the RGB buffer to wrap must already exist!! */
1733      assert(fb->Attachment[b].Renderbuffer);
1734
1735      /* only GLubyte supported for now */
1736      assert(fb->Attachment[b].Renderbuffer->DataType == GL_UNSIGNED_BYTE);
1737
1738      /* allocate alpha renderbuffer */
1739      arb = _mesa_new_renderbuffer(ctx, 0);
1740      if (!arb) {
1741         _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating alpha buffer");
1742         return GL_FALSE;
1743      }
1744
1745      /* wrap the alpha renderbuffer around the RGB renderbuffer */
1746      arb->Wrapped = fb->Attachment[b].Renderbuffer;
1747
1748      /* Set up my alphabuffer fields and plug in my functions.
1749       * The functions will put/get the alpha values from/to RGBA arrays
1750       * and then call the wrapped buffer's functions to handle the RGB
1751       * values.
1752       */
1753      arb->InternalFormat = arb->Wrapped->InternalFormat;
1754      arb->_ActualFormat  = GL_ALPHA8;
1755      arb->_BaseFormat    = arb->Wrapped->_BaseFormat;
1756      arb->DataType       = arb->Wrapped->DataType;
1757      arb->AllocStorage   = alloc_storage_alpha8;
1758      arb->Delete         = delete_renderbuffer_alpha8;
1759      arb->GetPointer     = get_pointer_alpha8;
1760      arb->GetRow         = get_row_alpha8;
1761      arb->GetValues      = get_values_alpha8;
1762      arb->PutRow         = put_row_alpha8;
1763      arb->PutRowRGB      = put_row_rgb_alpha8;
1764      arb->PutMonoRow     = put_mono_row_alpha8;
1765      arb->PutValues      = put_values_alpha8;
1766      arb->PutMonoValues  = put_mono_values_alpha8;
1767
1768      /* clear the pointer to avoid assertion/sanity check failure later */
1769      fb->Attachment[b].Renderbuffer = NULL;
1770
1771      /* plug the alpha renderbuffer into the colorbuffer attachment */
1772      _mesa_add_renderbuffer(fb, b, arb);
1773   }
1774
1775   return GL_TRUE;
1776}
1777
1778
1779/**
1780 * For framebuffers that use a software alpha channel wrapper
1781 * created by _mesa_add_alpha_renderbuffer or _mesa_add_soft_renderbuffers,
1782 * copy the back buffer alpha channel into the front buffer alpha channel.
1783 */
1784void
1785_mesa_copy_soft_alpha_renderbuffers(GLcontext *ctx, struct gl_framebuffer *fb)
1786{
1787   if (fb->Attachment[BUFFER_FRONT_LEFT].Renderbuffer &&
1788       fb->Attachment[BUFFER_BACK_LEFT].Renderbuffer)
1789      copy_buffer_alpha8(fb->Attachment[BUFFER_FRONT_LEFT].Renderbuffer,
1790                         fb->Attachment[BUFFER_BACK_LEFT].Renderbuffer);
1791
1792
1793   if (fb->Attachment[BUFFER_FRONT_RIGHT].Renderbuffer &&
1794       fb->Attachment[BUFFER_BACK_RIGHT].Renderbuffer)
1795      copy_buffer_alpha8(fb->Attachment[BUFFER_FRONT_RIGHT].Renderbuffer,
1796                         fb->Attachment[BUFFER_BACK_RIGHT].Renderbuffer);
1797}
1798
1799
1800/**
1801 * Add a software-based depth renderbuffer to the given framebuffer.
1802 * This is a helper routine for device drivers when creating a
1803 * window system framebuffer (not a user-created render/framebuffer).
1804 * Once this function is called, you can basically forget about this
1805 * renderbuffer; core Mesa will handle all the buffer management and
1806 * rendering!
1807 */
1808GLboolean
1809_mesa_add_depth_renderbuffer(GLcontext *ctx, struct gl_framebuffer *fb,
1810                             GLuint depthBits)
1811{
1812   struct gl_renderbuffer *rb;
1813
1814   if (depthBits > 32) {
1815      _mesa_problem(ctx,
1816                    "Unsupported depthBits in _mesa_add_depth_renderbuffer");
1817      return GL_FALSE;
1818   }
1819
1820   assert(fb->Attachment[BUFFER_DEPTH].Renderbuffer == NULL);
1821
1822   rb = _mesa_new_renderbuffer(ctx, 0);
1823   if (!rb) {
1824      _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating depth buffer");
1825      return GL_FALSE;
1826   }
1827
1828   if (depthBits <= 16) {
1829      rb->_ActualFormat = GL_DEPTH_COMPONENT16;
1830   }
1831   else if (depthBits <= 24) {
1832      rb->_ActualFormat = GL_DEPTH_COMPONENT24;
1833   }
1834   else {
1835      rb->_ActualFormat = GL_DEPTH_COMPONENT32;
1836   }
1837   rb->InternalFormat = rb->_ActualFormat;
1838
1839   rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1840   _mesa_add_renderbuffer(fb, BUFFER_DEPTH, rb);
1841
1842   return GL_TRUE;
1843}
1844
1845
1846/**
1847 * Add a software-based stencil renderbuffer to the given framebuffer.
1848 * This is a helper routine for device drivers when creating a
1849 * window system framebuffer (not a user-created render/framebuffer).
1850 * Once this function is called, you can basically forget about this
1851 * renderbuffer; core Mesa will handle all the buffer management and
1852 * rendering!
1853 */
1854GLboolean
1855_mesa_add_stencil_renderbuffer(GLcontext *ctx, struct gl_framebuffer *fb,
1856                               GLuint stencilBits)
1857{
1858   struct gl_renderbuffer *rb;
1859
1860   if (stencilBits > 16) {
1861      _mesa_problem(ctx,
1862                  "Unsupported stencilBits in _mesa_add_stencil_renderbuffer");
1863      return GL_FALSE;
1864   }
1865
1866   assert(fb->Attachment[BUFFER_STENCIL].Renderbuffer == NULL);
1867
1868   rb = _mesa_new_renderbuffer(ctx, 0);
1869   if (!rb) {
1870      _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating stencil buffer");
1871      return GL_FALSE;
1872   }
1873
1874   if (stencilBits <= 8) {
1875      rb->_ActualFormat = GL_STENCIL_INDEX8_EXT;
1876   }
1877   else {
1878      /* not really supported (see s_stencil.c code) */
1879      rb->_ActualFormat = GL_STENCIL_INDEX16_EXT;
1880   }
1881   rb->InternalFormat = rb->_ActualFormat;
1882
1883   rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1884   _mesa_add_renderbuffer(fb, BUFFER_STENCIL, rb);
1885
1886   return GL_TRUE;
1887}
1888
1889
1890/**
1891 * Add a software-based accumulation renderbuffer to the given framebuffer.
1892 * This is a helper routine for device drivers when creating a
1893 * window system framebuffer (not a user-created render/framebuffer).
1894 * Once this function is called, you can basically forget about this
1895 * renderbuffer; core Mesa will handle all the buffer management and
1896 * rendering!
1897 */
1898GLboolean
1899_mesa_add_accum_renderbuffer(GLcontext *ctx, struct gl_framebuffer *fb,
1900                             GLuint redBits, GLuint greenBits,
1901                             GLuint blueBits, GLuint alphaBits)
1902{
1903   struct gl_renderbuffer *rb;
1904
1905   if (redBits > 16 || greenBits > 16 || blueBits > 16 || alphaBits > 16) {
1906      _mesa_problem(ctx,
1907                    "Unsupported accumBits in _mesa_add_accum_renderbuffer");
1908      return GL_FALSE;
1909   }
1910
1911   assert(fb->Attachment[BUFFER_ACCUM].Renderbuffer == NULL);
1912
1913   rb = _mesa_new_renderbuffer(ctx, 0);
1914   if (!rb) {
1915      _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating accum buffer");
1916      return GL_FALSE;
1917   }
1918
1919   rb->_ActualFormat = GL_RGBA16;
1920   rb->InternalFormat = GL_RGBA16;
1921   rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1922   _mesa_add_renderbuffer(fb, BUFFER_ACCUM, rb);
1923
1924   return GL_TRUE;
1925}
1926
1927
1928
1929/**
1930 * Add a software-based accumulation renderbuffer to the given framebuffer.
1931 * This is a helper routine for device drivers when creating a
1932 * window system framebuffer (not a user-created render/framebuffer).
1933 * Once this function is called, you can basically forget about this
1934 * renderbuffer; core Mesa will handle all the buffer management and
1935 * rendering!
1936 *
1937 * NOTE: color-index aux buffers not supported.
1938 */
1939GLboolean
1940_mesa_add_aux_renderbuffers(GLcontext *ctx, struct gl_framebuffer *fb,
1941                            GLuint colorBits, GLuint numBuffers)
1942{
1943   GLuint i;
1944
1945   if (colorBits > 16) {
1946      _mesa_problem(ctx,
1947                    "Unsupported accumBits in _mesa_add_aux_renderbuffers");
1948      return GL_FALSE;
1949   }
1950
1951   assert(numBuffers < MAX_AUX_BUFFERS);
1952
1953   for (i = 0; i < numBuffers; i++) {
1954      struct gl_renderbuffer *rb = _mesa_new_renderbuffer(ctx, 0);
1955
1956      assert(fb->Attachment[BUFFER_AUX0 + i].Renderbuffer == NULL);
1957
1958      if (!rb) {
1959         _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating accum buffer");
1960         return GL_FALSE;
1961      }
1962
1963      if (colorBits <= 8) {
1964         rb->_ActualFormat = GL_RGBA8;
1965      }
1966      else {
1967         rb->_ActualFormat = GL_RGBA16;
1968      }
1969      rb->InternalFormat = rb->_ActualFormat;
1970
1971      rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1972      _mesa_add_renderbuffer(fb, BUFFER_AUX0 + i, rb);
1973   }
1974   return GL_TRUE;
1975}
1976
1977
1978/**
1979 * Create/attach software-based renderbuffers to the given framebuffer.
1980 * This is a helper routine for device drivers.  Drivers can just as well
1981 * call the individual _mesa_add_*_renderbuffer() routines directly.
1982 */
1983void
1984_mesa_add_soft_renderbuffers(struct gl_framebuffer *fb,
1985                             GLboolean color,
1986                             GLboolean depth,
1987                             GLboolean stencil,
1988                             GLboolean accum,
1989                             GLboolean alpha,
1990                             GLboolean aux)
1991{
1992   GLboolean frontLeft = GL_TRUE;
1993   GLboolean backLeft = fb->Visual.doubleBufferMode;
1994   GLboolean frontRight = fb->Visual.stereoMode;
1995   GLboolean backRight = fb->Visual.stereoMode && fb->Visual.doubleBufferMode;
1996
1997   if (color) {
1998      if (fb->Visual.rgbMode) {
1999         assert(fb->Visual.redBits == fb->Visual.greenBits);
2000         assert(fb->Visual.redBits == fb->Visual.blueBits);
2001         _mesa_add_color_renderbuffers(NULL, fb,
2002                                       fb->Visual.redBits,
2003                                       fb->Visual.alphaBits,
2004                                       frontLeft, backLeft,
2005                                       frontRight, backRight);
2006      }
2007      else {
2008         _mesa_add_color_index_renderbuffers(NULL, fb,
2009                                             fb->Visual.indexBits,
2010                                             frontLeft, backLeft,
2011                                             frontRight, backRight);
2012      }
2013   }
2014
2015   if (depth) {
2016      assert(fb->Visual.depthBits > 0);
2017      _mesa_add_depth_renderbuffer(NULL, fb, fb->Visual.depthBits);
2018   }
2019
2020   if (stencil) {
2021      assert(fb->Visual.stencilBits > 0);
2022      _mesa_add_stencil_renderbuffer(NULL, fb, fb->Visual.stencilBits);
2023   }
2024
2025   if (accum) {
2026      assert(fb->Visual.rgbMode);
2027      assert(fb->Visual.accumRedBits > 0);
2028      assert(fb->Visual.accumGreenBits > 0);
2029      assert(fb->Visual.accumBlueBits > 0);
2030      _mesa_add_accum_renderbuffer(NULL, fb,
2031                                   fb->Visual.accumRedBits,
2032                                   fb->Visual.accumGreenBits,
2033                                   fb->Visual.accumBlueBits,
2034                                   fb->Visual.accumAlphaBits);
2035   }
2036
2037   if (aux) {
2038      assert(fb->Visual.rgbMode);
2039      assert(fb->Visual.numAuxBuffers > 0);
2040      _mesa_add_aux_renderbuffers(NULL, fb, fb->Visual.redBits,
2041                                  fb->Visual.numAuxBuffers);
2042   }
2043
2044   if (alpha) {
2045      assert(fb->Visual.rgbMode);
2046      assert(fb->Visual.alphaBits > 0);
2047      _mesa_add_alpha_renderbuffers(NULL, fb, fb->Visual.alphaBits,
2048                                    frontLeft, backLeft,
2049                                    frontRight, backRight);
2050   }
2051
2052#if 0
2053   if (multisample) {
2054      /* maybe someday */
2055   }
2056#endif
2057}
2058
2059
2060/**
2061 * Attach a renderbuffer to a framebuffer.
2062 */
2063void
2064_mesa_add_renderbuffer(struct gl_framebuffer *fb,
2065                       GLuint bufferName, struct gl_renderbuffer *rb)
2066{
2067   assert(fb);
2068   assert(rb);
2069   assert(bufferName < BUFFER_COUNT);
2070
2071   /* There should be no previous renderbuffer on this attachment point,
2072    * with the exception of depth/stencil since the same renderbuffer may
2073    * be used for both.
2074    */
2075   assert(bufferName == BUFFER_DEPTH ||
2076          bufferName == BUFFER_STENCIL ||
2077          fb->Attachment[bufferName].Renderbuffer == NULL);
2078
2079   /* winsys vs. user-created buffer cross check */
2080   if (fb->Name) {
2081      assert(rb->Name);
2082   }
2083   else {
2084      assert(!rb->Name);
2085   }
2086
2087   /* If Mesa's compiled with deep color channels (16 or 32 bits / channel)
2088    * and the device driver is expecting 8-bit values (GLubyte), we can
2089    * use a "renderbuffer adaptor/wrapper" to do the necessary conversions.
2090    */
2091   if (rb->_BaseFormat == GL_RGBA) {
2092      if (CHAN_BITS == 16 && rb->DataType == GL_UNSIGNED_BYTE) {
2093         GET_CURRENT_CONTEXT(ctx);
2094         rb = _mesa_new_renderbuffer_16wrap8(ctx, rb);
2095      }
2096      else if (CHAN_BITS == 32 && rb->DataType == GL_UNSIGNED_BYTE) {
2097         GET_CURRENT_CONTEXT(ctx);
2098         rb = _mesa_new_renderbuffer_32wrap8(ctx, rb);
2099      }
2100      else if (CHAN_BITS == 32 && rb->DataType == GL_UNSIGNED_SHORT) {
2101         GET_CURRENT_CONTEXT(ctx);
2102         rb = _mesa_new_renderbuffer_32wrap16(ctx, rb);
2103      }
2104   }
2105
2106   fb->Attachment[bufferName].Type = GL_RENDERBUFFER_EXT;
2107   fb->Attachment[bufferName].Complete = GL_TRUE;
2108   _mesa_reference_renderbuffer(&fb->Attachment[bufferName].Renderbuffer, rb);
2109}
2110
2111
2112/**
2113 * Remove the named renderbuffer from the given framebuffer.
2114 */
2115void
2116_mesa_remove_renderbuffer(struct gl_framebuffer *fb, GLuint bufferName)
2117{
2118   struct gl_renderbuffer *rb;
2119
2120   assert(bufferName < BUFFER_COUNT);
2121
2122   rb = fb->Attachment[bufferName].Renderbuffer;
2123   if (!rb)
2124      return;
2125
2126   _mesa_reference_renderbuffer(&rb, NULL);
2127
2128   fb->Attachment[bufferName].Renderbuffer = NULL;
2129}
2130
2131
2132/**
2133 * Set *ptr to point to rb.  If *ptr points to another renderbuffer,
2134 * dereference that buffer first.  The new renderbuffer's refcount will
2135 * be incremented.  The old renderbuffer's refcount will be decremented.
2136 */
2137void
2138_mesa_reference_renderbuffer(struct gl_renderbuffer **ptr,
2139                             struct gl_renderbuffer *rb)
2140{
2141   assert(ptr);
2142   if (*ptr == rb) {
2143      /* no change */
2144      return;
2145   }
2146
2147   if (*ptr) {
2148      /* Unreference the old renderbuffer */
2149      GLboolean deleteFlag = GL_FALSE;
2150      struct gl_renderbuffer *oldRb = *ptr;
2151
2152      _glthread_LOCK_MUTEX(oldRb->Mutex);
2153      ASSERT(oldRb->RefCount > 0);
2154      oldRb->RefCount--;
2155      /*printf("RB DECR %p to %d\n", (void*) oldRb, oldRb->RefCount);*/
2156      deleteFlag = (oldRb->RefCount == 0);
2157      _glthread_UNLOCK_MUTEX(oldRb->Mutex);
2158
2159      if (deleteFlag)
2160         oldRb->Delete(oldRb);
2161
2162      *ptr = NULL;
2163   }
2164   assert(!*ptr);
2165
2166   if (rb) {
2167      /* reference new renderbuffer */
2168      _glthread_LOCK_MUTEX(rb->Mutex);
2169      rb->RefCount++;
2170      /*printf("RB REF  %p to %d\n", (void*)rb, rb->RefCount);*/
2171      _glthread_UNLOCK_MUTEX(rb->Mutex);
2172      *ptr = rb;
2173   }
2174}
2175
2176
2177/**
2178 * Create a new combined depth/stencil renderbuffer for implementing
2179 * the GL_EXT_packed_depth_stencil extension.
2180 * \return new depth/stencil renderbuffer
2181 */
2182struct gl_renderbuffer *
2183_mesa_new_depthstencil_renderbuffer(GLcontext *ctx, GLuint name)
2184{
2185   struct gl_renderbuffer *dsrb;
2186
2187   dsrb = _mesa_new_renderbuffer(ctx, name);
2188   if (!dsrb)
2189      return NULL;
2190
2191   /* init fields not covered by _mesa_new_renderbuffer() */
2192   dsrb->InternalFormat = GL_DEPTH24_STENCIL8_EXT;
2193   dsrb->_ActualFormat = GL_DEPTH24_STENCIL8_EXT;
2194   dsrb->AllocStorage = _mesa_soft_renderbuffer_storage;
2195
2196   return dsrb;
2197}
2198