st_framebuffer.c File Reference

Include dependency graph for st_framebuffer.c:

Go to the source code of this file.

Functions
struct st_framebuffer *	st_create_framebuffer (const __GLcontextModes *visual, enum pipe_format colorFormat, enum pipe_format depthFormat, enum pipe_format stencilFormat, uint width, uint height, void *private)
void	st_resize_framebuffer (struct st_framebuffer *stfb, uint width, uint height)
void	st_unreference_framebuffer (struct st_framebuffer **stfb)
void	st_set_framebuffer_surface (struct st_framebuffer *stfb, uint surfIndex, struct pipe_surface *surf)
	Set/replace a framebuffer surface.
struct pipe_surface *	st_get_framebuffer_surface (struct st_framebuffer *stfb, uint surfIndex)
	Return the pipe_surface for the given renderbuffer.
struct pipe_texture *	st_get_framebuffer_texture (struct st_framebuffer *stfb, uint surfIndex)
void	st_notify_swapbuffers (struct st_framebuffer *stfb)
	This function is to be called prior to SwapBuffers on the given framebuffer.
void	st_notify_swapbuffers_complete (struct st_framebuffer *stfb)
	Quick hack - allows the winsys to inform the driver that surface states are now undefined after a glXSwapBuffers or similar.
void *	st_framebuffer_private (struct st_framebuffer *stfb)

---

Function Documentation

struct st_framebuffer* st_create_framebuffer	(	const __GLcontextModes *	visual,
		enum pipe_format	colorFormat,
		enum pipe_format	depthFormat,
		enum pipe_format	stencilFormat,
		uint	width,
		uint	height,
		void *	private
	)			[read]

Definition at line 45 of file st_framebuffer.c.

References st_framebuffer::Base, CALLOC_STRUCT, DEFAULT_ACCUM_PIPE_FORMAT, st_framebuffer::InitHeight, st_framebuffer::InitWidth, PIPE_FORMAT_NONE, st_framebuffer::Private, st_get_msaa(), and st_new_renderbuffer_fb().

{
   struct st_framebuffer *stfb = CALLOC_STRUCT(st_framebuffer);
   if (stfb) {
      int samples = st_get_msaa();

      if (visual->sampleBuffers)
         samples = visual->samples;

      _mesa_initialize_framebuffer(&stfb->Base, visual);

      {
         /* fake frontbuffer */
         /* XXX allocation should only happen in the unusual case
            it's actually needed */
         struct gl_renderbuffer *rb
            = st_new_renderbuffer_fb(colorFormat, samples);
         _mesa_add_renderbuffer(&stfb->Base, BUFFER_FRONT_LEFT, rb);
      }

      if (visual->doubleBufferMode) {
         struct gl_renderbuffer *rb
            = st_new_renderbuffer_fb(colorFormat, samples);
         _mesa_add_renderbuffer(&stfb->Base, BUFFER_BACK_LEFT, rb);
      }

      if (depthFormat == stencilFormat && depthFormat != PIPE_FORMAT_NONE) {
         /* combined depth/stencil buffer */
         struct gl_renderbuffer *depthStencilRb
            = st_new_renderbuffer_fb(depthFormat, samples);
         /* note: bind RB to two attachment points */
         _mesa_add_renderbuffer(&stfb->Base, BUFFER_DEPTH, depthStencilRb);
         _mesa_add_renderbuffer(&stfb->Base, BUFFER_STENCIL, depthStencilRb);
      }
      else {
         /* separate depth and/or stencil */

         if (visual->depthBits == 32) {
            /* 32-bit depth buffer */
            struct gl_renderbuffer *depthRb
               = st_new_renderbuffer_fb(depthFormat, samples);
            _mesa_add_renderbuffer(&stfb->Base, BUFFER_DEPTH, depthRb);
         }
         else if (visual->depthBits == 24) {
            /* 24-bit depth buffer, ignore stencil bits */
            struct gl_renderbuffer *depthRb
               = st_new_renderbuffer_fb(depthFormat, samples);
            _mesa_add_renderbuffer(&stfb->Base, BUFFER_DEPTH, depthRb);
         }
         else if (visual->depthBits > 0) {
            /* 16-bit depth buffer */
            struct gl_renderbuffer *depthRb
               = st_new_renderbuffer_fb(depthFormat, samples);
            _mesa_add_renderbuffer(&stfb->Base, BUFFER_DEPTH, depthRb);
         }

         if (visual->stencilBits > 0) {
            /* 8-bit stencil */
            struct gl_renderbuffer *stencilRb
               = st_new_renderbuffer_fb(stencilFormat, samples);
            _mesa_add_renderbuffer(&stfb->Base, BUFFER_STENCIL, stencilRb);
         }
      }

      if (visual->accumRedBits > 0) {
         /* 16-bit/channel accum */
         struct gl_renderbuffer *accumRb
            = st_new_renderbuffer_fb(DEFAULT_ACCUM_PIPE_FORMAT, 0); /* XXX accum isn't multisampled right? */
         _mesa_add_renderbuffer(&stfb->Base, BUFFER_ACCUM, accumRb);
      }

      stfb->Base.Initialized = GL_TRUE;
      stfb->InitWidth = width;
      stfb->InitHeight = height;
      stfb->Private = private;
   }
   return stfb;
}

