Mercurial > mplayer.hg
annotate DOCS/xml/en/documentation.xml @ 32467:fbe5c829c69b
Move libvo/sub.[ch] from libvo to sub.
author | cigaes |
---|---|
date | Wed, 27 Oct 2010 17:47:13 +0000 |
parents | ca216bfc52cf |
children | 8b5513a75ab4 |
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> |
25538 | 17 <year>2008</year> |
29263
0f1b5b68af32
whitespace cosmetics: Remove all trailing whitespace.
diego
parents:
28231
diff
changeset
|
18 <year>2009</year> |
30372 | 19 <year>2010</year> |
12243 | 20 <holder>MPlayer team</holder> |
9675 | 21 </copyright> |
22 <legalnotice> | |
23 <title>License</title> | |
23558 | 24 <para>MPlayer is free software; you can redistribute it and/or modify |
31769
c6e58ec31959
MPlayer is licensed as GPL version 2, not any later version.
diego
parents:
30372
diff
changeset
|
25 it under the terms of the GNU General Public License version 2 as |
c6e58ec31959
MPlayer is licensed as GPL version 2, not any later version.
diego
parents:
30372
diff
changeset
|
26 published by the Free Software Foundation.</para> |
9675 | 27 |
23558 | 28 <para>MPlayer is distributed in the hope that it will be useful, but |
9675 | 29 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY |
30 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
31 for more details.</para> | |
32 | |
33 <para>You should have received a copy of the GNU General Public License | |
23558 | 34 along with MPlayer; if not, write to the Free Software Foundation, |
19614 | 35 Inc., 51 Franklin Street, Fifth Floor, Boston, MA 02110-1301 USA.</para> |
9675 | 36 </legalnotice> |
37 </bookinfo> | |
38 | |
39 | |
40 <preface id="howtoread"> | |
41 <title>How to read this documentation</title> | |
42 | |
43 <para> | |
44 If you are a first-time installer: be sure to read everything from here to | |
45 the end of the Installation section, and follow the links you will find. If | |
46 you have any other questions, return to the <link linkend="toc">Table of | |
47 Contents</link> and search for the topic, read the <xref linkend="faq"/>, | |
10462 | 48 or try grepping through the files. Most questions should be answered somewhere |
49 here and the rest has probably already been asked on our | |
21358 | 50 <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
|
51 Check the |
27179
77b12b0470e4
fix a FIXME: give the URL of the list of mailing lists (since we don't have a direct link to the list of archives)
gpoirier
parents:
27143
diff
changeset
|
52 <ulink url="https://lists.mplayerhq.hu/mailman/listinfo">archives</ulink>, there |
10462 | 53 is a lot of valuable information to be found there. |
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 | |
26955 | 63 many other Unices, and non-x86 CPUs, see <xref linkend="ports"/>). |
26958 | 64 It plays most MPEG, VOB, AVI, Ogg/OGM, VIVO, ASF/WMA/WMV, QT/MOV/MP4, FLI, RM, |
21521 | 65 NuppelVideo, yuv4mpeg, FILM, RoQ, PVA, Matroska files, supported by |
9675 | 66 many native, XAnim, RealPlayer, and Win32 DLL codecs. You can watch |
26958 | 67 Video CD, SVCD, DVD, 3ivx, RealMedia, Sorenson, Theora, |
68 and MPEG-4 (DivX) movies, too. Another big | |
13961
2946cbf097b5
DivX is MPEG4, so let's call it MPEG4 to avoid confusion.
diego
parents:
13716
diff
changeset
|
69 feature of <application>MPlayer</application> is the wide range of |
9675 | 70 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
|
71 fbdev, AAlib, libcaca, DirectFB, but you can use GGI and SDL (and this way all |
26958 | 72 their drivers) and some low level card-specific drivers (for Matrox, 3Dfx and |
18426 | 73 Radeon, Mach64, Permedia3) too! Most of them support software or hardware |
9675 | 74 scaling, so you can enjoy movies in fullscreen. |
75 <application>MPlayer</application> supports displaying through some | |
9683 | 76 hardware MPEG decoder boards, such as the <link linkend="dvb">DVB</link> and |
77 <link linkend="dxr3">DXR3/Hollywood+</link>. And what about the nice big | |
26955 | 78 antialiased shaded subtitles (14 supported types) |
9683 | 79 with European/ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic, Korean |
80 fonts, and the onscreen display (OSD)? | |
9675 | 81 </para> |
82 | |
83 <para> | |
84 The player is rock solid playing damaged MPEG files (useful for some VCDs), | |
27143
ad77d9f174ca
consistency fix: capitalize Windows Media Player, and add <application> tag around it.
gpoirier
parents:
26958
diff
changeset
|
85 and it plays bad AVI files which are unplayable with the famous |
ad77d9f174ca
consistency fix: capitalize Windows Media Player, and add <application> tag around it.
gpoirier
parents:
26958
diff
changeset
|
86 <application>Windows Media Player</application>. |
ad77d9f174ca
consistency fix: capitalize Windows Media Player, and add <application> tag around it.
gpoirier
parents:
26958
diff
changeset
|
87 Even AVI files without index chunk are playable, and you can |
9675 | 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 | |
26955 | 99 AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET/PVA |
21521 | 100 to other <application>MPlayer</application>-playable formats (see below). |
26955 | 101 It can encode with various codecs, like MPEG-4 (DivX4) |
14421 | 102 (one or two passes), <systemitem class="library">libavcodec</systemitem>, |
26955 | 103 PCM/MP3/VBR MP3 audio. |
9675 | 104 </para> |
105 | |
106 <itemizedlist> | |
11540 | 107 <title><application>MEncoder</application> features</title> |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
108 <listitem><para> |
26958 | 109 Encoding from the wide range of file formats and decoders of |
9675 | 110 <application>MPlayer</application> |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
111 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
112 <listitem><para> |
11822
359eaf957bf1
Add <systemitem class="library"> tags to libavcodec and a few others.
diego
parents:
11817
diff
changeset
|
113 Encoding to all the codecs of FFmpeg's |
27809 | 114 <systemitem class="library">libavcodec</systemitem> |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
115 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
116 <listitem><para> |
26955 | 117 Video encoding from V4L compatible TV tuners |
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 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
|
121 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
122 <listitem><para> |
9675 | 123 Creating files from external audio stream |
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 1, 2 or 3 pass encoding |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
127 </para></listitem> |
9675 | 128 <listitem><para> |
26955 | 129 VBR MP3 audio |
21521 | 130 </para></listitem> |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
131 <listitem><para> |
9675 | 132 PCM audio |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
133 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
134 <listitem><para> |
9675 | 135 Stream copying |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
136 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
137 <listitem><para> |
26958 | 138 Input A/V synchronizing (pts-based, can be disabled with |
9675 | 139 <option>-mc 0</option> option) |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
140 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
141 <listitem><para> |
15170 | 142 fps correction with <option>-ofps</option> option (useful when encoding |
14958 | 143 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
|
144 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
145 <listitem><para> |
13716 | 146 Using our very powerful filter system (crop, expand, flip, postprocess, |
26958 | 147 rotate, scale, RGB/YUV conversion) |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
148 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
149 <listitem><para> |
26955 | 150 Can encode DVD/VOBsub and text subtitles |
9675 | 151 into the output file |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
152 </para></listitem> |
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
153 <listitem><para> |
12615 | 154 Can rip DVD subtitles to VOBsub format |
21725
e4cd9d683286
Massive <simpara> -> <para>, as no <simpara>'s are actually needed.
torinthiel
parents:
21521
diff
changeset
|
155 </para></listitem> |
9675 | 156 </itemizedlist> |
157 | |
158 <!-- FIXME: the license should be in bookinfo --> | |
159 <para> | |
160 <application>MPlayer</application> and <application>MEncoder</application> | |
161 can be distributed under the terms of the GNU General Public License Version 2. | |
162 </para> | |
163 | |
164 </chapter> | |
165 | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
166 &install.xml; |
9675 | 167 |
168 &usage.xml; | |
17321
7f9fcf5245a0
Improve overall structure by adding a few top-level chapters so that
diego
parents:
17312
diff
changeset
|
169 &video.xml; |
9675 | 170 &ports.xml; |
171 &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
|
172 &encoding-guide.xml; |
28163
439fcd9bb27e
Reorder sections: Put FAQ at the end, group usage sections together.
diego
parents:
27809
diff
changeset
|
173 &faq.xml; |
9675 | 174 &bugreports.xml; |
175 &skin.xml; |