1 /**************************************************************************
3 * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas.
6 * Permission is hereby granted, free of charge, to any person obtaining a
7 * copy of this software and associated documentation files (the
8 * "Software"), to deal in the Software without restriction, including
9 * without limitation the rights to use, copy, modify, merge, publish,
10 * distribute, sub license, and/or sell copies of the Software, and to
11 * permit persons to whom the Software is furnished to do so, subject to
12 * the following conditions:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
19 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
20 * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NON-INFRINGEMENT.
21 * IN NO EVENT SHALL TUNGSTEN GRAPHICS AND/OR ITS SUPPLIERS BE LIABLE FOR
22 * ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
23 * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
24 * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
26 **************************************************************************/
30 * Framebuffer/renderbuffer functions.
36 #include "main/imports.h"
37 #include "main/context.h"
38 #include "main/fbobject.h"
39 #include "main/framebuffer.h"
40 #include "main/renderbuffer.h"
42 #include "pipe/p_context.h"
43 #include "pipe/p_defines.h"
44 #include "pipe/p_screen.h"
45 #include "st_context.h"
46 #include "st_cb_fbo.h"
47 #include "st_cb_texture.h"
48 #include "st_format.h"
49 #include "st_public.h"
50 #include "st_texture.h"
55 * Compute the renderbuffer's Red/Green/EtcBit fields from the pipe format.
58 init_renderbuffer_bits(struct st_renderbuffer
*strb
,
59 enum pipe_format pipeFormat
)
61 struct pipe_format_info info
;
63 if (!st_get_format_info( pipeFormat
, &info
)) {
67 strb
->Base
._ActualFormat
= info
.base_format
;
68 strb
->Base
.RedBits
= info
.red_bits
;
69 strb
->Base
.GreenBits
= info
.green_bits
;
70 strb
->Base
.BlueBits
= info
.blue_bits
;
71 strb
->Base
.AlphaBits
= info
.alpha_bits
;
72 strb
->Base
.DepthBits
= info
.depth_bits
;
73 strb
->Base
.StencilBits
= info
.stencil_bits
;
74 strb
->Base
.DataType
= st_format_datatype(pipeFormat
);
80 * gl_renderbuffer::AllocStorage()
81 * This is called to allocate the original drawing surface, and
82 * during window resize.
85 st_renderbuffer_alloc_storage(GLcontext
* ctx
, struct gl_renderbuffer
*rb
,
86 GLenum internalFormat
,
87 GLuint width
, GLuint height
)
89 struct pipe_context
*pipe
= ctx
->st
->pipe
;
90 struct st_renderbuffer
*strb
= st_renderbuffer(rb
);
91 struct pipe_texture
template;
92 unsigned surface_usage
;
94 /* Free the old surface and texture
96 pipe_surface_reference( &strb
->surface
, NULL
);
97 pipe_texture_reference( &strb
->texture
, NULL
);
99 /* Setup new texture template.
101 memset(&template, 0, sizeof(template));
102 template.target
= PIPE_TEXTURE_2D
;
103 if (strb
->format
!= PIPE_FORMAT_NONE
) {
104 template.format
= strb
->format
;
107 template.format
= st_choose_renderbuffer_format(pipe
, internalFormat
);
109 pf_get_block(template.format
, &template.block
);
110 template.width
[0] = width
;
111 template.height
[0] = height
;
112 template.depth
[0] = 1;
113 template.last_level
= 0;
114 template.nr_samples
= rb
->NumSamples
;
115 if (pf_is_depth_stencil(template.format
)) {
116 template.tex_usage
= PIPE_TEXTURE_USAGE_DEPTH_STENCIL
;
119 template.tex_usage
= (PIPE_TEXTURE_USAGE_DISPLAY_TARGET
|
120 PIPE_TEXTURE_USAGE_RENDER_TARGET
);
123 /* init renderbuffer fields */
124 strb
->Base
.Width
= width
;
125 strb
->Base
.Height
= height
;
126 init_renderbuffer_bits(strb
, template.format
);
128 /* Probably need dedicated flags for surface usage too:
130 surface_usage
= (PIPE_BUFFER_USAGE_GPU_READ
|
131 PIPE_BUFFER_USAGE_GPU_WRITE
);
133 PIPE_BUFFER_USAGE_CPU_READ
|
134 PIPE_BUFFER_USAGE_CPU_WRITE
);
137 strb
->texture
= pipe
->screen
->texture_create( pipe
->screen
,
140 /* Special path for accum buffers.
142 * Try a different surface format. Since accum buffers are s/w
143 * only for now, the surface pixel format doesn't really matter,
144 * only that the buffer is large enough.
146 if (!strb
->texture
&& template.format
== DEFAULT_ACCUM_PIPE_FORMAT
)
148 /* Actually, just setting this usage value should be sufficient
149 * to tell the driver to go ahead and allocate the buffer, even
150 * if HW doesn't support the format.
152 template.tex_usage
= 0;
153 surface_usage
= (PIPE_BUFFER_USAGE_CPU_READ
|
154 PIPE_BUFFER_USAGE_CPU_WRITE
);
156 strb
->texture
= pipe
->screen
->texture_create( pipe
->screen
,
164 strb
->surface
= pipe
->screen
->get_tex_surface( pipe
->screen
,
169 assert(strb
->surface
->texture
);
170 assert(strb
->surface
->format
);
171 assert(strb
->surface
->width
== width
);
172 assert(strb
->surface
->height
== height
);
175 return strb
->surface
!= NULL
;
180 * gl_renderbuffer::Delete()
183 st_renderbuffer_delete(struct gl_renderbuffer
*rb
)
185 struct st_renderbuffer
*strb
= st_renderbuffer(rb
);
187 pipe_surface_reference(&strb
->surface
, NULL
);
188 pipe_texture_reference(&strb
->texture
, NULL
);
194 * gl_renderbuffer::GetPointer()
197 null_get_pointer(GLcontext
* ctx
, struct gl_renderbuffer
*rb
,
200 /* By returning NULL we force all software rendering to go through
204 assert(0); /* Should never get called with softpipe */
211 * Called via ctx->Driver.NewFramebuffer()
213 static struct gl_framebuffer
*
214 st_new_framebuffer(GLcontext
*ctx
, GLuint name
)
216 /* XXX not sure we need to subclass gl_framebuffer for pipe */
217 return _mesa_new_framebuffer(ctx
, name
);
222 * Called via ctx->Driver.NewRenderbuffer()
224 static struct gl_renderbuffer
*
225 st_new_renderbuffer(GLcontext
*ctx
, GLuint name
)
227 struct st_renderbuffer
*strb
= ST_CALLOC_STRUCT(st_renderbuffer
);
229 _mesa_init_renderbuffer(&strb
->Base
, name
);
230 strb
->Base
.Delete
= st_renderbuffer_delete
;
231 strb
->Base
.AllocStorage
= st_renderbuffer_alloc_storage
;
232 strb
->Base
.GetPointer
= null_get_pointer
;
233 strb
->format
= PIPE_FORMAT_NONE
;
241 * Allocate a renderbuffer for a an on-screen window (not a user-created
242 * renderbuffer). The window system code determines the format.
244 struct gl_renderbuffer
*
245 st_new_renderbuffer_fb(enum pipe_format format
, int samples
)
247 struct st_renderbuffer
*strb
;
249 strb
= ST_CALLOC_STRUCT(st_renderbuffer
);
251 _mesa_error(NULL
, GL_OUT_OF_MEMORY
, "creating renderbuffer");
255 _mesa_init_renderbuffer(&strb
->Base
, 0);
256 strb
->Base
.ClassID
= 0x4242; /* just a unique value */
257 strb
->Base
.NumSamples
= samples
;
258 strb
->format
= format
;
261 case PIPE_FORMAT_A8R8G8B8_UNORM
:
262 case PIPE_FORMAT_B8G8R8A8_UNORM
:
263 case PIPE_FORMAT_X8R8G8B8_UNORM
:
264 case PIPE_FORMAT_B8G8R8X8_UNORM
:
265 case PIPE_FORMAT_A1R5G5B5_UNORM
:
266 case PIPE_FORMAT_A4R4G4B4_UNORM
:
267 case PIPE_FORMAT_R5G6B5_UNORM
:
268 strb
->Base
.InternalFormat
= GL_RGBA
;
269 strb
->Base
._BaseFormat
= GL_RGBA
;
271 case PIPE_FORMAT_Z16_UNORM
:
272 strb
->Base
.InternalFormat
= GL_DEPTH_COMPONENT16
;
273 strb
->Base
._BaseFormat
= GL_DEPTH_COMPONENT
;
275 case PIPE_FORMAT_Z32_UNORM
:
276 strb
->Base
.InternalFormat
= GL_DEPTH_COMPONENT32
;
277 strb
->Base
._BaseFormat
= GL_DEPTH_COMPONENT
;
279 case PIPE_FORMAT_S8Z24_UNORM
:
280 case PIPE_FORMAT_Z24S8_UNORM
:
281 case PIPE_FORMAT_X8Z24_UNORM
:
282 case PIPE_FORMAT_Z24X8_UNORM
:
283 strb
->Base
.InternalFormat
= GL_DEPTH24_STENCIL8_EXT
;
284 strb
->Base
._BaseFormat
= GL_DEPTH_STENCIL_EXT
;
286 case PIPE_FORMAT_S8_UNORM
:
287 strb
->Base
.InternalFormat
= GL_STENCIL_INDEX8_EXT
;
288 strb
->Base
._BaseFormat
= GL_STENCIL_INDEX
;
290 case DEFAULT_ACCUM_PIPE_FORMAT
: /*PIPE_FORMAT_R16G16B16A16_SNORM*/
291 strb
->Base
.InternalFormat
= GL_RGBA16
;
292 strb
->Base
._BaseFormat
= GL_RGBA
;
296 "Unexpected format in st_new_renderbuffer_fb");
300 /* st-specific methods */
301 strb
->Base
.Delete
= st_renderbuffer_delete
;
302 strb
->Base
.AllocStorage
= st_renderbuffer_alloc_storage
;
303 strb
->Base
.GetPointer
= null_get_pointer
;
305 /* surface is allocated in st_renderbuffer_alloc_storage() */
306 strb
->surface
= NULL
;
315 * Called via ctx->Driver.BindFramebufferEXT().
318 st_bind_framebuffer(GLcontext
*ctx
, GLenum target
,
319 struct gl_framebuffer
*fb
, struct gl_framebuffer
*fbread
)
325 * Called by ctx->Driver.FramebufferRenderbuffer
328 st_framebuffer_renderbuffer(GLcontext
*ctx
,
329 struct gl_framebuffer
*fb
,
331 struct gl_renderbuffer
*rb
)
333 /* XXX no need for derivation? */
334 _mesa_framebuffer_renderbuffer(ctx
, fb
, attachment
, rb
);
339 * Called by ctx->Driver.RenderTexture
342 st_render_texture(GLcontext
*ctx
,
343 struct gl_framebuffer
*fb
,
344 struct gl_renderbuffer_attachment
*att
)
346 struct st_renderbuffer
*strb
;
347 struct gl_renderbuffer
*rb
;
348 struct pipe_texture
*pt
= st_get_texobj_texture(att
->Texture
);
349 struct st_texture_object
*stObj
;
350 const struct gl_texture_image
*texImage
=
351 att
->Texture
->Image
[att
->CubeMapFace
][att
->TextureLevel
];
356 /* create new renderbuffer which wraps the texture image */
357 rb
= st_new_renderbuffer(ctx
, 0);
359 _mesa_error(ctx
, GL_OUT_OF_MEMORY
, "glFramebufferTexture()");
363 _mesa_reference_renderbuffer(&att
->Renderbuffer
, rb
);
364 assert(rb
->RefCount
== 1);
365 rb
->AllocStorage
= NULL
; /* should not get called */
366 strb
= st_renderbuffer(rb
);
368 /* get the texture for the texture object */
369 stObj
= st_texture_object(att
->Texture
);
371 /* point renderbuffer at texobject */
373 strb
->rtt_level
= att
->TextureLevel
;
374 strb
->rtt_face
= att
->CubeMapFace
;
375 strb
->rtt_slice
= att
->Zoffset
;
377 rb
->Width
= texImage
->Width2
;
378 rb
->Height
= texImage
->Height2
;
379 /*printf("***** render to texture level %d: %d x %d\n", att->TextureLevel, rb->Width, rb->Height);*/
381 /*printf("***** pipe texture %d x %d\n", pt->width[0], pt->height[0]);*/
383 pipe_texture_reference( &strb
->texture
, pt
);
385 pipe_surface_reference(&strb
->surface
, NULL
);
387 /* the new surface will be created during framebuffer validation */
389 init_renderbuffer_bits(strb
, pt
->format
);
392 printf("RENDER TO TEXTURE obj=%p pt=%p surf=%p %d x %d\n",
393 att->Texture, pt, strb->surface, rb->Width, rb->Height);
396 /* Invalidate buffer state so that the pipe's framebuffer state
398 * That's where the new renderbuffer (which we just created) gets
399 * passed to the pipe as a (color/depth) render target.
401 st_invalidate_state(ctx
, _NEW_BUFFERS
);
406 * Called via ctx->Driver.FinishRenderTexture.
409 st_finish_render_texture(GLcontext
*ctx
,
410 struct gl_renderbuffer_attachment
*att
)
412 struct st_renderbuffer
*strb
= st_renderbuffer(att
->Renderbuffer
);
417 st_flush( ctx
->st
, PIPE_FLUSH_RENDER_CACHE
, NULL
);
420 pipe_surface_reference( &strb
->surface
, NULL
);
425 printf("FINISH RENDER TO TEXTURE surf=%p\n", strb->surface);
428 _mesa_reference_renderbuffer(&att
->Renderbuffer
, NULL
);
430 /* restore previous framebuffer state */
431 st_invalidate_state(ctx
, _NEW_BUFFERS
);
436 * Check that the framebuffer configuration is valid in terms of what
437 * the driver can support.
439 * For Gallium we only supports combined Z+stencil, not separate buffers.
442 st_validate_framebuffer(GLcontext
*ctx
, struct gl_framebuffer
*fb
)
444 const struct gl_renderbuffer
*depthRb
=
445 fb
->Attachment
[BUFFER_DEPTH
].Renderbuffer
;
446 const struct gl_renderbuffer
*stencilRb
=
447 fb
->Attachment
[BUFFER_STENCIL
].Renderbuffer
;
449 if (stencilRb
&& depthRb
&& stencilRb
!= depthRb
) {
450 fb
->_Status
= GL_FRAMEBUFFER_UNSUPPORTED_EXT
;
455 void st_init_fbo_functions(struct dd_function_table
*functions
)
457 functions
->NewFramebuffer
= st_new_framebuffer
;
458 functions
->NewRenderbuffer
= st_new_renderbuffer
;
459 functions
->BindFramebuffer
= st_bind_framebuffer
;
460 functions
->FramebufferRenderbuffer
= st_framebuffer_renderbuffer
;
461 functions
->RenderTexture
= st_render_texture
;
462 functions
->FinishRenderTexture
= st_finish_render_texture
;
463 functions
->ValidateFramebuffer
= st_validate_framebuffer
;
464 /* no longer needed by core Mesa, drivers handle resizes...
465 functions->ResizeBuffers = st_resize_buffers;