.\" $XFree86: xc/programs/Xserver/hw/xfree86/drivers/ati/r128.man,v 1.3 2001/06/01 02:10:05 dawes Exp $.\" shorthand for double quote that works everywhere..ds q \N'34'.TH R128 __drivermansuffix__ __vendorversion__.SH NAMEr128 \- ATI Rage 128 video driver.SH SYNOPSIS.nf.B "Section \*qDevice\*q".BI "  Identifier \*q"  devname \*q.B  "  Driver \*qr128\*q"\ \ ....B EndSection.fi.SH DESCRIPTION.B r128is an __xservername__ driver for ATI Rage 128 based video cards.  It containsfull support for 8, 15, 16 and 24 bit pixel depths, hardwareacceleration of drawing primitives, hardware cursor, video modes up to1800x1440 @ 70Hz, doublescan modes (e.g., 320x200 and 320x240), gammacorrection at all pixel depths, a fully programming dot clock and robusttext mode restoration for VT switching.  Dualhead is supported on M3/M4mobile chips..SH SUPPORTED HARDWAREThe.B r128driver supports all ATI Rage 128 based video cards including the RageFury AGP 32MB, the XPERT 128 AGP 16MB and the XPERT 99 AGP 8MB..SH CONFIGURATION DETAILSPlease refer to __xconfigfile__(__filemansuffix__) for general configurationdetails.  This section only covers configuration details specific to thisdriver..PPThe driver auto-detects all device information necessary to initializethe card.  However, if you have problems with auto-detection, you canspecify:.PP.RS 4VideoRam - in kilobytes.brMemBase  - physical address of the linear framebuffer.brIOBase   - physical address of the MMIO registers.brChipID   - PCI DEVICE ID.RE.PPIn addition, the following driver.B Optionsare supported:.TP.BI "Option \*qSWcursor\*q \*q" boolean \*qSelects software cursor.  The default is.B off..TP.BI "Option \*qNoAccel\*q \*q" boolean \*qEnables or disables all hardware acceleration.  The default is to.B enablehardware acceleration..TP.BI "Option \*qDac6Bit\*q \*q" boolean \*qEnables or disables the use of 6 bits per color component when in 8 bppmode (emulates VGA mode).  By default, all 8 bits per color componentare used.  The default is.B off..TP.BI "Option \*qVideoKey\*q \*q" integer \*qThis overrides the default pixel value for the YUV video overlay key.The default value is.B undefined..TP.BI "Option \*qDisplay\*q \*q" string \*qSelect display mode for devices which support flat panels. Supported modes are:.B \*qFP\*q- use flat panel;.B \*qCRT\*q- use cathode ray tube;.B \*qMirror\*q- use both FP and CRT;.B \*qBIOS\*q- use mode as configured in the BIOS.The default is.B FP..PPThe following.B Optionsare mostly important for non-x86 architectures:.TP.BI "Option \*qProgramFPRegs\*q \*q" boolean \*qEnable or disable programming of the flat panel registers.Beware that this may damage your panel, so use this.B at your own risk.The default depends on the device..TP.BI "Option \*qPanelWidth\*q \*q" integer \*q.TP.BI "Option \*qPanelHeight\*q \*q" integer \*qOverride the flat panel dimensions in pixels. They are used to program the flat panelregisters and normally determined using the video card BIOS. If the wrong dimensionsare used, the system may hang..TP.BI "Option \*qUseFBDev\*q \*q" boolean \*qEnable or disable use of an OS-specific framebuffer device interface(which is not supported on all OSs).  See fbdevhw(__drivermansuffix__)for further information.Default: .BI on for PowerPC, .BI off for other architectures..TP.BI "Option \*qDMAForXv\*q \*q" boolean \*qTry or don't try to use DMA for Xv image transfers. This will reduce CPUusage when playing big videos like DVDs, but may cause instabilities.Default: off..PPThe following additional.B Optionsare supported:.TP.BI "Option \*qShowCache\*q \*q" boolean \*qEnable or disable viewing offscreen cache memory.  Adevelopment debug option.  Default: off..TP.BI "Option \*qVGAAccess\*q \*q" boolean \*qTell the driver if it can do legacy VGA IOs to the card. This isnecessary for properly resuming consoles when in VGA text mode, butshouldn't be if the console is using radeonfb or some other graphicmode driver. Some platforms like PowerPC have issues with those, and they aren'tnecessary unless you have a real text mode in console. The default is.B offon PowerPC and.B onon other architectures..PP.B 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 videooutput switch (e.g., fn-f7, etc.) prior to starting X or switch toanother VT and back..SH "SEE ALSO"__xservername__(__appmansuffix__), __xconfigfile__(__filemansuffix__), xorgconfig(__appmansuffix__), Xserver(__appmansuffix__), X(__miscmansuffix__).SH AUTHORS.nfRickard E. (Rik) Faith   \fIfaith@precisioninsight.com\fPKevin E. Martin          \fIkevin@precisioninsight.com\fP