config.h File Reference

---

Detailed Description

Tunable configuration parameters.

Defines
#define	MAX_PROGRAM_ENV_PARAMS   256
	Per-context constants (power of two).
#define	MAX_PROGRAM_MATRICES   8
#define	MAX_PROGRAM_MATRIX_STACK_DEPTH   4
#define	MAX_PROGRAM_CALL_DEPTH   8
#define	MAX_PROGRAM_TEMPS   256
#define	MAX_PROGRAM_ADDRESS_REGS   2
#define	MAX_VARYING   16
	number of float[4] vectors
#define	MAX_SAMPLERS   MAX_TEXTURE_IMAGE_UNITS
#define	MAX_PROGRAM_INPUTS   32
#define	MAX_PROGRAM_OUTPUTS   32
#define	SUPPORTED_ATI_BUMP_UNITS   0xff
	For GL_ATI_envmap_bump - support bump mapping on first 8 units.
OpenGL implementation limits
#define	MAX_MODELVIEW_STACK_DEPTH   32
	Maximum modelview matrix stack depth.
#define	MAX_PROJECTION_STACK_DEPTH   32
	Maximum projection matrix stack depth.
#define	MAX_TEXTURE_STACK_DEPTH   10
	Maximum texture matrix stack depth.
#define	MAX_COLOR_STACK_DEPTH   4
	Maximum color matrix stack depth.
#define	MAX_ATTRIB_STACK_DEPTH   16
	Maximum attribute stack depth.
#define	MAX_CLIENT_ATTRIB_STACK_DEPTH   16
	Maximum client attribute stack depth.
#define	MAX_LIST_NESTING   64
	Maximum recursion depth of display list calls.
#define	MAX_LIGHTS   8
	Maximum number of lights.
#define	MAX_CLIP_PLANES   6
	Maximum user-defined clipping planes.
#define	MAX_PIXEL_MAP_TABLE   256
	Maximum pixel map lookup table size.
#define	MAX_AUX_BUFFERS   1
	Maximum number of auxillary color buffers.
#define	MAX_EVAL_ORDER   30
	Maximum order (degree) of curves.
#define	MAX_NAME_STACK_DEPTH   64
	Maximum Name stack depth.
#define	MIN_POINT_SIZE   1.0
	Minimum point size.
#define	MAX_POINT_SIZE   60.0
	Maximum point size.
#define	POINT_SIZE_GRANULARITY   0.1
	Point size granularity.
#define	MIN_LINE_WIDTH   1.0
	Minimum line width.
#define	MAX_LINE_WIDTH   10.0
	Maximum line width.
#define	LINE_WIDTH_GRANULARITY   0.1
	Line width granularity.
#define	MAX_COLOR_TABLE_SIZE   256
	Max texture palette / color table size.
#define	MAX_TEXTURE_LEVELS   13
	Number of 1D/2D texture mipmap levels.
#define	MAX_3D_TEXTURE_LEVELS   9
	Number of 3D texture mipmap levels.
#define	MAX_CUBE_TEXTURE_LEVELS   13
	Number of cube texture mipmap levels - GL_ARB_texture_cube_map.
#define	MAX_TEXTURE_RECT_SIZE   4096
	Maximum rectangular texture size - GL_NV_texture_rectangle.
#define	MAX_ARRAY_TEXTURE_LAYERS   64
	Maximum number of layers in a 1D or 2D array texture - GL_MESA_texture_array.
#define	MAX_TEXTURE_COORD_UNITS   8
	Max number of texture coordinate units.
#define	MAX_TEXTURE_IMAGE_UNITS   16
	Max number of texture image units.
#define	MAX_TEXTURE_UNITS   ((MAX_TEXTURE_COORD_UNITS > MAX_TEXTURE_IMAGE_UNITS) ? MAX_TEXTURE_COORD_UNITS : MAX_TEXTURE_IMAGE_UNITS)
	Larger of MAX_TEXTURE_COORD_UNITS and MAX_TEXTURE_IMAGE_UNITS.
#define	MAX_WIDTH   4096
	Maximum viewport/image width.
