Mercurial > mplayer.hg
annotate DOCS/xml/en/documentation.xml @ 20385:985accf8cf95
<replaceable> tags aren't needed in literal example
author | torinthiel |
---|---|
date | Mon, 23 Oct 2006 07:03:38 +0000 |
parents | 171e9afa4554 |
children | c0687e92d463 |
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, | |
19614 | 33 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.</para> |
9675 | 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 | |
19726
a7c1cd01d515
Mailing list descriptions are on the homepage, remove from here.
diego
parents:
19614
diff
changeset
|
49 <ulink url="http://www.mplayerhq.hu/design7/info.html#mailing_lists">mailing lists</ulink>. |
a7c1cd01d515
Mailing list descriptions are on the homepage, remove from here.
diego
parents:
19614
diff
changeset
|
50 <!-- FIXME: This refers to nonexistent links |
a7c1cd01d515
Mailing list descriptions are on the homepage, remove from here.
diego
parents:
19614
diff
changeset
|
51 Check the |
19727 | 52 <ulink url="http://lists.mplayerhq.hu/cgi-bin/s-arch.cgi">archives</ulink>, there |
10462 | 53 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
|
54 --> |
9675 | 55 </para> |
56 </preface> | |
57 | |
58 | |
59 <chapter id="intro"> | |
60 <title>Introduction</title> | |
61 | |
62 <para> | |
63 <application>MPlayer</application> is a movie player for Linux (runs on | |
64 many other Unices, and <emphasis role="bold">non-x86</emphasis> CPUs, see | |
65 <xref linkend="ports"/>). It plays most MPEG, VOB, AVI, OGG/OGM, VIVO, ASF/WMA/WMV, | |
10132 | 66 QT/MOV/MP4, FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ, PVA, Matroska files, supported by |
9675 | 67 many native, XAnim, RealPlayer, and Win32 DLL codecs. You can watch |
10132 | 68 <emphasis role="bold">VideoCD, SVCD, DVD, 3ivx, RealMedia, Sorenson, Theora</emphasis>, and |
14024 | 69 <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 | |
12343 | 79 antialiased shaded subtitles (<emphasis role="bold">14 supported types</emphasis>) |
9683 | 80 with European/ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic, Korean |
81 fonts, and the onscreen display (OSD)? | |
9675 | 82 </para> |
83 | |
84 <para> | |
85 The player is rock solid playing damaged MPEG files (useful for some VCDs), | |
86 and it plays bad AVI files which are unplayable with the famous windows | |
87 media player. Even AVI files without index chunk are playable, and you can | |
88 temporarily rebuild their indexes with the <option>-idx</option> option, or | |
89 permanently with <application>MEncoder</application>, thus enabling | |
90 seeking! As you see, stability and quality are the most important things, | |
13716 | 91 but the speed is also amazing. There is also a powerful filter system for |
92 video and audio manipulation. | |
9675 | 93 </para> |
94 | |
95 <para> | |
12578 | 96 <application>MEncoder</application> (<application>MPlayer</application>'s Movie |
11540 | 97 Encoder) is a simple movie encoder, designed to encode |
98 <application>MPlayer</application>-playable movies | |
9675 | 99 (<emphasis role="bold">AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET/PVA</emphasis>) |
11540 | 100 to other <application>MPlayer</application>-playable formats (see below). It |
14024 | 101 can encode with various codecs, like <emphasis role="bold">MPEG-4 (DivX4)</emphasis> |
14421 | 102 (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
|
103 <emphasis role="bold">PCM/MP3/VBR MP3</emphasis> |
13716 | 104 audio. |
9675 | 105 </para> |
106 | |
107 | |
108 <itemizedlist> | |
11540 | 109 <title><application>MEncoder</application> features</title> |
9675 | 110 <listitem><simpara> |
111 Encoding from the wide range of fileformats and decoders of | |
112 <application>MPlayer</application> | |
113 </simpara></listitem> | |
114 <listitem><simpara> | |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11817
diff
changeset
|
115 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
|
116 <link linkend="ffmpeg"><systemitem class="library">libavcodec</systemitem></link> |
9675 | 117 </simpara></listitem> |
118 <listitem><simpara> | |
119 Video encoding from <emphasis role="bold">V4L compatible TV tuners</emphasis> | |
120 </simpara></listitem> | |
121 <listitem><simpara> | |
122 Encoding/multiplexing to interleaved AVI files with proper index | |
123 </simpara></listitem> | |
124 <listitem><simpara> | |
125 Creating files from external audio stream | |
126 </simpara></listitem> | |
127 <listitem><simpara> | |
128 1, 2 or 3 pass encoding | |
129 </simpara></listitem> | |
130 <listitem><para> | |
131 <emphasis role="bold">VBR</emphasis> MP3 audio | |
132 <important><simpara> | |
133 VBR MP3 audio doesn't always play nicely on windows players! | |
134 </simpara></important> | |
135 </para></listitem> | |
136 <listitem><simpara> | |
137 PCM audio | |
138 </simpara></listitem> | |
139 <listitem><simpara> | |
140 Stream copying | |
141 </simpara></listitem> | |
142 <listitem><simpara> | |
143 Input A/V synchronizing (PTS-based, can be disabled with | |
144 <option>-mc 0</option> option) | |
145 </simpara></listitem> | |
146 <listitem><simpara> | |
15170 | 147 fps correction with <option>-ofps</option> option (useful when encoding |
14958 | 148 30000/1001 fps VOB to 24000/1001 fps AVI) |
9675 | 149 </simpara></listitem> |
150 <listitem><simpara> | |
13716 | 151 Using our very powerful filter system (crop, expand, flip, postprocess, |
9675 | 152 rotate, scale, rgb/yuv conversion) |
153 </simpara></listitem> | |
154 <listitem><simpara> | |
155 Can encode DVD/VOBsub <emphasis role="bold">AND</emphasis> text subtitles | |
156 into the output file | |
157 </simpara></listitem> | |
158 <listitem><simpara> | |
12615 | 159 Can rip DVD subtitles to VOBsub format |
9675 | 160 </simpara></listitem> |
161 </itemizedlist> | |
162 | |
163 <itemizedlist> | |
164 <title>Planned features</title> | |
165 <listitem><simpara> | |
166 Even wider variety of available en/decoding formats/codecs | |
167 (creating VOB files with DivX4/Indeo5/VIVO streams :). | |
168 </simpara></listitem> | |
169 </itemizedlist> | |
170 | |
171 <!-- FIXME: the license should be in bookinfo --> | |
172 <para> | |
173 <application>MPlayer</application> and <application>MEncoder</application> | |
174 can be distributed under the terms of the GNU General Public License Version 2. | |
175 </para> | |
176 | |
177 </chapter> | |
178 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
179 &install.xml; |
9675 | 180 |
181 &usage.xml; | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
182 &cd-dvd.xml; |
9675 | 183 &faq.xml; |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
184 |
19732
05710b19651f
formats.xml --> containers.xml, the chapter was renamed long ago.
diego
parents:
19727
diff
changeset
|
185 &containers.xml; |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
186 &codecs.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
187 &video.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
188 &audio.xml; |
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
189 &tvinput.xml; |
19568
bd821fd3e244
Radio support, patch by Vladimir Voroshilov (voroshil gmail com)
reimar
parents:
18426
diff
changeset
|
190 &radio.xml; |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
191 |
9675 | 192 &ports.xml; |
193 &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
|
194 &encoding-guide.xml; |
9675 | 195 &bugreports.xml; |
196 &bugs.xml; | |
197 &skin.xml; | |
20079 | 198 &history.xml; |