home *** CD-ROM | disk | FTP | other *** search
/ AmigActive 6 / AACD06.ISO / AACD / System / Mesa-3.1 / docs / CONFIG next >
Text File  |  1999-04-21  |  4KB  |  121 lines
  1.  
  2.                       Mesa config file documentation
  3.  
  4.  
  5. As of Mesa 3.1 beta 2, a config file can be used to configure various
  6. Mesa parameters.  For example, extensions can be enable/disabled,
  7. glHints can be specified, etc.  More config options will be added
  8. in the future.
  9.  
  10. The config file uses a Lisp-like syntax.
  11.  
  12. Here's Keith's description of the file with a few examples.
  13.  
  14.  
  15.  
  16. ;; -*-lisp-*-
  17. ;;
  18. ;; KW: New mesa configuration file, syntax following a lisp style.
  19. ;;
  20. ;; valid syntax:
  21. ;;
  22. ;; (config-mesa version configs)
  23. ;;
  24. ;; where:
  25. ;;    version - is the version number of mesa for which the configuration
  26. ;;    was written.  Future versions will use this to check for upwards
  27. ;;    compatibility.  There is however no guarentee that old configurations
  28. ;;    will continue to be respected.
  29. ;;
  30. ;;    configs - is a list of valid configuration lists, as specified by:
  31. ;;
  32. ;;       (default-hint variable value)
  33. ;;       (disable-extension name)
  34. ;;       (fx-catch-signals {true|false})
  35. ;;
  36. ;; Mesa will look for an environment variable MESA_CONFIG, and try to
  37. ;; execute that profile.  Otherwise, it will fallback to the profile
  38. ;; with the same name as the current mesa version.  As default
  39. ;; profiles should normally be empty or near-empty, this should be
  40. ;; sufficiently powerful.
  41. ;;
  42.  
  43.  
  44. ;; Guareenteed to be an empty config.
  45. ;;
  46. (config-mesa empty ())
  47.  
  48.  
  49. ;; Default profile - should normally be an empty list of
  50. ;; configurations.
  51. ;;
  52. (config-mesa mesa3.1beta1 ())
  53.  
  54.  
  55. (config-mesa no-cva ((disable-extension GL_EXT_compiled_vertex_array)))
  56.  
  57.  
  58. ;; Turn off some compliance for the sake of speed.
  59. ;;
  60. (config-mesa quake2
  61.  (
  62.   ;; Quake2 likes this extension, but it really hurts performance if
  63.   ;; you don't also disable software fallbacks, below.  (And do
  64.   ;; something else to stop the eye-space calculations too...)
  65.   ;;
  66.   (disable-extension GL_EXT_point_parameters)
  67.  
  68.   ;; These hints are honoured only by the 3dfx driver - the X driver
  69.   ;; continues to function even if you specify hardware-only
  70.   ;; rendering.
  71.   ;;
  72.   ;(default-hint GL_ALLOW_DRAW_OBJ_HINT_PGI GL_TRUE)   ; wishful thinking
  73.   ;(default-hint GL_ALLOW_DRAW_WIN_HINT_PGI GL_TRUE)   ; allow 3dfx 
  74. hardware...
  75.   ;(default-hint GL_ALLOW_DRAW_SPN_HINT_PGI GL_FALSE)  ; no software spans
  76.   ;(default-hint GL_ALLOW_DRAW_MEM_HINT_PGI GL_FALSE)  ; no softare pixels
  77.  
  78.   ;; Lock in the hints specified above.
  79.   ;;
  80.   (disable-extension GL_PGI_misc_hints)))
  81.  
  82.  
  83. ;; Turn off some compliance for the sake of speed.
  84. ;;
  85. (config-mesa quake2b
  86.  (
  87.   ;; Quake2 likes this extension, but it really hurts performance if
  88.   ;; you don't also disable software fallbacks, below.  (And do
  89.   ;; something else to stop the eye-space calculations too...)
  90.   ;;
  91.   ;(disable-extension GL_EXT_point_parameters)
  92.  
  93.   ;; These hints are honoured only by the 3dfx driver - the X driver
  94.   ;; continues to function even if you specify hardware-only
  95.   ;; rendering.
  96.   ;;
  97.   (default-hint GL_ALLOW_DRAW_OBJ_HINT_PGI GL_TRUE)   ; wishful thinking
  98.   (default-hint GL_ALLOW_DRAW_WIN_HINT_PGI GL_TRUE)   ; allow 3dfx 
  99. hardware...
  100.   (default-hint GL_ALLOW_DRAW_SPN_HINT_PGI GL_FALSE)  ; no software spans
  101.   (default-hint GL_ALLOW_DRAW_MEM_HINT_PGI GL_FALSE)  ; no softare pixels
  102.  
  103.   ;; Lock in the hints specified above.
  104.   ;;
  105.   (disable-extension GL_PGI_misc_hints)))
  106.  
  107.  
  108. ;; Just some reminders for me.
  109. ;;
  110. (config-mesa todo-list
  111.  (
  112.   ;; Allows us to slot in simpler lighting routines - not
  113.   ;; implemented.
  114.   ;;
  115.   (default-hint GL_STRICT_POINT_DISTANCE_HINT_MESA GL_FALSE)
  116.   (default-hint GL_STRICT_LIGHTING_HINT_PGI GL_FALSE)))
  117.  
  118.  
  119. ----------------------------------------------------------------------
  120. $Id: CONFIG,v 1.1 1999/04/22 02:17:29 brianp Exp $
  121.