voodoo.man 2.8 KB

123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172
  1. .\" shorthand for double quote that works everywhere.
  2. .ds q \N'34'
  3. .TH VOODOO __drivermansuffix__ __vendorversion__
  4. .SH NAME
  5. voodoo \- Voodoo video driver
  6. .SH SYNOPSIS
  7. .nf
  8. .B "Section \*qDevice\*q"
  9. .BI " Identifier \*q" devname \*q
  10. .B " Driver \*qvoodoo\*q"
  11. \ \ ...
  12. .B EndSection
  13. .fi
  14. .SH DESCRIPTION
  15. .B voodoo
  16. is an __xservername__ driver for Voodoo 1 and Voodoo 2 series video adapters.
  17. On the Voodoo 1 the driver uses a shadow buffer in system memory as
  18. the video adapter has only 3D acceleration. Selected portions of the shadow
  19. framebuffer are copied out to the Voodoo board at the right time. Because
  20. of this, the speed of the driver is very dependent on the CPU. Processors
  21. nowadays are actually rather fast at moving data so we get very good speed
  22. anyway as the shadow framebuffer is in cached RAM.
  23. .PP
  24. The Voodoo2 has 16bpp acceleration and the driver provides accelerated
  25. versions of most operations except angled lines and stipples. Accelerated
  26. alpha blending with the Render extension is also supported as is DGA.
  27. .PP
  28. This driver supports 16bpp modes currently. The video hardware supports
  29. image conversion from 24bpp to 16bpp but the hardware is 16bpp only.
  30. .PP
  31. The Voodoo 1 series cards can go up to 800x600 resolution while the
  32. Voodoo 2 can reach 1024x768 providing it has at least 2Mb of frame
  33. buffer memory. 1024x768 2D mode does not require two cards configured in
  34. scan-line interleave mode (SLI).
  35. .PP
  36. Multihead and Xinerama configurations are supported. SLI configurations will
  37. be treated as multiple video cards.
  38. .PP
  39. Limited support for DPMS screen saving is available. The "standby" and
  40. "suspend" modes are just painting the screen black. The "off" mode turns
  41. the Voodoo board off and thus works correctly.
  42. .PP
  43. This driver does not support a virtual screen size different from the
  44. display size. This is a hardware limitation. 3D rendering is also not
  45. supported.
  46. .SH CONFIGURATION DETAILS
  47. Please refer to __xconfigfile__(__filemansuffix__) for general configuration
  48. details. This section only covers configuration details specific to this
  49. driver.
  50. .PP
  51. The following driver
  52. .B Options
  53. are supported:
  54. .TP
  55. .BI "Option \*qShadowFB\*q \*q" boolean \*q
  56. Enables a shadow buffer in main memory. This turns off acceleration but for
  57. otherwise unaccelerated operations can improve performance materially.
  58. Default: off for voodoo2, on for voodoo1.
  59. .TP
  60. .BI "Option \*qNoAccel\*q \*q" boolean \*q
  61. Disables acceleration if set. Unless debugging this option should only
  62. be set if ShadowFB is enabled.
  63. Default: off for voodoo2, on for voodoo1.
  64. .SH "BUGS"
  65. The driver interacts badly with the
  66. sstfb frame buffer driver as there is insufficient information to restore
  67. the chip to its previous state.
  68. .SH "SEE ALSO"
  69. __xservername__(1), __xconfigfile__(__filemansuffix__), Xserver(1), X(__miscmansuffix__)
  70. .SH AUTHORS
  71. Authors: Alan Cox, Ghozlane Toumi, Henrik Harmsen.