src/mesa/drivers/dri/intel/intel_screen.h

   1 /**************************************************************************
   2  *
   3  * Copyright 2003 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 #ifndef _INTEL_INIT_H_
  29 #define _INTEL_INIT_H_
  30
  31 #include <sys/time.h>
  32 #include "dri_util.h"
  33 #include "intel_bufmgr.h"
  34 #include "i915_drm.h"
  35 #include "xmlconfig.h"
  36
  37 /**
  38  * \brief Does X driver support DRI2BufferHiz and DRI2BufferStencil?
  39  *
  40  * (Here, "X driver" referes to the DDX driver, xf86-video-intel).
  41  *
  42  * The DRI2 protocol does not allow us to query the X driver's version nor
  43  * query for a list of buffer formats that the driver supports. So, to
  44  * determine if the X driver supports DRI2BufferHiz and DRI2BufferStencil we
  45  * must resort to a handshake.
  46  *
  47  * If the hardware lacks support for separate stencil (and consequently, lacks
  48  * support for hiz also), then the X driver's separate stencil and hiz support
  49  * is irrelevant and the handshake never occurs.
  50  *
  51  * Complications
  52  * -------------
  53  * The handshake is complicated by a bug in xf86-video-intel 2.15. Even though
  54  * that version of the X driver did not supppot requests for DRI2BufferHiz or
  55  * DRI2BufferStencil, if requested one it still allocated and returned one.
  56  * The returned buffer, however, was incorrectly X tiled.
  57  *
  58  * How the handshake works
  59  * -----------------------
  60  * (TODO: To be implemented on a future commit).
  61  *
  62  * Initially, intel_screen.dri2_has_hiz is set to unknown. The first time the
  63  * user requests a depth and stencil buffer, intelCreateBuffers() creates a
  64  * framebuffer with separate depth and stencil attachments (with formats
  65  * x8_z24 and s8).
  66  *
  67  * Eventually, intel_update_renderbuffers() makes a DRI2 request for
  68  * DRI2BufferStencil and DRI2BufferHiz. If the returned buffers are Y tiled,
  69  * then we joyfully set intel_screen.dri2_has_hiz to true and continue as if
  70  * nothing happend.
  71  *
  72  * If the buffers are X tiled, however, the handshake has failed and we must
  73  * clean up.
  74  *    1. Angrily set intel_screen.dri2_has_hiz to false.
  75  *    2. Discard the framebuffer's depth and stencil attachments.
  76  *    3. Attach a packed depth/stencil buffer to the framebuffer (with format
  77  *       s8_z24).
  78  *    4. Make a DRI2 request for the new buffer, using attachment type
  79  *       DRI2BufferDepthStencil).
  80  *
  81  * Future Considerations
  82  * ---------------------
  83  * On a sunny day in the far future, when we are certain that no one has an
  84  * xf86-video-intel installed without hiz and separate stencil support, then
  85  * this enumerant and the handshake should die.
  86  */
  87 enum intel_dri2_has_hiz {
  88    INTEL_DRI2_HAS_HIZ_UNKNOWN,
  89    INTEL_DRI2_HAS_HIZ_TRUE,
  90    INTEL_DRI2_HAS_HIZ_FALSE,
  91 };
  92
  93 struct intel_screen
  94 {
  95    int deviceID;
  96    int gen;
  97
  98    int logTextureGranularity;
  99
 100    __DRIscreen *driScrnPriv;
 101
 102    GLboolean no_hw;
 103    GLuint relaxed_relocations;
 104
 105    /*
 106     * The hardware hiz and separate stencil fields are needed in intel_screen,
 107     * rather than solely in intel_context, because glXCreatePbuffer and
 108     * glXCreatePixmap are not passed a GLXContext.
 109     */
 110    GLboolean hw_has_separate_stencil;
 111    GLboolean hw_must_use_separate_stencil;
 112    GLboolean hw_has_hiz;
 113    enum intel_dri2_has_hiz dri2_has_hiz;
 114
 115    GLboolean no_vbo;
 116    dri_bufmgr *bufmgr;
 117    struct _mesa_HashTable *named_regions;
 118
 119    /**
 120    * Configuration cache with default values for all contexts
 121    */
 122    driOptionCache optionCache;
 123 };
 124
 125 extern GLboolean intelMapScreenRegions(__DRIscreen * sPriv);
 126
 127 extern void intelDestroyContext(__DRIcontext * driContextPriv);
 128
 129 extern GLboolean intelUnbindContext(__DRIcontext * driContextPriv);
 130
 131 extern GLboolean
 132 intelMakeCurrent(__DRIcontext * driContextPriv,
 133                  __DRIdrawable * driDrawPriv,
 134                  __DRIdrawable * driReadPriv);
 135
 136 #endif