#define	MAX_HEIGHT   4096
	Maximum viewport/image height.
#define	MAX_ARRAY_LOCK_SIZE   3000
	Maxmimum size for CVA.
#define	SUB_PIXEL_BITS   4
	Subpixel precision for antialiasing, window coordinate snapping.
#define	HISTOGRAM_TABLE_SIZE   256
	Size of histogram tables.
#define	MAX_CONVOLUTION_WIDTH   9
	Max convolution filter width.
#define	MAX_CONVOLUTION_HEIGHT   9
	Max convolution filter height.
#define	MAX_COMPRESSED_TEXTURE_FORMATS   25
	For GL_ARB_texture_compression.
#define	MAX_TEXTURE_MAX_ANISOTROPY   16.0
	For GL_EXT_texture_filter_anisotropic.
#define	MAX_TEXTURE_LOD_BIAS   12.0
	For GL_EXT_texture_lod_bias (typically MAX_TEXTURE_LEVELS - 1).
#define	MAX_PROGRAM_INSTRUCTIONS   (16 * 1024)
	For any program target/extension.
#define	MAX_PROGRAM_LOCAL_PARAMS   1024
	Per-program constants (power of two).
#define	MAX_UNIFORMS   1024
#define	MAX_VERTEX_PROGRAM_ADDRESS_REGS   1
	For GL_ARB_vertex_program.
#define	MAX_VERTEX_PROGRAM_PARAMS   MAX_UNIFORMS
#define	MAX_FRAGMENT_PROGRAM_ADDRESS_REGS   0
	For GL_ARB_fragment_program.
#define	MAX_NV_VERTEX_PROGRAM_INSTRUCTIONS   128
	For GL_NV_vertex_program.
#define	MAX_NV_VERTEX_PROGRAM_TEMPS   12
#define	MAX_NV_VERTEX_PROGRAM_PARAMS   96
#define	MAX_NV_VERTEX_PROGRAM_INPUTS   16
#define	MAX_NV_VERTEX_PROGRAM_OUTPUTS   15
#define	MAX_NV_FRAGMENT_PROGRAM_INSTRUCTIONS   1024
	For GL_NV_fragment_program.
#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
#define	MAX_VERTEX_GENERIC_ATTRIBS   16
	For GL_ARB_vertex_shader.
#define	MAX_VERTEX_TEXTURE_IMAGE_UNITS   MAX_TEXTURE_IMAGE_UNITS
#define	MAX_COMBINED_TEXTURE_IMAGE_UNITS   MAX_TEXTURE_IMAGE_UNITS
#define	MAX_DRAW_BUFFERS   4
	For GL_ARB_draw_buffers.
#define	MAX_COLOR_ATTACHMENTS   8
	For GL_EXT_framebuffer_object.
Mesa-specific parameters
#define	TRIANGLE_WALK_DOUBLE   0
	If non-zero use GLdouble for walking triangle edges, for better accuracy.
#define	DEFAULT_SOFTWARE_DEPTH_BITS   16
	Bits per depth buffer value (max is 32).
#define	DEFAULT_SOFTWARE_DEPTH_TYPE   GLushort
	Depth buffer data type.
#define	STENCIL_BITS   8
	Bits per stencil value: 8.
#define	CHAN_BITS   8
	Bits per color channel: 8, 16 or 32.
#define	RCOMP   0
#define	GCOMP   1
#define	BCOMP   2
#define	ACOMP   3
#define	MAX_CLIPPED_VERTICES   ((2 * (6 + MAX_CLIP_PLANES))+1)
	Maximum number of temporary vertices required for clipping.

---

Define Documentation

#define ACOMP   3

#define BCOMP   2

#define CHAN_BITS   8

Bits per color channel: 8, 16 or 32.

#define DEFAULT_SOFTWARE_DEPTH_BITS   16

Bits per depth buffer value (max is 32).

#define DEFAULT_SOFTWARE_DEPTH_TYPE   GLushort

Depth buffer data type.

#define GCOMP   1

#define HISTOGRAM_TABLE_SIZE   256

