424ed60b571fec540e5e147c00d78f6c431af240
[mesa.git] / src / mesa / main / config.h
1 /**
2 * \file config.h
3 * Tunable configuration parameters.
4 */
5
6 /*
7 * Mesa 3-D graphics library
8 * Version: 7.1
9 *
10 * Copyright (C) 1999-2007 Brian Paul All Rights Reserved.
11 *
12 * Permission is hereby granted, free of charge, to any person obtaining a
13 * copy of this software and associated documentation files (the "Software"),
14 * to deal in the Software without restriction, including without limitation
15 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
16 * and/or sell copies of the Software, and to permit persons to whom the
17 * Software is furnished to do so, subject to the following conditions:
18 *
19 * The above copyright notice and this permission notice shall be included
20 * in all copies or substantial portions of the Software.
21 *
22 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
23 * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
24 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
25 * BRIAN PAUL BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN
26 * AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN
27 * CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
28 */
29
30
31 #ifndef MESA_CONFIG_H_INCLUDED
32 #define MESA_CONFIG_H_INCLUDED
33
34
35 #include "main/mfeatures.h"
36
37
38 /**
39 * \name OpenGL implementation limits
40 */
41 /*@{*/
42
43 /** Maximum modelview matrix stack depth */
44 #define MAX_MODELVIEW_STACK_DEPTH 32
45
46 /** Maximum projection matrix stack depth */
47 #define MAX_PROJECTION_STACK_DEPTH 32
48
49 /** Maximum texture matrix stack depth */
50 #define MAX_TEXTURE_STACK_DEPTH 10
51
52 /** Maximum color matrix stack depth */
53 #define MAX_COLOR_STACK_DEPTH 4
54
55 /** Maximum attribute stack depth */
56 #define MAX_ATTRIB_STACK_DEPTH 16
57
58 /** Maximum client attribute stack depth */
59 #define MAX_CLIENT_ATTRIB_STACK_DEPTH 16
60
61 /** Maximum recursion depth of display list calls */
62 #define MAX_LIST_NESTING 64
63
64 /** Maximum number of lights */
65 #define MAX_LIGHTS 8
66
67 /** Maximum user-defined clipping planes */
68 #define MAX_CLIP_PLANES 6
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 4
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 /** Number of 1D/2D texture mipmap levels */
104 #define MAX_TEXTURE_LEVELS 12
105
106 /** Number of 3D texture mipmap levels */
107 #define MAX_3D_TEXTURE_LEVELS 9
108
109 /** Number of cube texture mipmap levels - GL_ARB_texture_cube_map */
110 #define MAX_CUBE_TEXTURE_LEVELS 12
111
112 /** Maximum rectangular texture size - GL_NV_texture_rectangle */
113 #define MAX_TEXTURE_RECT_SIZE 2048
114
115 /** Maximum number of layers in a 1D or 2D array texture - GL_MESA_texture_array */
116 #define MAX_ARRAY_TEXTURE_LAYERS 64
117
118 /** Number of texture units - GL_ARB_multitexture
119 * This needs to be the larger of MAX_TEXTURE_COORD_UNITS and
120 * MAX_TEXTURE_IMAGE_UNITS seen below, since MAX_TEXTURE_UNITS is used
121 * to dimension some arrays that store both coord and image data.
122 */
123 #define MAX_TEXTURE_UNITS 8
124
125 /*@}*/
126
127
128 /**
129 * \name Separate numbers of texture coordinates and texture image units.
130 *
131 * These values will eventually replace most instances of MAX_TEXTURE_UNITS.
132 * We should always have MAX_TEXTURE_COORD_UNITS <= MAX_TEXTURE_IMAGE_UNITS.
133 * And, GL_MAX_TEXTURE_UNITS <= MAX_TEXTURE_COORD_UNITS.
134 */
135 /*@{*/
136 #define MAX_TEXTURE_COORD_UNITS 8
137 #define MAX_TEXTURE_IMAGE_UNITS 8
138 /*@}*/
139
140 /**
141 * Maximum viewport/image width. Must accomodate all texture sizes too.
142 */
143 #define MAX_WIDTH 4096
144 /** Maximum viewport/image height */
145 #define MAX_HEIGHT 4096
146
147 /** Maxmimum size for CVA. May be overridden by the drivers. */
148 #define MAX_ARRAY_LOCK_SIZE 3000
149
150 /** Subpixel precision for antialiasing, window coordinate snapping */
151 #define SUB_PIXEL_BITS 4
152
153 /** Size of histogram tables */
154 #define HISTOGRAM_TABLE_SIZE 256
155
156 /** Max convolution filter width */
157 #define MAX_CONVOLUTION_WIDTH 9
158 /** Max convolution filter height */
159 #define MAX_CONVOLUTION_HEIGHT 9
160
161 /** For GL_ARB_texture_compression */
162 #define MAX_COMPRESSED_TEXTURE_FORMATS 25
163
164 /** For GL_EXT_texture_filter_anisotropic */
165 #define MAX_TEXTURE_MAX_ANISOTROPY 16.0
166
167 /** For GL_EXT_texture_lod_bias (typically MAX_TEXTURE_LEVELS - 1) */
168 #define MAX_TEXTURE_LOD_BIAS 11.0
169
170 /** For GL_ARB_vertex_program */
171 /*@{*/
172 #define MAX_VERTEX_PROGRAM_ADDRESS_REGS 1
173 #define MAX_VERTEX_PROGRAM_ATTRIBS 16
174 /*@}*/
175
176 /** For GL_ARB_fragment_program */
177 /*@{*/
178 #define MAX_FRAGMENT_PROGRAM_ADDRESS_REGS 0
179 #define MAX_FRAGMENT_PROGRAM_ALU_INSTRUCTIONS 48
180 #define MAX_FRAGMENT_PROGRAM_TEX_INSTRUCTIONS 24
181 #define MAX_FRAGMENT_PROGRAM_TEX_INDIRECTIONS 4
182 /*@}*/
183
184 /** For any program target/extension */
185 /*@{*/
186 #define MAX_PROGRAM_LOCAL_PARAMS 256 /**< per-program constants (power of two) */
187 #define MAX_PROGRAM_ENV_PARAMS 128
188 #define MAX_PROGRAM_MATRICES 8
189 #define MAX_PROGRAM_MATRIX_STACK_DEPTH 4
190 #define MAX_PROGRAM_CALL_DEPTH 8
191 #define MAX_PROGRAM_TEMPS 128
192 #define MAX_PROGRAM_ADDRESS_REGS 2
193 #define MAX_UNIFORMS 256 /**< number of vec4 uniforms */
194 #define MAX_VARYING 8 /**< number of float[4] vectors */
195 #define MAX_SAMPLERS 8
196 #define MAX_PROGRAM_INPUTS 32
197 #define MAX_PROGRAM_OUTPUTS 32
198 /*@}*/
199
200 /** For GL_NV_vertex_program */
201 /*@{*/
202 #define MAX_NV_VERTEX_PROGRAM_INSTRUCTIONS 128
203 #define MAX_NV_VERTEX_PROGRAM_TEMPS 12
204 #define MAX_NV_VERTEX_PROGRAM_PARAMS MAX_PROGRAM_ENV_PARAMS
205 #define MAX_NV_VERTEX_PROGRAM_INPUTS 16
206 #define MAX_NV_VERTEX_PROGRAM_OUTPUTS 15
207 /*@}*/
208
209 /** For GL_NV_fragment_program */
210 /*@{*/
211 #define MAX_NV_FRAGMENT_PROGRAM_INSTRUCTIONS 1024 /* 72 for GL_ARB_f_p */
212 #define MAX_NV_FRAGMENT_PROGRAM_TEMPS 96
213 #define MAX_NV_FRAGMENT_PROGRAM_PARAMS 64
214 #define MAX_NV_FRAGMENT_PROGRAM_INPUTS 12
215 #define MAX_NV_FRAGMENT_PROGRAM_OUTPUTS 3
216 #define MAX_NV_FRAGMENT_PROGRAM_WRITE_ONLYS 2
217 /*@}*/
218
219
220 /** For GL_ARB_vertex_shader */
221 /*@{*/
222 #define MAX_VERTEX_ATTRIBS 16
223 #define MAX_VERTEX_TEXTURE_IMAGE_UNITS MAX_TEXTURE_UNITS
224 #define MAX_COMBINED_TEXTURE_IMAGE_UNITS (MAX_TEXTURE_IMAGE_UNITS + MAX_VERTEX_TEXTURE_IMAGE_UNITS)
225 /*@}*/
226
227
228 /** For GL_ARB_draw_buffers */
229 /*@{*/
230 #define MAX_DRAW_BUFFERS 4
231 /*@}*/
232
233
234 /** For GL_EXT_framebuffer_object */
235 /*@{*/
236 #define MAX_COLOR_ATTACHMENTS 8
237 /*@}*/
238
239
240
241 /**
242 * \name Mesa-specific parameters
243 */
244 /*@{*/
245
246
247 /**
248 * If non-zero use GLdouble for walking triangle edges, for better accuracy.
249 */
250 #define TRIANGLE_WALK_DOUBLE 0
251
252
253 /**
254 * Bits per depth buffer value (max is 32).
255 */
256 #ifndef DEFAULT_SOFTWARE_DEPTH_BITS
257 #define DEFAULT_SOFTWARE_DEPTH_BITS 16
258 #endif
259 /** Depth buffer data type */
260 #if DEFAULT_SOFTWARE_DEPTH_BITS <= 16
261 #define DEFAULT_SOFTWARE_DEPTH_TYPE GLushort
262 #else
263 #define DEFAULT_SOFTWARE_DEPTH_TYPE GLuint
264 #endif
265
266
267 /**
268 * Bits per stencil value: 8
269 */
270 #define STENCIL_BITS 8
271
272
273 /**
274 * Bits per color channel: 8, 16 or 32
275 */
276 #ifndef CHAN_BITS
277 #define CHAN_BITS 8
278 #endif
279
280
281 /*
282 * Color channel component order
283 *
284 * \note Changes will almost certainly cause problems at this time.
285 */
286 #define RCOMP 0
287 #define GCOMP 1
288 #define BCOMP 2
289 #define ACOMP 3
290
291
292 /**
293 * Maximum number of temporary vertices required for clipping.
294 *
295 * Used in array_cache and tnl modules.
296 */
297 #define MAX_CLIPPED_VERTICES ((2 * (6 + MAX_CLIP_PLANES))+1)
298
299
300 #endif /* MESA_CONFIG_H_INCLUDED */