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_inlines.h"
45 #include "pipe/p_winsys.h"
46 #include "st_context.h"
47 #include "st_cb_fbo.h"
48 #include "st_cb_texture.h"
49 #include "st_format.h"
50 #include "st_public.h"
51 #include "st_texture.h"
56 * Compute the renderbuffer's Red/Green/EtcBit fields from the pipe format.
59 init_renderbuffer_bits(struct st_renderbuffer *strb,
60 enum pipe_format pipeFormat)
62 struct pipe_format_info info;
64 if (!st_get_format_info( pipeFormat, &info )) {
68 strb->Base._ActualFormat = info.base_format;
69 strb->Base.RedBits = info.red_bits;
70 strb->Base.GreenBits = info.green_bits;
71 strb->Base.BlueBits = info.blue_bits;
72 strb->Base.AlphaBits = info.alpha_bits;
73 strb->Base.DepthBits = info.depth_bits;
74 strb->Base.StencilBits = info.stencil_bits;
75 strb->Base.DataType = st_format_datatype(pipeFormat);
81 * gl_renderbuffer::AllocStorage()
82 * This is called to allocate the original drawing surface, and
83 * during window resize.
86 st_renderbuffer_alloc_storage(GLcontext * ctx, struct gl_renderbuffer *rb,
87 GLenum internalFormat,
88 GLuint width, GLuint height)
90 struct pipe_context *pipe = ctx->st->pipe;
91 struct st_renderbuffer *strb = st_renderbuffer(rb);
92 struct pipe_texture template;
93 unsigned surface_usage;
95 /* Free the old surface and texture
97 pipe_surface_reference( &strb->surface, NULL );
98 pipe_texture_reference( &strb->texture, NULL );
101 memset(&template, 0, sizeof(template));
103 if (strb->format != PIPE_FORMAT_NONE) {
104 template.format = strb->format;
107 template.format = st_choose_renderbuffer_format(pipe, internalFormat);
110 strb->Base.Width = width;
111 strb->Base.Height = height;
112 init_renderbuffer_bits(strb, template.format);
114 template.target = PIPE_TEXTURE_2D;
115 template.compressed = 0;
116 pf_get_block(template.format, &template.block);
117 template.width[0] = width;
118 template.height[0] = height;
119 template.depth[0] = 1;
120 template.last_level = 0;
122 if (pf_is_depth_stencil(template.format)) {
123 template.tex_usage = PIPE_TEXTURE_USAGE_DEPTH_STENCIL;
126 template.tex_usage = (PIPE_TEXTURE_USAGE_DISPLAY_TARGET |
127 PIPE_TEXTURE_USAGE_RENDER_TARGET);
131 /* Probably need dedicated flags for surface usage too:
133 surface_usage = (PIPE_BUFFER_USAGE_GPU_READ |
134 PIPE_BUFFER_USAGE_GPU_WRITE);
136 PIPE_BUFFER_USAGE_CPU_READ |
137 PIPE_BUFFER_USAGE_CPU_WRITE);
140 strb->texture = pipe->screen->texture_create( pipe->screen,
143 /* Special path for accum buffers.
145 * Try a different surface format. Since accum buffers are s/w
146 * only for now, the surface pixel format doesn't really matter,
147 * only that the buffer is large enough.
149 if (!strb->texture && template.format == DEFAULT_ACCUM_PIPE_FORMAT)
151 /* Actually, just setting this usage value should be sufficient
152 * to tell the driver to go ahead and allocate the buffer, even
153 * if HW doesn't support the format.
155 template.tex_usage = 0;
156 surface_usage = (PIPE_BUFFER_USAGE_CPU_READ |
157 PIPE_BUFFER_USAGE_CPU_WRITE);
159 strb->texture = pipe->screen->texture_create( pipe->screen,
167 strb->surface = pipe->screen->get_tex_surface( pipe->screen,
172 assert(strb->surface->buffer);
173 assert(strb->surface->format);
174 assert(strb->surface->block.size);
175 assert(strb->surface->block.width);
176 assert(strb->surface->block.height);
177 assert(strb->surface->width == width);
178 assert(strb->surface->height == height);
179 assert(strb->surface->stride);
182 return strb->surface != NULL;
187 * gl_renderbuffer::Delete()
190 st_renderbuffer_delete(struct gl_renderbuffer *rb)
192 struct st_renderbuffer *strb = st_renderbuffer(rb);
194 pipe_surface_reference(&strb->surface, NULL);
195 pipe_texture_reference(&strb->texture, NULL);
201 * gl_renderbuffer::GetPointer()
204 null_get_pointer(GLcontext * ctx, struct gl_renderbuffer *rb,
207 /* By returning NULL we force all software rendering to go through
211 assert(0); /* Should never get called with softpipe */
218 * Called via ctx->Driver.NewFramebuffer()
220 static struct gl_framebuffer *
221 st_new_framebuffer(GLcontext *ctx, GLuint name)
223 /* XXX not sure we need to subclass gl_framebuffer for pipe */
224 return _mesa_new_framebuffer(ctx, name);
229 * Called via ctx->Driver.NewRenderbuffer()
231 static struct gl_renderbuffer *
232 st_new_renderbuffer(GLcontext *ctx, GLuint name)
234 struct st_renderbuffer *strb = CALLOC_STRUCT(st_renderbuffer);
236 _mesa_init_renderbuffer(&strb->Base, name);
237 strb->Base.Delete = st_renderbuffer_delete;
238 strb->Base.AllocStorage = st_renderbuffer_alloc_storage;
239 strb->Base.GetPointer = null_get_pointer;
240 strb->format = PIPE_FORMAT_NONE;
248 * Allocate a renderbuffer for a an on-screen window (not a user-created
249 * renderbuffer). The window system code determines the format.
251 struct gl_renderbuffer *
252 st_new_renderbuffer_fb(enum pipe_format format)
254 struct st_renderbuffer *strb;
256 strb = CALLOC_STRUCT(st_renderbuffer);
258 _mesa_error(NULL, GL_OUT_OF_MEMORY, "creating renderbuffer");
262 _mesa_init_renderbuffer(&strb->Base, 0);
263 strb->Base.ClassID = 0x4242; /* just a unique value */
264 strb->format = format;
267 case PIPE_FORMAT_A8R8G8B8_UNORM:
268 case PIPE_FORMAT_B8G8R8A8_UNORM:
269 case PIPE_FORMAT_X8R8G8B8_UNORM:
270 case PIPE_FORMAT_B8G8R8X8_UNORM:
271 case PIPE_FORMAT_A1R5G5B5_UNORM:
272 case PIPE_FORMAT_A4R4G4B4_UNORM:
273 case PIPE_FORMAT_R5G6B5_UNORM:
274 strb->Base.InternalFormat = GL_RGBA;
275 strb->Base._BaseFormat = GL_RGBA;
277 case PIPE_FORMAT_Z16_UNORM:
278 strb->Base.InternalFormat = GL_DEPTH_COMPONENT16;
279 strb->Base._BaseFormat = GL_DEPTH_COMPONENT;
281 case PIPE_FORMAT_Z32_UNORM:
282 strb->Base.InternalFormat = GL_DEPTH_COMPONENT32;
283 strb->Base._BaseFormat = GL_DEPTH_COMPONENT;
285 case PIPE_FORMAT_S8Z24_UNORM:
286 case PIPE_FORMAT_Z24S8_UNORM:
287 case PIPE_FORMAT_X8Z24_UNORM:
288 case PIPE_FORMAT_Z24X8_UNORM:
289 strb->Base.InternalFormat = GL_DEPTH24_STENCIL8_EXT;
290 strb->Base._BaseFormat = GL_DEPTH_STENCIL_EXT;
292 case PIPE_FORMAT_S8_UNORM:
293 strb->Base.InternalFormat = GL_STENCIL_INDEX8_EXT;
294 strb->Base._BaseFormat = GL_STENCIL_INDEX;
296 case DEFAULT_ACCUM_PIPE_FORMAT: /*PIPE_FORMAT_R16G16B16A16_SNORM*/
297 strb->Base.InternalFormat = GL_RGBA16;
298 strb->Base._BaseFormat = GL_RGBA;
302 "Unexpected format in st_new_renderbuffer_fb");
306 /* st-specific methods */
307 strb->Base.Delete = st_renderbuffer_delete;
308 strb->Base.AllocStorage = st_renderbuffer_alloc_storage;
309 strb->Base.GetPointer = null_get_pointer;
311 /* surface is allocated in st_renderbuffer_alloc_storage() */
312 strb->surface = NULL;
321 * Called via ctx->Driver.BindFramebufferEXT().
324 st_bind_framebuffer(GLcontext *ctx, GLenum target,
325 struct gl_framebuffer *fb, struct gl_framebuffer *fbread)
331 * Called by ctx->Driver.FramebufferRenderbuffer
334 st_framebuffer_renderbuffer(GLcontext *ctx,
335 struct gl_framebuffer *fb,
337 struct gl_renderbuffer *rb)
339 /* XXX no need for derivation? */
340 _mesa_framebuffer_renderbuffer(ctx, fb, attachment, rb);
345 * Called by ctx->Driver.RenderTexture
348 st_render_texture(GLcontext *ctx,
349 struct gl_framebuffer *fb,
350 struct gl_renderbuffer_attachment *att)
352 struct st_renderbuffer *strb;
353 struct gl_renderbuffer *rb;
354 struct pipe_texture *pt;
355 struct st_texture_object *stObj;
356 const struct gl_texture_image *texImage =
357 att->Texture->Image[att->CubeMapFace][att->TextureLevel];
360 assert(!att->Renderbuffer);
362 /* create new renderbuffer which wraps the texture image */
363 rb = st_new_renderbuffer(ctx, 0);
365 _mesa_error(ctx, GL_OUT_OF_MEMORY, "glFramebufferTexture()");
369 _mesa_reference_renderbuffer(&att->Renderbuffer, rb);
370 assert(rb->RefCount == 1);
371 rb->AllocStorage = NULL; /* should not get called */
372 strb = st_renderbuffer(rb);
374 /* get the texture for the texture object */
375 stObj = st_texture_object(att->Texture);
377 /* point renderbuffer at texobject */
379 strb->rtt_level = att->TextureLevel;
380 strb->rtt_face = att->CubeMapFace;
381 strb->rtt_slice = att->Zoffset;
383 rb->Width = texImage->Width2;
384 rb->Height = texImage->Height2;
385 /*printf("***** render to texture level %d: %d x %d\n", att->TextureLevel, rb->Width, rb->Height);*/
387 pt = st_get_texobj_texture(att->Texture);
389 /*printf("***** pipe texture %d x %d\n", pt->width[0], pt->height[0]);*/
391 pipe_texture_reference( &strb->texture, pt );
393 pipe_surface_reference(&strb->surface, NULL);
395 /* the new surface will be created during framebuffer validation */
397 init_renderbuffer_bits(strb, pt->format);
400 printf("RENDER TO TEXTURE obj=%p pt=%p surf=%p %d x %d\n",
401 att->Texture, pt, strb->surface, rb->Width, rb->Height);
404 /* Invalidate buffer state so that the pipe's framebuffer state
406 * That's where the new renderbuffer (which we just created) gets
407 * passed to the pipe as a (color/depth) render target.
409 st_invalidate_state(ctx, _NEW_BUFFERS);
414 * Called via ctx->Driver.FinishRenderTexture.
417 st_finish_render_texture(GLcontext *ctx,
418 struct gl_renderbuffer_attachment *att)
420 struct pipe_screen *screen = ctx->st->pipe->screen;
421 struct st_renderbuffer *strb = st_renderbuffer(att->Renderbuffer);
425 ctx->st->pipe->flush(ctx->st->pipe, PIPE_FLUSH_RENDER_CACHE, NULL);
428 screen->tex_surface_release( screen, &strb->surface );
433 printf("FINISH RENDER TO TEXTURE surf=%p\n", strb->surface);
436 _mesa_reference_renderbuffer(&att->Renderbuffer, NULL);
438 /* restore previous framebuffer state */
439 st_invalidate_state(ctx, _NEW_BUFFERS);
444 void st_init_fbo_functions(struct dd_function_table *functions)
446 functions->NewFramebuffer = st_new_framebuffer;
447 functions->NewRenderbuffer = st_new_renderbuffer;
448 functions->BindFramebuffer = st_bind_framebuffer;
449 functions->FramebufferRenderbuffer = st_framebuffer_renderbuffer;
450 functions->RenderTexture = st_render_texture;
451 functions->FinishRenderTexture = st_finish_render_texture;
452 /* no longer needed by core Mesa, drivers handle resizes...
453 functions->ResizeBuffers = st_resize_buffers;