Mercurial > mplayer.hg
annotate DOCS/documentation.html @ 1703:ed3be05e4eaf
*** empty log message ***
author | gabucino |
---|---|
date | Sun, 26 Aug 2001 17:02:22 +0000 |
parents | 315be3fa9daf |
children | a2e1432f7ac3 |
rev | line source |
---|---|
1612 | 1 <HTML> |
2 <BODY> | |
3 | |
1682 | 4 <P><CENTER><B>MPlayer - Movie Player for LINUX (C) 2000-2001 Arpad Gereoffy (A'rpi/ESP-team)</B><BR> |
5 <BR><A HREF="http://www.mplayerhq.hu">http://www.mplayerhq.hu</A></CENTER></P> | |
6 | |
7 <P><HR></P> | |
8 | |
9 <P>Table of Contents</P> | |
1612 | 10 |
11 <P><HR></P> | |
12 | |
1682 | 13 <P><UL> |
14 <LI><A HREF="#1">1. Introduction</A> | |
15 <UL><LI><A HREF="#1.1">1.1 Overview</A></LI> | |
16 <LI><A HREF="#1.2">1.2 History</A></LI> | |
17 <LI><A HREF="#1.3">1.3 Installation</A></LI> | |
18 <LI><A HREF="#1.4">1.4 What about the GUI?</A> | |
19 </LI></UL> | |
20 </LI><LI><A HREF="#2">2. Features</A> | |
21 <UL><LI><A HREF="codecs.html">2.1 Video Formats, Audio & Video Codecs</A> | |
22 <UL><LI><A HREF="codecs.html#2.1.1">2.1.1 Supported input formats</A></LI> | |
23 <LI><A HREF="codecs.html#2.1.2">2.1.2 Supported audio & video codecs</A> | |
24 <UL><LI><A HREF="codecs.html#2.1.2.1">2.1.2.1 DivX4</A></LI> | |
25 <LI><A HREF="codecs.html#2.1.2.2">2.1.2.2 ffmpeg's DivX/libavcodec</A></LI> | |
1688 | 26 <LI><A HREF="codecs.html#2.1.2.3">2.1.2.3 Hardware AC3 decoding</A></LI> |
1682 | 27 </UL> |
28 </LI><LI><A HREF="codecs.html#2.1.4">2.1.4 Codec importing howto</A></LI> | |
29 <UL><LI><A HREF="codecs.html#2.1.4.1">2.1.4.1 VFW codecs</A></LI> | |
30 <LI><A HREF="codecs.html#2.1.4.2">2.1.4.2 DirectShow codecs</A></LI> | |
31 </UL> | |
32 </LI></UL> | |
33 </LI><LI><A HREF="video.html">2.2 Video & Audio output devices</A> | |
34 <UL><LI><A HREF="video.html#2.2.1">2.2.1 Video output devices</A> | |
35 <UL><LI><A HREF="video.html#2.2.1.1">2.2.1.1 MTRR</A> | |
36 </LI><LI><A HREF="video.html#2.2.1.2">2.2.1.2 Xv</A> | |
37 <UL><LI><A HREF="video.html#2.2.1.2.1">2.2.1.2.1 3dfx cards</A> | |
38 </LI><LI><A HREF="video.html#2.2.1.2.2">2.2.1.2.2 S3 cards</A> | |
39 </LI><LI><A HREF="video.html#2.2.1.2.3">2.2.1.2.3 nVidia cards</A> | |
40 </LI><LI><A HREF="video.html#2.2.1.2.4">2.2.1.2.4 ATI cards</A> | |
41 </LI></UL> | |
42 </LI><LI><A HREF="video.html#2.2.1.3">2.2.3.2 DGA</A> | |
43 <UL><LI><A HREF="video.html#2.2.1.3.1">2.2.1.3.1 Summary</A> | |
44 </LI><LI><A HREF="video.html#2.2.1.3.2">2.2.1.3.2 What is DGA</A> | |
45 </LI><LI><A HREF="video.html#2.2.1.3.3">2.2.1.3.3 Installing DGA support for MPlayer</A> | |
46 </LI><LI><A HREF="video.html#2.2.1.3.4">2.2.1.3.4 Resolution switching</A> | |
47 </LI><LI><A HREF="video.html#2.2.1.3.5">2.2.1.3.5 DGA & MPlayer</A> | |
48 </LI><LI><A HREF="video.html#2.2.1.3.6">2.2.1.3.6 Features of the DGA driver</A> | |
49 </LI><LI><A HREF="video.html#2.2.1.3.7">2.2.1.3.7 Speed issues</A> | |
50 </LI><LI><A HREF="video.html#2.2.1.3.8">2.2.1.3.8 Known bugs</A> | |
51 </LI><LI><A HREF="video.html#2.2.1.3.9">2.2.1.3.9 Future work</A> | |
52 </LI><LI><A HREF="video.html#2.2.1.3.A">2.2.1.3.A Some modelines</A> | |
53 </LI><LI><A HREF="video.html#2.2.1.3.B">2.2.1.3.B Bug Reports</A> | |
54 </LI></UL> | |
55 </LI><LI><A HREF="video.html#2.2.1.4">2.2.1.4 SDL</A> | |
56 </LI><LI><A HREF="video.html#2.2.1.5">2.2.1.5 SVGAlib</A> | |
57 </LI><LI><A HREF="video.html#2.2.1.6">2.2.1.6 Framebuffer output (FBdev)</A> | |
58 </LI><LI><A HREF="video.html#2.2.1.7">2.2.1.7 Matrox framebuffer (mga_vid)</A> | |
59 </LI><LI><A HREF="video.html#2.2.1.8">2.2.1.8 SiS 6326 framebuffer (sis_vid)</A> | |
60 </LI><LI><A HREF="video.html#2.2.1.9">2.2.1.9 3dfx YUV support</A> | |
61 </LI><LI><A HREF="video.html#2.2.1.10">2.2.1.10 OpenGL output</A> | |
62 </LI><LI><A HREF="video.html#2.2.1.11">2.2.1.11 AAlib - text mode displaying</A> | |
63 </LI><LI><A HREF="video.html#2.2.1.A">2.2.1.A TVout</A> | |
1683
e39e774a8ca5
Gabu, you've corrected the missing <LI> things but ...
lgb
parents:
1682
diff
changeset
|
64 <UL><LI><A HREF="video.html#2.2.1.A.1">2.2.1.A.1 Matrox cards</A> |
e39e774a8ca5
Gabu, you've corrected the missing <LI> things but ...
lgb
parents:
1682
diff
changeset
|
65 </UL></LI></LI> |
1682 | 66 </LI><LI><A HREF="sound.html#2.2.2">2.2.2 Audio output devices</A> |
67 <UL><LI><A HREF="sound.html#2.2.2.1">2.2.2.1 Soundcard experiences, recommendations</A> | |
68 </LI></UL> | |
69 </LI></UL> | |
70 </LI></UL> | |
71 </LI><LI><A HREF="#3">3. Usage</A> | |
72 <UL><LI><A HREF="#3.1">3.1 Control from keyboard</A> | |
73 </LI><LI><A HREF="#3.2">3.2 Control from LIRC (Linux Infrared Remote Control)</A> | |
74 </LI><LI><A HREF="#3.3">3.3 Streaming from network or pipes</A> | |
75 </LI></UL> | |
76 </LI><LI><A HREF="cd-dvd.html#4">4. CD/DVD section</A> | |
77 <UL><LI><A HREF="cd-dvd.html#4.1">4.1 CD drives</A> | |
78 </LI><LI><A HREF="cd-dvd.html#4.2">4.2 DVD playback</A> | |
79 </LI><LI><A HREF="cd-dvd.html#4.3">4.3 DVD playback FAQ</A> | |
80 </LI></UL> | |
81 </LI><LI><A HREF="faq.html">5. FAQ section</A> | |
82 <UL><LI><A HREF="faq.html#5.1">5.1 Compilation</A> | |
83 </LI><LI><A HREF="faq.html#5.2">5.2 General questions</A> | |
84 </LI><LI><A HREF="faq.html#5.3">5.3 File playing problems</A> | |
85 </LI><LI><A HREF="faq.html#5.4">5.4 Video/audio driver problems</A> | |
86 </LI><LI><A HREF="faq.html#5.5">5.5 Feature requests</A> | |
87 </LI></UL> | |
88 </LI><LI><A HREF="#6">6. Misc OS'es</A> | |
89 <UL><LI><A HREF="#6.1">6.1 Debian packaging</A> | |
90 </LI><LI><A HREF="#6.2">6.2 FreeBSD</A> | |
1688 | 91 </LI><LI><A HREF="#6.3">6.3 Solaris</A> |
1682 | 92 </LI><LI><A HREF="#6.4">6.4 StrongARM</A> |
93 </LI></UL> | |
94 </LI><LI><A HREF="#A">A. Authors</A> | |
95 </LI><LI><A HREF="#B">B. Mailing lists</A> | |
96 </LI><LI><A HREF="bugreports.html">C. How to report bugs</A> | |
97 | |
98 </LI></UL></P> | |
1612 | 99 |
100 <P><HR></P> | |
101 | |
1682 | 102 <P><B><A NAME=1>1. Introduction</A></B></P> |
103 | |
104 <P><B><A NAME=1.1>1.1. Overview</A></B></P> | |
105 | |
106 <P><B>MPlayer</B> is a movie player for LINUX. It plays most MPEG, AVI and ASF files, | |
107 supported by many native and Win32 DLL codecs. You can watch VCD, DVD and | |
108 even DivX movies too. The another big feature of mplayer is the wide range of | |
109 supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, fbdev, | |
110 AAlib, but you can use SDL (and this way all drivers of SDL) and some | |
111 lowlevel card-specific drivers (for Matrox) too! Most of them supports | |
112 software or hardware scaling, so you can enjoy movies in fullscreen. And what | |
113 about the nice big antialiased shaded subtitles (7 supported types!!!) with | |
114 hungarian, english, cyrillic, czech, korean fonts, and OSD?</P> | |
1612 | 115 |
1682 | 116 <P>I didn't write any codecs, just some players. I spent |
117 a lot of time finding the best way to parse bad damaged input files | |
118 (both MPEG and AVI) and to do perfect A-V sync with seeking ability. | |
119 My player is rock solid playing damaged MPEG files (useful for some VCDs), | |
120 and it plays bad AVI files which are unplayable with the famous | |
121 windows media player. Even AVI files without index chunk are playable, and | |
122 you can rebuild their indexes with the -idx option, thus enabling seeking! | |
123 As you see, stability and quality are the most important things for me, | |
124 but the speed is also amazing.</P> | |
1612 | 125 |
1682 | 126 <P><B><A NAME=1.2>1.2. History</A></B></P> |
1612 | 127 |
1682 | 128 <P>This began a year ago... |
129 I've tried lots of players under linux (mtv,xmps,dvdview,livid/oms,VideoLAN, | |
130 xine,xanim,avifile,xmmp) but they all have some problem. Mostly with special | |
131 files or with audio/video sync. Most of them is unable to play both MPEG1, | |
132 MPEG2 and AVI (DivX) files. Many players have image quality or speed problems | |
133 too. So I've decided to write/modify one...</P> | |
1612 | 134 |
1682 | 135 <P><UL> |
136 <LI><B>mpg12play v0.1-v0.3:</B><BR> | |
1612 | 137 The first try, hacked together in a half hour! |
138 I've used libmpeg3 from www.heroinewarrior.com up to the version 0.3, | |
139 but there were image quality and speed problems with it. | |
1682 | 140 <LI><B>mpg12play v0.5-v0.87:</B><BR> |
1612 | 141 Mpeg codec replaced with DVDview by Dirk Farin, it was a great stuff, |
142 but it was slow and was written in C++ (I hate C++!!!) | |
1682 | 143 <LI><B>mpg12play v0.9-v0.95pre5:</B><BR> |
144 Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman & Michel Lespinasse. | |
1612 | 145 It's great, optimized very fast C code with perfect image quality and |
146 100% MPEG standard conformance. | |
1682 | 147 <LI><B>MPlayer v0.3-v0.9:</B><BR> |
1612 | 148 It was a pack of two programs: mpg12playv0.95pre6 and my new simple AVI |
149 player 'avip' based on avifile's Win32 DLL loader. | |
1682 | 150 <LI><B>MPlayer v0.10:</B><BR> |
1612 | 151 The MPEG and AVI player in a single binary! |
1682 | 152 <LI><B>MPlayer v0.11:</B><BR> |
1612 | 153 Some new developers joined and from 0.11 the mplayer project is a team-work! |
154 Added .ASF file support, and OpenDivX (see www.projectmayo.com) en/decoding. | |
1682 | 155 <LI><B>MPlayer v0.17 "The IdegCounter"</B><BR> |
1612 | 156 The release version of the 0.11pre after 4 months of heavy development! |
157 Try it, and be amazed! Thousands of new features added... and of course | |
158 old code was improved too, bugs removed etc. | |
1682 | 159 <LI><B>MPlayer 0.18 "The BugCounter"</B><BR> |
1612 | 160 2 months since 0.17 and here's a new release.. Completed ASF support, |
161 more subtitle formats, introduced libao (similar to libvo but to audio), | |
162 even more stable than ever, and so on. It's a MUST ! | |
1682 | 163 </UL></P> |
1612 | 164 |
1682 | 165 <P><B><A NAME=1.3>1.3. Installation</A></B></P> |
1612 | 166 |
1703 | 167 <UL> |
168 <LI>If you plan to use <B>MPlayer</B> on x86 architecture, you possibly want to use | |
1682 | 169 Win32 codecs. Download and unzip w32codecs.zip to /usr/lib/win32 . |
170 Note: the avifile project has similar codecs package, but it differs | |
171 from our, so if you want to use all supported codecs, then use | |
1703 | 172 our package! However, you can use our codecs package with avifile.</LI> |
1682 | 173 |
1703 | 174 <LI>If you own a Matrox G200/G400/G450 card, then please see the <A HREF="video.html#2.2.1.7">2.2.1.7</A> |
1682 | 175 section in order to gain big speedup. It is important to do these steps |
176 _before_ compiling <B>MPlayer</B>, otherwise no Matrox-specific support will be | |
1703 | 177 built.</LI> |
1682 | 178 |
1703 | 179 <LI>If you plan to use the ProjectMayo's <B>DivX4</B> codec, check the |
180 <A HREF="codecs.html#2.1.2.1">2.1.2.1</A> section before compiling.</LI> | |
181 | |
182 <LI>For DVD support, you'll have to compile libdvdread and libcss. | |
183 See <A HREF="cd-dvd.html#4.2">section 4.2</A> for more information.</LI> | |
184 </UL> | |
1612 | 185 |
1682 | 186 <P>Then build <B>MPlayer</B>:</P> |
187 | |
188 <PRE> ./configure | |
189 make | |
190 make install</PRE> | |
1612 | 191 |
1682 | 192 <P>It is recommended to browse the output of ./configure , it contains info |
193 about what will be built, and what won't. You may also want to view | |
194 config.h and config.mak files.</P> | |
1612 | 195 |
1682 | 196 <P>Though not mandatory, the fonts should be installed in order to gain |
197 OSD, and subtitle functionality. Download mp_font3.zip and optional | |
198 (if exists) language updates.</P> | |
1612 | 199 |
1682 | 200 <PRE> mkdir ~/.mplayer/font |
201 cd ~/.mplayer/font | |
202 unzip mp_font3.zip | |
203 unzip mp_font3_hu.zip</PRE> | |
1612 | 204 |
205 | |
1682 | 206 <P><B><A NAME=1.4>1.4. What about the GUI?</A></B></P> |
1612 | 207 |
1682 | 208 <P>I'm not a GUI programmer. I hate GUIs, I like the pure black 80x25 console. |
209 So the player has only keyboard control from the controlling console/xterm now. | |
210 There is a GUI development for the player, coordinated by Pontscho/Fresh! | |
211 It's still under development, but it will be merged and released real soon. | |
212 BTW he needs some nice skins, if you are a good graphician, contact him!!!</P> | |
1612 | 213 |
1682 | 214 <P><B><A NAME=2>2. Features</A></B></P> |
1612 | 215 |
1682 | 216 <P><A NAME=2.1>2.1. <A HREF="codecs.html">Video Formats, Audio & Video Codecs</A></P> |
1612 | 217 |
1682 | 218 <P><A NAME=2.2>2.2. <A HREF="video.html">Video</A> & <A HREF="sound.html">Audio</A> output devices</P> |
1612 | 219 |
1682 | 220 <P><B><A NAME=3>3. Usage</A></B></P> |
1612 | 221 |
1682 | 222 <P><TABLE BORDER=0> |
223 <TD> </TD><TD>file</TD><TD> </TD><TD><CODE>mplayer [options] [path/]filename</CODE></TD><TR> | |
224 <TD></TD><TD>VCD</TD><TD></TD><TD><CODE>mplayer [options] -vcd trackno /dev/cdrom</CODE></TD><TR> | |
225 <TD></TD><TD>DVD</TD><TD></TD><TD><CODE>mplayer [options] -dvd titleno [/dev/dvd]</CODE></TD><TR> | |
226 <TD></TD><TD>net</TD><TD></TD><TD><CODE>mplayer [options] http://site.com/file.[mpg|avi]</CODE></TD><TR> | |
227 </TABLE></P> | |
1612 | 228 |
1682 | 229 <P><PRE> mplayer -vo x11 /mnt/Films/Contact/contact2.mpg |
1612 | 230 mplayer -vcd 2 /dev/cdrom |
231 mplayer -afm 3 /mnt/DVDtrailers/alien4.vob | |
232 mplayer -dvd /dev/dvd /mnt/dvd/matrix.vob | |
1682 | 233 mplayer -abs 65536 -delay -0.4 -nobps ~/movies/test.avi</PRE></P> |
1612 | 234 |
235 | |
1682 | 236 <P><B><A NAME=3.1>3.1. Control from keyboard</A></B></P> |
237 | |
238 <P><TABLE BORDER=0> | |
239 <TD> </TD><TD><- or -></TD><TD> </TD><TD>seek backward/forward 10 seconds</TD><TR> | |
240 <TD></TD><TD>up or down</TD><TD></TD><TD>seek backward/forward 1 minute</TD><TR> | |
241 <TD></TD><TD>pgup/pgdown</TD><TD></TD><TD>seek backward/forward 10 minutes</TD><TR> | |
242 <TD></TD><TD>p or SPACE</TD><TD></TD><TD>pause movie (press any key)</TD><TR> | |
243 <TD></TD><TD>q or ESC</TD><TD></TD><TD>stop playing and quit program</TD><TR> | |
244 <TD></TD><TD>+ or -</TD><TD></TD><TD>adjust audio delay by +/- 0.1 second</TD><TR> | |
245 <TD></TD><TD>/ or *</TD><TD></TD><TD>decrease/increase volume</TD><TR> | |
246 <TD></TD><TD>o</TD><TD></TD><TD>toggle OSD: none / seek / seek+timer</TD><TR> | |
247 <TD></TD><TD>m</TD><TD></TD><TD>toggle using master/pcm volume</TD><TR> | |
248 <TD></TD><TD>z or x</TD><TD></TD><TD>adjust subtitle delay by +/- 0.1 second</TD><TR> | |
1612 | 249 |
1682 | 250 <TD COLSPAN=4><P><I>(the following keys are valid only when using DirectShow DivX codec)</I></P></TD><TR> |
1624 | 251 |
1682 | 252 <TD></TD><TD>1 or 2</TD><TD></TD><TD>adjust contrast</TD><TR> |
253 <TD></TD><TD>3 or 4</TD><TD></TD><TD>adjust brightness</TD><TR> | |
1702 | 254 <TD></TD><TD>5 or 6</TD><TD></TD><TD>adjust hue</TD><TR> |
1682 | 255 <TD></TD><TD>7 or 8</TD><TD></TD><TD>adjust saturation</TD><TR> |
256 </TABLE></P> | |
1624 | 257 |
1682 | 258 <P><B><A NAME=3.2>3.2. Control from LIRC</A></B></P> |
1612 | 259 |
1682 | 260 <P>Linux Infrared Remote Control - use an easy to build home-brewn IR-receiver, |
261 an (almost) arbitrary remote control and control your linux box with it! | |
262 More about it at <A HREF="http://www.lirc.org">www.lirc.org</A>.</P> | |
1612 | 263 |
1682 | 264 <P>If you have installed the lirc-package, you can compile <B>MPlayer</B> with LIRC |
265 support using ./configure --enable-lirc</P> | |
1612 | 266 |
1682 | 267 <P>If everything went fine, <B>MPlayer</B> will print a message like |
268 LIRC init was successful. | |
269 on startup. If an error occurs it will tell you. If it doens't tell you | |
270 anything about LIRC there's no support compiled in. That's it :-)</P> | |
1612 | 271 |
1682 | 272 <P>The application name for <B>MPlayer</B> is - oh wonder - mplayer_lirc. |
273 It understands the following commands:</P> | |
1612 | 274 |
1682 | 275 <P><TABLE BORDER=0> |
276 <TD> </TD><TD>PAUSE</TD><TD> </TD><TD>pause playing. Any other keystroke will continue replay.</TD><TR> | |
1702 | 277 <TD></TD><TD>QUIT</TD><TD></TD><TD>exit MPlayer</TD><TR> |
1682 | 278 <TD></TD><TD>RWND</TD><TD></TD><TD>10 secs back</TD><TR> |
279 <TD></TD><TD>FRWND</TD><TD></TD><TD>60 secs back</TD><TR> | |
280 <TD></TD><TD>FWD</TD><TD></TD><TD>skip 10 secs</TD><TR> | |
281 <TD></TD><TD>FFWD</TD><TD></TD><TD>skip 60 secs</TD><TR> | |
282 <TD></TD><TD>INCVOL</TD><TD></TD><TD>increase volume one percent</TD><TR> | |
1702 | 283 <TD></TD><TD>DECVOL</TD><TD></TD><TD>decrease volume one percent</TD><TR> |
1682 | 284 <TD></TD><TD>MASTER</TD><TD></TD><TD>use master mixer channel</TD><TR> |
285 <TD></TD><TD>PCM</TD><TD></TD><TD>use pcm mixer channel</TD><TR> | |
286 </TABLE></P> | |
1612 | 287 |
1682 | 288 <P> Don't forget to enable the repeat flag for RWND/FWD in .lircrc. Here's an |
289 excerpt from my .lircrc:</P> | |
1612 | 290 |
1682 | 291 <P><PRE> begin |
1612 | 292 remote = CU-SX070 |
293 prog = mplayer_lirc | |
294 button = Tape_Play | |
295 repeat = 1 | |
296 config = FFWD | |
297 end | |
298 | |
299 begin | |
300 remote = CU-SX070 | |
301 prog = mplayer_lirc | |
302 button = Tape_Stop | |
303 config = QUIT | |
1682 | 304 end</PRE></P> |
1612 | 305 |
1682 | 306 <P>If you don't like the standard location for the lirc-config file (~/.lircrc) |
307 use the -lircconf [filename] switch to specify another file.</P> | |
1612 | 308 |
1682 | 309 <P><B><A NAME=3.3>3.3. Streaming from network or pipes</A></B></P> |
1612 | 310 |
1682 | 311 <P><B>MPlayer</B> can play media from network, by using the HTTP protocol, and even |
312 beta ASF streaming (FROM network) is available. | |
313 Configuring it is simple, just recompile <B>MPlayer</B> with</P> | |
1612 | 314 |
1682 | 315 <P><CODE> ./configure --enable-streaming</CODE></P> |
1612 | 316 |
1682 | 317 <P><B>MPlayer</B> can read from stdin (NOT named pipes). This can be for example |
318 used to play from FTP:</P> | |
1612 | 319 |
1682 | 320 <P><CODE> wget ftp://micorsops.com/something.avi -O - | mplayer -</CODE></P> |
1612 | 321 |
1682 | 322 <P><B><A NAME=4>4. <A HREF="faq.html">FAQ section</A></A></B></P> |
1612 | 323 |
1682 | 324 <P><B><A NAME=5>5. <A HREF="cd-dvd.html">CD/DVD section</A></A></B></P> |
1612 | 325 |
1682 | 326 <P><B><A NAME=6>6. Misc OS'es</A></B></P> |
1612 | 327 |
1682 | 328 <P><B><A NAME=6.1>6.1. Debian packaging</A></B></P> |
1612 | 329 |
1682 | 330 <P>To build the package, get the cvs version, or .tgz and uncompress it, |
331 and cd into programs directory:</P> | |
1612 | 332 |
1682 | 333 <P><PRE> cd main |
334 fakeroot debian/rules binary</PRE></P> | |
1612 | 335 |
1682 | 336 <P>(... mplayer detects hardware/software, builds itself and.. ) |
337 dpkg-deb: building package `mplayer' in `../mplayer_0.18-1_i386.deb'.</P> | |
1612 | 338 |
1682 | 339 <P>And now just become root, and:</P> |
1612 | 340 |
1682 | 341 <P><PRE> dpkg -i ../mplayer_0.18-1_i386.deb as root.</PRE></P> |
1612 | 342 |
1682 | 343 <P>Here's how it looks like:</P> |
1612 | 344 |
1682 | 345 <P><PRE> eyck@incubus:/src/main$ sudo dpkg -i ../mplayer_0.18-1_i386.deb |
1612 | 346 Password: |
347 (Reading database ... 26946 files and directories currently installed.) | |
348 Preparing to replace mplayer 0.17a-1 (using ../mplayer_0.18-1_i386.deb) | |
349 Unpacking replacement mplayer ... | |
1682 | 350 Setting up mplayer (0.18-1) ...</PRE></P> |
1612 | 351 |
352 | |
1682 | 353 <P><B><A NAME=6.2>6.2. FreeBSD</A></B></P> |
1612 | 354 |
1682 | 355 <P>To build the package you will need GNU make (gmake, /usr/ports/devel/gmake), |
356 native BSD make will not work.</P> | |
1612 | 357 |
1682 | 358 <P>To run <B>MPlayer</B> you will need to re-compile the kernel with |
359 "options USER_LDT" (unless you are running -CURRENT, where this is default). | |
360 If you have a CPU with SSE also use "options CPU_ENABLE_SSE" to use it | |
361 (FreeBSD-STABLE required, or use kernel patches).</P> | |
1612 | 362 |
1682 | 363 <P>If <B>MPlayer</B> complains about "CD-ROM Device '/dev/cdrom' not found!" make a |
364 symbolic link: <CODE>ln -s /dev/(your_cdrom_device) /dev/cdrom</CODE></P> | |
1612 | 365 |
1682 | 366 <P>There's no DVD support for FreeBSD yet. |
367 Feel free to add it :-)</P> | |
1612 | 368 |
369 | |
1688 | 370 <P><B><A NAME=6.3>6.3. Solaris</A></B></P> |
371 | |
372 <P>MPlayer should work on Solaris 2.6 or newer.</P> | |
1612 | 373 |
1682 | 374 <P>AVI file playback works best on Solaris x86, because you have the |
375 option to use the win32 codecs on the x86 platform. On Solaris SPARC, | |
376 you'll find quite a few AVI files with non working video and/or | |
377 audio playback, because the video/audio codecs using the win32 DLLs | |
378 are not available. However, <B>DivX/OpenDivX</B> movies should work, | |
379 when using libavcodec.</P> | |
1612 | 380 |
1682 | 381 <P>To build the package you will need GNU make (gmake, /opt/sfw/gmake), native |
382 Solaris make will not work. Typical error you get when building with solaris' | |
383 make instead of GNU make:</P> | |
1612 | 384 |
1682 | 385 <P><PRE> % /usr/ccs/bin/make |
386 make: Fatal error in reader: Makefile, line 25: Unexpected end of line seen</P></PRE> | |
1612 | 387 |
1682 | 388 <P>On Solaris SPARC, you need the GNU C/C++ Compiler; it does not matter |
389 if GNU C/C++ compiler is configured with or without the GNU assembler.</P> | |
1612 | 390 |
1682 | 391 <P>On Solaris x86, you need the GNU assembler and the GNU C/C++ |
392 compiler, configured to use the GNU assembler! The mplayer code on | |
393 the x86 platform makes heavy use of MMX, SSE and 3DNOW! | |
394 instructions that cannot be compiled using Sun's assembler | |
395 <CODE>/usr/ccs/bin/as</CODE>.</P> | |
1612 | 396 |
1682 | 397 <P>The configure script tries to find out, which assembler program is |
398 used by your "gcc" command (in case the autodetection fails, use | |
399 the "--as=/whereever/you/have/installed/gnu-as" option to tell the | |
400 configure script where it can find GNU "as" on your system).</P> | |
1612 | 401 |
1682 | 402 <P>Error message from configure on a Solaris x86 system using GCC |
403 without GNU assembler:</P> | |
1612 | 404 |
1682 | 405 <P><PRE> % configure |
1612 | 406 ... |
407 Checking assembler (/usr/ccs/bin/as) ... , failed | |
1682 | 408 Please upgrade(downgrade) binutils to 2.10.1...</PRE></P> |
1612 | 409 |
1682 | 410 <P>(Solution: Install and use a gcc configured with "--with-as=gas")</P> |
1612 | 411 |
1682 | 412 <P>Typical error you get when building with a GNU C compiler that does |
413 not use GNU as:</P> | |
1612 | 414 |
1682 | 415 <P><PRE> % gmake |
1612 | 416 ... |
417 gcc -c -Iloader -Ilibvo -O4 -march=i686 -mcpu=i686 -pipe -ffast-math | |
418 -fomit-frame-pointer -I/usr/local/include -o mplayer.o mplayer.c | |
419 Assembler: mplayer.c | |
420 "(stdin)", line 3567 : Illegal mnemonic | |
421 "(stdin)", line 3567 : Syntax error | |
1682 | 422 ... more "Illegal mnemonic" and "Syntax error" errors ...</PRE></P> |
423 | |
424 <P>For DVD support you must have the patched libcss installed. Patch: | |
425 <A HREF="http://www.tools.de/solaris/mplayer/">http://www.tools.de/solaris/mplayer/</A>.</P> | |
426 | |
427 <P>Due to two bugs in solaris 8 x86, you cannot reliably play DVDs using a | |
428 capacity >4GB:</P> | |
429 | |
430 <P><UL><LI>The sd(7D) driver on solaris 8 x86 driver has bug when accessing a | |
431 disk block >4GB on a device using a logical blocksize != DEV_BSIZE | |
432 (i.e. CDROM and DVD media). Due to a 32bit int overflow, a disk | |
433 address modulo 4GB is accessed. | |
434 (http://groups.yahoo.com/group/solarisonintel/message/22516) | |
1688 | 435 |
1682 | 436 <LI>The similar bug is present in the hsfs(7FS) filesystem code (aka |
437 ISO9660), hsfs currently does not support partitions/disks >4GB, | |
438 all data is accessed modulo 4GB | |
439 (http://groups.yahoo.com/group/solarisonintel/message/22592) | |
440 </UL></P> | |
441 | |
1688 | 442 <P>On Solaris with an UltraSPARC CPU, you can get some extra speed by |
443 using the CPU's VIS instructions for certain time consuming operations. | |
444 VIS acceleration can be used in MPlayer by calling functions in Sun's | |
445 <A HREF="http://www.sun.com/sparc/vis/mediaLib.html">mediaLib</A>.</P> | |
446 | |
447 <P>VIS accelerated operations from mediaLib are used for mpeg2 video | |
448 decoding and for color space conversion in the video output drivers.</P> | |
449 | |
1682 | 450 <P><B><A NAME=6.4>6.4. StrongARM</A></B></P> |
451 | |
452 <P><B>MPlayer</B> is reported to compile on StrongARM. Use the following command line:</P> | |
453 | |
454 <P><PRE> ./configure --target=arm-linux --disable-css --with-x11libdir=/usr/arm/lib | |
455 --with-x11incdir=/usr/arm/lib --disable-gcc-checking</PRE></P> | |
456 | |
457 <P><B><A NAME=A>Appendix A - Authors</A></B></P> | |
458 | |
459 <P>NOTE: Do *NOT* send bugreports, help & feature requests directly to the authors!</P> | |
460 | |
461 <P>Read Appendix <A HREF="#C">C</A> and subscribe to mplayer-users mailing lists.</P> | |
462 | |
463 <P ALIGN=center><B><U>The <B>MPlayer</B> project:</U></B></P> | |
1612 | 464 |
1682 | 465 <P><UL> |
466 <LI>Árpád Gereöffy (A'rpi/ESP-team): [arpi@thot.banki.hu] | |
467 <UL><LI>player code (mpeg stream demultiplexer and avi/asf parser, A-V sync, seek...) | |
468 </LI><LI>mp3lib, based on mpglib sources [MP3 audio decoder] | |
469 </LI><LI>getch2 [keyboard handler] | |
470 </LI><LI>some changes in libmpeg2 code (progressive frames, bitrate & fps support) | |
471 </LI><LI>libvo improvements: adding OpenGL support, bugfix in mga driver... | |
472 </LI><LI>triple buffering & YUY2 support (for DivX/MPEG4) into mga_vid driver | |
473 </LI><LI>scripts in the TVout directory (TVout on Matrox G400DH, read documentation) | |
474 </LI><LI>hacking DivX/Mpeg4 VfW codecs to get YUV output | |
475 </LI><LI>opendivx decoder speed optimizations (see opendivx/ChangeLog) | |
476 </LI><LI>OSD & SUB display code | |
477 </LI><LI>ffmpeg/libavcodec integration | |
478 </LI><LI>DivX4Linux (ProjectMayo) support (see documentation) | |
479 </LI></UL> | |
480 | |
481 </LI><LI>Zoltán Ponekker (Pontscho/Fresh!): [pontscho@makacs.poliod.hu] | |
482 <UL><LI>configure script and Makefiles for easy compile | |
483 </LI><LI>GUI system (near complete!?) | |
484 </LI><LI>3DNow! support into mp3lib | |
485 </LI><LI>3DNow! support into fastmemcpy.h | |
486 </LI><LI>various X11 driver changes (keyboard handling, fullscreen, bpp detect, etc) | |
487 </LI><LI>libvo: adding xmga driver, and fullscreen support to xv | |
488 </LI><LI>audio mixer (volume) support | |
489 </LI></UL> | |
490 | |
491 </LI><LI>Gábor Lénárt (LGB): [lgb@lgb.hu] | |
492 <UL><LI>./configure script improvements | |
493 </LI><LI>Makefile improvements | |
494 </LI><LI>prelimenary DVD support | |
495 </LI><LI>another GUI code (is that so..?) | |
496 </LI><LI>various X11 cleanups and fixes | |
497 </LI></UL> | |
1612 | 498 |
1682 | 499 </LI><LI>Gábor Bérczi (Gabucino): [gabucino@k2.jozsef.kando.hu] |
500 <UL><LI>documentation maintainer | |
501 </LI><LI>hungarian translation of documentation | |
502 </LI><LI>second webpage design&gfx | |
503 </LI><LI>webpage maintainer | |
504 </LI><LI>testing, codecs quality & speed comparsions | |
505 </LI><LI>IRC channel #<B>MPlayer</B> operator | |
506 (devel channel, users earn kickban) | |
507 </LI><LI>experimental MINIX port :) | |
508 </LI></UL> | |
509 | |
510 </LI><LI>Szabolcs Berecz (Szabi): [szabi@inf.elte.hu] | |
511 <UL><LI>codecs.conf file parser | |
512 </LI><LI>config file and command line parser | |
513 </LI><LI>mga_vid fixes, module option etc. | |
514 </LI><LI>fbdev support in libvo | |
515 </LI><LI>type #7 subtitle support | |
516 </LI></UL> | |
517 | |
518 </LI><LI>László Megyer (Lez, Laaz): [lez@sch.bme.hu] | |
519 <UL><LI>SUB reader | |
520 </LI><LI>screensaver+DPMS disable for libvo | |
521 </LI></UL> | |
522 | |
523 </LI><LI>Gyula László (Chass, Tégla): [chass-@freemail.hu] | |
524 <UL><LI>first fonts (mp_font1.zip) | |
525 </LI><LI>third (current) homepage design&gfx | |
526 </LI></UL> | |
527 | |
528 </LI><LI>Zoltán Márk Vicián (Se7en): [se7en@sch.bme.hu] | |
529 <UL><LI>SVGAlib support in libvo | |
530 </LI></UL> | |
531 | |
532 </LI><LI>Alex Beregszaszi (Al3x): [alex@naxine.org] | |
533 <UL><LI>ALSA output driver in libao2 | |
534 </LI><LI>vo_ggi output driver in libvo (www.ggi-project.org) | |
535 </LI></UL> | |
536 | |
537 </LI><LI>Andreas Ackermann (Acki): [asackerm@stud.informatik.uni-erlangen.de] | |
538 <UL><LI>LIRC support (see documentation) | |
539 </LI><LI>DGA support in libvo | |
540 </LI></UL> | |
1612 | 541 |
1682 | 542 </LI><LI>Felix Bünemann (Atmos): [atmosfear@users.sourceforge.net] |
543 <UL><LI>SDL driver maintainer | |
544 </LI><LI>Additional YUV formats fixes | |
545 </LI><LI>New font (mp_font2.zip) | |
546 </LI><LI>PNG file output support in libvo | |
547 </LI><LI>flipping support (for Indeo 3/4, etc) | |
548 </LI><LI>SDL audio driver in libao2 | |
549 </LI><LI>RAW PCM/WAVE file writer for libao2 | |
550 </LI></UL> | |
1612 | 551 |
1682 | 552 </LI><LI>TeLeNiEkO: [telenieko@telenieko.com] |
553 <UL><LI>spanish translation of documentation | |
554 </LI></UL> | |
555 | |
556 </LI><LI>Michael Graffam: [mgraffam@idsi.net] | |
557 <UL><LI>XF86VidMode support to vo_x11 and vo_dga | |
558 </LI><LI>Video mode switching code to vo_dga | |
559 </LI></UL> | |
560 | |
561 </LI><LI>Jens Hoffmann: [hoffmajs@gmx.de] | |
562 <UL><LI>Additional YUV formats support | |
563 </LI><LI>found the big BITMAPINFOHEADER problem -> solved ASV2 pixelization | |
564 </LI></UL> | |
565 | |
566 </LI><LI>Nick Kurshev: [nickols_k@mail.ru] | |
567 <UL><LI>memcpy optimizations for AMD K7 and Intel Pentium III (fastmemcpy.h) | |
568 </LI><LI>CDROM tune info | |
569 </LI><LI>further 3DNow! optimizations into mp3lib and libac3 and ffmpeg | |
570 </LI><LI>russian translation of documentation | |
571 </LI></UL> | |
572 | |
573 </LI><LI>German Gomez Garcia: [german@piraos.com] | |
574 <UL><LI>DVD .ifo parser and chapter selection [not yet in the main trunk] | |
575 </LI><LI>SPDIF AC3 output for SBLive! | |
576 </LI></UL> | |
577 | |
578 </LI><LI>Dariush Pietrzak (Eyck): [eyck@incubus.ar.lublin.pl] | |
579 <UL><LI>debian packaging support (see debian/* and this documentation) | |
580 </LI><LI>support for vplayer subtitle format | |
581 </LI><LI>prelimenary support for .RT subtitle format | |
582 </LI></UL> | |
583 | |
584 </LI><LI>Marcus Comstedt: [marcus@idonex.se] | |
585 <UL><LI>initial solaris8-x86 support | |
586 </LI></UL> | |
1612 | 587 |
1682 | 588 </LI><LI>Jürgen Keil and Marcus Comstedt: [jk@tools.de] [marcus@idonex.se] |
589 <UL><LI>patched <B>MPlayer</B> to work on Solaris 8 x86 | |
590 </LI><LI>configure fixes | |
591 </LI><LI>various fixes (win32, configure, etc) | |
592 </LI><LI>SUN audio driver in libao2 | |
593 </LI></UL> | |
594 | |
595 </LI><LI>Vladimir Kushnir: [vkushnir@Alfacom.net] | |
596 <UL><LI>patched <B>MPlayer</B> to work on FreeBSD x86 | |
597 </LI></UL> | |
598 | |
599 </LI><LI>Bertrand BAUDET: [bertrand_baudet@yahoo.com] | |
600 <UL><LI>network streaming support | |
601 </LI></UL> | |
602 | |
603 </LI><LI>Artur Zaprzala: <zybi@fanthom.irc.pl> | |
604 <UL><LI>Complete font generator prog + OSD font (TOOLS/subfont-c) | |
605 </LI></UL> | |
606 | |
607 </LI><LI>lanzz@lanzz.org: | |
608 <UL><LI>GIMP font generator plugin (TOOLS/subfont-gimp) | |
609 </LI></UL> | |
610 | |
611 </LI><LI>Adam Tla/lka: [atlka@pg.gda.pl] | |
612 <UL><LI>osd/sub review, fixes, optimization, utf8 support | |
613 </LI></LI>various fixes | |
614 </LI></UL> | |
615 | |
616 </LI><LI>Folke Ashberg: [folke@ashberg.de] | |
617 <UL><LI>native AAlib driver (-vo aa) | |
618 </LI></UL> | |
619 | |
620 </LI></UL></P> | |
621 | |
622 <P>Main testers:</P> | |
623 | |
624 <P><UL> | |
625 <LI>Tibor Balázs (Tibcu) | |
626 <LI>Péter Sasi (SaPe) | |
627 <LI>Christoph H. Lampert | |
628 <LI>Attila Kinali | |
629 <LI>Dirk Vornheder | |
630 </UL></P> | |
631 | |
632 <P ALIGN=center><B><U>The codecs, libs:</U></B></P> | |
633 | |
634 <P><UL> | |
635 <LI>Aaron Holtzman: [aholtzma@engr.uvic.ca] | |
636 <UL><LI>ac3dec (and libac3) author [AC3 audio decoder] | |
637 </LI><LI>mga_vid driver [Matrox G200/G400 YUV Back-end Scaler] | |
638 </LI><LI>mpeg2dec [Fast MPEG1/MPEG2 video decoder, currently used in player] | |
639 </LI></UL> | |
640 | |
641 </LI><LI>Michel Lespinasse: [walken@zoy.org] | |
642 <UL><LI>did large libmpeg2 changes for better speed and mpeg conformance | |
643 </LI></UL> | |
644 | |
645 </LI><LI>Eugene Kuznetsov: [divx@euro.ru] | |
646 <UL><LI>avifile author [AVI player library for linux, using Win32 VfW/ACM codecs] | |
647 </LI><LI>technical help about AVI and ASF formats, and how to get YUV using VfW... | |
648 </LI><LI>divx4linux techical support | |
649 </LI></UL> | |
650 | |
651 </LI><LI>Zdenek Kabelac: [kabi@informatics.muni.cz] | |
652 <UL><LI>current avifile maintainer(?) | |
653 </LI><LI>some technical help about the win32 stuff and timers | |
654 </LI></UL> | |
655 | |
656 </LI><LI>Gerard Lantau: [glantau@yahoo.fr] | |
657 <UL><LI>ffmpeg/libavcodec author,maintainer (opensource mpeg, mjpeg, divx en/decoder) | |
658 </LI></UL> | |
659 | |
660 </LI><LI>Project Mayo: [http://www.projectmayo.com] | |
661 <UL><LI>the OpenDivX codec authors | |
662 </LI></UL> | |
663 | |
664 </LI><LI>Michael Hipp: | |
665 <UL><LI>mpglib author [isn't used directly but some parts in mp3lib] | |
666 </LI></UL> | |
1612 | 667 |
1682 | 668 </LI><LI>Mark Podlipec: |
669 <UL><LI>xa_gsm.c author [MS-GSM audio codec] | |
670 [from a GSM library by Jutta Degener and Carsten Bormann] | |
671 </LI></UL> | |
672 | |
673 </LI></UL></P> | |
674 | |
675 <P>Their code is not used in current player version, but I've got some ideas or | |
676 other technical help from:</P> | |
677 | |
678 <P><UL> | |
679 <LI>John F. McGowan http://www.jmcgowan.com/ | |
680 <UL><LI>AVI FAQ author/collector. [site with many useful docs on codecs and avi fmt] | |
681 </LI></UL> | |
1612 | 682 |
1682 | 683 </LI><LI>Dirk Farin: [farin@ti.uni-mannheim.de] |
684 <UL><LI>dvdview author [MPEG1/MPEG2 video decoder, used in v0.5-v0.8] | |
685 </LI></UL> | |
686 | |
687 </LI><LI>Adam Williams: [broadcast@earthling.net] | |
688 <UL><LI>libmpeg3 (and xmovie) author [MPEG1/MPEG2 video decoder, used in v0.1-v0.4] | |
689 </LI></UL> | |
690 | |
691 </UL></P> | |
692 | |
693 <P><B><A NAME=B>Appendix B - Mailing lists</A></B></P> | |
694 | |
695 <P>There are some public mailing lists on <B>MPlayer</B>. Subscribing can be | |
696 achieved on the following addresses:</P> | |
697 | |
698 <P><UL> | |
699 <LI>MPlayer core/hungarian developers list:<BR> | |
700 <A HREF="http://mp.dev.hu/mailman/listinfo/mplayer-devel">http://mp.dev.hu/mailman/listinfo/mplayer-devel</A> | |
701 <P>I dunno, it is the FLAME list in hungarian language :) | |
702 Also some talking about mplayer core team internals, like mplayer | |
703 party, sponsors etc can be here.</P> | |
1612 | 704 |
1682 | 705 </LI><LI>MPlayer developers list:<BR> |
706 <A HREF="http://lists.sourceforge.net/lists/listinfo/mplayer-dev-eng">http://lists.sourceforge.net/lists/listinfo/mplayer-dev-eng</A> | |
707 <P>This list is about mplayer development! Talking about interface/API changes, | |
708 new libraryes, code optimization, ./configure changes, and send patches here. | |
709 Do NOT send bugreports, user questions, feature requests here! | |
710 This list should be kept low-traffic.</P> | |
1612 | 711 |
1682 | 712 </LI><LI>MPlayer users list:<BR> |
713 <A HREF="http://lists.sourceforge.net/lists/listinfo/mplayer-users">http://lists.sourceforge.net/lists/listinfo/mplayer-users</A> | |
714 <P><UL> | |
715 <LI>send bugreports here (after reading DOCS/BUGS, Appendix <A HREF="#C">C</A>)</LI> | |
716 <LI>send feature requests here (after reading DOCS/TODO)</LI> | |
717 <LI>send user questions here (after reading all this documentation)</LI> | |
718 </UL></P> | |
719 | |
720 </LI><LI>MPlayer & Matrox G200/G400/G450 users:<BR> | |
721 <A HREF="http://lists.sourceforge.net/lists/listinfo/mplayer-matrox">http://lists.sourceforge.net/lists/listinfo/mplayer-matrox</A> | |
722 <P>Send matrox-related questions here<UL> | |
723 <LI>things about mga_vid</LI> | |
724 <LI>matrox's official beta drivers (for X 4.x.x)</LI> | |
725 <LI>and about matroxfb-TVout stuff.</LI></UL></P> | |
1612 | 726 |
1682 | 727 </LI><LI>MPlayer announce:<BR> |
728 <A HREF="http://lists.sourceforge.net/lists/listinfo/mplayer-announce">http://lists.sourceforge.net/lists/listinfo/mplayer-announce</A> | |
729 <P>Very low traffic list :) | |
730 And it's read-only. I'll post something shit there if a new release is done.</P> | |
731 | |
732 </LI><LI>MPlayer CVS-log: <BR> | |
733 <A HREF="http://mp.dev.hu/mailman/listinfo/mplayer-cvslog">http://mp.dev.hu/mailman/listinfo/mplayer-cvslog</A> | |
734 <P>Send only questions about CVS changes here. | |
735 (if you don't understand why a change is required or you've better fix) | |
736 Be sure in that your target developer reads this list!</P> | |
737 | |
738 </LI></UL></P> | |
739 | |
740 <P>NOTE: language of above lists are ENGLISH, unless explicitly stated | |
741 otherwise. Please do not send messages using other language!</P> | |
1612 | 742 |
743 | |
1682 | 744 <P><B><A NAME=C><A HREF="bugreports.html">Appendix C</A> - How to report bugs</A></B></P> |
1612 | 745 |
746 </BODY> | |
747 </HTML> |