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