view drivers/radeon/README @ 4218:3931c41f740a

Added new syncengine thanks to a new previously undocumented feature of the em8300, this might fix playback on both slow and fast machines (more testing needed). This also requires users to get the em8300 driver from cvs until the next version is released (will probably happen this weekend) Added lots of comments, should be pretty easy to understand most of the internals now Added lots of brackets to if's for's while's etc, this is not a cosmetical thing but rather due to the fact I got some very odd bugs with else's since I didn't properly use brackets (and it's the K&R standard to have brackets everywhere) Fixed some bugs that would occur when disabling libmp1e Switched to default to the new naming scheme of device nodes, the driver will slowly switch over to this state, if it can't find devices under the new name it will try the old naming scheme I stopped opening devices in non-blocking mode, it would break the new syncengine which tries to burst data to the device (alot of times meaning it will fill the fifo pretty fast which would previously result in jerkyness on fast machines) The device now sets the initial state of the pts and speed (probably not needed, but assumption is the mother of all fuckups =) Keep the control interface open during the entire duration of the libvo device, we might need this to flush video buffers on seeking (currently not implemented, therefore seeking is broken) This is beta stuff to the driver, I will get some users to test it for me and do my best to fix seeking as soon as possible...

	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 vesa's options> filename
or
mplayer -vo vesa:lvo:/dev/rage128_vid -<your vesa's options> filename

For YV12 formats you can use also:
mplayer -vo mga:/dev/radeon_vid -<your mga's option> filename

but in this case you should load at least radeonfb driver from
this package.

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 ;)
For example:
cat /dev/radeon_vid

List of parameters:
~~~~~~~~~~~~~~~~~~~
if you have rage128 chip:
brightness=decval          (-64:+63) changes brightness
saturation=decval          (0:+31) changes saturation 0 == grayscaled mode
else - if you have radeon:
brightness=decval          (-1000:+1000) -1000 == black screen 
saturation=decval          (-1000:+1000) -1000 == grayscaled mode
contrast=decval            (-1000:+1000) -1000 == black screen
hue=decval                 (-1000:+1000) -1000 == +1000 (full circle)
                           all other values are within this range
Note: 0 is default value for every parameter on radeons
WARNING: This driver violates rule: "no float in the kernel".
So if you have problems then don't use color correction and
tell me about these problems.

double_buff=on/off         enables/disables double buffering
deinterlace=on/off         enables/disables adaprive deinterlacing
deinterlace_pattern=hexval defines deinterlacing pattern

Driver parameters:
~~~~~~~~~~~~~~~~~~

You can use some additional parameters during module loading:
Example:
modprobe radeon_vid swap_fourcc=1

List of driver's parameters:
~~~~~~~~~~~~~~~~~~~~~~~~~~~~
mtrr=1/0                   configures MTRR (if available) default = 1
swap_fourcc=1/0            performs byte swapping of passed fourcc.
			   (It's required for compatibility with -vo mga)
			   
To know more about driver's parameters execute:
modinfo radeon_vid
or
modinfo rage128_vid
			   
Note:
~~~~~
For command line of mplayer: 
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.

Full example:
~~~~~~~~~~~~~
modprobe radeon_vid mtrr=1
echo "deinterlace_pattern=F0055555">/dev/radeon_vid
mplayer -vo vesa:lvo:/dev/radeon_vid -fs -zoom -bpp 32 filename

Enjoy!