xorg-server-1.4/hw/xfree86/Options

   1 !!
   2 !! Copyright (c) 2001 by The XFree86 Project, Inc.
   3 !!
   4 !! Permission is hereby granted, free of charge, to any person obtaining a
   5 !! copy of this software and associated documentation files (the "Software"),
   6 !! to deal in the Software without restriction, including without limitation
   7 !! the rights to use, copy, modify, merge, publish, distribute, sublicense,
   8 !! and/or sell copies of the Software, and to permit persons to whom the
   9 !! Software is furnished to do so, subject to the following conditions:
  10 !!
  11 !! The above copyright notice and this permission notice shall be included in
  12 !! all copies or substantial portions of the Software.
  13 !!
  14 !! THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
  15 !! IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
  16 !! FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.  IN NO EVENT SHALL
  17 !! THE XFREE86 PROJECT BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY,
  18 !! WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF
  19 !! OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
  20 !! SOFTWARE.
  21 !!
  22 !! Except as contained in this notice, the name of the XFree86 Project shall
  23 !! not be used in advertising or otherwise to promote the sale, use or other
  24 !! dealings in this Software without prior written authorization from the
  25 !! XFree86 Project.
  26 !!
  27 !! $XFree86: xc/programs/Xserver/hw/xfree86/Options,v 1.10 2003/02/15 06:46:30 paulo Exp $
  28
  29 !! XAA options
  30 xaa.XaaNoCPUToScreenColorExpandFill:\
  31 Disables accelerated rectangular expansion blits from source patterns \
  32 stored in system memory (using a memory-mapped aperture).
  33
  34 xaa.XaaNoColor8x8PatternFillRect:\
  35 Disables accelerated fills of a rectangular region with a full-color pattern.
  36
  37 xaa.XaaNoColor8x8PatternFillTrap:\
  38 Disables accelerated fills of a trapezoidal region with a full-color pattern.
  39
  40 xaa.XaaNoDashedBresenhamLine:\
  41 Disables accelerated dashed Bresenham line draws.
  42
  43 xaa.XaaNoDashedTwoPointLine:\
  44 Disables accelerated dashed line draws between two arbitrary points.
  45
  46 xaa.XaaNoImageWriteRect:\
  47 Disables acclerated transfers of full-color rectangular patterns from  \
  48 system memory to video memory (using a memory-mapped aperture).
  49
  50 xaa.XaaNoMono8x8PatternFillRect:\
  51 Disables accelerated fills of a rectangular region with a monochrome pattern.
  52
  53 xaa.XaaNoMono8x8PatternFillTrap:\
  54 Disables accelerated fills of a trapezoidal region with a monochrome pattern.
  55
  56 xaa.XaaNoOffscreenPixmaps:\
  57 Disables accelerated draws into pixmaps stored in offscreen video memory.
  58
  59 xaa.XaaNoPixmapCache:\
  60 Disables caching of patterns in offscreen video memory.
  61
  62 xaa.XaaNoScanlineCPUToScreenColorExpandFill:\
  63 Disables accelerated rectangular expansion blits from source patterns \
  64 stored in system memory (one scan line at a time).
  65
  66 xaa.XaaNoScanlineImageWriteRect:\
  67 Disables accelerated transfers of full-color rectangular patterns from \
  68 system memory to video memory (one scan line at a time).
  69
  70 xaa.XaaNoScreenToScreenColorExpandFill:\
  71 Disables accelerated rectangular expansion blits from source patterns \
  72 stored in off-screen video memory.
  73
  74 xaa.XaaNoScreenToScreenCopy:\
  75 Disables accelerated copies of rectangular regions from one part of video \
  76 memory to another part of video memory.
  77
  78 xaa.XaaNoSolidBresenhamLine:\
  79 Disables accelerated solid Bresenham line draws.
  80
  81 xaa.XaaNoSolidFillRect:\
  82 Disables accelerated solid-color fills of rectangles.
  83
  84 xaa.XaaNoSolidFillTrap:\
  85 Disables accelerated solid-color fills of Bresenham trapezoids.
  86
  87 xaa.XaaNoSolidHorVertLine:\
  88 Disables accelerated solid horizontal and vertical line draws.
  89
  90 xaa.XaaNoSolidTwoPointLine:\
  91 Disables accelerated solid line draws between two arbitrary points.
  92
  93
  94 !! DDC Options
  95 ddc.NoDDC:\
  96 Disables DDC (Display Data Channel) so that the Xserver doesn't try to talk to\
  97 the Monitor. \
  98 Default: off, implies DDC is used.
  99
 100 ddc.NoDDC1:\
 101 Disables use of DDC version 1 (DDC using vertical refresh). \
 102 Default: off, implies DDC1 is used.
 103
 104 ddc.NoDDC2:\
 105 Disables use of DDC version 2 (DDC using I2C - usually over vga connector). \
 106 Default: off, implies DDC2 is used.
 107
 108
 109 !! FBDev options
 110 fbdev.fbdev:\
 111 The framebuffer device to use. \
 112 Default: /dev/fb0.
 113
 114 fbdev.ShadowFB:\
 115 Enable or disable use of the shadow framebuffer layer. \
 116 Default: on.
 117
 118 fbdev.Rotate:\
 119 Enable rotation of the display. The supported values are "CW" (clockwise, \
 120 90 degrees), "UD" (upside down, 180 degrees) and "CCW" (counter clockwise, \
 121 270 degrees). Implies use of the shadow framebuffer layer. \
 122 Default: off.
 123
 124
 125 !! MGA options
 126 mga.ColorKey:\
 127 Set the colormap index used for the transparency key for the depth 8 plane \
 128 when operating in 8+24 overlay mode. The value must be in the range 2-255. \
 129 Default: 255.
 130
 131 !mga.HWcursor:\
 132 !Enable or disable the HW cursor. Default: on.
 133
 134 mga.MGASDRAM:\
 135 Specify whether G100, G200 or G400 cards have SDRAM. The driver attempts to \
 136 auto-detect this based on the card's PCI subsystem ID. This option may be \
 137 used to override that auto-detection. The mga driver is not able to \
 138 auto-detect the presence of of SDRAM on secondary heads in multihead \
 139 configurations so this option will often need to be specified in multihead \
 140 configurations. Default: auto-detected.
 141
 142 mga.NoAccel:\
 143 Disable or enable 2D hardware acceleration. Default: acceleration is enabled.
 144
 145 mga.OverclockMem:\
 146 Set clocks to values used by some commercial X-Servers (G100, G200 and \
 147 G400 only). Default: off.
 148
 149 mga.Overlay:\
 150 Enable 8+24 overlay mode. Only appropriate for depth 24. (Note: the G100 is \
 151 unaccelerated in the 8+24 overlay mode due to a missing hardware feature). \
 152 Default: off.
 153
 154 mga.PciRetry:\
 155 Enable or disable PCI retries. Default: off.
 156
 157 mga.Rotate:\
 158 Rotate the display clockwise or counterclockwise. This mode is unaccelerated. \
 159 Default: no rotation.
 160
 161 mga.ShadowFB:\
 162 Enable or disable use of the shadow framebuffer layer. Default: off. \
 163
 164 mga.SyncOnGreen:\
 165 Enable or disable combining the sync signals with the green signal. \
 166 Default: off.
 167
 168 mga.UseFBDev:\
 169 Enable or disable use of on OS-specific fb interface (and is not supported \
 170 on all OSs). See fbdevhw(4) for further information. Default: off.
 171
 172 mga.VideoKey:\
 173 This sets the default pixel value for the YUV video overlay key. \
 174 Default: undefined.
 175
 176 mga.TexturedVideo:\
 177 This has XvImage support use the texture engine rather than the video \
 178 overlay. This option is only supported by the G200 and G400, and only in \
 179 16 and 32 bits per pixel. Default: off.
 180
 181 mga.NoHal:\
 182 Matrox provides a "Hardware Abstraction Layer", \
 183 a separate binary which enables extra hardware features from G400 onwards. \
 184 Default: HAL is used.
 185
 186 !mga.DigitalScreen:\
 187 ! Option Ignored. Drivers auto-detect Digital output if they support it at all.
 188 !Default: Auto-detected.
 189
 190 ! mga.TV:\
 191 ! Option Ignored. Drivers auto-detect TV if they support TV out at all.
 192 !Default: Auto-detected.
 193
 194 mga.TVStandard:\
 195 (HAL only) Picture standard for TV out. Use "PAL" for 50Hz PAL. \
 196 Default: 60Hz NTSC.
 197
 198 mga.CableType:\
 199 (HAL only) Set the cable type for TV out. Options are "SCART_RGB", \
 200 "SCART_COMPOSITE", or "SCART_TYPE2". Any other string enables the default. \
 201 Default: YC_COMPOSITE.
 202
 203 mga.SwappedHead:\
 204 (HAL only) For Dual Head cards, reverse relationship between CRTC picture \
 205 generators and video output sockets. \
 206 Especially useful with TV or digital outputs. \
 207 Default: CRTC1 generates output for socket 1 and CRTC2 generates output for socket 2.
 208
 209 mga.Crtc2Half:\
 210 In dual head mode, allow CRTC2 to use half of the video memory. \
 211 Default: CRTC2 uses min{8MB, half video RAM}, but see also Crtc2Ram.
 212
 213 mga.Crtc2Ram:\
 214 In dual head mode, CRTC2 will use this many KB of video memory. \
 215 Overrrides Crtc2Half. \
 216 Default: CRTC2 uses min{8MB, half video RAM}, but see also Crtc2Half.
 217
 218 mga.ShowCache:\
 219 An option for hackers. The pixmap cache lives in off-screen video memory. \
 220 This option extends the virtual desktop to show this part of video memory. \
 221 Default: Off.
 222
 223 mga.AGPMode:\
 224 AGP bus speed multiplier, used by DRI. \
 225 Default: x1 (slowest but most stable).
 226
 227
 228 !! R128 options
 229
 230 !r128.SWcursor: \
 231 !Selects software cursor. \
 232 !Default: off.
 233
 234 r128.NoAccel:\
 235 Enables or disables all hardware acceleration. \
 236 Default: on.
 237
 238 r128.Dac6Bit:\
 239 Enables or disables the use of 6 bits per color component when in 8 bpp \
 240 mode (emulates VGA mode). \
 241 Default: off.
 242
 243 r128.VideoKey:\
 244 This overrides the default pixel value for the YUV video overlay key. \
 245 Default: undefined.
 246
 247 r128.Display:\
 248 Select display mode for devices which support flat panels. Supported\
 249 modes are "FP", "CRT", "Mirror", "BIOS". \
 250 Default: "FP".
 251
 252 r128.ProgramFPRegs:\
 253 Enable or disable programming of the flat panel registers.\
 254 Beware that this may damage your panel, so use at your own risk. \
 255 Default: device dependant.
 256
 257 r128.PanelWidth:\
 258 Override flat panel width in pixels. \
 259 Default: determined using BIOS.
 260
 261 r128.PanelHeight:\
 262 Override flat panel height in pixels. \
 263 Default: determined using BIOS.
 264
 265 r128.UseFBDev:\
 266 Enable or disable use of on OS-specific fb interface (and is not supported \
 267 on all OSs). See fbdevhw(4) for further information. Default: off.
 268
 269 r128.DMAForXv:\
 270 Try or don't try to use DMA for Xv image transfers. This will reduce CPU \
 271 usage when playing big videos like DVDs, but may cause instabilities. \
 272 Default: off.
 273
 274
 275 !! Radeon options
 276
 277 radeon.SWcursor:\
 278 Selects software cursor. Default: off.
 279
 280 radeon.NoAccel:\
 281 Disables all hardware acceleration. Default: off.
 282
 283 radeon.Dac6Bit:\
 284 Enables or disables the use of 6 bits per color component when in 8 bpp \
 285 mode (emulates VGA mode). Default: off.
 286
 287 radeon.VideoKey:\
 288 This overrides the default pixel value for the YUV video overlay key. \
 289 Default: undefined.
 290
 291 radeon.UseFBDev:\
 292 Enable or disable use of an OS-specific framebuffer device interface \
 293 (which is not supported on all OSs). Default: off.
 294
 295 radeon.AGPMode:\
 296 Set AGP data transfer rate. (used only when DRI is enabled) \
 297 Valid choices: 1 (default), 2 and 4
 298
 299 radeon.AGPFastWrite:\
 300 Enable AGP fast write. (used only when DRI is enabled) \
 301 Default: off.
 302
 303 radeon.ForcePCIMode:\
 304 Force to use PCI GART for DRI acceleration. (used only when DRI is enabled) \
 305 Default: off.
 306
 307 radeon.DDCMode:\
 308 Force to use the modes queried from the connected monitor. Default: off.
 309
 310 radeon.CloneDisplay:\
 311 This option is only used for dual-head cards with only single screen section \
 312 specified in the configuration file. Valid choices: \
 313 0 - disable (one CRTC used for both heads) \
 314 1 - auto-detect (default) \
 315 2 - force on \
 316 3 - auto-detect + 2nd head overlay \
 317 4 - force on + 2nd head overlay \
 318
 319 radeon.CloneMode:\
 320 Set the first mode for the secondary head. It can be different from the modes \
 321 used for the primary head. If you don't have this line while clone is on, the \
 322 modes specified for the primary head will be used for the secondary head.
 323
 324 radeon.CloneHSync:\
 325 Set the horizontal sync range for the secondary monitor. It is not required if \
 326 a DDC capable monitor is connected. Default: undefined.
 327
 328 radeon.CloneVRefresh:\
 329 Set the vertical refresh range for the secondary monitor. It is not required \
 330 if a DDC capable monitor is connected. Default: undefined.
 331
 332 radeon.PanelOff:\
 333 Disable panel output. Only used when clone is enabled. Default: off.
 334
 335 radeon.EnablePageFlip:\
 336 Enable page flipping for 3D acceleration. This will increase performance but \
 337 not work correctly in some rare cases. Default: off.
 338
 339
 340 !! NeoMagic options
 341
 342 neo.StrangeLockups:\
 343 Before XFree86 version 4.2.0 many NeoMagic systems experienced \
 344 strange lockups unless they used the options \
 345 "XaaNoScanlineImageWriteRect" and "XaaNoScanlineCPUToScreenColorExpandFill". \
 346 Setting this to "No" is faster but will lock some machines. \
 347 Default: Yes.
 348
 349 !! Vesa options
 350 vesa.ShadowFB:\
 351 Enable or disable use of the shadow framebuffer layer. See shadowfb(4)\
 352 for further information. Default: on.
 353
 354
 355 !! SiS Options
 356 sis.NoAccel:\
 357 Disable or enable acceleration. \
 358 Default: acceleration is enabled.
 359
 360 !sis.HWcursor:\
 361 !Enable or disable the HW cursor. \
 362 !Default: on.
 363
 364 !sis.SWcursor:\
 365 !The opposite of HWCursor. \
 366 !Default: on.
 367
 368 sis.NoXVideo:\
 369 Disable XV (XVideo) extension support. \
 370 Default: off.
 371
 372 sis.SetMClk:\
 373 Set the memory clock in MHz. \
 374 Default: autodetect.
 375
 376 sis.PciRetry:\
 377 Enable or disable PCI retries. \
 378 Default: on.
 379
 380 sis.TurboQueue:\
 381 Enable or disable TurboQueue mode. \
 382 Default: off for SIS530, on for the others.
 383
 384 sis.FastVram:\
 385 Enable or disable FastVram mode. \
 386 Default: on.
 387
 388 sis.Rotate:\
 389 Rotate the display clockwise (CW) or counterclockwise (CCW). \
 390 This mode is unaccelerated, and uses the Shadow Frame Buffer layer \
 391 Default: no rotation.
 392
 393 sis.ForceCRT2Type:\
 394 Force display type to one of: TV, LCD or VGA. \
 395 Default: autodetect.
 396
 397 sis.ShadowFB:\
 398 Enable or disable use of the shadow framebuffer layer. See shadowfb(4) for \
 399 further information. Default: off.
 400
 401 !! Generic driver options, apply to many drivers
 402
 403 *.SWcursor:\
 404 See also HWcursor.\
 405 Default: Usually Off.
 406
 407 *.HWcursor:\
 408 Use the hardware cursor. See also SWcursor. \
 409 Default: usually HWcursor, but some drivers may default to software.