new MESA_DEBUG option: disassem
[mesa.git] / src / mesa / main / config.h
index 5edc3b4f5c2e885701f01d9988181254b7ee471a..456f8ce76a9155b4a6235f8652e0111dd4130165 100644 (file)
@@ -1,21 +1,24 @@
-/* $Id: config.h,v 1.13 2000/05/07 20:41:30 brianp Exp $ */
+/**
+ * \file config.h
+ * Tunable configuration parameters.
+ */
 
 /*
  * Mesa 3-D graphics library
- * Version:  3.3
- * 
- * Copyright (C) 1999-2000  Brian Paul   All Rights Reserved.
- * 
+ * Version:  6.3
+ *
+ * Copyright (C) 1999-2005  Brian Paul   All Rights Reserved.
+ *
  * Permission is hereby granted, free of charge, to any person obtaining a
  * copy of this software and associated documentation files (the "Software"),
  * to deal in the Software without restriction, including without limitation
  * the rights to use, copy, modify, merge, publish, distribute, sublicense,
  * and/or sell copies of the Software, and to permit persons to whom the
  * Software is furnished to do so, subject to the following conditions:
- * 
+ *
  * The above copyright notice and this permission notice shall be included
  * in all copies or substantial portions of the Software.
- * 
+ *
  * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS
  * OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  */
 
 
-/*
- * Tunable configuration parameters.
- */
-
-
-
 #ifndef CONFIG_H
 #define CONFIG_H
 
 #endif
 
 
-/*
- * OpenGL implementation limits
+/**
+ * \name OpenGL implementation limits
  */
+/*@{*/
 
-/* Maximum modelview matrix stack depth: */
+/** Maximum modelview matrix stack depth */
 #define MAX_MODELVIEW_STACK_DEPTH 32
 
-/* Maximum projection matrix stack depth: */
+/** Maximum projection matrix stack depth */
 #define MAX_PROJECTION_STACK_DEPTH 32
 
-/* Maximum texture matrix stack depth: */
+/** Maximum texture matrix stack depth */
 #define MAX_TEXTURE_STACK_DEPTH 10
 
-/* Maximum color matrix stack depth: */
+/** Maximum color matrix stack depth */
 #define MAX_COLOR_STACK_DEPTH 4
 
-/* Maximum attribute stack depth: */
+/** Maximum attribute stack depth */
 #define MAX_ATTRIB_STACK_DEPTH 16
 
-/* Maximum client attribute stack depth: */
+/** Maximum client attribute stack depth */
 #define MAX_CLIENT_ATTRIB_STACK_DEPTH 16
 
-/* Maximum recursion depth of display list calls: */
+/** Maximum recursion depth of display list calls */
 #define MAX_LIST_NESTING 64
 
-/* Maximum number of lights: */
+/** Maximum number of lights */
 #define MAX_LIGHTS 8
 
-/* Maximum user-defined clipping planes: */
+/** Maximum user-defined clipping planes */
 #define MAX_CLIP_PLANES 6
 
-/* Maximum pixel map lookup table size: */
+/** Maximum pixel map lookup table size */
 #define MAX_PIXEL_MAP_TABLE 256
 
-/* Number of auxillary color buffers: */
-#define NUM_AUX_BUFFERS 0
+/** Maximum number of auxillary color buffers */
+#define MAX_AUX_BUFFERS 4
 
-/* Maximum order (degree) of curves: */
+/** Maximum order (degree) of curves */
 #ifdef AMIGA
 #   define MAX_EVAL_ORDER 12
 #else
 #   define MAX_EVAL_ORDER 30
 #endif
 
-/* Maximum Name stack depth */
+/** Maximum Name stack depth */
 #define MAX_NAME_STACK_DEPTH 64
 
-/* Min and Max point sizes and granularity */
+/** Minimum point size */
 #define MIN_POINT_SIZE 1.0
-#define MAX_POINT_SIZE 10.0
+/** Maximum point size */
+#define MAX_POINT_SIZE 20.0
+/** Point size granularity */
 #define POINT_SIZE_GRANULARITY 0.1
 
