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  * Initially, intel_screen.dri2_has_hiz is set to unknown. The first time the
  61  * user requests a depth and stencil buffer, intelCreateBuffers() creates a
  62  * framebuffer with separate depth and stencil attachments (with formats
  63  * x8_z24 and s8).
  64  *
  65  * Eventually, intel_update_renderbuffers() makes a DRI2 request for
  66  * DRI2BufferStencil and DRI2BufferHiz. If the stencil buffer's tiling is
  67  * I915_TILING_NONE [1], then we joyfully set intel_screen.dri2_has_hiz to
  68  * true and continue as if nothing happend.
  69  *
  70  * [1] The stencil buffer is actually W tiled. However, we request from the
  71  *     kernel a non-tiled buffer because the GTT is incapable of W fencing.
  72  *
  73  * If the buffers are X tiled, however, the handshake has failed and we must
  74  * clean up.
  75  *    1. Angrily set intel_screen.dri2_has_hiz to false.
  76  *    2. Discard the framebuffer's depth and stencil attachments.
  77  *    3. Attach a packed depth/stencil buffer to the framebuffer (with format
  78  *       s8_z24).
  79  *    4. Make a DRI2 request for the new buffer, using attachment type
  80  *       DRI2BufferDepthStencil).
  81  *
  82  * Future Considerations
  83  * ---------------------
  84  * On a sunny day in the far future, when we are certain that no one has an
  85  * xf86-video-intel installed without hiz and separate stencil support, then
  86  * this enumerant and the handshake should die.
  87  */
  88 enum intel_dri2_has_hiz {
  89    INTEL_DRI2_HAS_HIZ_UNKNOWN,
  90    INTEL_DRI2_HAS_HIZ_TRUE,
  91    INTEL_DRI2_HAS_HIZ_FALSE,
  92 };
  93
  94 struct intel_screen
  95 {
  96    int deviceID;
  97    int gen;
  98
  99    int logTextureGranularity;
 100
 101    __DRIscreen *driScrnPriv;
 102
 103    GLboolean no_hw;
 104    GLuint relaxed_relocations;
 105
 106    /*
 107     * The hardware hiz and separate stencil fields are needed in intel_screen,
 108     * rather than solely in intel_context, because glXCreatePbuffer and
 109     * glXCreatePixmap are not passed a GLXContext.
 110     */
 111    GLboolean hw_has_separate_stencil;
 112    GLboolean hw_must_use_separate_stencil;
 113    GLboolean hw_has_hiz;
 114    enum intel_dri2_has_hiz dri2_has_hiz;
 115
 116    GLboolean no_vbo;
 117    dri_bufmgr *bufmgr;
 118    struct _mesa_HashTable *named_regions;
 119
 120    /**
 121    * Configuration cache with default values for all contexts
 122    */
 123    driOptionCache optionCache;
 124 };
 125
 126 extern GLboolean intelMapScreenRegions(__DRIscreen * sPriv);
 127
 128 extern void intelDestroyContext(__DRIcontext * driContextPriv);
 129
 130 extern GLboolean intelUnbindContext(__DRIcontext * driContextPriv);
 131
 132 extern GLboolean
 133 intelMakeCurrent(__DRIcontext * driContextPriv,
 134                  __DRIdrawable * driDrawPriv,
 135                  __DRIdrawable * driReadPriv);
 136
 137 #endif