src/gallium/state_trackers/wgl/stw_framebuffer.h

   1 /**************************************************************************
   2  *
   3  * Copyright 2008 VMware, Inc.
   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 VMWARE 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 #ifndef STW_FRAMEBUFFER_H
  29 #define STW_FRAMEBUFFER_H
  30
  31 #include <windows.h>
  32
  33 #include <GL/gl.h>
  34 #include <GL/wglext.h>
  35
  36 #include "util/u_debug.h"
  37 #include "stw_st.h"
  38
  39
  40 struct pipe_resource;
  41 struct st_framebuffer_iface;
  42 struct stw_pixelformat_info;
  43
  44 /**
  45  * Windows framebuffer.
  46  */
  47 struct stw_framebuffer
  48 {
  49    /**
  50     * This mutex has two purposes:
  51     * - protect the access to the mutable data members below
  52     * - prevent the framebuffer from being deleted while being accessed.
  53     *
  54     * Note: if both this mutex and the stw_device::fb_mutex need to be locked,
  55     * the stw_device::fb_mutex needs to be locked first.
  56     */
  57    CRITICAL_SECTION mutex;
  58
  59    /*
  60     * Immutable members.
  61     *
  62     * Note that even access to immutable members implies acquiring the mutex
  63     * above, to prevent the framebuffer from being destroyed.
  64     */
  65
  66    HWND hWnd;
  67
  68    int iPixelFormat;
  69    const struct stw_pixelformat_info *pfi;
  70
  71    /* A pixel format that can be used by GDI */
  72    int iDisplayablePixelFormat;
  73    boolean bPbuffer;
  74
  75    struct st_framebuffer_iface *stfb;
  76
  77    /*
  78     * Mutable members.
  79     */
  80
  81    unsigned refcnt;
  82
  83
  84    /* FIXME: Make this work for multiple contexts bound to the same framebuffer */
  85    boolean must_resize;
  86
  87    boolean minimized;  /**< Is the window currently minimized? */
  88
  89    unsigned width;
  90    unsigned height;
  91
  92    /** WGL_ARB_render_texture - set at Pbuffer creation time */
  93    unsigned textureFormat;  /**< WGL_NO_TEXTURE or WGL_TEXTURE_RGB[A]_ARB */
  94    unsigned textureTarget;  /**< WGL_NO_TEXTURE or WGL_TEXTURE_1D/2D/
  95                                  CUBE_MAP_ARB */
  96    boolean textureMipmap;   /**< TRUE/FALSE */
  97    /** WGL_ARB_render_texture - set with wglSetPbufferAttribARB() */
  98    unsigned textureLevel;
  99    unsigned textureFace;    /**< [0..6] */
 100
 101    /**
 102     * Client area rectangle, relative to the window upper-left corner.
 103     *
 104     * @sa GLCBPRESENTBUFFERSDATA::rect.
 105     */
 106    RECT client_rect;
 107
 108    HANDLE hSharedSurface;
 109    struct stw_shared_surface *shared_surface;
 110
 111    /* For WGL_EXT_swap_control */
 112    int64_t prev_swap_time;
 113
 114    /**
 115     * This is protected by stw_device::fb_mutex, not the mutex above.
 116     *
 117     * Deletions must be done by first acquiring stw_device::fb_mutex, and then
 118     * acquiring the stw_framebuffer::mutex of the framebuffer to be deleted.
 119     * This ensures that nobody else is reading/writing to the.
 120     *
 121     * It is not necessary to acquire the mutex above to navigate the linked list
 122     * given that deletions are done with stw_device::fb_mutex held, so no other
 123     * thread can delete.
 124     */
 125    struct stw_framebuffer *next;
 126 };
 127
 128
 129 /**
 130  * Create a new framebuffer object which will correspond to the given HDC.
 131  *
 132  * This function will acquire stw_framebuffer::mutex. stw_framebuffer_unlock
 133  * must be called when done
 134  */
 135 struct stw_framebuffer *
 136 stw_framebuffer_create(HDC hdc, int iPixelFormat);
 137
 138
 139 /**
 140  * Increase fb reference count.  The referenced framebuffer should be locked.
 141  *
 142  * It's not necessary to hold stw_dev::fb_mutex global lock.
 143  */
 144 static inline void
 145 stw_framebuffer_reference_locked(struct stw_framebuffer *fb)
 146 {
 147    if (fb) {
 148       assert(stw_own_mutex(&fb->mutex));
 149       fb->refcnt++;
 150    }
 151 }
 152
 153
 154 void
 155 stw_framebuffer_release_locked(struct stw_framebuffer *fb);
 156
 157 /**
 158  * Search a framebuffer with a matching HWND.
 159  *
 160  * This function will acquire stw_framebuffer::mutex. stw_framebuffer_unlock
 161  * must be called when done
 162  */
 163 struct stw_framebuffer *
 164 stw_framebuffer_from_hwnd(HWND hwnd);
 165
 166 /**
 167  * Search a framebuffer with a matching HDC.
 168  *
 169  * This function will acquire stw_framebuffer::mutex. stw_framebuffer_unlock
 170  * must be called when done
 171  */
 172 struct stw_framebuffer *
 173 stw_framebuffer_from_hdc(HDC hdc);
 174
 175 BOOL
 176 stw_framebuffer_present_locked(HDC hdc,
 177                                struct stw_framebuffer *fb,
 178                                struct pipe_resource *res);
 179
 180 void
 181 stw_framebuffer_update(struct stw_framebuffer *fb);
 182
 183
 184 static inline void
 185 stw_framebuffer_lock(struct stw_framebuffer *fb)
 186 {
 187    assert(fb);
 188    EnterCriticalSection(&fb->mutex);
 189 }
 190
 191
 192 /**
 193  * Release stw_framebuffer::mutex lock. This framebuffer must not be accessed
 194  * after calling this function, as it may have been deleted by another thread
 195  * in the meanwhile.
 196  */
 197 static inline void
 198 stw_framebuffer_unlock(struct stw_framebuffer *fb)
 199 {
 200    assert(fb);
 201    assert(stw_own_mutex(&fb->mutex));
 202    LeaveCriticalSection(&fb->mutex);
 203 }
 204
 205
 206 /**
 207  * Cleanup any existing framebuffers when exiting application.
 208  */
 209 void
 210 stw_framebuffer_cleanup(void);
 211
 212
 213 static inline struct stw_st_framebuffer *
 214 stw_st_framebuffer(struct st_framebuffer_iface *stfb)
 215 {
 216    return (struct stw_st_framebuffer *) stfb;
 217 }
 218
 219
 220 static inline struct stw_framebuffer *
 221 stw_framebuffer_from_HPBUFFERARB(HPBUFFERARB hPbuffer)
 222 {
 223    return (struct stw_framebuffer *) hPbuffer;
 224 }
 225
 226
 227 #endif /* STW_FRAMEBUFFER_H */