-/* Min and Max line widths and granularity */
+/** Minimum line width */
 #define MIN_LINE_WIDTH 1.0
+/** Maximum line width */
 #define MAX_LINE_WIDTH 10.0
+/** Line width granularity */
 #define LINE_WIDTH_GRANULARITY 0.1
 
-/* Max texture palette / color table size */
+/** Max texture palette / color table size */
 #define MAX_COLOR_TABLE_SIZE 256
 
-/* Number of texture levels */
+/** Number of 1D/2D texture mipmap levels */
 #define MAX_TEXTURE_LEVELS 12
 
-/* Number of texture units - GL_ARB_multitexture */
-#define MAX_TEXTURE_UNITS 2
+/** Number of 3D texture mipmap levels */
+#define MAX_3D_TEXTURE_LEVELS 9
+
+/** Number of cube texture mipmap levels - GL_ARB_texture_cube_map */
+#define MAX_CUBE_TEXTURE_LEVELS 12
+
+/** Maximum rectangular texture size - GL_NV_texture_rectangle */
+#define MAX_TEXTURE_RECT_SIZE 2048
+
+/** Number of texture units - GL_ARB_multitexture */
+#define MAX_TEXTURE_UNITS 8
 
-/* Maximum viewport size: */
-#define MAX_WIDTH 1600
-#define MAX_HEIGHT 1200
+/*@}*/
+
+
+/**
+ * \name Separate numbers of texture coordinates and texture image units.
+ *
+ * These values will eventually replace most instances of MAX_TEXTURE_UNITS.
+ * We should always have MAX_TEXTURE_COORD_UNITS <= MAX_TEXTURE_IMAGE_UNITS.
+ * And, GL_MAX_TEXTURE_UNITS <= MAX_TEXTURE_COORD_UNITS.
+ */
+/*@{*/
+#define MAX_TEXTURE_COORD_UNITS 8
+#define MAX_TEXTURE_IMAGE_UNITS 8
+/*@}*/
+
+/** 
+ * Maximum viewport/image width. Must accomodate all texture sizes too. 
+ */
+#define MAX_WIDTH 4096
+/** Maximum viewport/image height */
+#define MAX_HEIGHT 4096
 
-/* Maxmimum size for CVA.  May be overridden by the drivers.  */
+/** Maxmimum size for CVA.  May be overridden by the drivers.  */
 #define MAX_ARRAY_LOCK_SIZE 3000
 
-/* Subpixel precision for antialiasing, window coordinate snapping */
+/** Subpixel precision for antialiasing, window coordinate snapping */
 #define SUB_PIXEL_BITS 4
 
-/* Size of histogram tables */
+/** Size of histogram tables */
 #define HISTOGRAM_TABLE_SIZE 256
 
