Mercurial > mplayer.hg
annotate drivers/radeon/README @ 20427:cca07f6ff5b6
Sync with upstream r201.
author | diego |
---|---|
date | Wed, 25 Oct 2006 13:08:08 +0000 |
parents | d30207dfe25a |
children | e31e2699d9c1 |
rev | line source |
---|---|
1921 | 1 framebuffer driver for ATI Radeon chipset video boards |
2 ====================================================== | |
3 | |
1919 | 4 These files are replacement for linux-2.4.x-ac.y drivers. |
5 To use this driver you should have at least linux-2.4.5-ac.1 | |
6 then simply replace linux/drivers/video/radeon* with files | |
7 from this directory. | |
1968 | 8 Note: since linux-2.4.10 this driver was moved from -ac to |
9 Linus distribution. | |
1919 | 10 |
1921 | 11 Alternative way: |
12 ~~~~~~~~~~~~~~~~ | |
3244 | 13 Simply type two commands in this directory: |
14 make | |
15 make install | |
1921 | 16 |
17 Anyway you should have 'Frame buffer support' compiled into linux-kernel | |
18 and at least '8bpp packed pixel support' compiled and installed as module. | |
19 (But if you plan to use this module with mplayer you also should have | |
20 16bpp, 24bpp and 32bpp pixel support compiled as modules). | |
21 | |
3164 | 22 |
23 Radeon video overlay | |
24 ==================== | |
25 | |
26 Was designed for mplayer and currently can be used only by mplayer. | |
27 It's RGB-YUV BES for radeon cards (althrough there is experimental | |
28 support for rage128 / rage128pro chips). | |
29 | |
30 Installation: | |
31 ~~~~~~~~~~~~~ | |
32 | |
3244 | 33 Simply type two commands in this directory: |
34 make | |
35 make install | |
3246 | 36 If you install it first time then type also: |
37 make nodes | |
3164 | 38 |
39 Using with mplayer: | |
40 ~~~~~~~~~~~~~~~~~~~ | |
41 | |
42 Currently there is only way to use ATI's drivers: | |
3270 | 43 mplayer -vo vesa:lvo:/dev/radeon_vid -<your vesa's options> filename |
3164 | 44 or |
3270 | 45 mplayer -vo vesa:lvo:/dev/rage128_vid -<your vesa's options> filename |
46 | |
47 For YV12 formats you can use also: | |
48 mplayer -vo mga:/dev/radeon_vid -<your mga's option> filename | |
49 | |
50 but in this case you should load at least radeonfb driver from | |
51 this package. | |
3164 | 52 |
3246 | 53 Configuring: |
54 ~~~~~~~~~~~~ | |
55 | |
56 You can tune up some parameters with using following trick: | |
57 echo "parameter=value">/dev/radeon_vid | |
3251 | 58 Example (disables adaptive deinterlacing): |
59 echo "deinterlace=off">/dev/radeon_vid | |
3246 | 60 |
61 To know more about these parameters - try read /dev/radeon_vid file ;) | |
3263 | 62 For example: |
63 cat /dev/radeon_vid | |
3253 | 64 |
65 List of parameters: | |
66 ~~~~~~~~~~~~~~~~~~~ | |
3470 | 67 if you have rage128 chip: |
3921
f6cd00725f6e
Added support of BRIGHTNESS, SATURATION, CONTRAST, HUE on Radeons
nick
parents:
3470
diff
changeset
|
68 brightness=decval (-64:+63) changes brightness |
f6cd00725f6e
Added support of BRIGHTNESS, SATURATION, CONTRAST, HUE on Radeons
nick
parents:
3470
diff
changeset
|
69 saturation=decval (0:+31) changes saturation 0 == grayscaled mode |
f6cd00725f6e
Added support of BRIGHTNESS, SATURATION, CONTRAST, HUE on Radeons
nick
parents:
3470
diff
changeset
|
70 else - if you have radeon: |
f6cd00725f6e
Added support of BRIGHTNESS, SATURATION, CONTRAST, HUE on Radeons
nick
parents:
3470
diff
changeset
|
71 brightness=decval (-1000:+1000) -1000 == black screen |
f6cd00725f6e
Added support of BRIGHTNESS, SATURATION, CONTRAST, HUE on Radeons
nick
parents:
3470
diff
changeset
|
72 saturation=decval (-1000:+1000) -1000 == grayscaled mode |
f6cd00725f6e
Added support of BRIGHTNESS, SATURATION, CONTRAST, HUE on Radeons
nick
parents:
3470
diff
changeset
|
73 contrast=decval (-1000:+1000) -1000 == black screen |
f6cd00725f6e
Added support of BRIGHTNESS, SATURATION, CONTRAST, HUE on Radeons
nick
parents:
3470
diff
changeset
|
74 hue=decval (-1000:+1000) -1000 == +1000 (full circle) |
f6cd00725f6e
Added support of BRIGHTNESS, SATURATION, CONTRAST, HUE on Radeons
nick
parents:
3470
diff
changeset
|
75 all other values are within this range |
f6cd00725f6e
Added support of BRIGHTNESS, SATURATION, CONTRAST, HUE on Radeons
nick
parents:
3470
diff
changeset
|
76 Note: 0 is default value for every parameter on radeons |
3945 | 77 WARNING: This driver violates rule: "no float in the kernel". |
78 So if you have problems then don't use color correction and | |
79 tell me about these problems. | |
3470 | 80 |
3253 | 81 double_buff=on/off enables/disables double buffering |
82 deinterlace=on/off enables/disables adaprive deinterlacing | |
83 deinterlace_pattern=hexval defines deinterlacing pattern | |
3246 | 84 |
3265 | 85 Driver parameters: |
86 ~~~~~~~~~~~~~~~~~~ | |
87 | |
88 You can use some additional parameters during module loading: | |
89 Example: | |
90 modprobe radeon_vid swap_fourcc=1 | |
91 | |
92 List of driver's parameters: | |
93 ~~~~~~~~~~~~~~~~~~~~~~~~~~~~ | |
94 mtrr=1/0 configures MTRR (if available) default = 1 | |
95 swap_fourcc=1/0 performs byte swapping of passed fourcc. | |
96 (It's required for compatibility with -vo mga) | |
97 | |
98 To know more about driver's parameters execute: | |
99 modinfo radeon_vid | |
100 or | |
101 modinfo rage128_vid | |
102 | |
3164 | 103 Note: |
104 ~~~~~ | |
3265 | 105 For command line of mplayer: |
3164 | 106 You can pass only options with can be recognized by vo_vesa driver. |
107 (Indeed radeon_vid and rage128_vid are stupid things and can create | |
108 video overlay only. But mode switching and other adjustement performs | |
109 vo_vesa driver. This mean that they use VESA BIOS as graphics server). | |
110 | |
111 Conslusion: | |
112 ~~~~~~~~~~~ | |
113 This stuff (radeon(rage128)_vid) currently doesn't support any standards. | |
114 So after implementing linux standards I'll fully rewrite this driver. | |
115 | |
3265 | 116 Full example: |
117 ~~~~~~~~~~~~~ | |
118 modprobe radeon_vid mtrr=1 | |
3278 | 119 echo "deinterlace_pattern=F0055555">/dev/radeon_vid |
3265 | 120 mplayer -vo vesa:lvo:/dev/radeon_vid -fs -zoom -bpp 32 filename |
121 | |
122 Enjoy! |