Mercurial > mplayer.hg
annotate DOCS/xml/en/documentation.xml @ 11031:f57563a141aa
libfaad FAQ, external FAAD info added back.
author | diego |
---|---|
date | Tue, 07 Oct 2003 10:18:55 +0000 |
parents | 49b1a67e7381 |
children | d480f7e36b74 |
rev | line source |
---|---|
9675 | 1 <?xml version="1.0" encoding="iso-8859-1" standalone="no"?> |
10913
49b1a67e7381
Add revision keyword to english xml files, to ease translation synchronization
lumag
parents:
10462
diff
changeset
|
2 <!-- $Revision$ --> |
9675 | 3 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN" |
4 "/usr/share/sgml/docbook/dtd/xml/4.1.2/docbookx.dtd" | |
5 [ | |
6 <!ENTITY audio.xml SYSTEM "audio.xml"> | |
7 <!ENTITY bugreports.xml SYSTEM "bugreports.xml"> | |
8 <!ENTITY bugs.xml SYSTEM "bugs.xml"> | |
9 <!ENTITY cd-dvd.xml SYSTEM "cd-dvd.xml"> | |
10 <!ENTITY codecs.xml SYSTEM "codecs.xml"> | |
11 <!ENTITY edl.xml SYSTEM "edl.xml"> | |
12 <!ENTITY faq.xml SYSTEM "faq.xml"> | |
13 <!ENTITY features.xml SYSTEM "features.xml"> | |
14 <!ENTITY formats.xml SYSTEM "formats.xml"> | |
15 <!ENTITY history.xml SYSTEM "history.xml"> | |
16 <!ENTITY install.xml SYSTEM "install.xml"> | |
17 <!ENTITY mail-lists.xml SYSTEM "mail-lists.xml"> | |
18 <!ENTITY mencoder.xml SYSTEM "mencoder.xml"> | |
19 <!ENTITY patches.xml SYSTEM "patches.xml"> | |
20 <!ENTITY ports.xml SYSTEM "ports.xml"> | |
21 <!ENTITY skin.xml SYSTEM "skin.xml"> | |
22 <!ENTITY tvinput.xml SYSTEM "tvinput.xml"> | |
23 <!ENTITY usage.xml SYSTEM "usage.xml"> | |
24 <!ENTITY users-vs-dev.xml SYSTEM "users-vs-dev.xml"> | |
25 <!ENTITY video-filters.xml SYSTEM "video-filters.xml"> | |
26 <!ENTITY video.xml SYSTEM "video.xml"> | |
27 ]> | |
28 | |
10351 | 29 <book id="index" lang="en"> |
9675 | 30 <bookinfo id="toc"> |
31 <title>MPlayer - The Movie Player for LINUX</title> | |
32 <subtitle><ulink url="http://www.mplayerhq.hu"></ulink></subtitle> | |
9683 | 33 <date>March 24, 2003</date> |
9675 | 34 <copyright> |
35 <year>2000</year> | |
36 <year>2001</year> | |
37 <year>2002</year> | |
38 <year>2003</year> | |
39 <holder>Arpad Gereoffy (A'rpi/ESP-team)</holder> | |
40 </copyright> | |
41 <!-- | |
42 <legalnotice> | |
43 <title>License</title> | |
44 <para>This program is free software; you can redistribute it and/or modify | |
45 it under the terms of the GNU General Public License as published by the | |
46 Free Software Foundation; either version 2 of the License, or (at your | |
47 option) any later version.</para> | |
48 | |
49 <para>This program is distributed in the hope that it will be useful, but | |
50 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY | |
51 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License | |
52 for more details.</para> | |
53 | |
54 <para>You should have received a copy of the GNU General Public License | |
55 along with this program; if not, write to the Free Software Foundation, | |
56 Inc., 59 Temple Place, Suite 330, Boston, MA, 02111-1307, USA.</para> | |
57 </legalnotice> | |
58 --> | |
59 </bookinfo> | |
60 | |
61 | |
62 <preface id="howtoread"> | |
63 <title>How to read this documentation</title> | |
64 | |
65 <para> | |
66 If you are a first-time installer: be sure to read everything from here to | |
67 the end of the Installation section, and follow the links you will find. If | |
68 you have any other questions, return to the <link linkend="toc">Table of | |
69 Contents</link> and search for the topic, read the <xref linkend="faq"/>, | |
10462 | 70 or try grepping through the files. Most questions should be answered somewhere |
71 here and the rest has probably already been asked on our | |
72 <link linkend="mailinglists">mailing lists</link>. Check the | |
73 <ulink url="http://www.mplayerhq.hu/cgi-bin/htsearch">archives</ulink>, there | |
74 is a lot of valuable information to be found there. | |
9675 | 75 </para> |
76 </preface> | |
77 | |
78 | |
79 <chapter id="intro"> | |
80 <title>Introduction</title> | |
81 | |
82 <para> | |
83 <application>MPlayer</application> is a movie player for Linux (runs on | |
84 many other Unices, and <emphasis role="bold">non-x86</emphasis> CPUs, see | |
85 <xref linkend="ports"/>). It plays most MPEG, VOB, AVI, OGG/OGM, VIVO, ASF/WMA/WMV, | |
10132 | 86 QT/MOV/MP4, FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ, PVA, Matroska files, supported by |
9675 | 87 many native, XAnim, RealPlayer, and Win32 DLL codecs. You can watch |
10132 | 88 <emphasis role="bold">VideoCD, SVCD, DVD, 3ivx, RealMedia, Sorenson, Theora</emphasis>, and |
9675 | 89 <emphasis role="bold">DivX</emphasis> movies too (and you don't need the avifile |
90 library at all!). Another big feature of mplayer is the wide range of | |
91 supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, | |
92 fbdev, AAlib, DirectFB, but you can use GGI and SDL (and this way all their | |
93 drivers) and some lowlevel card-specific drivers (for Matrox, 3Dfx and | |
94 Radeon, Mach64, Permedia3) too! Most of them supports software or hardware | |
95 scaling, so you can enjoy movies in fullscreen. | |
96 <application>MPlayer</application> supports displaying through some | |
9683 | 97 hardware MPEG decoder boards, such as the <link linkend="dvb">DVB</link> and |
98 <link linkend="dxr3">DXR3/Hollywood+</link>. And what about the nice big | |
99 antialiased shaded subtitles (<emphasis role="bold">10 supported types</emphasis>) | |
100 with European/ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic, Korean | |
101 fonts, and the onscreen display (OSD)? | |
9675 | 102 </para> |
103 | |
104 <para> | |
105 The player is rock solid playing damaged MPEG files (useful for some VCDs), | |
106 and it plays bad AVI files which are unplayable with the famous windows | |
107 media player. Even AVI files without index chunk are playable, and you can | |
108 temporarily rebuild their indexes with the <option>-idx</option> option, or | |
109 permanently with <application>MEncoder</application>, thus enabling | |
110 seeking! As you see, stability and quality are the most important things, | |
111 but the speed is also amazing. | |
112 </para> | |
113 | |
114 <para> | |
115 <application>MEncoder</application> (MPlayer's Movie Encoder) is a simple movie | |
116 encoder, designed to encode MPlayer-playable movies | |
117 (<emphasis role="bold">AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET/PVA</emphasis>) | |
118 to other MPlayer-playable formats (see below). It can encode with various codecs, | |
9683 | 119 like <emphasis role="bold">DivX4</emphasis> (1 or 2 passes), libavcodec, |
120 <emphasis role="bold">PCM/MP3/VBR MP3</emphasis> audio. Also has powerful plugin | |
121 system for video manipulation. | |
9675 | 122 </para> |
123 | |
124 | |
125 <itemizedlist> | |
126 <title>MEncoder features</title> | |
127 <listitem><simpara> | |
128 Encoding from the wide range of fileformats and decoders of | |
129 <application>MPlayer</application> | |
130 </simpara></listitem> | |
131 <listitem><simpara> | |
132 Encoding to all the codecs of ffmpeg's <link | |
133 linkend="ffmpeg">libavcodec</link> | |
134 </simpara></listitem> | |
135 <listitem><simpara> | |
136 Video encoding from <emphasis role="bold">V4L compatible TV tuners</emphasis> | |
137 </simpara></listitem> | |
138 <listitem><simpara> | |
139 Encoding/multiplexing to interleaved AVI files with proper index | |
140 </simpara></listitem> | |
141 <listitem><simpara> | |
142 Creating files from external audio stream | |
143 </simpara></listitem> | |
144 <listitem><simpara> | |
145 1, 2 or 3 pass encoding | |
146 </simpara></listitem> | |
147 <listitem><para> | |
148 <emphasis role="bold">VBR</emphasis> MP3 audio | |
149 <important><simpara> | |
150 VBR MP3 audio doesn't always play nicely on windows players! | |
151 </simpara></important> | |
152 </para></listitem> | |
153 <listitem><simpara> | |
154 PCM audio | |
155 </simpara></listitem> | |
156 <listitem><simpara> | |
157 Stream copying | |
158 </simpara></listitem> | |
159 <listitem><simpara> | |
160 Input A/V synchronizing (PTS-based, can be disabled with | |
161 <option>-mc 0</option> option) | |
162 </simpara></listitem> | |
163 <listitem><simpara> | |
164 FPS correction with <option>-ofps</option> option (useful when encoding | |
165 29.97 fps VOB to 24 fps AVI) | |
166 </simpara></listitem> | |
167 <listitem><simpara> | |
168 Using our very powerful plugin system (crop, expand, flip, postprocess, | |
169 rotate, scale, rgb/yuv conversion) | |
170 </simpara></listitem> | |
171 <listitem><simpara> | |
172 Can encode DVD/VOBsub <emphasis role="bold">AND</emphasis> text subtitles | |
173 into the output file | |
174 </simpara></listitem> | |
175 <listitem><simpara> | |
176 Can rip DVD subtitles to Vobsub format | |
177 </simpara></listitem> | |
178 </itemizedlist> | |
179 | |
180 <itemizedlist> | |
181 <title>Planned features</title> | |
182 <listitem><simpara> | |
183 Even wider variety of available en/decoding formats/codecs | |
184 (creating VOB files with DivX4/Indeo5/VIVO streams :). | |
185 </simpara></listitem> | |
186 </itemizedlist> | |
187 | |
188 <!-- FIXME: the license should be in bookinfo --> | |
189 <para> | |
190 <application>MPlayer</application> and <application>MEncoder</application> | |
191 can be distributed under the terms of the GNU General Public License Version 2. | |
192 </para> | |
193 | |
194 &history.xml; | |
195 &install.xml; | |
196 </chapter> | |
197 | |
198 | |
199 &features.xml; | |
200 &usage.xml; | |
201 &faq.xml; | |
202 &cd-dvd.xml; | |
203 &ports.xml; | |
204 &mencoder.xml; | |
205 &mail-lists.xml; | |
206 &bugreports.xml; | |
207 &bugs.xml; | |
208 &skin.xml; | |
209 &users-vs-dev.xml; | |
210 &patches.xml; | |
211 </book> |