renderbuffer.c revision e5070bc3ca75dee31034cc543f3d2ee04e5dc032
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
1438
1439/**********************************************************************/
1440/**********************************************************************/
1441/**********************************************************************/
1442
1443
1444/**
1445 * Default GetPointer routine.  Always return NULL to indicate that
1446 * direct buffer access is not supported.
1447 */
1448static void *
1449nop_get_pointer(GLcontext *ctx, struct gl_renderbuffer *rb, GLint x, GLint y)
1450{
1451   return NULL;
1452}
1453
1454
1455/**
1456 * Initialize the fields of a gl_renderbuffer to default values.
1457 */
1458void
1459_mesa_init_renderbuffer(struct gl_renderbuffer *rb, GLuint name)
1460{
1461   _glthread_INIT_MUTEX(rb->Mutex);
1462
1463   rb->ClassID = 0;
1464   rb->Name = name;
1465   rb->RefCount = 1;
1466   rb->Delete = _mesa_delete_renderbuffer;
1467
1468   /* The rest of these should be set later by the caller of this function or
1469    * the AllocStorage method:
1470    */
1471   rb->AllocStorage = NULL;
1472
1473   rb->Width = 0;
1474   rb->Height = 0;
1475   rb->InternalFormat = GL_NONE;
1476   rb->_ActualFormat = GL_NONE;
1477   rb->_BaseFormat = GL_NONE;
1478   rb->DataType = GL_NONE;
1479   rb->RedBits = rb->GreenBits = rb->BlueBits = rb->AlphaBits = 0;
1480   rb->IndexBits = 0;
1481   rb->DepthBits = 0;
1482   rb->StencilBits = 0;
1483   rb->Data = NULL;
1484
1485   /* Point back to ourself so that we don't have to check for Wrapped==NULL
1486    * all over the drivers.
1487    */
1488   rb->Wrapped = rb;
1489
1490   rb->GetPointer = nop_get_pointer;
1491   rb->GetRow = NULL;
1492   rb->GetValues = NULL;
1493   rb->PutRow = NULL;
1494   rb->PutRowRGB = NULL;
1495   rb->PutMonoRow = NULL;
1496   rb->PutValues = NULL;
1497   rb->PutMonoValues = NULL;
1498}
1499
1500
1501/**
1502 * Allocate a new gl_renderbuffer object.  This can be used for user-created
1503 * renderbuffers or window-system renderbuffers.
1504 */
1505struct gl_renderbuffer *
1506_mesa_new_renderbuffer(GLcontext *ctx, GLuint name)
1507{
1508   struct gl_renderbuffer *rb = CALLOC_STRUCT(gl_renderbuffer);
1509   if (rb) {
1510      _mesa_init_renderbuffer(rb, name);
1511   }
1512   return rb;
1513}
1514
1515
1516/**
1517 * Delete a gl_framebuffer.
1518 * This is the default function for renderbuffer->Delete().
1519 */
1520void
1521_mesa_delete_renderbuffer(struct gl_renderbuffer *rb)
1522{
1523   if (rb->Data) {
1524      _mesa_free(rb->Data);
1525   }
1526   _mesa_free(rb);
1527}
1528
1529
1530/**
1531 * Allocate a software-based renderbuffer.  This is called via the
1532 * ctx->Driver.NewRenderbuffer() function when the user creates a new
1533 * renderbuffer.
1534 * This would not be used for hardware-based renderbuffers.
1535 */
1536struct gl_renderbuffer *
1537_mesa_new_soft_renderbuffer(GLcontext *ctx, GLuint name)
1538{
1539   struct gl_renderbuffer *rb = _mesa_new_renderbuffer(ctx, name);
1540   if (rb) {
1541      rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1542      /* Normally, one would setup the PutRow, GetRow, etc functions here.
1543       * But we're doing that in the _mesa_soft_renderbuffer_storage() function
1544       * instead.
1545       */
1546   }
1547   return rb;
1548}
1549
1550
1551/**
1552 * Add software-based color renderbuffers to the given framebuffer.
1553 * This is a helper routine for device drivers when creating a
1554 * window system framebuffer (not a user-created render/framebuffer).
1555 * Once this function is called, you can basically forget about this
1556 * renderbuffer; core Mesa will handle all the buffer management and
1557 * rendering!
1558 */
1559GLboolean
1560_mesa_add_color_renderbuffers(GLcontext *ctx, struct gl_framebuffer *fb,
1561                              GLuint rgbBits, GLuint alphaBits,
1562                              GLboolean frontLeft, GLboolean backLeft,
1563                              GLboolean frontRight, GLboolean backRight)
1564{
1565   GLuint b;
1566
1567   if (rgbBits > 16 || alphaBits > 16) {
1568      _mesa_problem(ctx,
1569                    "Unsupported bit depth in _mesa_add_color_renderbuffers");
1570      return GL_FALSE;
1571   }
1572
1573   assert(MAX_COLOR_ATTACHMENTS >= 4);
1574
1575   for (b = BUFFER_FRONT_LEFT; b <= BUFFER_BACK_RIGHT; b++) {
1576      struct gl_renderbuffer *rb;
1577
1578      if (b == BUFFER_FRONT_LEFT && !frontLeft)
1579         continue;
1580      else if (b == BUFFER_BACK_LEFT && !backLeft)
1581         continue;
1582      else if (b == BUFFER_FRONT_RIGHT && !frontRight)
1583         continue;
1584      else if (b == BUFFER_BACK_RIGHT && !backRight)
1585         continue;
1586
1587      assert(fb->Attachment[b].Renderbuffer == NULL);
1588
1589      rb = _mesa_new_renderbuffer(ctx, 0);
1590      if (!rb) {
1591         _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating color buffer");
1592         return GL_FALSE;
1593      }
1594
1595      if (rgbBits <= 8) {
1596         if (alphaBits)
1597            rb->_ActualFormat = GL_RGBA8;
1598         else
1599            rb->_ActualFormat = GL_RGB8;
1600      }
1601      else {
1602         assert(rgbBits <= 16);
1603         if (alphaBits)
1604            rb->_ActualFormat = GL_RGBA16;
1605         else
1606            rb->_ActualFormat = GL_RGBA16; /* don't really have RGB16 yet */
1607      }
1608      rb->InternalFormat = rb->_ActualFormat;
1609
1610      rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1611      _mesa_add_renderbuffer(fb, b, rb);
1612   }
1613
1614   return GL_TRUE;
1615}
1616
1617
1618/**
1619 * Add software-based color index renderbuffers to the given framebuffer.
1620 * This is a helper routine for device drivers when creating a
1621 * window system framebuffer (not a user-created render/framebuffer).
1622 * Once this function is called, you can basically forget about this
1623 * renderbuffer; core Mesa will handle all the buffer management and
1624 * rendering!
1625 */
1626GLboolean
1627_mesa_add_color_index_renderbuffers(GLcontext *ctx, struct gl_framebuffer *fb,
1628                                    GLuint indexBits,
1629                                    GLboolean frontLeft, GLboolean backLeft,
1630                                    GLboolean frontRight, GLboolean backRight)
1631{
1632   GLuint b;
1633
1634   if (indexBits > 8) {
1635      _mesa_problem(ctx,
1636                "Unsupported bit depth in _mesa_add_color_index_renderbuffers");
1637      return GL_FALSE;
1638   }
1639
1640   assert(MAX_COLOR_ATTACHMENTS >= 4);
1641
1642   for (b = BUFFER_FRONT_LEFT; b <= BUFFER_BACK_RIGHT; b++) {
1643      struct gl_renderbuffer *rb;
1644
1645      if (b == BUFFER_FRONT_LEFT && !frontLeft)
1646         continue;
1647      else if (b == BUFFER_BACK_LEFT && !backLeft)
1648         continue;
1649      else if (b == BUFFER_FRONT_RIGHT && !frontRight)
1650         continue;
1651      else if (b == BUFFER_BACK_RIGHT && !backRight)
1652         continue;
1653
1654      assert(fb->Attachment[b].Renderbuffer == NULL);
1655
1656      rb = _mesa_new_renderbuffer(ctx, 0);
1657      if (!rb) {
1658         _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating color buffer");
1659         return GL_FALSE;
1660      }
1661
1662      if (indexBits <= 8) {
1663         /* only support GLuint for now */
1664         /*rb->InternalFormat = GL_COLOR_INDEX8_EXT;*/
1665         rb->_ActualFormat = COLOR_INDEX32;
1666      }
1667      else {
1668         rb->_ActualFormat = COLOR_INDEX32;
1669      }
1670      rb->InternalFormat = rb->_ActualFormat;
1671
1672      rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1673      _mesa_add_renderbuffer(fb, b, rb);
1674   }
1675
1676   return GL_TRUE;
1677}
1678
1679
1680/**
1681 * Add software-based alpha renderbuffers to the given framebuffer.
1682 * This is a helper routine for device drivers when creating a
1683 * window system framebuffer (not a user-created render/framebuffer).
1684 * Once this function is called, you can basically forget about this
1685 * renderbuffer; core Mesa will handle all the buffer management and
1686 * rendering!
1687 */
1688GLboolean
1689_mesa_add_alpha_renderbuffers(GLcontext *ctx, struct gl_framebuffer *fb,
1690                              GLuint alphaBits,
1691                              GLboolean frontLeft, GLboolean backLeft,
1692                              GLboolean frontRight, GLboolean backRight)
1693{
1694   GLuint b;
1695
1696   /* for window system framebuffers only! */
1697   assert(fb->Name == 0);
1698
1699   if (alphaBits > 8) {
1700      _mesa_problem(ctx,
1701                    "Unsupported bit depth in _mesa_add_alpha_renderbuffers");
1702      return GL_FALSE;
1703   }
1704
1705   assert(MAX_COLOR_ATTACHMENTS >= 4);
1706
1707   /* Wrap each of the RGB color buffers with an alpha renderbuffer.
1708    */
1709   for (b = BUFFER_FRONT_LEFT; b <= BUFFER_BACK_RIGHT; b++) {
1710      struct gl_renderbuffer *arb;
1711
1712      if (b == BUFFER_FRONT_LEFT && !frontLeft)
1713         continue;
1714      else if (b == BUFFER_BACK_LEFT && !backLeft)
1715         continue;
1716      else if (b == BUFFER_FRONT_RIGHT && !frontRight)
1717         continue;
1718      else if (b == BUFFER_BACK_RIGHT && !backRight)
1719         continue;
1720
1721      /* the RGB buffer to wrap must already exist!! */
1722      assert(fb->Attachment[b].Renderbuffer);
1723
1724      /* only GLubyte supported for now */
1725      assert(fb->Attachment[b].Renderbuffer->DataType == GL_UNSIGNED_BYTE);
1726
1727      /* allocate alpha renderbuffer */
1728      arb = _mesa_new_renderbuffer(ctx, 0);
1729      if (!arb) {
1730         _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating alpha buffer");
1731         return GL_FALSE;
1732      }
1733
1734      /* wrap the alpha renderbuffer around the RGB renderbuffer */
1735      arb->Wrapped = fb->Attachment[b].Renderbuffer;
1736
1737      /* Set up my alphabuffer fields and plug in my functions.
1738       * The functions will put/get the alpha values from/to RGBA arrays
1739       * and then call the wrapped buffer's functions to handle the RGB
1740       * values.
1741       */
1742      arb->InternalFormat = arb->Wrapped->InternalFormat;
1743      arb->_ActualFormat  = GL_ALPHA8;
1744      arb->_BaseFormat    = arb->Wrapped->_BaseFormat;
1745      arb->DataType       = arb->Wrapped->DataType;
1746      arb->AllocStorage   = alloc_storage_alpha8;
1747      arb->Delete         = delete_renderbuffer_alpha8;
1748      arb->GetPointer     = get_pointer_alpha8;
1749      arb->GetRow         = get_row_alpha8;
1750      arb->GetValues      = get_values_alpha8;
1751      arb->PutRow         = put_row_alpha8;
1752      arb->PutRowRGB      = put_row_rgb_alpha8;
1753      arb->PutMonoRow     = put_mono_row_alpha8;
1754      arb->PutValues      = put_values_alpha8;
1755      arb->PutMonoValues  = put_mono_values_alpha8;
1756
1757      /* clear the pointer to avoid assertion/sanity check failure later */
1758      fb->Attachment[b].Renderbuffer = NULL;
1759
1760      /* plug the alpha renderbuffer into the colorbuffer attachment */
1761      _mesa_add_renderbuffer(fb, b, arb);
1762   }
1763
1764   return GL_TRUE;
1765}
1766
1767
1768/**
1769 * Add a software-based depth renderbuffer to the given framebuffer.
1770 * This is a helper routine for device drivers when creating a
1771 * window system framebuffer (not a user-created render/framebuffer).
1772 * Once this function is called, you can basically forget about this
1773 * renderbuffer; core Mesa will handle all the buffer management and
1774 * rendering!
1775 */
1776GLboolean
1777_mesa_add_depth_renderbuffer(GLcontext *ctx, struct gl_framebuffer *fb,
1778                             GLuint depthBits)
1779{
1780   struct gl_renderbuffer *rb;
1781
1782   if (depthBits > 32) {
1783      _mesa_problem(ctx,
1784                    "Unsupported depthBits in _mesa_add_depth_renderbuffer");
1785      return GL_FALSE;
1786   }
1787
1788   assert(fb->Attachment[BUFFER_DEPTH].Renderbuffer == NULL);
1789
1790   rb = _mesa_new_renderbuffer(ctx, 0);
1791   if (!rb) {
1792      _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating depth buffer");
1793      return GL_FALSE;
1794   }
1795
1796   if (depthBits <= 16) {
1797      rb->_ActualFormat = GL_DEPTH_COMPONENT16;
1798   }
1799   else if (depthBits <= 24) {
1800      rb->_ActualFormat = GL_DEPTH_COMPONENT24;
1801   }
1802   else {
1803      rb->_ActualFormat = GL_DEPTH_COMPONENT32;
1804   }
1805   rb->InternalFormat = rb->_ActualFormat;
1806
1807   rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1808   _mesa_add_renderbuffer(fb, BUFFER_DEPTH, rb);
1809
1810   return GL_TRUE;
1811}
1812
1813
1814/**
1815 * Add a software-based stencil renderbuffer to the given framebuffer.
1816 * This is a helper routine for device drivers when creating a
1817 * window system framebuffer (not a user-created render/framebuffer).
1818 * Once this function is called, you can basically forget about this
1819 * renderbuffer; core Mesa will handle all the buffer management and
1820 * rendering!
1821 */
1822GLboolean
1823_mesa_add_stencil_renderbuffer(GLcontext *ctx, struct gl_framebuffer *fb,
1824                               GLuint stencilBits)
1825{
1826   struct gl_renderbuffer *rb;
1827
1828   if (stencilBits > 16) {
1829      _mesa_problem(ctx,
1830                  "Unsupported stencilBits in _mesa_add_stencil_renderbuffer");
1831      return GL_FALSE;
1832   }
1833
1834   assert(fb->Attachment[BUFFER_STENCIL].Renderbuffer == NULL);
1835
1836   rb = _mesa_new_renderbuffer(ctx, 0);
1837   if (!rb) {
1838      _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating stencil buffer");
1839      return GL_FALSE;
1840   }
1841
1842   if (stencilBits <= 8) {
1843      rb->_ActualFormat = GL_STENCIL_INDEX8_EXT;
1844   }
1845   else {
1846      /* not really supported (see s_stencil.c code) */
1847      rb->_ActualFormat = GL_STENCIL_INDEX16_EXT;
1848   }
1849   rb->InternalFormat = rb->_ActualFormat;
1850
1851   rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1852   _mesa_add_renderbuffer(fb, BUFFER_STENCIL, rb);
1853
1854   return GL_TRUE;
1855}
1856
1857
1858/**
1859 * Add a software-based accumulation renderbuffer to the given framebuffer.
1860 * This is a helper routine for device drivers when creating a
1861 * window system framebuffer (not a user-created render/framebuffer).
1862 * Once this function is called, you can basically forget about this
1863 * renderbuffer; core Mesa will handle all the buffer management and
1864 * rendering!
1865 */
1866GLboolean
1867_mesa_add_accum_renderbuffer(GLcontext *ctx, struct gl_framebuffer *fb,
1868                             GLuint redBits, GLuint greenBits,
1869                             GLuint blueBits, GLuint alphaBits)
1870{
1871   struct gl_renderbuffer *rb;
1872
1873   if (redBits > 16 || greenBits > 16 || blueBits > 16 || alphaBits > 16) {
1874      _mesa_problem(ctx,
1875                    "Unsupported accumBits in _mesa_add_accum_renderbuffer");
1876      return GL_FALSE;
1877   }
1878
1879   assert(fb->Attachment[BUFFER_ACCUM].Renderbuffer == NULL);
1880
1881   rb = _mesa_new_renderbuffer(ctx, 0);
1882   if (!rb) {
1883      _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating accum buffer");
1884      return GL_FALSE;
1885   }
1886
1887   rb->_ActualFormat = GL_RGBA16;
1888   rb->InternalFormat = GL_RGBA16;
1889   rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1890   _mesa_add_renderbuffer(fb, BUFFER_ACCUM, rb);
1891
1892   return GL_TRUE;
1893}
1894
1895
1896
1897/**
1898 * Add a software-based accumulation renderbuffer to the given framebuffer.
1899 * This is a helper routine for device drivers when creating a
1900 * window system framebuffer (not a user-created render/framebuffer).
1901 * Once this function is called, you can basically forget about this
1902 * renderbuffer; core Mesa will handle all the buffer management and
1903 * rendering!
1904 *
1905 * NOTE: color-index aux buffers not supported.
1906 */
1907GLboolean
1908_mesa_add_aux_renderbuffers(GLcontext *ctx, struct gl_framebuffer *fb,
1909                            GLuint colorBits, GLuint numBuffers)
1910{
1911   GLuint i;
1912
1913   if (colorBits > 16) {
1914      _mesa_problem(ctx,
1915                    "Unsupported accumBits in _mesa_add_aux_renderbuffers");
1916      return GL_FALSE;
1917   }
1918
1919   assert(numBuffers < MAX_AUX_BUFFERS);
1920
1921   for (i = 0; i < numBuffers; i++) {
1922      struct gl_renderbuffer *rb = _mesa_new_renderbuffer(ctx, 0);
1923
1924      assert(fb->Attachment[BUFFER_AUX0 + i].Renderbuffer == NULL);
1925
1926      if (!rb) {
1927         _mesa_error(ctx, GL_OUT_OF_MEMORY, "Allocating accum buffer");
1928         return GL_FALSE;
1929      }
1930
1931      if (colorBits <= 8) {
1932         rb->_ActualFormat = GL_RGBA8;
1933      }
1934      else {
1935         rb->_ActualFormat = GL_RGBA16;
1936      }
1937      rb->InternalFormat = rb->_ActualFormat;
1938
1939      rb->AllocStorage = _mesa_soft_renderbuffer_storage;
1940      _mesa_add_renderbuffer(fb, BUFFER_AUX0 + i, rb);
1941   }
1942   return GL_TRUE;
1943}
1944
1945
1946/**
1947 * Create/attach software-based renderbuffers to the given framebuffer.
1948 * This is a helper routine for device drivers.  Drivers can just as well
1949 * call the individual _mesa_add_*_renderbuffer() routines directly.
1950 */
1951void
1952_mesa_add_soft_renderbuffers(struct gl_framebuffer *fb,
1953                             GLboolean color,
1954                             GLboolean depth,
1955                             GLboolean stencil,
1956                             GLboolean accum,
1957                             GLboolean alpha,
1958                             GLboolean aux)
1959{
1960   GLboolean frontLeft = GL_TRUE;
1961   GLboolean backLeft = fb->Visual.doubleBufferMode;
1962   GLboolean frontRight = fb->Visual.stereoMode;
1963   GLboolean backRight = fb->Visual.stereoMode && fb->Visual.doubleBufferMode;
1964
1965   if (color) {
1966      if (fb->Visual.rgbMode) {
1967         assert(fb->Visual.redBits == fb->Visual.greenBits);
1968         assert(fb->Visual.redBits == fb->Visual.blueBits);
1969         _mesa_add_color_renderbuffers(NULL, fb,
1970                                       fb->Visual.redBits,
1971                                       fb->Visual.alphaBits,
1972                                       frontLeft, backLeft,
1973                                       frontRight, backRight);
1974      }
1975      else {
1976         _mesa_add_color_index_renderbuffers(NULL, fb,
1977                                             fb->Visual.indexBits,
1978                                             frontLeft, backLeft,
1979                                             frontRight, backRight);
1980      }
1981   }
1982
1983   if (depth) {
1984      assert(fb->Visual.depthBits > 0);
1985      _mesa_add_depth_renderbuffer(NULL, fb, fb->Visual.depthBits);
1986   }
1987
1988   if (stencil) {
1989      assert(fb->Visual.stencilBits > 0);
1990      _mesa_add_stencil_renderbuffer(NULL, fb, fb->Visual.stencilBits);
1991   }
1992
1993   if (accum) {
1994      assert(fb->Visual.rgbMode);
1995      assert(fb->Visual.accumRedBits > 0);
1996      assert(fb->Visual.accumGreenBits > 0);
1997      assert(fb->Visual.accumBlueBits > 0);
1998      _mesa_add_accum_renderbuffer(NULL, fb,
1999                                   fb->Visual.accumRedBits,
2000                                   fb->Visual.accumGreenBits,
2001                                   fb->Visual.accumBlueBits,
2002                                   fb->Visual.accumAlphaBits);
2003   }
2004
2005   if (aux) {
2006      assert(fb->Visual.rgbMode);
2007      assert(fb->Visual.numAuxBuffers > 0);
2008      _mesa_add_aux_renderbuffers(NULL, fb, fb->Visual.redBits,
2009                                  fb->Visual.numAuxBuffers);
2010   }
2011
2012   if (alpha) {
2013      assert(fb->Visual.rgbMode);
2014      assert(fb->Visual.alphaBits > 0);
2015      _mesa_add_alpha_renderbuffers(NULL, fb, fb->Visual.alphaBits,
2016                                    frontLeft, backLeft,
2017                                    frontRight, backRight);
2018   }
2019
2020#if 0
2021   if (multisample) {
2022      /* maybe someday */
2023   }
2024#endif
2025}
2026
2027
2028/**
2029 * Attach a renderbuffer to a framebuffer.
2030 */
2031void
2032_mesa_add_renderbuffer(struct gl_framebuffer *fb,
2033                       GLuint bufferName, struct gl_renderbuffer *rb)
2034{
2035   assert(fb);
2036   assert(rb);
2037   assert(bufferName < BUFFER_COUNT);
2038
2039   /* There should be no previous renderbuffer on this attachment point,
2040    * with the exception of depth/stencil since the same renderbuffer may
2041    * be used for both.
2042    */
2043   assert(bufferName == BUFFER_DEPTH ||
2044          bufferName == BUFFER_STENCIL ||
2045          fb->Attachment[bufferName].Renderbuffer == NULL);
2046
2047   /* winsys vs. user-created buffer cross check */
2048   if (fb->Name) {
2049      assert(rb->Name);
2050   }
2051   else {
2052      assert(!rb->Name);
2053   }
2054
2055   /* If Mesa's compiled with deep color channels (16 or 32 bits / channel)
2056    * and the device driver is expecting 8-bit values (GLubyte), we can
2057    * use a "renderbuffer adaptor/wrapper" to do the necessary conversions.
2058    */
2059   if (rb->_BaseFormat == GL_RGBA) {
2060      if (CHAN_BITS == 16 && rb->DataType == GL_UNSIGNED_BYTE) {
2061         GET_CURRENT_CONTEXT(ctx);
2062         rb = _mesa_new_renderbuffer_16wrap8(ctx, rb);
2063      }
2064      else if (CHAN_BITS == 32 && rb->DataType == GL_UNSIGNED_BYTE) {
2065         GET_CURRENT_CONTEXT(ctx);
2066         rb = _mesa_new_renderbuffer_32wrap8(ctx, rb);
2067      }
2068      else if (CHAN_BITS == 32 && rb->DataType == GL_UNSIGNED_SHORT) {
2069         GET_CURRENT_CONTEXT(ctx);
2070         rb = _mesa_new_renderbuffer_32wrap16(ctx, rb);
2071      }
2072   }
2073
2074   fb->Attachment[bufferName].Type = GL_RENDERBUFFER_EXT;
2075   fb->Attachment[bufferName].Complete = GL_TRUE;
2076   fb->Attachment[bufferName].Renderbuffer = rb;
2077
2078   rb->RefCount++;
2079}
2080
2081
2082/**
2083 * Remove the named renderbuffer from the given framebuffer.
2084 */
2085void
2086_mesa_remove_renderbuffer(struct gl_framebuffer *fb, GLuint bufferName)
2087{
2088   struct gl_renderbuffer *rb;
2089
2090   assert(bufferName < BUFFER_COUNT);
2091
2092   rb = fb->Attachment[bufferName].Renderbuffer;
2093   if (!rb)
2094      return;
2095
2096   _mesa_unreference_renderbuffer(&rb);
2097
2098   fb->Attachment[bufferName].Renderbuffer = NULL;
2099}
2100
2101
2102/**
2103 * Decrement a renderbuffer object's reference count and delete it when
2104 * the refcount hits zero.
2105 * Note: we pass the address of a pointer.
2106 */
2107void
2108_mesa_unreference_renderbuffer(struct gl_renderbuffer **rb)
2109{
2110   assert(rb);
2111   if (*rb) {
2112      GLboolean deleteFlag = GL_FALSE;
2113
2114      _glthread_LOCK_MUTEX((*rb)->Mutex);
2115      ASSERT((*rb)->RefCount > 0);
2116      (*rb)->RefCount--;
2117      deleteFlag = ((*rb)->RefCount == 0);
2118      _glthread_UNLOCK_MUTEX((*rb)->Mutex);
2119
2120      if (deleteFlag)
2121         (*rb)->Delete(*rb);
2122
2123      *rb = NULL;
2124   }
2125}
2126
2127
2128
2129
2130/**
2131 * Create a new combined depth/stencil renderbuffer for implementing
2132 * the GL_EXT_packed_depth_stencil extension.
2133 * \return new depth/stencil renderbuffer
2134 */
2135struct gl_renderbuffer *
2136_mesa_new_depthstencil_renderbuffer(GLcontext *ctx, GLuint name)
2137{
2138   struct gl_renderbuffer *dsrb;
2139
2140   dsrb = _mesa_new_renderbuffer(ctx, name);
2141   if (!dsrb)
2142      return NULL;
2143
2144   /* init fields not covered by _mesa_new_renderbuffer() */
2145   dsrb->InternalFormat = GL_DEPTH24_STENCIL8_EXT;
2146   dsrb->_ActualFormat = GL_DEPTH24_STENCIL8_EXT;
2147   dsrb->AllocStorage = _mesa_soft_renderbuffer_storage;
2148
2149   return dsrb;
2150}
2151
2152