-/* Max convolution filter sizes */
-#define MAX_CONVOLUTION_WIDTH 5
-#define MAX_CONVOLUTION_HEIGHT 5
+/** Max convolution filter width */
+#define MAX_CONVOLUTION_WIDTH 9
+/** Max convolution filter height */
+#define MAX_CONVOLUTION_HEIGHT 9
+
+/** For GL_ARB_texture_compression */
+#define MAX_COMPRESSED_TEXTURE_FORMATS 25
+
+/** For GL_EXT_texture_filter_anisotropic */
+#define MAX_TEXTURE_MAX_ANISOTROPY 16.0
+
+/** For GL_EXT_texture_lod_bias (typically MAX_TEXTURE_LEVELS - 1) */
+#define MAX_TEXTURE_LOD_BIAS 11.0
+
+/** For GL_NV_vertex_program */
+/*@{*/
+#define MAX_NV_VERTEX_PROGRAM_INSTRUCTIONS 128
+#define MAX_NV_VERTEX_PROGRAM_TEMPS         12
+#define MAX_NV_VERTEX_PROGRAM_PARAMS        128        /* KW: power of two */
+#define MAX_NV_VERTEX_PROGRAM_INPUTS        16
+#define MAX_NV_VERTEX_PROGRAM_OUTPUTS       15
+/*@}*/
+
+/** For GL_NV_fragment_program */
+/*@{*/
+#define MAX_NV_FRAGMENT_PROGRAM_INSTRUCTIONS 128
+#define MAX_NV_FRAGMENT_PROGRAM_TEMPS         96
+#define MAX_NV_FRAGMENT_PROGRAM_PARAMS        64
+#define MAX_NV_FRAGMENT_PROGRAM_INPUTS        12
+#define MAX_NV_FRAGMENT_PROGRAM_OUTPUTS        3
+#define MAX_NV_FRAGMENT_PROGRAM_WRITE_ONLYS    2
+/*@}*/
+
+/** For GL_ARB_vertex_program */
+/*@{*/
+#define MAX_VERTEX_PROGRAM_ADDRESS_REGS 1
+#define MAX_VERTEX_PROGRAM_ATTRIBS     16
+/*@}*/
+
+/** For GL_ARB_fragment_program */
+/*@{*/
+#define MAX_FRAGMENT_PROGRAM_ADDRESS_REGS 1
+#define MAX_FRAGMENT_PROGRAM_ALU_INSTRUCTIONS 48
+#define MAX_FRAGMENT_PROGRAM_TEX_INSTRUCTIONS 24
+#define MAX_FRAGMENT_PROGRAM_TEX_INDIRECTIONS  4
+/*@}*/
+
+/** For any program target/extension */
+/*@{*/
+#define MAX_PROGRAM_LOCAL_PARAMS 128 /* KW: power of two */
+#define MAX_PROGRAM_MATRICES 8
+#define MAX_PROGRAM_MATRIX_STACK_DEPTH 4
+/*@}*/
+
+/** For GL_ARB_fragment_shader */
+/*@{*/
+#define MAX_FRAGMENT_UNIFORM_COMPONENTS 64
+/*@}*/
+
+/** For GL_ARB_vertex_shader */
+/*@{*/
+#define MAX_VERTEX_UNIFORM_COMPONENTS 512
+#define MAX_VARYING_FLOATS 32
+#define MAX_VERTEX_TEXTURE_IMAGE_UNITS 0
+#define MAX_COMBINED_TEXTURE_IMAGE_UNITS (MAX_TEXTURE_IMAGE_UNITS + MAX_VERTEX_TEXTURE_IMAGE_UNITS)
+/*@}*/
+
+
+/** For GL_ARB_draw_buffers */
+/*@{*/
+#define MAX_DRAW_BUFFERS 1
+/*@}*/
+
+
+/** For GL_EXT_framebuffer_object */
+/*@{*/
+#define MAX_COLOR_ATTACHMENTS 8
+/*@}*/
+
+
+
+/**
+ * \name Mesa-specific parameters
+ */
+/*@{*/
 
 
-/*
- * Mesa-specific parameters
+/**
+ * If non-zero use GLdouble for walking triangle edges, for better accuracy.
  */
+#define TRIANGLE_WALK_DOUBLE 0
 
-
-/*
- * Bits per accumulation buffer color component:  8 or 16
+/**
+ * Bits per accumulation buffer color component:  8, 16 or 32
  */
 #define ACCUM_BITS 16
 
-
-/*
- * Bits per depth buffer value:  16 or 32 (GLushort or GLuint)
- * gl_create_visual() can select any depth in [0, 32].
+/**
+ * Bits per depth buffer value.  
+ *
+ * Any reasonable value up to 31 will work.  32 doesn't work because of integer
+ * overflow problems in the rasterizer code.
  */
+#ifndef DEFAULT_SOFTWARE_DEPTH_BITS
 #define DEFAULT_SOFTWARE_DEPTH_BITS 16
+#endif
+/** Depth buffer data type */
+#if DEFAULT_SOFTWARE_DEPTH_BITS <= 16
 #define DEFAULT_SOFTWARE_DEPTH_TYPE GLushort
