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