Mercurial > mplayer.hg
annotate DOCS/xml/en/documentation.xml @ 18636:80324ad2b3f1
Project Mayo is long dead, their CVS does not work. Some more changes
for the DivX section, it's in for a big overhaul...
author | diego |
---|---|
date | Wed, 07 Jun 2006 22:22:45 +0000 |
parents | 2306dcaa256f |
children | bd821fd3e244 |
rev | line source |
---|---|
11817
19919e913e3d
Shiny new build system by Torinthiel, polished and improved by myself.
diego
parents:
11786
diff
changeset
|
1 <?xml version="1.0" encoding="iso-8859-1"?> |
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> |
12243 | 16 <holder>MPlayer team</holder> |
9675 | 17 </copyright> |
18 <!-- | |
19 <legalnotice> | |
20 <title>License</title> | |
21 <para>This program is free software; you can redistribute it and/or modify | |
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 | |
26 <para>This program is distributed in the hope that it will be useful, but | |
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 | |
32 along with this program; if not, write to the Free Software Foundation, | |
33 Inc., 59 Temple Place, Suite 330, Boston, MA, 02111-1307, USA.</para> | |
34 </legalnotice> | |
35 --> | |
36 </bookinfo> | |
37 | |
38 | |
39 <preface id="howtoread"> | |
40 <title>How to read this documentation</title> | |
41 | |
42 <para> | |
43 If you are a first-time installer: be sure to read everything from here to | |
44 the end of the Installation section, and follow the links you will find. If | |
45 you have any other questions, return to the <link linkend="toc">Table of | |
46 Contents</link> and search for the topic, read the <xref linkend="faq"/>, | |
10462 | 47 or try grepping through the files. Most questions should be answered somewhere |
48 here and the rest has probably already been asked on our | |
49 <link linkend="mailinglists">mailing lists</link>. Check the | |
11907 | 50 <ulink url="http://www.mplayerhq.hu/cgi-bin/s-arch.cgi">archives</ulink>, there |
10462 | 51 is a lot of valuable information to be found there. |
9675 | 52 </para> |
53 </preface> | |
54 | |
55 | |
56 <chapter id="intro"> | |
57 <title>Introduction</title> | |
58 | |
59 <para> | |
60 <application>MPlayer</application> is a movie player for Linux (runs on | |
61 many other Unices, and <emphasis role="bold">non-x86</emphasis> CPUs, see | |
62 <xref linkend="ports"/>). It plays most MPEG, VOB, AVI, OGG/OGM, VIVO, ASF/WMA/WMV, | |
10132 | 63 QT/MOV/MP4, FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ, PVA, Matroska files, supported by |
9675 | 64 many native, XAnim, RealPlayer, and Win32 DLL codecs. You can watch |
10132 | 65 <emphasis role="bold">VideoCD, SVCD, DVD, 3ivx, RealMedia, Sorenson, Theora</emphasis>, and |
14024 | 66 <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
|
67 feature of <application>MPlayer</application> is the wide range of |
9675 | 68 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
|
69 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
|
70 their drivers) and some lowlevel card-specific drivers (for Matrox, 3Dfx and |
18426 | 71 Radeon, Mach64, Permedia3) too! Most of them support software or hardware |
9675 | 72 scaling, so you can enjoy movies in fullscreen. |
73 <application>MPlayer</application> supports displaying through some | |
9683 | 74 hardware MPEG decoder boards, such as the <link linkend="dvb">DVB</link> and |
75 <link linkend="dxr3">DXR3/Hollywood+</link>. And what about the nice big | |
12343 | 76 antialiased shaded subtitles (<emphasis role="bold">14 supported types</emphasis>) |
9683 | 77 with European/ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic, Korean |
78 fonts, and the onscreen display (OSD)? | |
9675 | 79 </para> |
80 | |
81 <para> | |
82 The player is rock solid playing damaged MPEG files (useful for some VCDs), | |
83 and it plays bad AVI files which are unplayable with the famous windows | |
84 media player. Even AVI files without index chunk are playable, and you can | |
85 temporarily rebuild their indexes with the <option>-idx</option> option, or | |
86 permanently with <application>MEncoder</application>, thus enabling | |
87 seeking! As you see, stability and quality are the most important things, | |
13716 | 88 but the speed is also amazing. There is also a powerful filter system for |
89 video and audio manipulation. | |
9675 | 90 </para> |
91 | |
92 <para> | |
12578 | 93 <application>MEncoder</application> (<application>MPlayer</application>'s Movie |
11540 | 94 Encoder) is a simple movie encoder, designed to encode |
95 <application>MPlayer</application>-playable movies | |
9675 | 96 (<emphasis role="bold">AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET/PVA</emphasis>) |
11540 | 97 to other <application>MPlayer</application>-playable formats (see below). It |
14024 | 98 can encode with various codecs, like <emphasis role="bold">MPEG-4 (DivX4)</emphasis> |
14421 | 99 (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
|
100 <emphasis role="bold">PCM/MP3/VBR MP3</emphasis> |
13716 | 101 audio. |
9675 | 102 </para> |
103 | |
104 | |
105 <itemizedlist> | |
11540 | 106 <title><application>MEncoder</application> features</title> |
9675 | 107 <listitem><simpara> |
108 Encoding from the wide range of fileformats and decoders of | |
109 <application>MPlayer</application> | |
110 </simpara></listitem> | |
111 <listitem><simpara> | |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11817
diff
changeset
|
112 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
|
113 <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link> |
9675 | 114 </simpara></listitem> |
115 <listitem><simpara> | |
116 Video encoding from <emphasis role="bold">V4L compatible TV tuners</emphasis> | |
117 </simpara></listitem> | |
118 <listitem><simpara> | |
119 Encoding/multiplexing to interleaved AVI files with proper index | |
120 </simpara></listitem> | |
121 <listitem><simpara> | |
122 Creating files from external audio stream | |
123 </simpara></listitem> | |
124 <listitem><simpara> | |
125 1, 2 or 3 pass encoding | |
126 </simpara></listitem> | |
127 <listitem><para> | |
128 <emphasis role="bold">VBR</emphasis> MP3 audio | |
129 <important><simpara> | |
130 VBR MP3 audio doesn't always play nicely on windows players! | |
131 </simpara></important> | |
132 </para></listitem> | |
133 <listitem><simpara> | |
134 PCM audio | |
135 </simpara></listitem> | |
136 <listitem><simpara> | |
137 Stream copying | |
138 </simpara></listitem> | |
139 <listitem><simpara> | |
140 Input A/V synchronizing (PTS-based, can be disabled with | |
141 <option>-mc 0</option> option) | |
142 </simpara></listitem> | |
143 <listitem><simpara> | |
15170 | 144 fps correction with <option>-ofps</option> option (useful when encoding |
14958 | 145 30000/1001 fps VOB to 24000/1001 fps AVI) |
9675 | 146 </simpara></listitem> |
147 <listitem><simpara> | |
13716 | 148 Using our very powerful filter system (crop, expand, flip, postprocess, |
9675 | 149 rotate, scale, rgb/yuv conversion) |
150 </simpara></listitem> | |
151 <listitem><simpara> | |
152 Can encode DVD/VOBsub <emphasis role="bold">AND</emphasis> text subtitles | |
153 into the output file | |
154 </simpara></listitem> | |
155 <listitem><simpara> | |
12615 | 156 Can rip DVD subtitles to VOBsub format |
9675 | 157 </simpara></listitem> |
158 </itemizedlist> | |
159 | |
160 <itemizedlist> | |
161 <title>Planned features</title> | |
162 <listitem><simpara> | |
163 Even wider variety of available en/decoding formats/codecs | |
164 (creating VOB files with DivX4/Indeo5/VIVO streams :). | |
165 </simpara></listitem> | |
166 </itemizedlist> | |
167 | |
168 <!-- FIXME: the license should be in bookinfo --> | |
169 <para> | |
170 <application>MPlayer</application> and <application>MEncoder</application> | |
171 can be distributed under the terms of the GNU General Public License Version 2. | |
172 </para> | |
173 | |
174 &history.xml; | |
175 </chapter> | |
176 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
177 &install.xml; |
9675 | 178 |
179 &usage.xml; | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
180 &cd-dvd.xml; |
9675 | 181 &faq.xml; |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
182 |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
183 &formats.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
184 &codecs.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
185 &video.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
186 &audio.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
187 &tvinput.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
188 |
9675 | 189 &ports.xml; |
190 &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
|
191 &encoding-guide.xml; |
9675 | 192 &mail-lists.xml; |
193 &bugreports.xml; | |
194 &bugs.xml; | |
195 &skin.xml; | |
196 &users-vs-dev.xml; |