void* st_framebuffer_private

(

struct st_framebuffer *

stfb

)

Definition at line 302 of file st_framebuffer.c.

References st_framebuffer::Private.

{
   return stfb->Private;
}

struct pipe_surface* st_get_framebuffer_surface	(	struct st_framebuffer *	stfb,
		uint	surfIndex
	)			[read]

Return the pipe_surface for the given renderbuffer.

Definition at line 222 of file st_framebuffer.c.

References assert, st_framebuffer::Base, st_renderbuffer(), ST_SURFACE_BACK_RIGHT, ST_SURFACE_DEPTH, ST_SURFACE_FRONT_LEFT, and st_renderbuffer::surface.

{
   struct st_renderbuffer *strb;

   assert(surfIndex <= ST_SURFACE_DEPTH);

   /* sanity checks, ST tokens should match Mesa tokens */
   assert(ST_SURFACE_FRONT_LEFT == BUFFER_FRONT_LEFT);
   assert(ST_SURFACE_BACK_RIGHT == BUFFER_BACK_RIGHT);

   strb = st_renderbuffer(stfb->Base.Attachment[surfIndex].Renderbuffer);
   if (strb)
      return strb->surface;
   return NULL;
}

struct pipe_texture* st_get_framebuffer_texture	(	struct st_framebuffer *	stfb,
		uint	surfIndex
	)			[read]

Definition at line 239 of file st_framebuffer.c.

References assert, st_framebuffer::Base, st_renderbuffer(), ST_SURFACE_BACK_RIGHT, ST_SURFACE_DEPTH, ST_SURFACE_FRONT_LEFT, and st_renderbuffer::texture.

{
   struct st_renderbuffer *strb;

   assert(surfIndex <= ST_SURFACE_DEPTH);

   /* sanity checks, ST tokens should match Mesa tokens */
   assert(ST_SURFACE_FRONT_LEFT == BUFFER_FRONT_LEFT);
   assert(ST_SURFACE_BACK_RIGHT == BUFFER_BACK_RIGHT);

   strb = st_renderbuffer(stfb->Base.Attachment[surfIndex].Renderbuffer);
   if (strb)
      return strb->texture;
   return NULL;
}

void st_notify_swapbuffers

(

struct st_framebuffer *

stfb

)

This function is to be called prior to SwapBuffers on the given framebuffer.

It checks if the current context is bound to the framebuffer and flushes rendering if needed.

Definition at line 261 of file st_framebuffer.c.

References st_framebuffer::Base, FRONT_STATUS_COPY_OF_BACK, PIPE_FLUSH_FRAME, PIPE_FLUSH_RENDER_CACHE, PIPE_FLUSH_SWAPBUFFERS, and st_flush().

{
   GET_CURRENT_CONTEXT(ctx);

   if (ctx && ctx->DrawBuffer == &stfb->Base) {
      st_flush( ctx->st, 
                PIPE_FLUSH_RENDER_CACHE | 
                PIPE_FLUSH_SWAPBUFFERS |
                PIPE_FLUSH_FRAME,
                NULL );
      ctx->st->frontbuffer_status = FRONT_STATUS_COPY_OF_BACK;
   }
}

void st_notify_swapbuffers_complete

(

struct st_framebuffer *

stfb

)

Quick hack - allows the winsys to inform the driver that surface states are now undefined after a glXSwapBuffers or similar.

Definition at line 281 of file st_framebuffer.c.

