Provided by: xserver-xorg-video-r128_6.12.1-1_amd64 bug

NAME

       r128 - ATI Rage 128 video driver

SYNOPSIS

       Section "Device"
         Identifier "devname"
         Driver "r128"
         ...
       EndSection

DESCRIPTION

       r128  is  an Xorg driver for ATI Rage 128 based video cards.  It contains full support for
       8, 15, 16 and 24 bit pixel depths, hardware acceleration of drawing  primitives,  hardware
       cursor,  video modes up to 1800x1440 @ 70Hz, doublescan modes (e.g., 320x200 and 320x240),
       gamma correction at all pixel depths, a fully programming dot clock and robust  text  mode
       restoration for VT switching.  Dualhead is supported on M3/M4 mobile chips.

SUPPORTED HARDWARE

       The  r128  driver  supports all ATI Rage 128 based video cards including the Rage Fury AGP
       32MB, the XPERT 128 AGP 16MB and the XPERT 99 AGP 8MB.

CONFIGURATION DETAILS

       Please refer to xorg.conf(5) for general configuration details.  This section only  covers
       configuration details specific to this driver.

       The driver auto-detects all device information necessary to initialize the card.  However,
       if you have problems with auto-detection, you can specify:

           VideoRam - in kilobytes
           MemBase  - physical address of the linear framebuffer
           IOBase   - physical address of the MMIO registers
           ChipID   - PCI DEVICE ID

       In addition, the following driver Options are supported:

       Option "SWcursor" "boolean"
              Selects software cursor.  The default is off.

       Option "NoAccel" "boolean"
              Enables or disables all hardware acceleration.  The default is to  enable  hardware
              acceleration.

       Option "EnablePageFlip" "boolean"
              Enable  page  flipping  for 3D acceleration. This will increase performance but not
              work correctly in some rare cases, hence the default is off.

       Option "RenderAccel" "boolean"
              Enables or disables hardware Render acceleration.  It is only supported when  using
              EXA acceleration and DRI.  The default is to enable Render acceleration.

       Option "AccelMethod" "string"
              Chooses  between  available  acceleration architectures.  Valid options are XAA and
              EXA.  XAA is the traditional acceleration architecture and support for it  is  very
              stable.   EXA  is a newer acceleration architecture with better performance for the
              Render and Composite extensions.  The default is XAA.

       Option "VideoKey" "integer"
              This overrides the default pixel value for the YUV video overlay key.  The  default
              value is undefined.

       The following Options are mostly important for non-x86 architectures:

       Option "ProgramFPRegs" "boolean"
              Enable  or  disable  programming of the flat panel registers.  Beware that this may
              damage your panel, so use this at your  own  risk.   The  default  depends  on  the
              device.

       Option "PanelWidth" "integer"

       Option "PanelHeight" "integer"
              Override  the  flat  panel  dimensions in pixels. They are used to program the flat
              panel registers and normally determined using the video card  BIOS.  If  the  wrong
              dimensions are used, the system may hang.

       Option "UseFBDev" "boolean"
              Enable  or disable use of an OS-specific framebuffer device interface (which is not
              supported on all OSs).  See fbdevhw(4) for further information.   Default:  on  for
              PowerPC, off for other architectures.

       Option "DMAForXv" "boolean"
              Try or don't try to use DMA for Xv image transfers. This will reduce CPU usage when
              playing big videos like DVDs, but may cause instabilities.  Default: off.

       The following additional Options are supported:

       Option "ShowCache" "boolean"
              Enable or disable viewing offscreen cache  memory.   A  development  debug  option.
              Default: off.

       Option "VGAAccess" "boolean"
              Tell  the  driver  if  it  can do legacy VGA IOs to the card. This is necessary for
              properly resuming consoles when in VGA text mode, but shouldn't be if  the  console
              is  using  radeonfb  or some other graphic mode driver. Some platforms like PowerPC
              have issues with those, and they aren't necessary unless you have a real text  mode
              in console. The default is off on PowerPC and SPARC and on on other architectures.

       Dualhead Note: The video BIOS on some laptops interacts strangely with dualhead.  This can
       result in flickering and problems changing  modes  on  crtc2.   If  you  experience  these
       problems  try  toggling  your  laptop's  video  output switch (e.g., fn-f7, etc.) prior to
       starting X or switch to another VT and back.

SEE ALSO

       Xorg(1), xorg.conf(5), Xserver(1), X(7)

AUTHORS

       Rickard E. (Rik) Faith   faith@precisioninsight.com
       Kevin E. Martin          kevin@precisioninsight.com