2 * Mesa 3-D graphics library
5 * Copyright (C) 1999-2006 Brian Paul All Rights Reserved.
7 * Permission is hereby granted, free of charge, to any person obtaining a
8 * copy of this software and associated documentation files (the "Software"),
9 * to deal in the Software without restriction, including without limitation
10 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11 * and/or sell copies of the Software, and to permit persons to whom the
12 * Software is furnished to do so, subject to the following conditions:
14 * The above copyright notice and this permission notice shall be included
15 * in all copies or substantial portions of the Software.
17 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
20 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
21 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
22 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
27 * Off-Screen Mesa rendering / Rendering into client memory space
29 * Note on thread safety: this driver is thread safe. All
30 * functions are reentrant. The notion of current context is
31 * managed by the core _mesa_make_current() and _mesa_get_current_context()
32 * functions. Those functions are thread-safe.
37 #include "GL/osmesa.h"
39 #include "extensions.h"
40 #include "framebuffer.h"
44 #include "renderbuffer.h"
45 #include "array_cache/acache.h"
46 #include "swrast/swrast.h"
47 #include "swrast_setup/swrast_setup.h"
48 #include "swrast/s_context.h"
49 #include "swrast/s_depth.h"
50 #include "swrast/s_lines.h"
51 #include "swrast/s_triangle.h"
53 #include "tnl/t_context.h"
54 #include "tnl/t_pipeline.h"
55 #include "drivers/common/driverfuncs.h"
60 * This is the OS/Mesa context struct.
61 * Notice how it includes a GLcontext. By doing this we're mimicking
62 * C++ inheritance/derivation.
63 * Later, we can cast a GLcontext pointer into an OSMesaContext pointer
66 struct osmesa_context
{
67 GLcontext mesa
; /* The core GL/Mesa context */
68 GLvisual
*gl_visual
; /* Describes the buffers */
69 GLframebuffer
*gl_buffer
; /* Depth, stencil, accum, etc buffers */
70 GLenum format
; /* either GL_RGBA or GL_COLOR_INDEX */
71 void *buffer
; /* the image buffer */
72 GLint width
, height
; /* size of image buffer */
73 GLint rowlength
; /* number of pixels per row */
74 GLint userRowLength
; /* user-specified number of pixels per row */
75 GLint rInd
, gInd
, bInd
, aInd
;/* index offsets for RGBA formats */
76 GLchan
*rowaddr
[MAX_HEIGHT
]; /* address of first pixel in each image row */
77 GLboolean yup
; /* TRUE -> Y increases upward */
78 /* FALSE -> Y increases downward */
82 /* Just cast, since we're using structure containment */
83 #define OSMESA_CONTEXT(ctx) ((OSMesaContext) (ctx->DriverCtx))
87 /**********************************************************************/
88 /*** Private Device Driver Functions ***/
89 /**********************************************************************/
92 static const GLubyte
*
93 get_string( GLcontext
*ctx
, GLenum name
)
99 return (const GLubyte
*) "Mesa OffScreen32";
100 #elif CHAN_BITS == 16
101 return (const GLubyte
*) "Mesa OffScreen16";
103 return (const GLubyte
*) "Mesa OffScreen";
112 osmesa_update_state( GLcontext
*ctx
, GLuint new_state
)
114 /* easy - just propogate */
115 _swrast_InvalidateState( ctx
, new_state
);
116 _swsetup_InvalidateState( ctx
, new_state
);
117 _ac_InvalidateState( ctx
, new_state
);
118 _tnl_InvalidateState( ctx
, new_state
);
123 * Just return the current buffer size.
124 * There's no window to track the size of.
127 get_buffer_size( GLframebuffer
*buffer
, GLuint
*width
, GLuint
*height
)
129 /* don't use GET_CURRENT_CONTEXT(ctx) here - it's a problem on Windows */
130 GLcontext
*ctx
= (GLcontext
*) _glapi_get_context();
133 OSMesaContext osmesa
= OSMESA_CONTEXT(ctx
);
134 *width
= osmesa
->width
;
135 *height
= osmesa
->height
;
140 /**********************************************************************/
141 /***** Read/write spans/arrays of pixels *****/
142 /**********************************************************************/
145 #define NAME(PREFIX) PREFIX##_RGBA
146 #define FORMAT GL_RGBA
148 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx);
149 #define INIT_PIXEL_PTR(P, X, Y) \
150 GLchan *P = osmesa->rowaddr[Y] + 4 * (X)
151 #define INC_PIXEL_PTR(P) P += 4
152 #if CHAN_TYPE == GL_FLOAT
153 #define STORE_PIXEL(DST, X, Y, VALUE) \
154 DST[0] = MAX2((VALUE[RCOMP]), 0.0F); \
155 DST[1] = MAX2((VALUE[GCOMP]), 0.0F); \
156 DST[2] = MAX2((VALUE[BCOMP]), 0.0F); \
157 DST[3] = CLAMP((VALUE[ACOMP]), 0.0F, CHAN_MAXF)
158 #define STORE_PIXEL_RGB(DST, X, Y, VALUE) \
159 DST[0] = MAX2((VALUE[RCOMP]), 0.0F); \
160 DST[1] = MAX2((VALUE[GCOMP]), 0.0F); \
161 DST[2] = MAX2((VALUE[BCOMP]), 0.0F); \
164 #define STORE_PIXEL(DST, X, Y, VALUE) \
165 DST[0] = VALUE[RCOMP]; \
166 DST[1] = VALUE[GCOMP]; \
167 DST[2] = VALUE[BCOMP]; \
168 DST[3] = VALUE[ACOMP]
169 #define STORE_PIXEL_RGB(DST, X, Y, VALUE) \
170 DST[0] = VALUE[RCOMP]; \
171 DST[1] = VALUE[GCOMP]; \
172 DST[2] = VALUE[BCOMP]; \
175 #define FETCH_PIXEL(DST, SRC) \
176 DST[RCOMP] = SRC[0]; \
177 DST[GCOMP] = SRC[1]; \
178 DST[BCOMP] = SRC[2]; \
180 #include "swrast/s_spantemp.h"
183 #define NAME(PREFIX) PREFIX##_BGRA
184 #define FORMAT GL_RGBA
186 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx);
187 #define INIT_PIXEL_PTR(P, X, Y) \
188 GLchan *P = osmesa->rowaddr[Y] + 4 * (X)
189 #define INC_PIXEL_PTR(P) P += 4
190 #define STORE_PIXEL(DST, X, Y, VALUE) \
191 DST[2] = VALUE[RCOMP]; \
192 DST[1] = VALUE[GCOMP]; \
193 DST[0] = VALUE[BCOMP]; \
194 DST[3] = VALUE[ACOMP]
195 #define STORE_PIXEL_RGB(DST, X, Y, VALUE) \
196 DST[2] = VALUE[RCOMP]; \
197 DST[1] = VALUE[GCOMP]; \
198 DST[0] = VALUE[BCOMP]; \
200 #define FETCH_PIXEL(DST, SRC) \
201 DST[RCOMP] = SRC[2]; \
202 DST[GCOMP] = SRC[1]; \
203 DST[BCOMP] = SRC[0]; \
205 #include "swrast/s_spantemp.h"
208 #define NAME(PREFIX) PREFIX##_ARGB
209 #define FORMAT GL_RGBA
211 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx);
212 #define INIT_PIXEL_PTR(P, X, Y) \
213 GLchan *P = osmesa->rowaddr[Y] + 4 * (X)
214 #define INC_PIXEL_PTR(P) P += 4
215 #define STORE_PIXEL(DST, X, Y, VALUE) \
216 DST[1] = VALUE[RCOMP]; \
217 DST[2] = VALUE[GCOMP]; \
218 DST[3] = VALUE[BCOMP]; \
219 DST[0] = VALUE[ACOMP]
220 #define STORE_PIXEL_RGB(DST, X, Y, VALUE) \
221 DST[1] = VALUE[RCOMP]; \
222 DST[2] = VALUE[GCOMP]; \
223 DST[3] = VALUE[BCOMP]; \
225 #define FETCH_PIXEL(DST, SRC) \
226 DST[RCOMP] = SRC[1]; \
227 DST[GCOMP] = SRC[2]; \
228 DST[BCOMP] = SRC[3]; \
230 #include "swrast/s_spantemp.h"
233 #define NAME(PREFIX) PREFIX##_RGB
234 #define FORMAT GL_RGBA
236 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx);
237 #define INIT_PIXEL_PTR(P, X, Y) \
238 GLchan *P = osmesa->rowaddr[Y] + 3 * (X)
239 #define INC_PIXEL_PTR(P) P += 3
240 #define STORE_PIXEL(DST, X, Y, VALUE) \
241 DST[0] = VALUE[RCOMP]; \
242 DST[1] = VALUE[GCOMP]; \
243 DST[2] = VALUE[BCOMP]
244 #define FETCH_PIXEL(DST, SRC) \
245 DST[RCOMP] = SRC[0]; \
246 DST[GCOMP] = SRC[1]; \
247 DST[BCOMP] = SRC[2]; \
248 DST[ACOMP] = CHAN_MAX
249 #include "swrast/s_spantemp.h"
252 #define NAME(PREFIX) PREFIX##_BGR
253 #define FORMAT GL_RGBA
255 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx);
256 #define INIT_PIXEL_PTR(P, X, Y) \
257 GLchan *P = osmesa->rowaddr[Y] + 3 * (X)
258 #define INC_PIXEL_PTR(P) P += 3
259 #define STORE_PIXEL(DST, X, Y, VALUE) \
260 DST[2] = VALUE[RCOMP]; \
261 DST[1] = VALUE[GCOMP]; \
262 DST[0] = VALUE[BCOMP]
263 #define FETCH_PIXEL(DST, SRC) \
264 DST[RCOMP] = SRC[2]; \
265 DST[GCOMP] = SRC[1]; \
266 DST[BCOMP] = SRC[0]; \
267 DST[ACOMP] = CHAN_MAX
268 #include "swrast/s_spantemp.h"
271 #if CHAN_TYPE == GL_UNSIGNED_BYTE
272 #define NAME(PREFIX) PREFIX##_RGB_565
273 #define FORMAT GL_RGBA
275 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx);
276 #define INIT_PIXEL_PTR(P, X, Y) \
277 GLushort *P = (GLushort *) osmesa->rowaddr[Y] + (X)
278 #define INC_PIXEL_PTR(P) P += 1
279 #define STORE_PIXEL(DST, X, Y, VALUE) \
280 *DST = ( (((VALUE[RCOMP]) & 0xf8) << 8) | (((VALUE[GCOMP]) & 0xfc) << 3) | ((VALUE[BCOMP]) >> 3) )
281 #define FETCH_PIXEL(DST, SRC) \
282 DST[RCOMP] = ( (((*SRC) >> 8) & 0xf8) | (((*SRC) >> 11) & 0x7) ); \
283 DST[GCOMP] = ( (((*SRC) >> 3) & 0xfc) | (((*SRC) >> 5) & 0x3) ); \
284 DST[BCOMP] = ( (((*SRC) << 3) & 0xf8) | (((*SRC) ) & 0x7) ); \
285 DST[ACOMP] = CHAN_MAX
286 #include "swrast/s_spantemp.h"
287 #endif /* CHAN_TYPE == GL_UNSIGNED_BYTE */
290 #define NAME(PREFIX) PREFIX##_CI
291 #define FORMAT GL_COLOR_INDEX8_EXT
293 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx);
294 #define INIT_PIXEL_PTR(P, X, Y) \
295 GLubyte *P = (GLubyte *) osmesa->rowaddr[Y] + (X)
296 #define INC_PIXEL_PTR(P) P += 1
297 #define STORE_PIXEL(DST, X, Y, VALUE) \
299 #define FETCH_PIXEL(DST, SRC) \
301 #include "swrast/s_spantemp.h"
306 /**********************************************************************/
307 /***** Optimized line rendering *****/
308 /**********************************************************************/
311 #if CHAN_TYPE == GL_FLOAT
312 #define PACK_RGBA(DST, R, G, B, A) \
314 (DST)[0] = MAX2( R, 0.0F ); \
315 (DST)[1] = MAX2( G, 0.0F ); \
316 (DST)[2] = MAX2( B, 0.0F ); \
317 (DST)[3] = CLAMP(A, 0.0F, CHAN_MAXF);\
320 #define PACK_RGBA(DST, R, G, B, A) \
322 (DST)[osmesa->rInd] = R; \
323 (DST)[osmesa->gInd] = G; \
324 (DST)[osmesa->bInd] = B; \
325 (DST)[osmesa->aInd] = A; \
329 #define PACK_RGB(DST, R, G, B) \
336 #define PACK_BGR(DST, R, G, B) \
343 #define PACK_RGB_565(DST, R, G, B) \
345 (DST) = (((int) (R) << 8) & 0xf800) | (((int) (G) << 3) & 0x7e0) | ((int) (B) >> 3);\
348 #define UNPACK_RED(P) ( (P)[osmesa->rInd] )
349 #define UNPACK_GREEN(P) ( (P)[osmesa->gInd] )
350 #define UNPACK_BLUE(P) ( (P)[osmesa->bInd] )
351 #define UNPACK_ALPHA(P) ( (P)[osmesa->aInd] )
353 #define PIXELADDR1(X,Y) (osmesa->rowaddr[Y] + (X))
354 #define PIXELADDR2(X,Y) (osmesa->rowaddr[Y] + 2 * (X))
355 #define PIXELADDR3(X,Y) (osmesa->rowaddr[Y] + 3 * (X))
356 #define PIXELADDR4(X,Y) (osmesa->rowaddr[Y] + 4 * (X))
360 * Draw a flat-shaded, RGB line into an osmesa buffer.
362 #define NAME flat_rgba_line
365 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx); \
366 const GLchan *color = vert1->color;
370 GLchan *p = PIXELADDR4(X, Y); \
371 PACK_RGBA(p, color[0], color[1], color[2], color[3]); \
375 #include "..\swrast\s_linetemp.h"
377 #include "swrast/s_linetemp.h"
383 * Draw a flat-shaded, Z-less, RGB line into an osmesa buffer.
385 #define NAME flat_rgba_z_line
388 #define DEPTH_TYPE DEFAULT_SOFTWARE_DEPTH_TYPE
390 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx); \
391 const GLchan *color = vert1->color;
396 GLchan *p = PIXELADDR4(X, Y); \
397 PACK_RGBA(p, color[RCOMP], color[GCOMP], \
398 color[BCOMP], color[ACOMP]); \
404 #include "..\swrast\s_linetemp.h"
406 #include "swrast/s_linetemp.h"
412 * Analyze context state to see if we can provide a fast line drawing
413 * function, like those in lines.c. Otherwise, return NULL.
415 static swrast_line_func
416 osmesa_choose_line_function( GLcontext
*ctx
)
418 const OSMesaContext osmesa
= OSMESA_CONTEXT(ctx
);
419 const SWcontext
*swrast
= SWRAST_CONTEXT(ctx
);
421 if (CHAN_BITS
!= 8) return NULL
;
422 if (ctx
->RenderMode
!= GL_RENDER
) return NULL
;
423 if (ctx
->Line
.SmoothFlag
) return NULL
;
424 if (ctx
->Texture
._EnabledUnits
) return NULL
;
425 if (ctx
->Light
.ShadeModel
!= GL_FLAT
) return NULL
;
426 if (ctx
->Line
.Width
!= 1.0F
) return NULL
;
427 if (ctx
->Line
.StippleFlag
) return NULL
;
428 if (ctx
->Line
.SmoothFlag
) return NULL
;
429 if (osmesa
->format
!= OSMESA_RGBA
&&
430 osmesa
->format
!= OSMESA_BGRA
&&
431 osmesa
->format
!= OSMESA_ARGB
) return NULL
;
433 if (swrast
->_RasterMask
==DEPTH_BIT
434 && ctx
->Depth
.Func
==GL_LESS
435 && ctx
->Depth
.Mask
==GL_TRUE
436 && ctx
->Visual
.depthBits
== DEFAULT_SOFTWARE_DEPTH_BITS
) {
437 return (swrast_line_func
) flat_rgba_z_line
;
440 if (swrast
->_RasterMask
== 0) {
441 return (swrast_line_func
) flat_rgba_line
;
444 return (swrast_line_func
) NULL
;
448 /**********************************************************************/
449 /***** Optimized triangle rendering *****/
450 /**********************************************************************/
454 * Smooth-shaded, z-less triangle, RGBA color.
456 #define NAME smooth_rgba_z_triangle
458 #define DEPTH_TYPE DEFAULT_SOFTWARE_DEPTH_TYPE
460 #define INTERP_ALPHA 1
462 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx);
463 #define RENDER_SPAN( span ) { \
465 GLchan *img = PIXELADDR4(span.x, span.y); \
466 for (i = 0; i < span.end; i++, img += 4) { \
467 const GLuint z = FixedToDepth(span.z); \
469 PACK_RGBA(img, FixedToChan(span.red), \
470 FixedToChan(span.green), FixedToChan(span.blue), \
471 FixedToChan(span.alpha)); \
474 span.red += span.redStep; \
475 span.green += span.greenStep; \
476 span.blue += span.blueStep; \
477 span.alpha += span.alphaStep; \
478 span.z += span.zStep; \
482 #include "..\swrast\s_tritemp.h"
484 #include "swrast/s_tritemp.h"
490 * Flat-shaded, z-less triangle, RGBA color.
492 #define NAME flat_rgba_z_triangle
494 #define DEPTH_TYPE DEFAULT_SOFTWARE_DEPTH_TYPE
496 const OSMesaContext osmesa = OSMESA_CONTEXT(ctx); \
498 PACK_RGBA((GLchan *) &pixel, v2->color[0], v2->color[1], \
499 v2->color[2], v2->color[3]);
501 #define RENDER_SPAN( span ) { \
503 GLuint *img = (GLuint *) PIXELADDR4(span.x, span.y); \
504 for (i = 0; i < span.end; i++) { \
505 const GLuint z = FixedToDepth(span.z); \
510 span.z += span.zStep; \
514 #include "..\swrast\s_tritemp.h"
516 #include "swrast/s_tritemp.h"
522 * Return pointer to an accelerated triangle function if possible.
524 static swrast_tri_func
525 osmesa_choose_triangle_function( GLcontext
*ctx
)
527 const OSMesaContext osmesa
= OSMESA_CONTEXT(ctx
);
528 const SWcontext
*swrast
= SWRAST_CONTEXT(ctx
);
530 if (CHAN_BITS
!= 8) return (swrast_tri_func
) NULL
;
531 if (ctx
->RenderMode
!= GL_RENDER
) return (swrast_tri_func
) NULL
;
532 if (ctx
->Polygon
.SmoothFlag
) return (swrast_tri_func
) NULL
;
533 if (ctx
->Polygon
.StippleFlag
) return (swrast_tri_func
) NULL
;
534 if (ctx
->Texture
._EnabledUnits
) return (swrast_tri_func
) NULL
;
535 if (osmesa
->format
!= OSMESA_RGBA
&&
536 osmesa
->format
!= OSMESA_BGRA
&&
537 osmesa
->format
!= OSMESA_ARGB
) return (swrast_tri_func
) NULL
;
538 if (ctx
->Polygon
.CullFlag
&&
539 ctx
->Polygon
.CullFaceMode
== GL_FRONT_AND_BACK
)
540 return (swrast_tri_func
) NULL
;
542 if (swrast
->_RasterMask
== DEPTH_BIT
&&
543 ctx
->Depth
.Func
== GL_LESS
&&
544 ctx
->Depth
.Mask
== GL_TRUE
&&
545 ctx
->Visual
.depthBits
== DEFAULT_SOFTWARE_DEPTH_BITS
) {
546 if (ctx
->Light
.ShadeModel
== GL_SMOOTH
) {
547 return (swrast_tri_func
) smooth_rgba_z_triangle
;
550 return (swrast_tri_func
) flat_rgba_z_triangle
;
553 return (swrast_tri_func
) NULL
;
558 /* Override for the swrast triangle-selection function. Try to use one
559 * of our internal triangle functions, otherwise fall back to the
560 * standard swrast functions.
563 osmesa_choose_triangle( GLcontext
*ctx
)
565 SWcontext
*swrast
= SWRAST_CONTEXT(ctx
);
567 swrast
->Triangle
= osmesa_choose_triangle_function( ctx
);
568 if (!swrast
->Triangle
)
569 _swrast_choose_triangle( ctx
);
573 osmesa_choose_line( GLcontext
*ctx
)
575 SWcontext
*swrast
= SWRAST_CONTEXT(ctx
);
577 swrast
->Line
= osmesa_choose_line_function( ctx
);
579 _swrast_choose_line( ctx
);
584 * Don't use _mesa_delete_renderbuffer since we can't free rb->Data.
587 osmesa_delete_renderbuffer(struct gl_renderbuffer
*rb
)
594 * Allocate renderbuffer storage. We don't actually allocate any storage
595 * since we're using a user-provided buffer.
596 * Just set up all the gl_renderbuffer methods.
599 osmesa_renderbuffer_storage(GLcontext
*ctx
, struct gl_renderbuffer
*rb
,
600 GLenum internalFormat
, GLuint width
, GLuint height
)
602 const OSMesaContext osmesa
= OSMESA_CONTEXT(ctx
);
604 if (osmesa
->format
== OSMESA_RGBA
) {
605 rb
->GetRow
= get_row_RGBA
;
606 rb
->GetValues
= get_values_RGBA
;
607 rb
->PutRow
= put_row_RGBA
;
608 rb
->PutRowRGB
= put_row_rgb_RGBA
;
609 rb
->PutMonoRow
= put_mono_row_RGBA
;
610 rb
->PutValues
= put_values_RGBA
;
611 rb
->PutMonoValues
= put_mono_values_RGBA
;
613 else if (osmesa
->format
== OSMESA_BGRA
) {
614 rb
->GetRow
= get_row_BGRA
;
615 rb
->GetValues
= get_values_BGRA
;
616 rb
->PutRow
= put_row_BGRA
;
617 rb
->PutRowRGB
= put_row_rgb_BGRA
;
618 rb
->PutMonoRow
= put_mono_row_BGRA
;
619 rb
->PutValues
= put_values_BGRA
;
620 rb
->PutMonoValues
= put_mono_values_BGRA
;
622 else if (osmesa
->format
== OSMESA_ARGB
) {
623 rb
->GetRow
= get_row_ARGB
;
624 rb
->GetValues
= get_values_ARGB
;
625 rb
->PutRow
= put_row_ARGB
;
626 rb
->PutRowRGB
= put_row_rgb_ARGB
;
627 rb
->PutMonoRow
= put_mono_row_ARGB
;
628 rb
->PutValues
= put_values_ARGB
;
629 rb
->PutMonoValues
= put_mono_values_ARGB
;
631 else if (osmesa
->format
== OSMESA_RGB
) {
632 rb
->GetRow
= get_row_RGB
;
633 rb
->GetValues
= get_values_RGB
;
634 rb
->PutRow
= put_row_RGB
;
635 rb
->PutRowRGB
= put_row_rgb_RGB
;
636 rb
->PutMonoRow
= put_mono_row_RGB
;
637 rb
->PutValues
= put_values_RGB
;
638 rb
->PutMonoValues
= put_mono_values_RGB
;
640 else if (osmesa
->format
== OSMESA_BGR
) {
641 rb
->GetRow
= get_row_BGR
;
642 rb
->GetValues
= get_values_BGR
;
643 rb
->PutRow
= put_row_BGR
;
644 rb
->PutRowRGB
= put_row_rgb_BGR
;
645 rb
->PutMonoRow
= put_mono_row_BGR
;
646 rb
->PutValues
= put_values_BGR
;
647 rb
->PutMonoValues
= put_mono_values_BGR
;
649 #if CHAN_TYPE == GL_UNSIGNED_BYTE
650 else if (osmesa
->format
== OSMESA_RGB_565
) {
651 rb
->GetRow
= get_row_RGB_565
;
652 rb
->GetValues
= get_values_RGB_565
;
653 rb
->PutRow
= put_row_RGB_565
;
654 rb
->PutRowRGB
= put_row_rgb_RGB_565
;
655 rb
->PutMonoRow
= put_mono_row_RGB_565
;
656 rb
->PutValues
= put_values_RGB_565
;
657 rb
->PutMonoValues
= put_mono_values_RGB_565
;
660 else if (osmesa
->format
== OSMESA_COLOR_INDEX
) {
661 rb
->GetRow
= get_row_CI
;
662 rb
->GetValues
= get_values_CI
;
663 rb
->PutRow
= put_row_CI
;
664 rb
->PutMonoRow
= put_mono_row_CI
;
665 rb
->PutValues
= put_values_CI
;
666 rb
->PutMonoValues
= put_mono_values_CI
;
669 _mesa_problem(ctx
, "bad pixel format in osmesa renderbuffer_storage");
677 * Allocate a new renderbuffer tpo describe the user-provided color buffer.
679 static struct gl_renderbuffer
*
680 new_osmesa_renderbuffer(GLenum format
)
682 struct gl_renderbuffer
*rb
= CALLOC_STRUCT(gl_renderbuffer
);
684 const GLuint name
= 0;
685 _mesa_init_renderbuffer(rb
, name
);
687 rb
->Delete
= osmesa_delete_renderbuffer
;
688 rb
->AllocStorage
= osmesa_renderbuffer_storage
;
690 if (format
== OSMESA_COLOR_INDEX
) {
691 rb
->_BaseFormat
= GL_COLOR_INDEX
;
692 rb
->InternalFormat
= GL_COLOR_INDEX
;
693 rb
->DataType
= GL_UNSIGNED_BYTE
;
696 rb
->_BaseFormat
= GL_RGBA
;
697 rb
->InternalFormat
= GL_RGBA
;
698 rb
->DataType
= CHAN_TYPE
;
706 /**********************************************************************/
707 /***** Public Functions *****/
708 /**********************************************************************/
712 * Create an Off-Screen Mesa rendering context. The only attribute needed is
713 * an RGBA vs Color-Index mode flag.
715 * Input: format - either GL_RGBA or GL_COLOR_INDEX
716 * sharelist - specifies another OSMesaContext with which to share
717 * display lists. NULL indicates no sharing.
718 * Return: an OSMesaContext or 0 if error
720 GLAPI OSMesaContext GLAPIENTRY
721 OSMesaCreateContext( GLenum format
, OSMesaContext sharelist
)
723 const GLint accumBits
= (format
== OSMESA_COLOR_INDEX
) ? 0 : 16;
724 return OSMesaCreateContextExt(format
, DEFAULT_SOFTWARE_DEPTH_BITS
,
725 8, accumBits
, sharelist
);
733 * Create context and specify size of ancillary buffers.
735 GLAPI OSMesaContext GLAPIENTRY
736 OSMesaCreateContextExt( GLenum format
, GLint depthBits
, GLint stencilBits
,
737 GLint accumBits
, OSMesaContext sharelist
)
739 OSMesaContext osmesa
;
740 struct dd_function_table functions
;
741 GLint rind
, gind
, bind
, aind
;
742 GLint indexBits
= 0, redBits
= 0, greenBits
= 0, blueBits
= 0, alphaBits
=0;
745 rind
= gind
= bind
= aind
= 0;
746 if (format
==OSMESA_COLOR_INDEX
) {
750 else if (format
==OSMESA_RGBA
) {
753 greenBits
= CHAN_BITS
;
754 blueBits
= CHAN_BITS
;
755 alphaBits
= CHAN_BITS
;
762 else if (format
==OSMESA_BGRA
) {
765 greenBits
= CHAN_BITS
;
766 blueBits
= CHAN_BITS
;
767 alphaBits
= CHAN_BITS
;
774 else if (format
==OSMESA_ARGB
) {
777 greenBits
= CHAN_BITS
;
778 blueBits
= CHAN_BITS
;
779 alphaBits
= CHAN_BITS
;
786 else if (format
==OSMESA_RGB
) {
789 greenBits
= CHAN_BITS
;
790 blueBits
= CHAN_BITS
;
797 else if (format
==OSMESA_BGR
) {
800 greenBits
= CHAN_BITS
;
801 blueBits
= CHAN_BITS
;
808 #if CHAN_TYPE == GL_UNSIGNED_BYTE
809 else if (format
==OSMESA_RGB_565
) {
815 rind
= 0; /* not used */
825 osmesa
= (OSMesaContext
) CALLOC_STRUCT(osmesa_context
);
827 osmesa
->gl_visual
= _mesa_create_visual( rgbmode
,
828 GL_FALSE
, /* double buffer */
829 GL_FALSE
, /* stereo */
840 alphaBits
? accumBits
: 0,
843 if (!osmesa
->gl_visual
) {
848 /* Initialize device driver function table */
849 _mesa_init_driver_functions(&functions
);
850 /* override with our functions */
851 functions
.GetString
= get_string
;
852 functions
.UpdateState
= osmesa_update_state
;
853 functions
.GetBufferSize
= get_buffer_size
;
855 if (!_mesa_initialize_context(&osmesa
->mesa
,
857 sharelist
? &sharelist
->mesa
858 : (GLcontext
*) NULL
,
859 &functions
, (void *) osmesa
)) {
860 _mesa_destroy_visual( osmesa
->gl_visual
);
865 _mesa_enable_sw_extensions(&(osmesa
->mesa
));
866 _mesa_enable_1_3_extensions(&(osmesa
->mesa
));
867 _mesa_enable_1_4_extensions(&(osmesa
->mesa
));
868 _mesa_enable_1_5_extensions(&(osmesa
->mesa
));
870 osmesa
->gl_buffer
= _mesa_create_framebuffer(osmesa
->gl_visual
);
871 if (!osmesa
->gl_buffer
) {
872 _mesa_destroy_visual( osmesa
->gl_visual
);
873 _mesa_free_context_data( &osmesa
->mesa
);
878 /* create front color buffer in user-provided memory (no back buffer) */
879 _mesa_add_renderbuffer(osmesa
->gl_buffer
, BUFFER_FRONT_LEFT
,
880 new_osmesa_renderbuffer(format
));
881 _mesa_add_soft_renderbuffers(osmesa
->gl_buffer
,
882 GL_FALSE
, /* color */
883 osmesa
->gl_visual
->haveDepthBuffer
,
884 osmesa
->gl_visual
->haveStencilBuffer
,
885 osmesa
->gl_visual
->haveAccumBuffer
,
886 GL_FALSE
, /* alpha */
887 GL_FALSE
/* aux */ );
889 osmesa
->format
= format
;
890 osmesa
->buffer
= NULL
;
893 osmesa
->userRowLength
= 0;
894 osmesa
->rowlength
= 0;
895 osmesa
->yup
= GL_TRUE
;
901 /* Initialize the software rasterizer and helper modules. */
903 GLcontext
*ctx
= &osmesa
->mesa
;
907 if (!_swrast_CreateContext( ctx
) ||
908 !_ac_CreateContext( ctx
) ||
909 !_tnl_CreateContext( ctx
) ||
910 !_swsetup_CreateContext( ctx
)) {
911 _mesa_destroy_visual(osmesa
->gl_visual
);
912 _mesa_free_context_data(ctx
);
917 _swsetup_Wakeup( ctx
);
919 /* use default TCL pipeline */
920 tnl
= TNL_CONTEXT(ctx
);
921 tnl
->Driver
.RunPipeline
= _tnl_run_pipeline
;
923 /* Extend the software rasterizer with our optimized line and triangle
926 swrast
= SWRAST_CONTEXT( ctx
);
927 swrast
->choose_line
= osmesa_choose_line
;
928 swrast
->choose_triangle
= osmesa_choose_triangle
;
936 * Destroy an Off-Screen Mesa rendering context.
938 * Input: ctx - the context to destroy
940 GLAPI
void GLAPIENTRY
941 OSMesaDestroyContext( OSMesaContext ctx
)
944 _swsetup_DestroyContext( &ctx
->mesa
);
945 _tnl_DestroyContext( &ctx
->mesa
);
946 _ac_DestroyContext( &ctx
->mesa
);
947 _swrast_DestroyContext( &ctx
->mesa
);
949 _mesa_destroy_visual( ctx
->gl_visual
);
950 _mesa_destroy_framebuffer( ctx
->gl_buffer
);
951 _mesa_free_context_data( &ctx
->mesa
);
958 * Recompute the values of the context's rowaddr array.
961 compute_row_addresses( OSMesaContext ctx
)
963 GLint bytesPerPixel
, bytesPerRow
, i
;
964 GLubyte
*origin
= (GLubyte
*) ctx
->buffer
;
966 if (ctx
->format
== OSMESA_COLOR_INDEX
) {
968 bytesPerPixel
= 1 * sizeof(GLubyte
);
970 else if ((ctx
->format
== OSMESA_RGB
) || (ctx
->format
== OSMESA_BGR
)) {
972 bytesPerPixel
= 3 * sizeof(GLchan
);
974 else if (ctx
->format
== OSMESA_RGB_565
) {
975 /* 5/6/5 RGB pixel in 16 bits */
980 bytesPerPixel
= 4 * sizeof(GLchan
);
983 bytesPerRow
= ctx
->rowlength
* bytesPerPixel
;
986 /* Y=0 is bottom line of window */
987 for (i
= 0; i
< MAX_HEIGHT
; i
++) {
988 ctx
->rowaddr
[i
] = (GLchan
*) ((GLubyte
*) origin
+ i
* bytesPerRow
);
992 /* Y=0 is top line of window */
993 for (i
= 0; i
< MAX_HEIGHT
; i
++) {
994 GLint j
= ctx
->height
- i
- 1;
995 ctx
->rowaddr
[i
] = (GLchan
*) ((GLubyte
*) origin
+ j
* bytesPerRow
);
1002 * Bind an OSMesaContext to an image buffer. The image buffer is just a
1003 * block of memory which the client provides. Its size must be at least
1004 * as large as width*height*sizeof(type). Its address should be a multiple
1005 * of 4 if using RGBA mode.
1007 * Image data is stored in the order of glDrawPixels: row-major order
1008 * with the lower-left image pixel stored in the first array position
1009 * (ie. bottom-to-top).
1011 * If the context's viewport hasn't been initialized yet, it will now be
1012 * initialized to (0,0,width,height).
1014 * Input: ctx - the rendering context
1015 * buffer - the image buffer memory
1016 * type - data type for pixel components
1017 * Normally, only GL_UNSIGNED_BYTE and GL_UNSIGNED_SHORT_5_6_5
1018 * are supported. But if Mesa's been compiled with CHAN_BITS==16
1019 * then type must be GL_UNSIGNED_SHORT. And if Mesa's been build
1020 * with CHAN_BITS==32 then type must be GL_FLOAT.
1021 * width, height - size of image buffer in pixels, at least 1
1022 * Return: GL_TRUE if success, GL_FALSE if error because of invalid ctx,
1023 * invalid buffer address, invalid type, width<1, height<1,
1024 * width>internal limit or height>internal limit.
1026 GLAPI GLboolean GLAPIENTRY
1027 OSMesaMakeCurrent( OSMesaContext ctx
, void *buffer
, GLenum type
,
1028 GLsizei width
, GLsizei height
)
1030 if (!ctx
|| !buffer
||
1031 width
< 1 || height
< 1 ||
1032 width
> MAX_WIDTH
|| height
> MAX_HEIGHT
) {
1036 if (ctx
->format
== OSMESA_RGB_565
) {
1037 if (type
!= GL_UNSIGNED_SHORT_5_6_5
)
1040 else if (type
!= CHAN_TYPE
) {
1044 /* Need to set these before calling _mesa_make_current() since the first
1045 * time the context is bound, _mesa_make_current() will call our
1046 * get_buffer_size() function to initialize the viewport. These are the
1047 * values returned by get_buffer_size():
1049 ctx
->buffer
= buffer
;
1051 ctx
->height
= height
;
1053 osmesa_update_state( &ctx
->mesa
, 0 );
1055 /* Call this periodically to detect when the user has begun using
1056 * GL rendering from multiple threads.
1058 _glapi_check_multithread();
1060 _mesa_make_current( &ctx
->mesa
, ctx
->gl_buffer
, ctx
->gl_buffer
);
1062 if (ctx
->userRowLength
)
1063 ctx
->rowlength
= ctx
->userRowLength
;
1065 ctx
->rowlength
= width
;
1067 compute_row_addresses( ctx
);
1069 /* this will make ensure we recognize the new buffer size */
1070 _mesa_resize_framebuffer(&ctx
->mesa
, ctx
->gl_buffer
, width
, height
);
1077 GLAPI OSMesaContext GLAPIENTRY
1078 OSMesaGetCurrentContext( void )
1080 GLcontext
*ctx
= _mesa_get_current_context();
1082 return (OSMesaContext
) ctx
;
1089 GLAPI
void GLAPIENTRY
1090 OSMesaPixelStore( GLint pname
, GLint value
)
1092 OSMesaContext osmesa
= OSMesaGetCurrentContext();
1095 case OSMESA_ROW_LENGTH
:
1097 _mesa_error( &osmesa
->mesa
, GL_INVALID_VALUE
,
1098 "OSMesaPixelStore(value)" );
1101 osmesa
->userRowLength
= value
;
1102 osmesa
->rowlength
= value
? value
: osmesa
->width
;
1105 osmesa
->yup
= value
? GL_TRUE
: GL_FALSE
;
1108 _mesa_error( &osmesa
->mesa
, GL_INVALID_ENUM
, "OSMesaPixelStore(pname)" );
1112 compute_row_addresses( osmesa
);
1116 GLAPI
void GLAPIENTRY
1117 OSMesaGetIntegerv( GLint pname
, GLint
*value
)
1119 OSMesaContext osmesa
= OSMesaGetCurrentContext();
1123 *value
= osmesa
->width
;
1126 *value
= osmesa
->height
;
1129 *value
= osmesa
->format
;
1134 case OSMESA_ROW_LENGTH
:
1135 *value
= osmesa
->userRowLength
;
1138 *value
= osmesa
->yup
;
1140 case OSMESA_MAX_WIDTH
:
1143 case OSMESA_MAX_HEIGHT
:
1144 *value
= MAX_HEIGHT
;
1147 _mesa_error(&osmesa
->mesa
, GL_INVALID_ENUM
, "OSMesaGetIntergerv(pname)");
1153 * Return the depth buffer associated with an OSMesa context.
1154 * Input: c - the OSMesa context
1155 * Output: width, height - size of buffer in pixels
1156 * bytesPerValue - bytes per depth value (2 or 4)
1157 * buffer - pointer to depth buffer values
1158 * Return: GL_TRUE or GL_FALSE to indicate success or failure.
1160 GLAPI GLboolean GLAPIENTRY
1161 OSMesaGetDepthBuffer( OSMesaContext c
, GLint
*width
, GLint
*height
,
1162 GLint
*bytesPerValue
, void **buffer
)
1164 struct gl_renderbuffer
*rb
= NULL
;
1167 rb
= c
->gl_buffer
->Attachment
[BUFFER_DEPTH
].Renderbuffer
;
1169 if (!rb
|| !rb
->Data
) {
1170 /*if ((!c->gl_buffer) || (!c->gl_buffer->DepthBuffer)) {*/
1178 *width
= c
->gl_buffer
->Width
;
1179 *height
= c
->gl_buffer
->Height
;
1180 if (c
->gl_visual
->depthBits
<= 16)
1181 *bytesPerValue
= sizeof(GLushort
);
1183 *bytesPerValue
= sizeof(GLuint
);
1190 * Return the color buffer associated with an OSMesa context.
1191 * Input: c - the OSMesa context
1192 * Output: width, height - size of buffer in pixels
1193 * format - the pixel format (OSMESA_FORMAT)
1194 * buffer - pointer to color buffer values
1195 * Return: GL_TRUE or GL_FALSE to indicate success or failure.
1197 GLAPI GLboolean GLAPIENTRY
1198 OSMesaGetColorBuffer( OSMesaContext c
, GLint
*width
,
1199 GLint
*height
, GLint
*format
, void **buffer
)
1210 *height
= c
->height
;
1211 *format
= c
->format
;
1212 *buffer
= c
->buffer
;
1218 struct name_function
1221 OSMESAproc Function
;
1224 static struct name_function functions
[] = {
1225 { "OSMesaCreateContext", (OSMESAproc
) OSMesaCreateContext
},
1226 { "OSMesaCreateContextExt", (OSMESAproc
) OSMesaCreateContextExt
},
1227 { "OSMesaDestroyContext", (OSMESAproc
) OSMesaDestroyContext
},
1228 { "OSMesaMakeCurrent", (OSMESAproc
) OSMesaMakeCurrent
},
1229 { "OSMesaGetCurrentContext", (OSMESAproc
) OSMesaGetCurrentContext
},
1230 { "OSMesaPixelsStore", (OSMESAproc
) OSMesaPixelStore
},
1231 { "OSMesaGetIntegerv", (OSMESAproc
) OSMesaGetIntegerv
},
1232 { "OSMesaGetDepthBuffer", (OSMESAproc
) OSMesaGetDepthBuffer
},
1233 { "OSMesaGetColorBuffer", (OSMESAproc
) OSMesaGetColorBuffer
},
1234 { "OSMesaGetProcAddress", (OSMESAproc
) OSMesaGetProcAddress
},
1239 GLAPI OSMESAproc GLAPIENTRY
1240 OSMesaGetProcAddress( const char *funcName
)
1243 for (i
= 0; functions
[i
].Name
; i
++) {
1244 if (_mesa_strcmp(functions
[i
].Name
, funcName
) == 0)
1245 return functions
[i
].Function
;
1247 return _glapi_get_proc_address(funcName
);
1251 GLAPI
void GLAPIENTRY
1252 OSMesaColorClamp(GLboolean enable
)
1254 OSMesaContext osmesa
= OSMesaGetCurrentContext();
1256 if (enable
== GL_TRUE
) {
1257 osmesa
->mesa
.Color
.ClampFragmentColor
= GL_TRUE
;
1260 osmesa
->mesa
.Color
.ClampFragmentColor
= GL_FIXED_ONLY_ARB
;