README revision 1.1.1.2
1 1.1.1.2 mrg xf86-video-s3virge - S3 ViRGE video driver for the Xorg X server 2 1.1 mrg 3 1.1.1.2 mrg Please submit bugs & patches to the Xorg bugzilla: 4 1.1.1.2 mrg 5 1.1.1.2 mrg https://bugs.freedesktop.org/enter_bug.cgi?product=xorg 6 1.1.1.2 mrg 7 1.1.1.2 mrg All questions regarding this software should be directed at the 8 1.1.1.2 mrg Xorg mailing list: 9 1.1.1.2 mrg 10 1.1.1.2 mrg http://lists.freedesktop.org/mailman/listinfo/xorg 11 1.1.1.2 mrg 12 1.1.1.2 mrg The master development code repository can be found at: 13 1.1.1.2 mrg 14 1.1.1.2 mrg git://anongit.freedesktop.org/git/xorg/driver/xf86-video-s3virge 15 1.1.1.2 mrg 16 1.1.1.2 mrg http://cgit.freedesktop.org/xorg/driver/xf86-video-s3virge 17 1.1.1.2 mrg 18 1.1.1.2 mrg For more information on the git code manager, see: 19 1.1.1.2 mrg 20 1.1.1.2 mrg http://wiki.x.org/wiki/GitPage 21 1.1.1.2 mrg 22 1.1.1.2 mrg ------------------------------------------------------------------------ 23 1.1 mrg What works: 24 1.1 mrg - Supports 8bpp, 15/16bpp, 24bpp and 32bpp. Heavy testing on ViRGE DX. 25 1.1 mrg - There is some known instability in ViRGE GX2, please report problems. 26 1.1 mrg - Silken Mouse is enabled by default, use the generic server option of 27 1.1 mrg -nosilk to disable it. 28 1.1 mrg 29 1.1 mrg XCONFIG options: 30 1.1 mrg 31 1.1 mrg The driver supports quite a few different XConfig options, which can 32 1.1 mrg be used to tune the driver and improve performance. Without any options, 33 1.1 mrg the driver will use conservative settings which should work on most 34 1.1 mrg hardware. Large improvements in performance are possible by selecting 35 1.1 mrg the proper options, which will probably work on most systems. 36 1.1 mrg 37 1.1 mrg Cursor: 38 1.1 mrg 39 1.1 mrg - "hwcursor" "off" behaves exactly like "swcursor". Default: "on" 40 1.1 mrg - "swcursor" will disable the HW Cursor. HW Cursor is used by default and 41 1.1 mrg no option is needed to enable it. 42 1.1 mrg 43 1.1 mrg Display: 44 1.1 mrg - "ShadowFB" Use shadow framebuffer. Disables HW acceleration. Default: off. 45 1.1 mrg - "Rotate" " cw "|" ccw " Rotate the screen CW - clockwise or CCW - counter 46 1.1 mrg clockwise. Disables HW Acceleration and HW Cursor, uses ShadowFB. 47 1.1 mrg Default: no rotation. 48 1.1 mrg - "XVideo" Disable XVideo support by using the off option. This changes FIFO 49 1.1 mrg settings which prevent screen noise for high-res modes. Default: on 50 1.1 mrg 51 1.1 mrg Video memory: 52 1.1 mrg 53 1.1 mrg - "slow_edodram" will switch the standard ViRGE to 2-cycle edo mode. Try this 54 1.1 mrg if you encounter pixel corruption on the ViRGE. Using this option will 55 1.1 mrg cause a large decrease in performance. 56 1.1 mrg - "fpm_vram" will switch the ViRGE/VX to fast page mode vram mode 57 1.1 mrg - "slow_dram " | " fast_dram" Change Trio 3D and 3D/2X memory options. 58 1.1 mrg Default: Use BIOS defaults. 59 1.1 mrg - "early_ras_precharge", "late_ras_precharge" adjust memory parameters. One 60 1.1 mrg of these will us the same settings as your video card defaults, and 61 1.1 mrg using neither in the config file does the same. 62 1.1 mrg - "set_mclk" sets the memory clock, format is: 63 1.1 mrg Option "set_mclk" "50000" 64 1.1 mrg in the XF86Config file. Valid values are any 65 1.1 mrg integer <= 100000, where 100000 == 100 MHz. 66 1.1 mrg - "set_refclk" sets the ref clock for ViRGE MX, format is: 67 1.1 mrg Option "set_refclk" "50000" 68 1.1 mrg 69 1.1 mrg Acceleration and graphic engine: 70 1.1 mrg 71 1.1 mrg - "NoAccel" turns off all acceleration 72 1.1 mrg - "fifo_aggressive", "fifo_moderate" and "fifo_conservative" alter the settings 73 1.1 mrg for the threshold at which the pixel FIFO takes over the internal 74 1.1 mrg memory bus to refill itself. The smaller this threshold, the better 75 1.1 mrg the acceleration performance of the card. You may try the fastest 76 1.1 mrg setting ("aggressive") and move down if you encounter pixel corruption. 77 1.1 mrg The optimal setting will probably depend on dot-clock and on color 78 1.1 mrg depth. Note that specifying any of these options will also alter other 79 1.1 mrg memory settings which should increase performance, so you should at 80 1.1 mrg least use "fifo_conservative" (this uses the chip defaults). 81 1.1 mrg - Common XAA acceleration options to disable primitives for test purposes: 82 1.1 mrg "XaaNoScreenToScreenCopy" 83 1.1 mrg "XaaNoSolidFillRect" 84 1.1 mrg "XaaNoColor8x8PatternFillRect" 85 1.1 mrg "XaaNoImageWriteRect" 86 1.1 mrg "XaaNoPixmapCache" 87 1.1 mrg 88 1.1 mrg PCI bus: 89 1.1 mrg - "pci_burst" will enable PCI burst mode. This should work on all but a 90 1.1 mrg few "broken" PCI chipsets, and will increase performance. Option may 91 1.1 mrg take a parameter "on", "off", "yes", etc... 92 1.1 mrg - "pci_retry" will allow the driver to rely on PCI Retry to program the 93 1.1 mrg ViRGE registers. "pci_burst" must be enabled for this to work. 94 1.1 mrg This will increase performance, especially for small fills/blits, 95 1.1 mrg because the driver does not have to poll the ViRGE before sending it 96 1.1 mrg commands to make sure it is ready. It should work on most 97 1.1 mrg recent PCI chipsets. 98 1.1 mrg 99 1.1 mrg ViRGE MX LCD options: 100 1.1 mrg - "lcd_center" 101 1.1 mrg - "set_lcdclk" allows setting the clock for a ViRGE MX LCD display. Format is: 102 1.1 mrg Option "set_lcdclk" "30000" 103 1.1 mrg in the config file. Valid values are ? 104 1.1 mrg 105 1.1 mrg Debug: 106 1.1 mrg - "ShowCache" Enable or disable viewing offscreen cache memory. A 107 1.1 mrg development debug option. Default: off. 108 1.1 mrg - "mx_cr3a_fix" Enable or disable a cr3a fix added for ViRGE MX. 109 1.1 mrg Default: on. 110 1.1 mrg 111 1.1 mrg 112 1.1 mrg $XFree86: xc/programs/Xserver/hw/xfree86/drivers/s3virge/README,v 1.9 2000/06/14 21:57:54 dawes Exp $ 113
Indexes created Mon Oct 26 00:26:21 UTC 2026