Size of histogram tables.

#define LINE_WIDTH_GRANULARITY   0.1

Line width granularity.

#define MAX_3D_TEXTURE_LEVELS   9

Number of 3D texture mipmap levels.

#define MAX_ARRAY_LOCK_SIZE   3000

Maxmimum size for CVA.

May be overridden by the drivers.

#define MAX_ARRAY_TEXTURE_LAYERS   64

Maximum number of layers in a 1D or 2D array texture - GL_MESA_texture_array.

#define MAX_ATTRIB_STACK_DEPTH   16

Maximum attribute stack depth.

#define MAX_AUX_BUFFERS   1

Maximum number of auxillary color buffers.

#define MAX_CLIENT_ATTRIB_STACK_DEPTH   16

Maximum client attribute stack depth.

#define MAX_CLIP_PLANES   6

Maximum user-defined clipping planes.

#define MAX_CLIPPED_VERTICES   ((2 * (6 + MAX_CLIP_PLANES))+1)

Maximum number of temporary vertices required for clipping.

Used in array_cache and tnl modules.

#define MAX_COLOR_ATTACHMENTS   8

For GL_EXT_framebuffer_object.

#define MAX_COLOR_STACK_DEPTH   4

Maximum color matrix stack depth.

#define MAX_COLOR_TABLE_SIZE   256

Max texture palette / color table size.

#define MAX_COMBINED_TEXTURE_IMAGE_UNITS   MAX_TEXTURE_IMAGE_UNITS

#define MAX_COMPRESSED_TEXTURE_FORMATS   25

For GL_ARB_texture_compression.

#define MAX_CONVOLUTION_HEIGHT   9

Max convolution filter height.

#define MAX_CONVOLUTION_WIDTH   9

Max convolution filter width.

#define MAX_CUBE_TEXTURE_LEVELS   13

Number of cube texture mipmap levels - GL_ARB_texture_cube_map.

#define MAX_DRAW_BUFFERS   4

For GL_ARB_draw_buffers.

#define MAX_EVAL_ORDER   30

Maximum order (degree) of curves.

#define MAX_FRAGMENT_PROGRAM_ADDRESS_REGS   0

For GL_ARB_fragment_program.

#define MAX_HEIGHT   4096

Maximum viewport/image height.

#define MAX_LIGHTS   8

Maximum number of lights.

#define MAX_LINE_WIDTH   10.0

Maximum line width.

#define MAX_LIST_NESTING   64

Maximum recursion depth of display list calls.

#define MAX_MODELVIEW_STACK_DEPTH   32

Maximum modelview matrix stack depth.

#define MAX_NAME_STACK_DEPTH   64

Maximum Name stack depth.

#define MAX_NV_FRAGMENT_PROGRAM_INPUTS   12

#define MAX_NV_FRAGMENT_PROGRAM_INSTRUCTIONS   1024

For GL_NV_fragment_program.

#define MAX_NV_FRAGMENT_PROGRAM_OUTPUTS   3

#define MAX_NV_FRAGMENT_PROGRAM_PARAMS   64

#define MAX_NV_FRAGMENT_PROGRAM_TEMPS   96

#define MAX_NV_FRAGMENT_PROGRAM_WRITE_ONLYS   2

#define MAX_NV_VERTEX_PROGRAM_INPUTS   16

#define MAX_NV_VERTEX_PROGRAM_INSTRUCTIONS   128

For GL_NV_vertex_program.

#define MAX_NV_VERTEX_PROGRAM_OUTPUTS   15

#define MAX_NV_VERTEX_PROGRAM_PARAMS   96

#define MAX_NV_VERTEX_PROGRAM_TEMPS   12

#define MAX_PIXEL_MAP_TABLE   256

Maximum pixel map lookup table size.

#define MAX_POINT_SIZE   60.0

Maximum point size.

#define MAX_PROGRAM_ADDRESS_REGS   2

#define MAX_PROGRAM_CALL_DEPTH   8

#define MAX_PROGRAM_ENV_PARAMS   256

Per-context constants (power of two).

Note:

