Mercurial > mplayer.hg
annotate DOCS/xml/en/documentation.xml @ 23559:294cbf94b48a
Activate license notice.
author | diego |
---|---|
date | Mon, 18 Jun 2007 20:04:46 +0000 |
parents | 8d3fe0133760 |
children | f249ddba010c |
rev | line source |
---|---|
20535 | 1 <?xml version="1.0" encoding="utf-8"?> |
10913
49b1a67e7381
Add revision keyword to english xml files, to ease translation synchronization
lumag
parents:
10462
diff
changeset
|
2 <!-- $Revision$ --> |
9675 | 3 |
4 <bookinfo id="toc"> | |
12645 | 5 <title><application>MPlayer</application> - The Movie Player</title> |
9675 | 6 <subtitle><ulink url="http://www.mplayerhq.hu"></ulink></subtitle> |
9683 | 7 <date>March 24, 2003</date> |
9675 | 8 <copyright> |
9 <year>2000</year> | |
10 <year>2001</year> | |
11 <year>2002</year> | |
12 <year>2003</year> | |
12243 | 13 <year>2004</year> |
14311 | 14 <year>2005</year> |
17312 | 15 <year>2006</year> |
21849 | 16 <year>2007</year> |
12243 | 17 <holder>MPlayer team</holder> |
9675 | 18 </copyright> |
19 <legalnotice> | |
20 <title>License</title> | |
23558 | 21 <para>MPlayer is free software; you can redistribute it and/or modify |
9675 | 22 it under the terms of the GNU General Public License as published by the |
23 Free Software Foundation; either version 2 of the License, or (at your | |
24 option) any later version.</para> | |
25 | |
23558 | 26 <para>MPlayer is distributed in the hope that it will be useful, but |
9675 | 27 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY |
28 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
29 for more details.</para> | |
30 | |
31 <para>You should have received a copy of the GNU General Public License | |
23558 | 32 along with MPlayer; if not, write to the Free Software Foundation, |
19614 | 33 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.</para> |
9675 | 34 </legalnotice> |
35 </bookinfo> | |
36 | |
37 | |
38 <preface id="howtoread"> | |
39 <title>How to read this documentation</title> | |
40 | |
41 <para> | |
42 If you are a first-time installer: be sure to read everything from here to | |
43 the end of the Installation section, and follow the links you will find. If | |
44 you have any other questions, return to the <link linkend="toc">Table of | |
45 Contents</link> and search for the topic, read the <xref linkend="faq"/>, | |
10462 | 46 or try grepping through the files. Most questions should be answered somewhere |
47 here and the rest has probably already been asked on our | |
21358 | 48 <ulink url="http://www.mplayerhq.hu/design7/mailing_lists.html">mailing lists</ulink>. |
19726
a7c1cd01d515
Mailing list descriptions are on the homepage, remove from here.
diego
parents:
19614
diff
changeset
|
49 <!-- FIXME: This refers to nonexistent links |
a7c1cd01d515
Mailing list descriptions are on the homepage, remove from here.
diego
parents:
19614
diff
changeset
|
50 Check the |
19727 | 51 <ulink url="http://lists.mplayerhq.hu/cgi-bin/s-arch.cgi">archives</ulink>, there |
10462 | 52 is a lot of valuable information to be found there. |
19726
a7c1cd01d515
Mailing list descriptions are on the homepage, remove from here.
diego
parents:
19614
diff
changeset
|
53 --> |
9675 | 54 </para> |
55 </preface> | |
56 | |
57 | |
58 <chapter id="intro"> | |
59 <title>Introduction</title> | |
60 | |
61 <para> | |
62 <application>MPlayer</application> is a movie player for Linux (runs on | |
63 many other Unices, and <emphasis role="bold">non-x86</emphasis> CPUs, see | |
21521 | 64 <xref linkend="ports"/>). |
65 It plays most MPEG, VOB, AVI, OGG/OGM, VIVO, ASF/WMA/WMV, QT/MOV/MP4, FLI, RM, | |
66 NuppelVideo, yuv4mpeg, FILM, RoQ, PVA, Matroska files, supported by | |
9675 | 67 many native, XAnim, RealPlayer, and Win32 DLL codecs. You can watch |
21521 | 68 <emphasis role="bold">VideoCD, SVCD, DVD, 3ivx, RealMedia, Sorenson, Theora</emphasis>, |
69 and <emphasis role="bold">MPEG-4 (DivX)</emphasis> movies too. Another big | |
13961
2946cbf097b5
DivX is MPEG4, so let's call it MPEG4 to avoid confusion.
diego
parents:
13716
diff
changeset
|
70 feature of <application>MPlayer</application> is the wide range of |
9675 | 71 supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, |
12216
d4e2bdc246a3
-vo caca documentation, patch by Pigeon <pigeon@pigeond.net>
diego
parents:
11907
diff
changeset
|
72 fbdev, AAlib, libcaca, DirectFB, but you can use GGI and SDL (and this way all |
d4e2bdc246a3
-vo caca documentation, patch by Pigeon <pigeon@pigeond.net>
diego
parents:
11907
diff
changeset
|
73 their drivers) and some lowlevel card-specific drivers (for Matrox, 3Dfx and |
18426 | 74 Radeon, Mach64, Permedia3) too! Most of them support software or hardware |
9675 | 75 scaling, so you can enjoy movies in fullscreen. |
76 <application>MPlayer</application> supports displaying through some | |
9683 | 77 hardware MPEG decoder boards, such as the <link linkend="dvb">DVB</link> and |
78 <link linkend="dxr3">DXR3/Hollywood+</link>. And what about the nice big | |
21521 | 79 antialiased shaded subtitles |
80 (<emphasis role="bold">14 supported types</emphasis>) | |
9683 | 81 with European/ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic, Korean |
82 fonts, and the onscreen display (OSD)? | |
9675 | 83 </para> |
84 | |
85 <para> | |
86 The player is rock solid playing damaged MPEG files (useful for some VCDs), | |
87 and it plays bad AVI files which are unplayable with the famous windows | |
88 media player. Even AVI files without index chunk are playable, and you can | |
89 temporarily rebuild their indexes with the <option>-idx</option> option, or | |
90 permanently with <application>MEncoder</application>, thus enabling | |
91 seeking! As you see, stability and quality are the most important things, | |
13716 | 92 but the speed is also amazing. There is also a powerful filter system for |
93 video and audio manipulation. | |
9675 | 94 </para> |
95 | |
96 <para> | |
12578 | 97 <application>MEncoder</application> (<application>MPlayer</application>'s Movie |
11540 | 98 Encoder) is a simple movie encoder, designed to encode |
99 <application>MPlayer</application>-playable movies | |
9675 | 100 (<emphasis role="bold">AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET/PVA</emphasis>) |
21521 | 101 to other <application>MPlayer</application>-playable formats (see below). |
102 It can encode with various codecs, like | |
103 <emphasis role="bold">MPEG-4 (DivX4)</emphasis> | |
14421 | 104 (one or two passes), <systemitem class="library">libavcodec</systemitem>, |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11817
diff
changeset
|
105 <emphasis role="bold">PCM/MP3/VBR MP3</emphasis> |
13716 | 106 audio. |
9675 | 107 </para> |
108 | |
109 <itemizedlist> | |
11540 | 110 <title><application>MEncoder</application> features</title> |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
111 <listitem><para> |
9675 | 112 Encoding from the wide range of fileformats and decoders of |
113 <application>MPlayer</application> | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
114 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
115 <listitem><para> |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11817
diff
changeset
|
116 Encoding to all the codecs of FFmpeg's |
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11817
diff
changeset
|
117 <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link> |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
118 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
119 <listitem><para> |
9675 | 120 Video encoding from <emphasis role="bold">V4L compatible TV tuners</emphasis> |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
121 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
122 <listitem><para> |
9675 | 123 Encoding/multiplexing to interleaved AVI files with proper index |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
124 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
125 <listitem><para> |
9675 | 126 Creating files from external audio stream |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
127 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
128 <listitem><para> |
9675 | 129 1, 2 or 3 pass encoding |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
130 </para></listitem> |
9675 | 131 <listitem><para> |
132 <emphasis role="bold">VBR</emphasis> MP3 audio | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
133 <important><para> |
9675 | 134 VBR MP3 audio doesn't always play nicely on windows players! |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
135 </para></important> |
21521 | 136 </para></listitem> |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
137 <listitem><para> |
9675 | 138 PCM audio |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
139 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
140 <listitem><para> |
9675 | 141 Stream copying |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
142 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
143 <listitem><para> |
9675 | 144 Input A/V synchronizing (PTS-based, can be disabled with |
145 <option>-mc 0</option> option) | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
146 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
147 <listitem><para> |
15170 | 148 fps correction with <option>-ofps</option> option (useful when encoding |
14958 | 149 30000/1001 fps VOB to 24000/1001 fps AVI) |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
150 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
151 <listitem><para> |
13716 | 152 Using our very powerful filter system (crop, expand, flip, postprocess, |
9675 | 153 rotate, scale, rgb/yuv conversion) |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
154 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
155 <listitem><para> |
9675 | 156 Can encode DVD/VOBsub <emphasis role="bold">AND</emphasis> text subtitles |
157 into the output file | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
158 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
159 <listitem><para> |
12615 | 160 Can rip DVD subtitles to VOBsub format |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
161 </para></listitem> |
9675 | 162 </itemizedlist> |
163 | |
164 <itemizedlist> | |
165 <title>Planned features</title> | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
166 <listitem><para> |
9675 | 167 Even wider variety of available en/decoding formats/codecs |
168 (creating VOB files with DivX4/Indeo5/VIVO streams :). | |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
169 </para></listitem> |
9675 | 170 </itemizedlist> |
171 | |
172 <!-- FIXME: the license should be in bookinfo --> | |
173 <para> | |
174 <application>MPlayer</application> and <application>MEncoder</application> | |
175 can be distributed under the terms of the GNU General Public License Version 2. | |
176 </para> | |
177 | |
178 </chapter> | |
179 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
180 &install.xml; |
9675 | 181 |
182 &usage.xml; | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
183 &cd-dvd.xml; |
9675 | 184 &faq.xml; |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
185 |
19732
05710b19651f
formats.xml --> containers.xml, the chapter was renamed long ago.
diego
parents:
19727
diff
changeset
|
186 &containers.xml; |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
187 &codecs.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
188 &video.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
189 &audio.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
190 &tvinput.xml; |
19568
bd821fd3e244
Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents:
18426
diff
changeset
|
191 &radio.xml; |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
192 |
9675 | 193 &ports.xml; |
194 &mencoder.xml; | |
16080
baae7cdb0726
re-organize MEncoder doc in a more sensible way: splitting "basic mencoder usage" and "encoding with mencoder".
gpoirier
parents:
15170
diff
changeset
|
195 &encoding-guide.xml; |
9675 | 196 &bugreports.xml; |
197 &bugs.xml; | |
198 &skin.xml; | |
20079 | 199 &history.xml; |