[MESA/OPENGL32]
[reactos.git] / reactos / dll / opengl / mesa / src / mesa / main / config.h
1 /*
2 * Mesa 3-D graphics library
3 * Version: 7.5
4 *
5 * Copyright (C) 1999-2007 Brian Paul All Rights Reserved.
6 * Copyright (C) 2008 VMware, Inc. All Rights Reserved.
7 *
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
14 *
15 * The above copyright notice and this permission notice shall be included
16 * in all copies or substantial portions 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 MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
22 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
23 * CONNECTION WITH THE SOFTWARE OR THE USE OR 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
35 /**
36 * \name OpenGL implementation limits
37 */
38 /*@{*/
39
40 /** Maximum modelview matrix stack depth */
41 #define MAX_MODELVIEW_STACK_DEPTH 32
42
43 /** Maximum projection matrix stack depth */
44 #define MAX_PROJECTION_STACK_DEPTH 32
45
46 /** Maximum texture matrix stack depth */
47 #define MAX_TEXTURE_STACK_DEPTH 10
48
49 /** Maximum color matrix stack depth */
50 #define MAX_COLOR_STACK_DEPTH 4
51
52 /** Maximum attribute stack depth */
53 #define MAX_ATTRIB_STACK_DEPTH 16
54
55 /** Maximum client attribute stack depth */
56 #define MAX_CLIENT_ATTRIB_STACK_DEPTH 16
57
58 /** Maximum recursion depth of display list calls */
59 #define MAX_LIST_NESTING 64
60
61 /** Maximum number of lights */
62 #define MAX_LIGHTS 8
63
64 /**
65 * Maximum number of user-defined clipping planes supported by any driver in
66 * Mesa. This is used to size arrays.
67 */
68 #define MAX_CLIP_PLANES 8
69
70 /** Maximum pixel map lookup table size */
71 #define MAX_PIXEL_MAP_TABLE 256
72
73 /** Maximum number of auxillary color buffers */
74 #define MAX_AUX_BUFFERS 1
75
76 /** Maximum order (degree) of curves */
77 #ifdef AMIGA
78 # define MAX_EVAL_ORDER 12
79 #else
80 # define MAX_EVAL_ORDER 30
81 #endif
82
83 /** Maximum Name stack depth */
84 #define MAX_NAME_STACK_DEPTH 64
85
86 /** Minimum point size */
87 #define MIN_POINT_SIZE 1.0
88 /** Maximum point size */
89 #define MAX_POINT_SIZE 60.0
90 /** Point size granularity */
91 #define POINT_SIZE_GRANULARITY 0.1
92
93 /** Minimum line width */
94 #define MIN_LINE_WIDTH 1.0
95 /** Maximum line width */
96 #define MAX_LINE_WIDTH 10.0
97 /** Line width granularity */
98 #define LINE_WIDTH_GRANULARITY 0.1
99
100 /** Max texture palette / color table size */
101 #define MAX_COLOR_TABLE_SIZE 256
102
103 /** Max memory to allow for a single texture image (in megabytes) */
104 #define MAX_TEXTURE_MBYTES 1024
105
106 /** Number of 1D/2D texture mipmap levels */
107 #define MAX_TEXTURE_LEVELS 15
108
109 /** Number of 3D texture mipmap levels */
110 #define MAX_3D_TEXTURE_LEVELS 15
111
112 /** Number of cube texture mipmap levels - GL_ARB_texture_cube_map */
113 #define MAX_CUBE_TEXTURE_LEVELS 15
114
115 /** Maximum rectangular texture size - GL_NV_texture_rectangle */
116 #define MAX_TEXTURE_RECT_SIZE 16384
117
118 /** Maximum number of layers in a 1D or 2D array texture - GL_MESA_texture_array */
119 #define MAX_ARRAY_TEXTURE_LAYERS 64
120
121 /**
122 * Max number of texture coordinate units. This mainly just applies to
123 * the fixed-function vertex code. This will be difficult to raise above
124 * eight because of various vertex attribute bitvectors.
125 */
126 #define MAX_TEXTURE_COORD_UNITS 8
127
128 /**
129 * Max number of texture image units. Also determines number of texture
130 * samplers in shaders.
131 */
132 #define MAX_TEXTURE_IMAGE_UNITS 16
133
134 /**
135 * Larger of MAX_TEXTURE_COORD_UNITS and MAX_TEXTURE_IMAGE_UNITS.
136 * This value is only used for dimensioning arrays.
137 * Either MAX_TEXTURE_COORD_UNITS or MAX_TEXTURE_IMAGE_UNITS (or the
138 * corresponding ctx->Const.MaxTextureCoord/ImageUnits fields) should be
139 * used almost everywhere else.
140 */
141 #define MAX_TEXTURE_UNITS ((MAX_TEXTURE_COORD_UNITS > MAX_TEXTURE_IMAGE_UNITS) ? MAX_TEXTURE_COORD_UNITS : MAX_TEXTURE_IMAGE_UNITS)
142
143
144 /**
145 * Maximum viewport/image width. Must accomodate all texture sizes too.
146 */
147
148 #ifndef MAX_WIDTH
149 # define MAX_WIDTH 16384
150 #endif
151 /** Maximum viewport/image height */
152 #ifndef MAX_HEIGHT
153 # define MAX_HEIGHT 16384
154 #endif
155
156 /* XXX: hack to prevent stack overflow on windows until all temporary arrays
157 * [MAX_WIDTH] are allocated from the heap */
158 #ifdef WIN32
159 #undef MAX_TEXTURE_LEVELS
160 #undef MAX_3D_TEXTURE_LEVELS
161 #undef MAX_CUBE_TEXTURE_LEVELS
162 #undef MAX_TEXTURE_RECT_SIZE
163 #undef MAX_WIDTH
164 #undef MAX_HEIGHT
165 #define MAX_TEXTURE_LEVELS 13
166 #define MAX_3D_TEXTURE_LEVELS 9
167 #define MAX_CUBE_TEXTURE_LEVELS 13
168 #define MAX_TEXTURE_RECT_SIZE 4096
169 #define MAX_WIDTH 4096
170 #define MAX_HEIGHT 4096
171 #endif
172
173 /** Maxmimum size for CVA. May be overridden by the drivers. */
174 #define MAX_ARRAY_LOCK_SIZE 3000
175
176 /** Subpixel precision for antialiasing, window coordinate snapping */
177 #define SUB_PIXEL_BITS 4
178
179 /** Size of histogram tables */
180 #define HISTOGRAM_TABLE_SIZE 256
181
182 /** Max convolution filter width */
183 #define MAX_CONVOLUTION_WIDTH 9
184 /** Max convolution filter height */
185 #define MAX_CONVOLUTION_HEIGHT 9
186
187 /** For GL_ARB_texture_compression */
188 #define MAX_COMPRESSED_TEXTURE_FORMATS 25
189
190 /** For GL_EXT_texture_filter_anisotropic */
191 #define MAX_TEXTURE_MAX_ANISOTROPY 16.0
192
193 /** For GL_EXT_texture_lod_bias (typically MAX_TEXTURE_LEVELS - 1) */
194 #define MAX_TEXTURE_LOD_BIAS 14.0
195
196 /** For any program target/extension */
197 /*@{*/
198 #define MAX_PROGRAM_INSTRUCTIONS (16 * 1024)
199
200 /**
201 * Per-program constants (power of two)
202 *
203 * \c MAX_PROGRAM_LOCAL_PARAMS and \c MAX_UNIFORMS are just the assembly shader
204 * and GLSL shader names for the same thing. They should \b always have the
205 * same value. Each refers to the number of vec4 values supplied as
206 * per-program parameters.
207 */
208 /*@{*/
209 #define MAX_PROGRAM_LOCAL_PARAMS 4096
210 #define MAX_UNIFORMS 4096
211 /*@}*/
212
213 /**
214 * Per-context constants (power of two)
215 *
216 * \note
217 * This value should always be less than or equal to \c MAX_PROGRAM_LOCAL_PARAMS
218 * and \c MAX_VERTEX_PROGRAM_PARAMS. Otherwise some applications will make
219 * incorrect assumptions.
220 */
221 #define MAX_PROGRAM_ENV_PARAMS 256
222
223 #define MAX_PROGRAM_MATRICES 8
224 #define MAX_PROGRAM_MATRIX_STACK_DEPTH 4
225 #define MAX_PROGRAM_CALL_DEPTH 8
226 #define MAX_PROGRAM_TEMPS 256
227 #define MAX_PROGRAM_ADDRESS_REGS 2
228 #define MAX_VARYING 16 /**< number of float[4] vectors */
229 #define MAX_SAMPLERS MAX_TEXTURE_IMAGE_UNITS
230 #define MAX_PROGRAM_INPUTS 32
231 #define MAX_PROGRAM_OUTPUTS 64
232 /*@}*/
233
234 /** For GL_ARB_vertex_program */
235 /*@{*/
236 #define MAX_VERTEX_PROGRAM_ADDRESS_REGS 1
237 #define MAX_VERTEX_PROGRAM_PARAMS MAX_UNIFORMS
238 /*@}*/
239
240 /** For GL_ARB_fragment_program */
241 /*@{*/
242 #define MAX_FRAGMENT_PROGRAM_ADDRESS_REGS 0
243 /*@}*/
244
245 /** For GL_NV_vertex_program */
246 /*@{*/
247 #define MAX_NV_VERTEX_PROGRAM_INSTRUCTIONS 128
248 #define MAX_NV_VERTEX_PROGRAM_TEMPS 12
249 #define MAX_NV_VERTEX_PROGRAM_PARAMS 96
250 #define MAX_NV_VERTEX_PROGRAM_INPUTS 16
251 #define MAX_NV_VERTEX_PROGRAM_OUTPUTS 15
252 /*@}*/
253
254 /** For GL_NV_fragment_program */
255 /*@{*/
256 #define MAX_NV_FRAGMENT_PROGRAM_INSTRUCTIONS 1024 /* 72 for GL_ARB_f_p */
257 #define MAX_NV_FRAGMENT_PROGRAM_TEMPS 96
258 #define MAX_NV_FRAGMENT_PROGRAM_PARAMS 64
259 #define MAX_NV_FRAGMENT_PROGRAM_INPUTS 12
260 #define MAX_NV_FRAGMENT_PROGRAM_OUTPUTS 3
261 #define MAX_NV_FRAGMENT_PROGRAM_WRITE_ONLYS 2
262 /*@}*/
263
264
265 /** For GL_ARB_vertex_shader */
266 /*@{*/
267 #define MAX_VERTEX_GENERIC_ATTRIBS 16
268 #define MAX_VERTEX_TEXTURE_IMAGE_UNITS MAX_TEXTURE_IMAGE_UNITS
269 #define MAX_COMBINED_TEXTURE_IMAGE_UNITS (MAX_VERTEX_TEXTURE_IMAGE_UNITS + \
270 MAX_TEXTURE_IMAGE_UNITS)
271 /*@}*/
272
273
274 /** For GL_ARB_draw_buffers */
275 /*@{*/
276 #define MAX_DRAW_BUFFERS 8
277 /*@}*/
278
279
280 /** For GL_EXT_framebuffer_object */
281 /*@{*/
282 #define MAX_COLOR_ATTACHMENTS 8
283 /*@}*/
284
285 /** For GL_ATI_envmap_bump - support bump mapping on first 8 units */
286 #define SUPPORTED_ATI_BUMP_UNITS 0xff
287
288 /** For GL_EXT_transform_feedback */
289 #define MAX_FEEDBACK_ATTRIBS 32
290
291 /** For GL_ARB_geometry_shader4 */
292 /*@{*/
293 #define MAX_GEOMETRY_TEXTURE_IMAGE_UNITS 8
294 #define MAX_GEOMETRY_VARYING_COMPONENTS 32
295 #define MAX_VERTEX_VARYING_COMPONENTS 32
296 #define MAX_GEOMETRY_UNIFORM_COMPONENTS 512
297 #define MAX_GEOMETRY_OUTPUT_VERTICES 256
298 #define MAX_GEOMETRY_TOTAL_OUTPUT_COMPONENTS 1024
299 /*@}*/
300
301
302 /**
303 * \name Mesa-specific parameters
304 */
305 /*@{*/
306
307
308 /**
309 * If non-zero use GLdouble for walking triangle edges, for better accuracy.
310 */
311 #define TRIANGLE_WALK_DOUBLE 0
312
313
314 /**
315 * Bits per depth buffer value (max is 32).
316 */
317 #ifndef DEFAULT_SOFTWARE_DEPTH_BITS
318 #define DEFAULT_SOFTWARE_DEPTH_BITS 16
319 #endif
320 /** Depth buffer data type */
321 #if DEFAULT_SOFTWARE_DEPTH_BITS <= 16
322 #define DEFAULT_SOFTWARE_DEPTH_TYPE GLushort
323 #else
324 #define DEFAULT_SOFTWARE_DEPTH_TYPE GLuint
325 #endif
326
327
328 /**
329 * Bits per stencil value: 8
330 */
331 #define STENCIL_BITS 8
332
333
334 /**
335 * For swrast, bits per color channel: 8, 16 or 32
336 */
337 #ifndef CHAN_BITS
338 #define CHAN_BITS 8
339 #endif
340
341
342 /*
343 * Color channel component order
344 *
345 * \note Changes will almost certainly cause problems at this time.
346 */
347 #define RCOMP 0
348 #define GCOMP 1
349 #define BCOMP 2
350 #define ACOMP 3
351
352
353 /**
354 * Maximum number of temporary vertices required for clipping.
355 *
356 * Used in array_cache and tnl modules.
357 */
358 #define MAX_CLIPPED_VERTICES ((2 * (6 + MAX_CLIP_PLANES))+1)
359
360
361 #endif /* MESA_CONFIG_H_INCLUDED */