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 /** Maximum user-defined clipping planes */
  65 #define MAX_CLIP_PLANES 6
  66
  67 /** Maximum pixel map lookup table size */
  68 #define MAX_PIXEL_MAP_TABLE 256
  69
  70 /** Maximum number of auxillary color buffers */
  71 #define MAX_AUX_BUFFERS 1
  72
  73 /** Maximum order (degree) of curves */
  74 #ifdef AMIGA
  75 #   define MAX_EVAL_ORDER 12
  76 #else
  77 #   define MAX_EVAL_ORDER 30
  78 #endif
  79
  80 /** Maximum Name stack depth */
  81 #define MAX_NAME_STACK_DEPTH 64
  82
  83 /** Minimum point size */
  84 #define MIN_POINT_SIZE 1.0
  85 /** Maximum point size */
  86 #define MAX_POINT_SIZE 60.0
  87 /** Point size granularity */
  88 #define POINT_SIZE_GRANULARITY 0.1
  89
  90 /** Minimum line width */
  91 #define MIN_LINE_WIDTH 1.0
  92 /** Maximum line width */
  93 #define MAX_LINE_WIDTH 10.0
  94 /** Line width granularity */
  95 #define LINE_WIDTH_GRANULARITY 0.1
  96
  97 /** Max texture palette / color table size */
  98 #define MAX_COLOR_TABLE_SIZE 256
  99
 100 /** Max memory to allow for a single texture image (in megabytes) */
 101 #define MAX_TEXTURE_MBYTES 1024
 102
 103 /** Number of 1D/2D texture mipmap levels */
 104 #define MAX_TEXTURE_LEVELS 15
 105
 106 /** Number of 3D texture mipmap levels */
 107 #define MAX_3D_TEXTURE_LEVELS 15
 108
 109 /** Number of cube texture mipmap levels - GL_ARB_texture_cube_map */
 110 #define MAX_CUBE_TEXTURE_LEVELS 15
 111
 112 /** Maximum rectangular texture size - GL_NV_texture_rectangle */
 113 #define MAX_TEXTURE_RECT_SIZE 16384
 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 /**
 119  * Max number of texture coordinate units.  This mainly just applies to
 120  * the fixed-function vertex code.  This will be difficult to raise above
 121  * eight because of various vertex attribute bitvectors.
 122  */
 123 #define MAX_TEXTURE_COORD_UNITS 8
 124
 125 /**
 126  * Max number of texture image units.  Also determines number of texture
 127  * samplers in shaders.
 128  */
 129 #define MAX_TEXTURE_IMAGE_UNITS 16
 130
 131 /**
 132  * Larger of MAX_TEXTURE_COORD_UNITS and MAX_TEXTURE_IMAGE_UNITS.
 133  * This value is only used for dimensioning arrays.
 134  * Either MAX_TEXTURE_COORD_UNITS or MAX_TEXTURE_IMAGE_UNITS (or the
 135  * corresponding ctx->Const.MaxTextureCoord/ImageUnits fields) should be
 136  * used almost everywhere else.
 137  */
 138 #define MAX_TEXTURE_UNITS ((MAX_TEXTURE_COORD_UNITS > MAX_TEXTURE_IMAGE_UNITS) ? MAX_TEXTURE_COORD_UNITS : MAX_TEXTURE_IMAGE_UNITS)
 139
 140
 141 /**
 142  * Maximum viewport/image width. Must accomodate all texture sizes too.
 143  */
 144
 145 #ifndef MAX_WIDTH
 146 #   define MAX_WIDTH 16384
 147 #endif
 148 /** Maximum viewport/image height */
 149 #ifndef MAX_HEIGHT
 150 #   define MAX_HEIGHT 16384
 151 #endif
 152
 153 /* XXX: hack to prevent stack overflow on windows until all temporary arrays
 154  * [MAX_WIDTH] are allocated from the heap */
 155 #ifdef WIN32
 156 #undef MAX_TEXTURE_LEVELS
 157 #undef MAX_3D_TEXTURE_LEVELS
 158 #undef MAX_CUBE_TEXTURE_LEVELS
 159 #undef MAX_TEXTURE_RECT_SIZE
 160 #undef MAX_WIDTH
 161 #undef MAX_HEIGHT
 162 #define MAX_TEXTURE_LEVELS 13
 163 #define MAX_3D_TEXTURE_LEVELS 9
 164 #define MAX_CUBE_TEXTURE_LEVELS 13
 165 #define MAX_TEXTURE_RECT_SIZE 4096
 166 #define MAX_WIDTH 4096
 167 #define MAX_HEIGHT 4096
 168 #endif
 169
 170 /** Maxmimum size for CVA.  May be overridden by the drivers.  */
 171 #define MAX_ARRAY_LOCK_SIZE 3000
 172
 173 /** Subpixel precision for antialiasing, window coordinate snapping */
 174 #define SUB_PIXEL_BITS 4
 175
 176 /** Size of histogram tables */
 177 #define HISTOGRAM_TABLE_SIZE 256
 178
 179 /** Max convolution filter width */
 180 #define MAX_CONVOLUTION_WIDTH 9
 181 /** Max convolution filter height */
 182 #define MAX_CONVOLUTION_HEIGHT 9
 183
 184 /** For GL_ARB_texture_compression */
 185 #define MAX_COMPRESSED_TEXTURE_FORMATS 25
 186
 187 /** For GL_EXT_texture_filter_anisotropic */
 188 #define MAX_TEXTURE_MAX_ANISOTROPY 16.0
 189
 190 /** For GL_EXT_texture_lod_bias (typically MAX_TEXTURE_LEVELS - 1) */
 191 #define MAX_TEXTURE_LOD_BIAS 14.0
 192
 193 /** For any program target/extension */
 194 /*@{*/
 195 #define MAX_PROGRAM_INSTRUCTIONS       (16 * 1024)
 196
 197 /**
 198  * Per-program constants (power of two)
 199  *
 200  * \c MAX_PROGRAM_LOCAL_PARAMS and \c MAX_UNIFORMS are just the assembly shader
 201  * and GLSL shader names for the same thing.  They should \b always have the
 202  * same value.  Each refers to the number of vec4 values supplied as
 203  * per-program parameters.
 204  */
 205 /*@{*/
 206 #define MAX_PROGRAM_LOCAL_PARAMS       1024
 207 #define MAX_UNIFORMS                   1024
 208 /*@}*/
 209
 210 /**
 211  * Per-context constants (power of two)
 212  *
 213  * \note
 214  * This value should always be less than or equal to \c MAX_PROGRAM_LOCAL_PARAMS
 215  * and \c MAX_VERTEX_PROGRAM_PARAMS.  Otherwise some applications will make
 216  * incorrect assumptions.
 217  */
 218 #define MAX_PROGRAM_ENV_PARAMS         256
 219
 220 #define MAX_PROGRAM_MATRICES           8
 221 #define MAX_PROGRAM_MATRIX_STACK_DEPTH 4
 222 #define MAX_PROGRAM_CALL_DEPTH         8
 223 #define MAX_PROGRAM_TEMPS              256
 224 #define MAX_PROGRAM_ADDRESS_REGS       2
 225 #define MAX_VARYING                    16    /**< number of float[4] vectors */
 226 #define MAX_SAMPLERS                   MAX_TEXTURE_IMAGE_UNITS
 227 #define MAX_PROGRAM_INPUTS             32
 228 #define MAX_PROGRAM_OUTPUTS            64
 229 /*@}*/
 230
 231 /** For GL_ARB_vertex_program */
 232 /*@{*/
 233 #define MAX_VERTEX_PROGRAM_ADDRESS_REGS 1
 234 #define MAX_VERTEX_PROGRAM_PARAMS       MAX_UNIFORMS
 235 /*@}*/
 236
 237 /** For GL_ARB_fragment_program */
 238 /*@{*/
 239 #define MAX_FRAGMENT_PROGRAM_ADDRESS_REGS 0
 240 /*@}*/
 241
 242 /** For GL_NV_vertex_program */
 243 /*@{*/
 244 #define MAX_NV_VERTEX_PROGRAM_INSTRUCTIONS 128
 245 #define MAX_NV_VERTEX_PROGRAM_TEMPS         12
 246 #define MAX_NV_VERTEX_PROGRAM_PARAMS        96
 247 #define MAX_NV_VERTEX_PROGRAM_INPUTS        16
 248 #define MAX_NV_VERTEX_PROGRAM_OUTPUTS       15
 249 /*@}*/
 250
 251 /** For GL_NV_fragment_program */
 252 /*@{*/
 253 #define MAX_NV_FRAGMENT_PROGRAM_INSTRUCTIONS 1024 /* 72 for GL_ARB_f_p */
 254 #define MAX_NV_FRAGMENT_PROGRAM_TEMPS         96
 255 #define MAX_NV_FRAGMENT_PROGRAM_PARAMS        64
 256 #define MAX_NV_FRAGMENT_PROGRAM_INPUTS        12
 257 #define MAX_NV_FRAGMENT_PROGRAM_OUTPUTS        3
 258 #define MAX_NV_FRAGMENT_PROGRAM_WRITE_ONLYS    2
 259 /*@}*/
 260
 261
 262 /** For GL_ARB_vertex_shader */
 263 /*@{*/
 264 #define MAX_VERTEX_GENERIC_ATTRIBS 16
 265 #define MAX_VERTEX_TEXTURE_IMAGE_UNITS MAX_TEXTURE_IMAGE_UNITS
 266 #define MAX_COMBINED_TEXTURE_IMAGE_UNITS (MAX_VERTEX_TEXTURE_IMAGE_UNITS + \
 267                                           MAX_TEXTURE_IMAGE_UNITS)
 268 /*@}*/
 269
 270
 271 /** For GL_ARB_draw_buffers */
 272 /*@{*/
 273 #define MAX_DRAW_BUFFERS 8
 274 /*@}*/
 275
 276
 277 /** For GL_EXT_framebuffer_object */
 278 /*@{*/
 279 #define MAX_COLOR_ATTACHMENTS 8
 280 /*@}*/
 281
 282 /** For GL_ATI_envmap_bump - support bump mapping on first 8 units */
 283 #define SUPPORTED_ATI_BUMP_UNITS 0xff
 284
 285 /** For GL_EXT_transform_feedback */
 286 #define MAX_FEEDBACK_ATTRIBS 32
 287
 288 /** For GL_ARB_geometry_shader4 */
 289 /*@{*/
 290 #define MAX_GEOMETRY_TEXTURE_IMAGE_UNITS             8
 291 #define MAX_GEOMETRY_VARYING_COMPONENTS              32
 292 #define MAX_VERTEX_VARYING_COMPONENTS                32
 293 #define MAX_GEOMETRY_UNIFORM_COMPONENTS              512
 294 #define MAX_GEOMETRY_OUTPUT_VERTICES                 256
 295 #define MAX_GEOMETRY_TOTAL_OUTPUT_COMPONENTS         1024
 296 /*@}*/
 297
 298
 299 /**
 300  * \name Mesa-specific parameters
 301  */
 302 /*@{*/
 303
 304
 305 /**
 306  * If non-zero use GLdouble for walking triangle edges, for better accuracy.
 307  */
 308 #define TRIANGLE_WALK_DOUBLE 0
 309
 310
 311 /**
 312  * Bits per depth buffer value (max is 32).
 313  */
 314 #ifndef DEFAULT_SOFTWARE_DEPTH_BITS
 315 #define DEFAULT_SOFTWARE_DEPTH_BITS 16
 316 #endif
 317 /** Depth buffer data type */
 318 #if DEFAULT_SOFTWARE_DEPTH_BITS <= 16
 319 #define DEFAULT_SOFTWARE_DEPTH_TYPE GLushort
 320 #else
 321 #define DEFAULT_SOFTWARE_DEPTH_TYPE GLuint
 322 #endif
 323
 324
 325 /**
 326  * Bits per stencil value: 8
 327  */
 328 #define STENCIL_BITS 8
 329
 330
 331 /**
 332  * Bits per color channel:  8, 16 or 32
 333  */
 334 #ifndef CHAN_BITS
 335 #define CHAN_BITS 8
 336 #endif
 337
 338
 339 /*
 340  * Color channel component order
 341  *
 342  * \note Changes will almost certainly cause problems at this time.
 343  */
 344 #define RCOMP 0
 345 #define GCOMP 1
 346 #define BCOMP 2
 347 #define ACOMP 3
 348
 349
 350 /**
 351  * Maximum number of temporary vertices required for clipping.
 352  *
 353  * Used in array_cache and tnl modules.
 354  */
 355 #define MAX_CLIPPED_VERTICES ((2 * (6 + MAX_CLIP_PLANES))+1)
 356
 357
 358 #endif /* MESA_CONFIG_H_INCLUDED */