1 /*
2  * Mesa 3-D graphics library
3  *
4  * Copyright (C) 1999-2007  Brian Paul   All Rights Reserved.
5  * Copyright (C) 2008  VMware, Inc.  All Rights Reserved.
6  *
7  * Permission is hereby granted, free of charge, to any person obtaining a
8  * copy of this software and associated documentation files (the "Software"),
9  * to deal in the Software without restriction, including without limitation
10  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
11  * and/or sell copies of the Software, and to permit persons to whom the
12  * Software is furnished to do so, subject to the following conditions:
13  *
14  * The above copyright notice and this permission notice shall be included
15  * in all copies or substantial portions of the Software.
16  *
17  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
18  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
19  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
20  * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR
21  * OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE,
22  * ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR
23  * OTHER DEALINGS IN THE SOFTWARE.
24  */
25 
26 /**
27  * \file config.h
28  * Tunable configuration parameters.
29  */
30 
31 #ifndef MESA_CONFIG_H_INCLUDED
32 #define MESA_CONFIG_H_INCLUDED
33 
34 #include "compiler/shader_enums.h"
35 
36 /**
37  * \name OpenGL implementation limits
38  */
39 /*@{*/
40 
41 /** Maximum modelview matrix stack depth */
42 #define MAX_MODELVIEW_STACK_DEPTH 32
43 
44 /** Maximum projection matrix stack depth */
45 #define MAX_PROJECTION_STACK_DEPTH 32
46 
47 /** Maximum texture matrix stack depth */
48 #define MAX_TEXTURE_STACK_DEPTH 10
49 
50 /** Maximum attribute stack depth */
51 #define MAX_ATTRIB_STACK_DEPTH 16
52 
53 /** Maximum client attribute stack depth */
54 #define MAX_CLIENT_ATTRIB_STACK_DEPTH 16
55 
56 /** Maximum recursion depth of display list calls */
57 #define MAX_LIST_NESTING 64
58 
59 /** Maximum number of lights */
60 #define MAX_LIGHTS 8
61 
62 /**
63  * Maximum number of user-defined clipping planes supported by any driver in
64  * Mesa.  This is used to size arrays.
65  */
66 #define MAX_CLIP_PLANES 8
67 
68 /** Maximum pixel map lookup table size */
69 #define MAX_PIXEL_MAP_TABLE 256
70 
71 /** Maximum number of auxillary color buffers */
72 #define MAX_AUX_BUFFERS 1
73 
74 /** Maximum order (degree) of curves */
75 #define MAX_EVAL_ORDER 30
76 
77 /** Maximum Name stack depth */
78 #define MAX_NAME_STACK_DEPTH 64
79 
80 /** Minimum point size */
81 #define MIN_POINT_SIZE 1.0
82 /** Maximum point size */
83 #define MAX_POINT_SIZE 60.0
84 /** Point size granularity */
85 #define POINT_SIZE_GRANULARITY 0.1
86 
87 /** Minimum line width */
88 #define MIN_LINE_WIDTH 1.0
89 /** Maximum line width */
90 #define MAX_LINE_WIDTH 10.0
91 /** Line width granularity */
92 #define LINE_WIDTH_GRANULARITY 0.1
93 
94 /** Max memory to allow for a single texture image (in megabytes) */
95 #define MAX_TEXTURE_MBYTES 1024
96 
97 /** Number of 1D/2D texture mipmap levels */
98 #define MAX_TEXTURE_LEVELS 15
99 
100 /** Number of 3D texture mipmap levels */
101 #define MAX_3D_TEXTURE_LEVELS 15
102 
103 /** Number of cube texture mipmap levels - GL_ARB_texture_cube_map */
104 #define MAX_CUBE_TEXTURE_LEVELS 15
105 
106 /** Maximum rectangular texture size - GL_NV_texture_rectangle */
107 #define MAX_TEXTURE_RECT_SIZE 16384
108 
109 /**
110  * Maximum number of layers in a 1D or 2D array texture - GL_MESA_texture_array
111  */
112 #define MAX_ARRAY_TEXTURE_LAYERS 64
113 
114 /**
115  * Max number of texture coordinate units.  This mainly just applies to
116  * the fixed-function vertex code.  This will be difficult to raise above
117  * eight because of various vertex attribute bitvectors.
118  */
119 #define MAX_TEXTURE_COORD_UNITS 8
120 
121 /**
122  * Max number of texture image units.  Also determines number of texture
123  * samplers in shaders.
124  */
125 #define MAX_TEXTURE_IMAGE_UNITS 32
126 
127 /**
128  * Larger of MAX_TEXTURE_COORD_UNITS and MAX_TEXTURE_IMAGE_UNITS.
129  * This value is only used for dimensioning arrays.
130  * Either MAX_TEXTURE_COORD_UNITS or MAX_TEXTURE_IMAGE_UNITS (or the
131  * corresponding ctx->Const.MaxTextureCoord/ImageUnits fields) should be
132  * used almost everywhere else.
133  */
134 #define MAX_TEXTURE_UNITS ((MAX_TEXTURE_COORD_UNITS > MAX_TEXTURE_IMAGE_UNITS) ? MAX_TEXTURE_COORD_UNITS : MAX_TEXTURE_IMAGE_UNITS)
135 
136 /** Maximum number of viewports supported with ARB_viewport_array */
137 #define MAX_VIEWPORTS 16
138 
139 /** Maximum number of window rectangles supported with EXT_window_rectangles */
140 #define MAX_WINDOW_RECTANGLES 8
141 
142 /** Maximum size for CVA.  May be overridden by the drivers.  */
143 #define MAX_ARRAY_LOCK_SIZE 3000
144 
145 /** Subpixel precision for antialiasing, window coordinate snapping */
146 #define SUB_PIXEL_BITS 4
147 
148 /** For GL_ARB_texture_compression */
149 #define MAX_COMPRESSED_TEXTURE_FORMATS 25
150 
151 /** For GL_EXT_texture_filter_anisotropic */
152 #define MAX_TEXTURE_MAX_ANISOTROPY 16.0
153 
154 /** For GL_EXT_texture_lod_bias (typically MAX_TEXTURE_LEVELS - 1) */
155 #define MAX_TEXTURE_LOD_BIAS 14.0
156 
157 /** For any program target/extension */
158 /*@{*/
159 #define MAX_PROGRAM_INSTRUCTIONS       (16 * 1024)
160 
161 /**
162  * Per-program constants (power of two)
163  *
164  * \c MAX_PROGRAM_LOCAL_PARAMS and \c MAX_UNIFORMS are just the assembly shader
165  * and GLSL shader names for the same thing.  They should \b always have the
166  * same value.  Each refers to the number of vec4 values supplied as
167  * per-program parameters.
168  */
169 /*@{*/
170 #define MAX_PROGRAM_LOCAL_PARAMS       4096
171 #define MAX_UNIFORMS                   4096
172 #define MAX_UNIFORM_BUFFERS            15 /* + 1 default uniform buffer */
173 #define MAX_SHADER_STORAGE_BUFFERS     16
174 /* 6 is for vertex, hull, domain, geometry, fragment, and compute shader. */
175 #define MAX_COMBINED_UNIFORM_BUFFERS   (MAX_UNIFORM_BUFFERS * 6)
176 #define MAX_COMBINED_SHADER_STORAGE_BUFFERS   (MAX_SHADER_STORAGE_BUFFERS * 6)
177 #define MAX_ATOMIC_COUNTERS            4096
178 /* 6 is for vertex, hull, domain, geometry, fragment, and compute shader. */
179 #define MAX_COMBINED_ATOMIC_BUFFERS    (MAX_UNIFORM_BUFFERS * 6)
180 /* Size of an atomic counter in bytes according to ARB_shader_atomic_counters */
181 #define ATOMIC_COUNTER_SIZE            4
182 #define MAX_IMAGE_UNIFORMS             32
183 /* 6 is for vertex, hull, domain, geometry, fragment, and compute shader. */
184 #define MAX_IMAGE_UNITS                (MAX_IMAGE_UNIFORMS * 6)
185 /*@}*/
186 
187 /**
188  * Per-context constants (power of two)
189  *
190  * \note
191  * This value should always be less than or equal to \c MAX_PROGRAM_LOCAL_PARAMS
192  * and \c MAX_VERTEX_PROGRAM_PARAMS.  Otherwise some applications will make
193  * incorrect assumptions.
194  */
195 #define MAX_PROGRAM_ENV_PARAMS         256
196 
197 #define MAX_PROGRAM_MATRICES           8
198 #define MAX_PROGRAM_MATRIX_STACK_DEPTH 4
199 #define MAX_PROGRAM_CALL_DEPTH         8
200 #define MAX_PROGRAM_TEMPS              256
201 #define MAX_PROGRAM_ADDRESS_REGS       1
202 #define MAX_SAMPLERS                   MAX_TEXTURE_IMAGE_UNITS
203 #define MAX_PROGRAM_INPUTS             32
204 #define MAX_PROGRAM_OUTPUTS            64
205 /*@}*/
206 
207 /** For GL_ARB_vertex_program */
208 /*@{*/
209 #define MAX_VERTEX_PROGRAM_ADDRESS_REGS 1
210 #define MAX_VERTEX_PROGRAM_PARAMS       MAX_UNIFORMS
211 /*@}*/
212 
213 /** For GL_ARB_fragment_program */
214 /*@{*/
215 #define MAX_FRAGMENT_PROGRAM_ADDRESS_REGS 0
216 #define MAX_FRAGMENT_PROGRAM_PARAMS       64
217 #define MAX_FRAGMENT_PROGRAM_INPUTS       12
218 /*@}*/
219 
220 /** For GL_ARB_vertex_shader */
221 /*@{*/
222 #define MAX_VERTEX_GENERIC_ATTRIBS 16
223 /* 6 is for vertex, hull, domain, geometry, fragment, and compute shader. */
224 #define MAX_COMBINED_TEXTURE_IMAGE_UNITS (MAX_TEXTURE_IMAGE_UNITS * 6)
225 /*@}*/
226 
227 
228 /** For GL_EXT_framebuffer_object */
229 /*@{*/
230 #define MAX_COLOR_ATTACHMENTS 8
231 #define MAX_RENDERBUFFER_SIZE 16384
232 /*@}*/
233 
234 /** For GL_ATI_envmap_bump - support bump mapping on first 8 units */
235 #define SUPPORTED_ATI_BUMP_UNITS 0xff
236 
237 /** For GL_EXT_transform_feedback */
238 #define MAX_FEEDBACK_BUFFERS 4
239 #define MAX_FEEDBACK_ATTRIBS 32
240 
241 /** For geometry shader */
242 /*@{*/
243 #define MAX_GEOMETRY_UNIFORM_COMPONENTS              512
244 #define MAX_GEOMETRY_OUTPUT_VERTICES                 256
245 #define MAX_GEOMETRY_TOTAL_OUTPUT_COMPONENTS         1024
246 /*@}*/
247 
248 /** For GL_ARB_debug_output and GL_KHR_debug */
249 /*@{*/
250 #define MAX_DEBUG_LOGGED_MESSAGES   10
251 #define MAX_DEBUG_MESSAGE_LENGTH    4096
252 /*@}*/
253 
254 /** For GL_KHR_debug */
255 /*@{*/
256 #define MAX_LABEL_LENGTH 256
257 #define MAX_DEBUG_GROUP_STACK_DEPTH 64
258 /*@}*/
259 
260 /** For GL_ARB_gpu_shader5 */
261 /*@{*/
262 #define MAX_GEOMETRY_SHADER_INVOCATIONS     32
263 #define MIN_FRAGMENT_INTERPOLATION_OFFSET   -0.5
264 #define MAX_FRAGMENT_INTERPOLATION_OFFSET   0.5
265 #define FRAGMENT_INTERPOLATION_OFFSET_BITS  4
266 #define MAX_VERTEX_STREAMS                  4
267 /*@}*/
268 
269 /** For GL_ARB_shader_subroutine */
270 /*@{*/
271 #define MAX_SUBROUTINES                   256
272 #define MAX_SUBROUTINE_UNIFORM_LOCATIONS  1024
273 /*@}*/
274 
275 /** For GL_INTEL_performance_query */
276 /*@{*/
277 #define MAX_PERFQUERY_QUERY_NAME_LENGTH     256
278 #define MAX_PERFQUERY_COUNTER_NAME_LENGTH   256
279 #define MAX_PERFQUERY_COUNTER_DESC_LENGTH   1024
280 #define PERFQUERY_HAVE_GPA_EXTENDED_COUNTERS 0
281 /*@}*/
282 
283 /** For GL_ARB_pipeline_statistics_query */
284 #define MAX_PIPELINE_STATISTICS             11
285 
286 /** For GL_ARB_tessellation_shader */
287 /*@{*/
288 #define MAX_TESS_GEN_LEVEL 64
289 #define MAX_PATCH_VERTICES 32
290 #define MAX_TESS_PATCH_COMPONENTS 120
291 #define MAX_TESS_CONTROL_TOTAL_OUTPUT_COMPONENTS 4096
292 /*@}*/
293 
294 /*
295  * Color channel component order
296  *
297  * \note Changes will almost certainly cause problems at this time.
298  */
299 #define RCOMP 0
300 #define GCOMP 1
301 #define BCOMP 2
302 #define ACOMP 3
303 
304 
305 /**
306  * Maximum number of temporary vertices required for clipping.
307  *
308  * Used in array_cache and tnl modules.
309  */
310 #define MAX_CLIPPED_VERTICES ((2 * (6 + MAX_CLIP_PLANES))+1)
311 
312 
313 /** For GL_ARB_sample_locations - maximum of SAMPLE_LOCATION_PIXEL_GRID_*_ARB */
314 #define MAX_SAMPLE_LOCATION_GRID_SIZE 4
315 
316 /* It is theoretically possible for Consts.MaxSamples to be >32 but
317  * other code seems to assume that is not the case.
318  */
319 #define MAX_SAMPLE_LOCATION_TABLE_SIZE \
320    (MAX_SAMPLE_LOCATION_GRID_SIZE * MAX_SAMPLE_LOCATION_GRID_SIZE * 32)
321 
322 #endif /* MESA_CONFIG_H_INCLUDED */
323