+#else
+#define DEFAULT_SOFTWARE_DEPTH_TYPE GLuint
+#endif
 
 
-
-/*
- * Bits per stencil value:  8
+/**
+ * Bits per stencil value: 8
  */
 #define STENCIL_BITS 8
 
 
-/*
- * Bits per color channel (must be 8 at this time!)
+/**
+ * Bits per color channel:  8, 16 or 32
  */
+#ifndef CHAN_BITS
 #define CHAN_BITS 8
-#define CHAN_MAX ((1 << CHAN_BITS) - 1)
-#define CHAN_MAXF ((GLfloat) CHAN_MAX)
+#endif
 
 
 /*
  * Color channel component order
- * (changes will almost certainly cause problems at this time)
+ * 
+ * \note Changes will almost certainly cause problems at this time.
  */
 #define RCOMP 0
 #define GCOMP 1
 #define ACOMP 3
 
 
-
-/* Vertex buffer size.  KW: no restrictions on the divisibility of
- * this number, though things may go better for you if you choose a
- * value of 12n + 3.  
+/*
+ * Enable/disable features (blocks of code) by setting FEATURE_xyz to 0 or 1.
  */
-#define VB_START  3
-
-#define VB_MAX (216 + VB_START)
-
-
+#ifndef _HAVE_FULL_GL
+#define _HAVE_FULL_GL 1
+#endif
 
-/*
- * Actual vertex buffer size.
+#define FEATURE_ARB_vertex_buffer_object  _HAVE_FULL_GL
+#define FEATURE_ARB_vertex_program  _HAVE_FULL_GL
+#define FEATURE_ARB_fragment_program  _HAVE_FULL_GL
+#define FEATURE_ARB_occlusion_query  _HAVE_FULL_GL
+#define FEATURE_EXT_pixel_buffer_object  _HAVE_FULL_GL
+#define FEATURE_MESA_program_debug  _HAVE_FULL_GL
+#define FEATURE_NV_fence  _HAVE_FULL_GL
+#define FEATURE_NV_fragment_program  _HAVE_FULL_GL
+#define FEATURE_NV_vertex_program  _HAVE_FULL_GL
+#define FEATURE_userclip  _HAVE_FULL_GL
+#define FEATURE_texgen  _HAVE_FULL_GL
+#define FEATURE_windowpos  _HAVE_FULL_GL
+#define FEATURE_ARB_vertex_shader _HAVE_FULL_GL
+#define FEATURE_ARB_fragment_shader _HAVE_FULL_GL
+#define FEATURE_ARB_shader_objects (FEATURE_ARB_vertex_shader || FEATURE_ARB_fragment_shader)
+#define FEATURE_ARB_shading_language_100 FEATURE_ARB_shader_objects
+#define FEATURE_ATI_fragment_shader _HAVE_FULL_GL
+#define FEATURE_EXT_framebuffer_object _HAVE_FULL_GL
+/*@}*/
+
+
+/**
+ * Maximum number of temporary vertices required for clipping.  
  *
- * Arrays must also accomodate new vertices from clipping, and
- * potential overflow from primitives which don't fit into neatly into
- * VB_MAX vertices.  (This only happens when mixed primitives are
- * sharing the vb).  
+ * Used in array_cache and tnl modules.
  */
-#define VB_MAX_CLIPPED_VERTS ((2 * (6 + MAX_CLIP_PLANES))+1)
-#define VB_SIZE  (VB_MAX + VB_MAX_CLIPPED_VERTS)
+#define MAX_CLIPPED_VERTICES ((2 * (6 + MAX_CLIP_PLANES))+1)
 
 
+/* XXX these are temporary */
+#define NEW_RENDERBUFFER 1
+#define OLD_RENDERBUFFER 1
 
-typedef struct gl_context GLcontext;
 
-extern void
-gl_read_config_file( struct gl_context *ctx );
-
-extern void
-gl_register_config_var(const char *name, void (*notify)( const char *, int ));
-
-#endif
+#endif /* CONFIG_H */