mpv/drivers/radeon
nick 8f1b0f7bee Minor improvements
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@3254 b3059339-0415-0410-9bf9-f77b7e298cf2
2001-12-01 20:23:47 +00:00
..
Makefile Minor improvements 2001-12-01 20:23:47 +00:00
README Minor improvements 2001-12-01 20:23:47 +00:00
hacking Sorry for inexactitude 2001-11-29 17:06:58 +00:00
radeon.h radeon_vid new features: 2001-11-27 18:36:02 +00:00
radeon_vid.c Minor improvements 2001-12-01 20:23:47 +00:00
radeon_vid.h Probably ugly attempt to fix Rage128 problems 2001-11-29 17:07:52 +00:00
radeonfb.c Enable discards - now it works 2001-10-11 06:24:17 +00:00

README

	framebuffer driver for ATI Radeon chipset video boards
	======================================================

These files are replacement for linux-2.4.x-ac.y drivers.
To use this driver you should have at least linux-2.4.5-ac.1
then simply replace linux/drivers/video/radeon* with files
from this directory.
Note: since linux-2.4.10 this driver was moved from -ac to
Linus distribution.

Alternative way:
~~~~~~~~~~~~~~~~
Simply type two commands in this directory:
make
make install

Anyway you should have 'Frame buffer support' compiled into linux-kernel
and at least '8bpp packed pixel support' compiled and installed as module.  
(But if you plan to use this module with mplayer you also should have
16bpp, 24bpp and 32bpp pixel support compiled as modules).  


                      Radeon video overlay
		      ====================
		      
Was designed for mplayer and currently can be used only by mplayer.
It's RGB-YUV BES for radeon cards (althrough there is experimental
support for rage128 / rage128pro chips).

Installation:
~~~~~~~~~~~~~

Simply type two commands in this directory:
make
make install
If you install it first time then type also:
make nodes

Using with mplayer:
~~~~~~~~~~~~~~~~~~~

Currently there is only way to use ATI's drivers:
mplayer -vo vesa:lvo:/dev/radeon_vid -<your options> filename
or
mplayer -vo vesa:lvo:/dev/rage128_vid -<your options> filename

Configuring:
~~~~~~~~~~~~

You can tune up some parameters with using following trick:
echo "parameter=value">/dev/radeon_vid
Example (disables adaptive deinterlacing):
echo "deinterlace=off">/dev/radeon_vid

To know more about these parameters - try read /dev/radeon_vid file ;)
Note: don't use 'cat' since it can't detect EOF during reading such files.
(I use midnight commander for that ;)
or try this:
head -n 20 /dev/radeon_vid

List of parameters:
~~~~~~~~~~~~~~~~~~~
brightness=decval          (-64:+63) doesn't work on radeons
saturation=decval          (0:+31) doesn't work on radeons
double_buff=on/off         enables/disables double buffering
colour_key=hexval          defines colour key
deinterlace=on/off         enables/disables adaprive deinterlacing
deinterlace_pattern=hexval defines deinterlacing pattern

Note:
~~~~~
You can pass only options with can be recognized by vo_vesa driver.
(Indeed radeon_vid and rage128_vid are stupid things and can create
video overlay only. But mode switching and other adjustement performs
vo_vesa driver. This mean that they use VESA BIOS as graphics server).

Conslusion:
~~~~~~~~~~~
This stuff (radeon(rage128)_vid) currently doesn't support any standards.
So after implementing linux standards I'll fully rewrite this driver.

Enjoy