9675
|
1 <?xml version="1.0" encoding="iso-8859-1" standalone="no"?>
|
|
2 <!DOCTYPE book PUBLIC "-//OASIS//DTD DocBook XML V4.1.2//EN"
|
|
3 "/usr/share/sgml/docbook/dtd/xml/4.1.2/docbookx.dtd"
|
|
4 [
|
|
5 <!ENTITY audio.xml SYSTEM "audio.xml">
|
|
6 <!ENTITY bugreports.xml SYSTEM "bugreports.xml">
|
|
7 <!ENTITY bugs.xml SYSTEM "bugs.xml">
|
|
8 <!ENTITY cd-dvd.xml SYSTEM "cd-dvd.xml">
|
|
9 <!ENTITY codecs.xml SYSTEM "codecs.xml">
|
|
10 <!ENTITY edl.xml SYSTEM "edl.xml">
|
|
11 <!ENTITY faq.xml SYSTEM "faq.xml">
|
|
12 <!ENTITY features.xml SYSTEM "features.xml">
|
|
13 <!ENTITY formats.xml SYSTEM "formats.xml">
|
|
14 <!ENTITY history.xml SYSTEM "history.xml">
|
|
15 <!ENTITY install.xml SYSTEM "install.xml">
|
|
16 <!ENTITY mail-lists.xml SYSTEM "mail-lists.xml">
|
|
17 <!ENTITY mencoder.xml SYSTEM "mencoder.xml">
|
|
18 <!ENTITY patches.xml SYSTEM "patches.xml">
|
|
19 <!ENTITY ports.xml SYSTEM "ports.xml">
|
|
20 <!ENTITY skin.xml SYSTEM "skin.xml">
|
|
21 <!ENTITY tvinput.xml SYSTEM "tvinput.xml">
|
|
22 <!ENTITY usage.xml SYSTEM "usage.xml">
|
|
23 <!ENTITY users-vs-dev.xml SYSTEM "users-vs-dev.xml">
|
|
24 <!ENTITY video-filters.xml SYSTEM "video-filters.xml">
|
|
25 <!ENTITY video.xml SYSTEM "video.xml">
|
|
26 ]>
|
|
27
|
|
28 <book lang="en">
|
|
29 <bookinfo id="toc">
|
|
30 <title>MPlayer - The Movie Player for LINUX</title>
|
|
31 <subtitle><ulink url="http://www.mplayerhq.hu"></ulink></subtitle>
|
9683
|
32 <date>March 24, 2003</date>
|
9675
|
33 <copyright>
|
|
34 <year>2000</year>
|
|
35 <year>2001</year>
|
|
36 <year>2002</year>
|
|
37 <year>2003</year>
|
|
38 <holder>Arpad Gereoffy (A'rpi/ESP-team)</holder>
|
|
39 </copyright>
|
|
40 <!--
|
|
41 <legalnotice>
|
|
42 <title>License</title>
|
|
43 <para>This program is free software; you can redistribute it and/or modify
|
|
44 it under the terms of the GNU General Public License as published by the
|
|
45 Free Software Foundation; either version 2 of the License, or (at your
|
|
46 option) any later version.</para>
|
|
47
|
|
48 <para>This program is distributed in the hope that it will be useful, but
|
|
49 WITHOUT ANY WARRANTY; without even the implied warranty of MERCHANTABILITY
|
|
50 or FITNESS FOR A PARTICULAR PURPOSE. See the GNU General Public License
|
|
51 for more details.</para>
|
|
52
|
|
53 <para>You should have received a copy of the GNU General Public License
|
|
54 along with this program; if not, write to the Free Software Foundation,
|
|
55 Inc., 59 Temple Place, Suite 330, Boston, MA, 02111-1307, USA.</para>
|
|
56 </legalnotice>
|
|
57 -->
|
|
58 </bookinfo>
|
|
59
|
|
60
|
|
61 <preface id="howtoread">
|
|
62 <title>How to read this documentation</title>
|
|
63
|
|
64 <para>
|
|
65 If you are a first-time installer: be sure to read everything from here to
|
|
66 the end of the Installation section, and follow the links you will find. If
|
|
67 you have any other questions, return to the <link linkend="toc">Table of
|
|
68 Contents</link> and search for the topic, read the <xref linkend="faq"/>,
|
|
69 or try grepping through the files.
|
|
70 </para>
|
|
71
|
|
72 <para>
|
|
73 The main rule of this documentation: if it's not documented, it
|
|
74 <emphasis>does not exist.</emphasis> If I don't say you encode audio from
|
|
75 TV tuner, you can't. A healthy quantity of combining ability is welcomed,
|
|
76 though. Good luck. You'll need it :) And for another good advice, let me
|
9683
|
77 quote Chris Phillips from the
|
|
78 <ulink url="http://mplayerhq.hu/pipermail/mplayer-users/">mplayer-users</ulink>
|
|
79 mailing list:
|
9675
|
80 </para>
|
|
81
|
|
82 <blockquote><para>
|
|
83 I said a while ago that there is such a difference between a newbie and a
|
|
84 dumbass. No matter what you actually know about a system (linux, cars,
|
|
85 girls :D) you should ALWAYS be able to take a step back and be objective,
|
9683
|
86 otherwise, you're just dumb IMHO. A girl I live with assumed the vacuum
|
9675
|
87 cleaner was broken because it didn't suck things up. never thought to
|
9683
|
88 change the bag, because she'd never done it before... now that's just
|
9675
|
89 stupid, not a case of simply not knowing what to do... Simply not being
|
|
90 that familiar with your surroundings is no excuse for a) laziness and b)
|
|
91 ignorance. So many people seem to see the word "error" and then stop...
|
|
92 few seem to actually read the words on the OTHER side of the colon.
|
|
93 </para></blockquote>
|
|
94 </preface>
|
|
95
|
|
96
|
|
97 <chapter id="intro">
|
|
98 <title>Introduction</title>
|
|
99
|
|
100 <para>
|
|
101 <application>MPlayer</application> is a movie player for Linux (runs on
|
|
102 many other Unices, and <emphasis role="bold">non-x86</emphasis> CPUs, see
|
|
103 <xref linkend="ports"/>). It plays most MPEG, VOB, AVI, OGG/OGM, VIVO, ASF/WMA/WMV,
|
|
104 QT/MOV/MP4, FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ, PVA files, supported by
|
|
105 many native, XAnim, RealPlayer, and Win32 DLL codecs. You can watch
|
|
106 <emphasis role="bold">VideoCD, SVCD, DVD, 3ivx, RealMedia</emphasis>, and
|
|
107 <emphasis role="bold">DivX</emphasis> movies too (and you don't need the avifile
|
|
108 library at all!). Another big feature of mplayer is the wide range of
|
|
109 supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib,
|
|
110 fbdev, AAlib, DirectFB, but you can use GGI and SDL (and this way all their
|
|
111 drivers) and some lowlevel card-specific drivers (for Matrox, 3Dfx and
|
|
112 Radeon, Mach64, Permedia3) too! Most of them supports software or hardware
|
|
113 scaling, so you can enjoy movies in fullscreen.
|
|
114 <application>MPlayer</application> supports displaying through some
|
9683
|
115 hardware MPEG decoder boards, such as the <link linkend="dvb">DVB</link> and
|
|
116 <link linkend="dxr3">DXR3/Hollywood+</link>. And what about the nice big
|
|
117 antialiased shaded subtitles (<emphasis role="bold">10 supported types</emphasis>)
|
|
118 with European/ISO 8859-1,2 (Hungarian, English, Czech, etc), Cyrillic, Korean
|
|
119 fonts, and the onscreen display (OSD)?
|
9675
|
120 </para>
|
|
121
|
|
122 <para>
|
|
123 The player is rock solid playing damaged MPEG files (useful for some VCDs),
|
|
124 and it plays bad AVI files which are unplayable with the famous windows
|
|
125 media player. Even AVI files without index chunk are playable, and you can
|
|
126 temporarily rebuild their indexes with the <option>-idx</option> option, or
|
|
127 permanently with <application>MEncoder</application>, thus enabling
|
|
128 seeking! As you see, stability and quality are the most important things,
|
|
129 but the speed is also amazing.
|
|
130 </para>
|
|
131
|
|
132 <para>
|
|
133 <application>MEncoder</application> (MPlayer's Movie Encoder) is a simple movie
|
|
134 encoder, designed to encode MPlayer-playable movies
|
|
135 (<emphasis role="bold">AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET/PVA</emphasis>)
|
|
136 to other MPlayer-playable formats (see below). It can encode with various codecs,
|
9683
|
137 like <emphasis role="bold">DivX4</emphasis> (1 or 2 passes), libavcodec,
|
|
138 <emphasis role="bold">PCM/MP3/VBR MP3</emphasis> audio. Also has powerful plugin
|
|
139 system for video manipulation.
|
9675
|
140 </para>
|
|
141
|
|
142
|
|
143 <itemizedlist>
|
|
144 <title>MEncoder features</title>
|
|
145 <listitem><simpara>
|
|
146 Encoding from the wide range of fileformats and decoders of
|
|
147 <application>MPlayer</application>
|
|
148 </simpara></listitem>
|
|
149 <listitem><simpara>
|
|
150 Encoding to all the codecs of ffmpeg's <link
|
|
151 linkend="ffmpeg">libavcodec</link>
|
|
152 </simpara></listitem>
|
|
153 <listitem><simpara>
|
|
154 Video encoding from <emphasis role="bold">V4L compatible TV tuners</emphasis>
|
|
155 </simpara></listitem>
|
|
156 <listitem><simpara>
|
|
157 Encoding/multiplexing to interleaved AVI files with proper index
|
|
158 </simpara></listitem>
|
|
159 <listitem><simpara>
|
|
160 Creating files from external audio stream
|
|
161 </simpara></listitem>
|
|
162 <listitem><simpara>
|
|
163 1, 2 or 3 pass encoding
|
|
164 </simpara></listitem>
|
|
165 <listitem><para>
|
|
166 <emphasis role="bold">VBR</emphasis> MP3 audio
|
|
167 <important><simpara>
|
|
168 VBR MP3 audio doesn't always play nicely on windows players!
|
|
169 </simpara></important>
|
|
170 </para></listitem>
|
|
171 <listitem><simpara>
|
|
172 PCM audio
|
|
173 </simpara></listitem>
|
|
174 <listitem><simpara>
|
|
175 Stream copying
|
|
176 </simpara></listitem>
|
|
177 <listitem><simpara>
|
|
178 Input A/V synchronizing (PTS-based, can be disabled with
|
|
179 <option>-mc 0</option> option)
|
|
180 </simpara></listitem>
|
|
181 <listitem><simpara>
|
|
182 FPS correction with <option>-ofps</option> option (useful when encoding
|
|
183 29.97 fps VOB to 24 fps AVI)
|
|
184 </simpara></listitem>
|
|
185 <listitem><simpara>
|
|
186 Using our very powerful plugin system (crop, expand, flip, postprocess,
|
|
187 rotate, scale, rgb/yuv conversion)
|
|
188 </simpara></listitem>
|
|
189 <listitem><simpara>
|
|
190 Can encode DVD/VOBsub <emphasis role="bold">AND</emphasis> text subtitles
|
|
191 into the output file
|
|
192 </simpara></listitem>
|
|
193 <listitem><simpara>
|
|
194 Can rip DVD subtitles to Vobsub format
|
|
195 </simpara></listitem>
|
|
196 </itemizedlist>
|
|
197
|
|
198 <itemizedlist>
|
|
199 <title>Planned features</title>
|
|
200 <listitem><simpara>
|
|
201 Even wider variety of available en/decoding formats/codecs
|
|
202 (creating VOB files with DivX4/Indeo5/VIVO streams :).
|
|
203 </simpara></listitem>
|
|
204 </itemizedlist>
|
|
205
|
|
206 <!-- FIXME: the license should be in bookinfo -->
|
|
207 <para>
|
|
208 <application>MPlayer</application> and <application>MEncoder</application>
|
|
209 can be distributed under the terms of the GNU General Public License Version 2.
|
|
210 </para>
|
|
211
|
|
212 &history.xml;
|
|
213 &install.xml;
|
|
214 </chapter>
|
|
215
|
|
216
|
|
217 &features.xml;
|
|
218 &usage.xml;
|
|
219 &faq.xml;
|
|
220 &cd-dvd.xml;
|
|
221 &ports.xml;
|
|
222 &mencoder.xml;
|
|
223 &mail-lists.xml;
|
|
224 &bugreports.xml;
|
|
225 &bugs.xml;
|
|
226 &skin.xml;
|
|
227 &users-vs-dev.xml;
|
|
228 &patches.xml;
|
|
229 </book>
|