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