1 /**************************************************************************
3 * Copyright 2003 Tungsten Graphics, Inc., Cedar Park, Texas.
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:
14 * The above copyright notice and this permission notice (including the
15 * next paragraph) shall be included in all copies or substantial portions
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.
26 **************************************************************************/
28 #ifndef _INTEL_INIT_H_
29 #define _INTEL_INIT_H_
34 #include "intel_bufmgr.h"
36 #include "xmlconfig.h"
39 * \brief Does X driver support DRI2BufferHiz and DRI2BufferStencil?
41 * (Here, "X driver" referes to the DDX driver, xf86-video-intel).
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.
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.
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.
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
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.
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.
74 * If the buffers are X tiled, however, the handshake has failed and we must
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
80 * 4. Make a DRI2 request for the new buffer, using attachment type
81 * DRI2BufferDepthStencil).
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.
89 enum intel_dri2_has_hiz
{
90 INTEL_DRI2_HAS_HIZ_UNKNOWN
,
91 INTEL_DRI2_HAS_HIZ_TRUE
,
92 INTEL_DRI2_HAS_HIZ_FALSE
,
100 int logTextureGranularity
;
102 __DRIscreen
*driScrnPriv
;
105 GLuint relaxed_relocations
;
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.
112 bool hw_has_separate_stencil
;
113 bool hw_must_use_separate_stencil
;
115 enum intel_dri2_has_hiz dri2_has_hiz
;
119 struct _mesa_HashTable
*named_regions
;
122 * Configuration cache with default values for all contexts
124 driOptionCache optionCache
;
127 extern bool intelMapScreenRegions(__DRIscreen
* sPriv
);
129 extern void intelDestroyContext(__DRIcontext
* driContextPriv
);
131 extern GLboolean
intelUnbindContext(__DRIcontext
* driContextPriv
);
134 intelMakeCurrent(__DRIcontext
* driContextPriv
,
135 __DRIdrawable
* driDrawPriv
,
136 __DRIdrawable
* driReadPriv
);