Mercurial > mplayer.hg
comparison DOCS/xml/en/documentation.xml @ 9675:62c5a17038ba
XML version of MPlayer's doc
author | nicolas |
---|---|
date | Sun, 23 Mar 2003 23:35:12 +0000 |
parents | |
children | c70001c8bde9 |
comparison
equal
deleted
inserted
replaced
9674:461f71ba8af4 | 9675:62c5a17038ba |
---|---|
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> | |
32 <date>July 4, 2002</date> | |
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 | |
77 quote Chris Phillips from the mplayer-users mailing list: | |
78 </para> | |
79 | |
80 <blockquote><para> | |
81 I said a while ago that there is such a difference between a newbie and a | |
82 dumbass. No matter what you actually know about a system (linux, cars, | |
83 girls :D) you should ALWAYS be able to take a step back and be objective, | |
84 otherwise, you're just dumb IMHO. A girl i live with assumed the vacuum | |
85 cleaner was broken because it didn't suck things up. never thought to | |
86 change the bag, becasue she'd never done it before... now that's just | |
87 stupid, not a case of simply not knowing what to do... Simply not being | |
88 that familiar with your surroundings is no excuse for a) laziness and b) | |
89 ignorance. So many people seem to see the word "error" and then stop... | |
90 few seem to actually read the words on the OTHER side of the colon. | |
91 </para></blockquote> | |
92 </preface> | |
93 | |
94 | |
95 <chapter id="intro"> | |
96 <title>Introduction</title> | |
97 | |
98 <para> | |
99 <application>MPlayer</application> is a movie player for Linux (runs on | |
100 many other Unices, and <emphasis role="bold">non-x86</emphasis> CPUs, see | |
101 <xref linkend="ports"/>). It plays most MPEG, VOB, AVI, OGG/OGM, VIVO, ASF/WMA/WMV, | |
102 QT/MOV/MP4, FLI, RM, NuppelVideo, yuv4mpeg, FILM, RoQ, PVA files, supported by | |
103 many native, XAnim, RealPlayer, and Win32 DLL codecs. You can watch | |
104 <emphasis role="bold">VideoCD, SVCD, DVD, 3ivx, RealMedia</emphasis>, and | |
105 <emphasis role="bold">DivX</emphasis> movies too (and you don't need the avifile | |
106 library at all!). Another big feature of mplayer is the wide range of | |
107 supported output drivers. It works with X11, Xv, DGA, OpenGL, SVGAlib, | |
108 fbdev, AAlib, DirectFB, but you can use GGI and SDL (and this way all their | |
109 drivers) and some lowlevel card-specific drivers (for Matrox, 3Dfx and | |
110 Radeon, Mach64, Permedia3) too! Most of them supports software or hardware | |
111 scaling, so you can enjoy movies in fullscreen. | |
112 <application>MPlayer</application> supports displaying through some | |
113 hardware MPEG decoder boards, such as the DVB and DXR3/Hollywood+ ! And | |
114 what about the nice big antialiased shaded subtitles | |
115 (<emphasis role="bold">10 supported types</emphasis>) with European/ISO 8859-1,2 | |
116 (Hungarian, English, Czech, etc), Cyrillic, Korean fonts, and the onscreen display | |
117 (OSD)? | |
118 </para> | |
119 | |
120 <para> | |
121 The player is rock solid playing damaged MPEG files (useful for some VCDs), | |
122 and it plays bad AVI files which are unplayable with the famous windows | |
123 media player. Even AVI files without index chunk are playable, and you can | |
124 temporarily rebuild their indexes with the <option>-idx</option> option, or | |
125 permanently with <application>MEncoder</application>, thus enabling | |
126 seeking! As you see, stability and quality are the most important things, | |
127 but the speed is also amazing. | |
128 </para> | |
129 | |
130 <para> | |
131 <application>MEncoder</application> (MPlayer's Movie Encoder) is a simple movie | |
132 encoder, designed to encode MPlayer-playable movies | |
133 (<emphasis role="bold">AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET/PVA</emphasis>) | |
134 to other MPlayer-playable formats (see below). It can encode with various codecs, | |
135 like DivX4 (1 or 2 passes), libavcodec, <emphasis role="bold">PCM/MP3/VBR MP3</emphasis> | |
136 audio. Also has powerful plugin system for video manipulation. | |
137 </para> | |
138 | |
139 | |
140 <itemizedlist> | |
141 <title>MEncoder features</title> | |
142 <listitem><simpara> | |
143 Encoding from the wide range of fileformats and decoders of | |
144 <application>MPlayer</application> | |
145 </simpara></listitem> | |
146 <listitem><simpara> | |
147 Encoding to all the codecs of ffmpeg's <link | |
148 linkend="ffmpeg">libavcodec</link> | |
149 </simpara></listitem> | |
150 <listitem><simpara> | |
151 Video encoding from <emphasis role="bold">V4L compatible TV tuners</emphasis> | |
152 </simpara></listitem> | |
153 <listitem><simpara> | |
154 Encoding/multiplexing to interleaved AVI files with proper index | |
155 </simpara></listitem> | |
156 <listitem><simpara> | |
157 Creating files from external audio stream | |
158 </simpara></listitem> | |
159 <listitem><simpara> | |
160 1, 2 or 3 pass encoding | |
161 </simpara></listitem> | |
162 <listitem><para> | |
163 <emphasis role="bold">VBR</emphasis> MP3 audio | |
164 <important><simpara> | |
165 VBR MP3 audio doesn't always play nicely on windows players! | |
166 </simpara></important> | |
167 </para></listitem> | |
168 <listitem><simpara> | |
169 PCM audio | |
170 </simpara></listitem> | |
171 <listitem><simpara> | |
172 Stream copying | |
173 </simpara></listitem> | |
174 <listitem><simpara> | |
175 Input A/V synchronizing (PTS-based, can be disabled with | |
176 <option>-mc 0</option> option) | |
177 </simpara></listitem> | |
178 <listitem><simpara> | |
179 FPS correction with <option>-ofps</option> option (useful when encoding | |
180 29.97 fps VOB to 24 fps AVI) | |
181 </simpara></listitem> | |
182 <listitem><simpara> | |
183 Using our very powerful plugin system (crop, expand, flip, postprocess, | |
184 rotate, scale, rgb/yuv conversion) | |
185 </simpara></listitem> | |
186 <listitem><simpara> | |
187 Can encode DVD/VOBsub <emphasis role="bold">AND</emphasis> text subtitles | |
188 into the output file | |
189 </simpara></listitem> | |
190 <listitem><simpara> | |
191 Can rip DVD subtitles to Vobsub format | |
192 </simpara></listitem> | |
193 </itemizedlist> | |
194 | |
195 <itemizedlist> | |
196 <title>Planned features</title> | |
197 <listitem><simpara> | |
198 Even wider variety of available en/decoding formats/codecs | |
199 (creating VOB files with DivX4/Indeo5/VIVO streams :). | |
200 </simpara></listitem> | |
201 </itemizedlist> | |
202 | |
203 <!-- FIXME: the license should be in bookinfo --> | |
204 <para> | |
205 <application>MPlayer</application> and <application>MEncoder</application> | |
206 can be distributed under the terms of the GNU General Public License Version 2. | |
207 </para> | |
208 | |
209 &history.xml; | |
210 &install.xml; | |
211 </chapter> | |
212 | |
213 | |
214 &features.xml; | |
215 &usage.xml; | |
216 &faq.xml; | |
217 &cd-dvd.xml; | |
218 &ports.xml; | |
219 &mencoder.xml; | |
220 &mail-lists.xml; | |
221 &bugreports.xml; | |
222 &bugs.xml; | |
223 &skin.xml; | |
224 &users-vs-dev.xml; | |
225 &patches.xml; | |
226 </book> |