References st_framebuffer::Base, PIPE_SURFACE_STATUS_UNDEFINED, st_renderbuffer(), pipe_surface::status, and st_renderbuffer::surface.

{
   GET_CURRENT_CONTEXT(ctx);

   if (ctx && ctx->DrawBuffer == &stfb->Base) {
      struct st_renderbuffer *strb;

      /* Mark back color buffers as undefined */
      strb = st_renderbuffer(stfb->Base.Attachment[BUFFER_BACK_LEFT].
                             Renderbuffer);
      if (strb && strb->surface)
         strb->surface->status = PIPE_SURFACE_STATUS_UNDEFINED;

      strb = st_renderbuffer(stfb->Base.Attachment[BUFFER_BACK_RIGHT].
                             Renderbuffer);
      if (strb && strb->surface)
         strb->surface->status = PIPE_SURFACE_STATUS_UNDEFINED;
   }
}

void st_resize_framebuffer	(	struct st_framebuffer *	stfb,
		uint	width,
		uint	height
	)

Definition at line 130 of file st_framebuffer.c.

References assert, st_framebuffer::Base, st_framebuffer::InitHeight, and st_framebuffer::InitWidth.

{
   if (stfb->Base.Width != width || stfb->Base.Height != height) {
      GET_CURRENT_CONTEXT(ctx);
      if (ctx) {
         if (stfb->InitWidth == 0 && stfb->InitHeight == 0) {
            /* didn't have a valid size until now */
            stfb->InitWidth = width;
            stfb->InitHeight = height;
            if (ctx->Viewport.Width <= 1) {
               /* set context's initial viewport/scissor size */
               _mesa_set_viewport(ctx, 0, 0, width, height);
               _mesa_set_scissor(ctx, 0, 0, width, height);
            }
         }

         _mesa_resize_framebuffer(ctx, &stfb->Base, width, height);

         assert(stfb->Base.Width == width);
         assert(stfb->Base.Height == height);
      }
   }
}

void st_set_framebuffer_surface	(	struct st_framebuffer *	stfb,
		uint	surfIndex,
		struct pipe_surface *	surf
	)

Set/replace a framebuffer surface.

The user of the state tracker can use this instead of st_resize_framebuffer() to provide new surfaces when a window is resized.

Definition at line 169 of file st_framebuffer.c.

References assert, st_renderbuffer::Base, st_framebuffer::Base, pipe_surface::height, pipe_surface_reference(), pipe_texture_reference(), st_renderbuffer(), st_renderbuffer::surface, pipe_surface::texture, st_renderbuffer::texture, and pipe_surface::width.

{
   static const GLuint invalid_size = 9999999;
   struct st_renderbuffer *strb;
   GLuint width, height, i;

   assert(surfIndex < BUFFER_COUNT);

   strb = st_renderbuffer(stfb->Base.Attachment[surfIndex].Renderbuffer);
   assert(strb);

   /* replace the renderbuffer's surface/texture pointers */
   pipe_surface_reference( &strb->surface, surf );
   pipe_texture_reference( &strb->texture, surf->texture );

   /* update renderbuffer's width/height */
   strb->Base.Width = surf->width;
   strb->Base.Height = surf->height;

   /* Try to update the framebuffer's width/height from the renderbuffer
    * sizes.  Before we start drawing, all the rbs _should_ be the same size.
    */
   width = height = invalid_size;
   for (i = 0; i < BUFFER_COUNT; i++) {
      if (stfb->Base.Attachment[i].Renderbuffer) {
         if (width == invalid_size) {
            width = stfb->Base.Attachment[i].Renderbuffer->Width;
            height = stfb->Base.Attachment[i].Renderbuffer->Height;
         }
         else if (width != stfb->Base.Attachment[i].Renderbuffer->Width ||
                  height != stfb->Base.Attachment[i].Renderbuffer->Height) {
            /* inconsistant renderbuffer sizes, bail out */
            return;
         }
      }
   }

   if (width != invalid_size) {
      /* OK, the renderbuffers are of a consistant size, so update the
       * parent framebuffer's size.
       */
      stfb->Base.Width = width;
      stfb->Base.Height = height;
   }
}

void st_unreference_framebuffer

(

struct st_framebuffer **

stfb

)

Definition at line 156 of file st_framebuffer.c.

{
   _mesa_unreference_framebuffer((struct gl_framebuffer **) stfb);
}

---