This value should always be less than or equal to MAX_PROGRAM_LOCAL_PARAMS and MAX_VERTEX_PROGRAM_PARAMS. Otherwise some applications will make incorrect assumptions.

#define MAX_PROGRAM_INPUTS   32

#define MAX_PROGRAM_INSTRUCTIONS   (16 * 1024)

For any program target/extension.

#define MAX_PROGRAM_LOCAL_PARAMS   1024

Per-program constants (power of two).

MAX_PROGRAM_LOCAL_PARAMS and MAX_UNIFORMS are just the assmebly shader and GLSL shader names for the same thing. They should always have the same value. Each refers to the number of vec4 values supplied as per-program parameters.

#define MAX_PROGRAM_MATRICES   8

#define MAX_PROGRAM_MATRIX_STACK_DEPTH   4

#define MAX_PROGRAM_OUTPUTS   32

#define MAX_PROGRAM_TEMPS   256

#define MAX_PROJECTION_STACK_DEPTH   32

Maximum projection matrix stack depth.

#define MAX_SAMPLERS   MAX_TEXTURE_IMAGE_UNITS

#define MAX_TEXTURE_COORD_UNITS   8

Max number of texture coordinate units.

This mainly just applies to the fixed-function vertex code. This will be difficult to raise above eight because of various vertex attribute bitvectors.

#define MAX_TEXTURE_IMAGE_UNITS   16

Max number of texture image units.

Also determines number of texture samplers in shaders.

#define MAX_TEXTURE_LEVELS   13

Number of 1D/2D texture mipmap levels.

#define MAX_TEXTURE_LOD_BIAS   12.0

For GL_EXT_texture_lod_bias (typically MAX_TEXTURE_LEVELS - 1).

#define MAX_TEXTURE_MAX_ANISOTROPY   16.0

For GL_EXT_texture_filter_anisotropic.

#define MAX_TEXTURE_RECT_SIZE   4096

Maximum rectangular texture size - GL_NV_texture_rectangle.

#define MAX_TEXTURE_STACK_DEPTH   10

Maximum texture matrix stack depth.

#define MAX_TEXTURE_UNITS   ((MAX_TEXTURE_COORD_UNITS > MAX_TEXTURE_IMAGE_UNITS) ? MAX_TEXTURE_COORD_UNITS : MAX_TEXTURE_IMAGE_UNITS)

Larger of MAX_TEXTURE_COORD_UNITS and MAX_TEXTURE_IMAGE_UNITS.

This value is only used for dimensioning arrays. Either MAX_TEXTURE_COORD_UNITS or MAX_TEXTURE_IMAGE_UNITS (or the corresponding ctx->Const.MaxTextureCoord/ImageUnits fields) should be used almost everywhere else.

#define MAX_UNIFORMS   1024

#define MAX_VARYING   16

number of float[4] vectors

#define MAX_VERTEX_GENERIC_ATTRIBS   16

For GL_ARB_vertex_shader.

#define MAX_VERTEX_PROGRAM_ADDRESS_REGS   1

For GL_ARB_vertex_program.

#define MAX_VERTEX_PROGRAM_PARAMS   MAX_UNIFORMS

#define MAX_VERTEX_TEXTURE_IMAGE_UNITS   MAX_TEXTURE_IMAGE_UNITS

#define MAX_WIDTH   4096

Maximum viewport/image width.

Must accomodate all texture sizes too.

#define MIN_LINE_WIDTH   1.0

Minimum line width.

#define MIN_POINT_SIZE   1.0

Minimum point size.

#define POINT_SIZE_GRANULARITY   0.1

Point size granularity.

#define RCOMP   0

#define STENCIL_BITS   8

Bits per stencil value: 8.

#define SUB_PIXEL_BITS   4

Subpixel precision for antialiasing, window coordinate snapping.

#define SUPPORTED_ATI_BUMP_UNITS   0xff

For GL_ATI_envmap_bump - support bump mapping on first 8 units.

#define TRIANGLE_WALK_DOUBLE   0

If non-zero use GLdouble for walking triangle edges, for better accuracy.

---