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_
33 #include "intel_bufmgr.h"
35 #include "xmlconfig.h"
38 * \brief Does X driver support DRI2BufferHiz and DRI2BufferStencil?
40 * (Here, "X driver" referes to the DDX driver, xf86-video-intel).
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.
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.
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.
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
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.
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.
73 * If the buffers are X tiled, however, the handshake has failed and we must
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
79 * 4. Make a DRI2 request for the new buffer, using attachment type
80 * DRI2BufferDepthStencil).
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.
88 enum intel_dri2_has_hiz
{
89 INTEL_DRI2_HAS_HIZ_UNKNOWN
,
90 INTEL_DRI2_HAS_HIZ_TRUE
,
91 INTEL_DRI2_HAS_HIZ_FALSE
,
99 int logTextureGranularity
;
101 __DRIscreen
*driScrnPriv
;
104 GLuint relaxed_relocations
;
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.
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
;
118 struct _mesa_HashTable
*named_regions
;
121 * Configuration cache with default values for all contexts
123 driOptionCache optionCache
;
126 extern GLboolean
intelMapScreenRegions(__DRIscreen
* sPriv
);
128 extern void intelDestroyContext(__DRIcontext
* driContextPriv
);
130 extern GLboolean
intelUnbindContext(__DRIcontext
* driContextPriv
);
133 intelMakeCurrent(__DRIcontext
* driContextPriv
,
134 __DRIdrawable
* driDrawPriv
,
135 __DRIdrawable
* driReadPriv
);