st_cb_flush.c revision f455ca6490fcb65781b21f81c7117bd923e250d1 
1/**************************************************************************
2 *
3 * Copyright 2007 Tungsten Graphics, Inc., Cedar Park, Texas.
4 * All Rights Reserved.
5 *
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:
13 *
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
16 * of the Software.
17 *
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.
25 *
26 **************************************************************************/
27
28 /*
29  * Authors:
30  *   Keith Whitwell <keith@tungstengraphics.com>
31  *   Brian Paul
32  */
33
34#include "main/glheader.h"
35#include "main/macros.h"
36#include "main/context.h"
37#include "st_context.h"
38#include "st_cb_bitmap.h"
39#include "st_cb_flush.h"
40#include "st_cb_clear.h"
41#include "st_cb_fbo.h"
42#include "st_public.h"
43#include "pipe/p_context.h"
44#include "pipe/p_defines.h"
45#include "pipe/p_screen.h"
46#include "util/u_gen_mipmap.h"
47#include "util/u_blit.h"
48
49
50/** Check if we have a front color buffer and if it's been drawn to. */
51static INLINE GLboolean
52is_front_buffer_dirty(struct st_context *st)
53{
54   if (st->frontbuffer_status == FRONT_STATUS_DIRTY) {
55      return GL_TRUE;
56   }
57   else {
58      GLframebuffer *fb = st->ctx->DrawBuffer;
59      struct st_renderbuffer *strb
60         = st_renderbuffer(fb->Attachment[BUFFER_FRONT_LEFT].Renderbuffer);
61      return strb && strb->defined;
62   }
63}
64
65
66/**
67 * Tell the screen to display the front color buffer on-screen.
68 */
69static void
70display_front_buffer(struct st_context *st)
71{
72   GLframebuffer *fb = st->ctx->DrawBuffer;
73   struct st_renderbuffer *strb
74      = st_renderbuffer(fb->Attachment[BUFFER_FRONT_LEFT].Renderbuffer);
75
76   if (strb) {
77      struct pipe_surface *front_surf = strb->surface;
78
79      /* Hook for copying "fake" frontbuffer if necessary:
80       */
81      st->pipe->screen->flush_frontbuffer( st->pipe->screen, front_surf,
82                                           st->pipe->priv );
83
84      /*
85        st->frontbuffer_status = FRONT_STATUS_UNDEFINED;
86      */
87   }
88}
89
90
91void st_flush( struct st_context *st, uint pipeFlushFlags,
92               struct pipe_fence_handle **fence )
93{
94   if (pipeFlushFlags & PIPE_FLUSH_RENDER_CACHE)
95      FLUSH_CURRENT(st->ctx, 0);
96
97   /* Release any vertex buffers that might potentially be accessed in
98    * successive frames:
99    */
100   st_flush_bitmap(st);
101   st_flush_clear(st);
102   util_blit_flush(st->blit);
103   util_gen_mipmap_flush(st->gen_mipmap);
104
105   st->pipe->flush( st->pipe, pipeFlushFlags, fence );
106
107   if ((pipeFlushFlags & PIPE_FLUSH_FRAME) &&
108       is_front_buffer_dirty(st))
109      display_front_buffer(st);
110}
111
112
113/**
114 * Flush, and wait for completion.
115 */
116void st_finish( struct st_context *st )
117{
118   struct pipe_fence_handle *fence = NULL;
119
120   st_flush(st, PIPE_FLUSH_RENDER_CACHE | PIPE_FLUSH_FRAME, &fence);
121
122   if(fence) {
123      st->pipe->screen->fence_finish(st->pipe->screen, fence, 0);
124      st->pipe->screen->fence_reference(st->pipe->screen, &fence, NULL);
125   }
126}
127
128
129
130/**
131 * Called via ctx->Driver.Flush()
132 */
133static void st_glFlush(GLcontext *ctx)
134{
135   struct st_context *st = ctx->st;
136
137   /* Don't call st_finish() here.  It is not the state tracker's
138    * responsibilty to inject sleeps in the hope of avoiding buffer
139    * synchronization issues.  Calling finish() here will just hide
140    * problems that need to be fixed elsewhere.
141    */
142   st_flush(st, PIPE_FLUSH_RENDER_CACHE | PIPE_FLUSH_FRAME, NULL);
143}
144
145
146/**
147 * Called via ctx->Driver.Finish()
148 */
149static void st_glFinish(GLcontext *ctx)
150{
151   struct st_context *st = ctx->st;
152
153   st_finish(st);
154}
155
156
157void st_init_flush_functions(struct dd_function_table *functions)
158{
159   functions->Flush = st_glFlush;
160   functions->Finish = st_glFinish;
161
162   /* Windows opengl32.dll calls glFinish prior to every swapbuffers.
163    * This is unnecessary and degrades performance.  Luckily we have some
164    * scope to work around this, as the externally-visible behaviour of
165    * Finish() is identical to Flush() in all cases - no differences in
166    * rendering or ReadPixels are visible if we opt not to wait here.
167    *
168    * Only set this up on windows to avoid suprise elsewhere.
169    */
170#ifdef PIPE_OS_WINDOWS
171   functions->Finish = st_glFlush;
172#endif
173}
174