mirror of
https://github.com/mpv-player/mpv
synced 2025-03-30 15:29:56 +00:00
<application> attack
git-svn-id: svn://svn.mplayerhq.hu/mplayer/trunk@11541 b3059339-0415-0410-9bf9-f77b7e298cf2
This commit is contained in:
wight
parent
40434c6079
commit
6eaad0c492
@ -400,7 +400,7 @@ Use automatic insertion of filters and optimize for quality.
|
||||
<term><option>3</option></term>
|
||||
<listitem><para>
|
||||
Use no automatic insertion of filters and no optimization.
|
||||
<emphasis>Warning:</emphasis> It may be possible to crash MPlayer
|
||||
<emphasis>Warning:</emphasis> It may be possible to crash <application>MPlayer</application>
|
||||
using this setting.
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
@ -492,7 +492,7 @@ to rectify the difference.
|
||||
<title>Up/Downsampling</title>
|
||||
|
||||
<para>
|
||||
MPlayer fully supports sound up/down-sampling through the
|
||||
<application>MPlayer</application> fully supports sound up/down-sampling through the
|
||||
<option>resample</option> filter. It can be used if you
|
||||
have a fixed frequency sound card or if you are stuck with an old sound card
|
||||
that is only capable of max 44.1kHz. This filter is automatically enabled if
|
||||
@ -740,9 +740,9 @@ would amplify the sound by 10.1dB and hard-clip if the sound level is too high.
|
||||
|
||||
<para>
|
||||
This filter has a second feature: It measures the overall maximum sound level
|
||||
and prints out that level when MPlayer exits. This volume estimate can be used
|
||||
for setting the sound level in MEncoder such that the maximum dynamic range is
|
||||
utilized.
|
||||
and prints out that level when <application>MPlayer</application> exits.
|
||||
This volume estimate can be used for setting the sound level in
|
||||
<application>MEncoder</application> such that the maximum dynamic range is utilized.
|
||||
</para>
|
||||
</sect4>
|
||||
|
||||
|
||||
@ -7,9 +7,9 @@ Good bug reports are a very valuable contribution to the development of any
|
||||
software project. But just like writing good software, good problem reports
|
||||
involve some work. Please realize that most developers are extremely busy and
|
||||
receive obscene amounts of email. So while your feedback is crucial in improving
|
||||
MPlayer and very much appreciated, please understand that you have to provide
|
||||
<emphasis role="bold">all</emphasis> of the information we request and follow
|
||||
the instructions in this document closely.
|
||||
<application>MPlayer</application> and very much appreciated, please understand
|
||||
that you have to provide <emphasis role="bold">all</emphasis> of the information
|
||||
we request and follow the instructions in this document closely.
|
||||
</para>
|
||||
<sect1 id="bugreports_fix">
|
||||
<title>How to fix bugs</title>
|
||||
@ -17,7 +17,7 @@ the instructions in this document closely.
|
||||
If you feel have the necessary skills you are invited to have a go at fixing the
|
||||
bug yourself. Or maybe you already did that? Please read
|
||||
<ulink url="../../tech/patches.txt">this short document</ulink> to find out how to
|
||||
get your code included in MPlayer. The people on the
|
||||
get your code included in <application>MPlayer</application>. The people on the
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng">mplayer-dev-eng</ulink>
|
||||
mailing list will assist you if you have questions.
|
||||
</para>
|
||||
@ -25,11 +25,12 @@ mailing list will assist you if you have questions.
|
||||
<sect1 id="bugreports_report">
|
||||
<title>How to report bugs</title>
|
||||
<para>
|
||||
First of all please try the latest CVS version of MPlayer as your bug might
|
||||
already be fixed there. Development moves extremely fast, most problems in
|
||||
official releases are reported within days or even hours, so please use
|
||||
<emphasis role="bold">only CVS</emphasis> to report bugs. This includes
|
||||
binary packages of MPlayer. CVS instructions can be found at the bottom of
|
||||
First of all please try the latest CVS version of <application>MPlayer</application>
|
||||
as your bug might already be fixed there. Development moves extremely fast,
|
||||
most problems in official releases are reported within days or even hours, so
|
||||
please use <emphasis role="bold">only CVS</emphasis> to report bugs. This
|
||||
includes binary packages of <application>MPlayer</application>. CVS
|
||||
instructions can be found at the bottom of
|
||||
<ulink url="http://www.mplayerhq.hu/homepage/dload.html">this page</ulink> or in
|
||||
the README. If this did not help please refer to the list of
|
||||
<link linkend="bugs">known bugs</link> and the rest of the documentation. If your
|
||||
@ -40,7 +41,7 @@ problem is not known or not solvable by our instructions, then please report the
|
||||
Please do not send bug reports privately to individual developers. This is
|
||||
community work and thus there might be several people interested in it. Sometimes
|
||||
other users already experienced your troubles and know how to circumvent a problem
|
||||
even if it is a bug in MPlayer code.
|
||||
even if it is a bug in <application>MPlayer</application> code.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@ -245,9 +246,9 @@ If your problem is specific to one or more files, then please upload the offende
|
||||
<para>
|
||||
Also upload a small text file having the same base name as your file with a .txt
|
||||
extension. Describe the problem you are having with the particular file there and
|
||||
include your email address as well as the output of MPlayer at verbosity level 1.
|
||||
Usually the first 1-5 MB of a file are enough to reproduce the problem, but to be
|
||||
sure we ask you to:
|
||||
include your email address as well as the output of <application>MPlayer</application>
|
||||
at verbosity level 1. Usually the first 1-5 MB of a file are enough to reproduce
|
||||
the problem, but to be sure we ask you to:
|
||||
<screen>dd if=<replaceable>yourfile</replaceable> of=<replaceable>smallfile</replaceable> bs=1024k count=5</screen>
|
||||
It will take the first five megabytes of '<emphasis role="bold">your-file</emphasis>'
|
||||
and write it to '<emphasis role="bold">small-file</emphasis>'. Then try again on
|
||||
@ -270,12 +271,12 @@ the crash you can extract useful information from the Core file. Here's how:
|
||||
<sect3 id="bugreports_debug">
|
||||
<title>How to conserve information about a reproducible crash</title>
|
||||
<para>
|
||||
Recompile MPlayer with debugging code enabled:
|
||||
Recompile <application>MPlayer</application> with debugging code enabled:
|
||||
<screen>
|
||||
./configure --enable-debug=3
|
||||
make
|
||||
</screen>
|
||||
and then run MPlayer within gdb using:
|
||||
and then run <application>MPlayer</application> within gdb using:
|
||||
<screen>gdb ./mplayer</screen>
|
||||
You are now within gdb. Type:
|
||||
<screen>run -v <replaceable>options-to-mplayer</replaceable> <replaceable>filename</replaceable></screen>
|
||||
@ -309,18 +310,18 @@ Then simply execute this command:
|
||||
<title>I know what I am doing...</title>
|
||||
<para>
|
||||
If you created a proper bug report following the steps above and you are confident
|
||||
it is a bug in MPlayer, not a compiler problem or broken file, you have already
|
||||
read the documentation and you could not find a solution, your sound drivers are
|
||||
OK, then you might want to subscribe to the mplayer-advusers list and send your
|
||||
bug report there to get a better and faster answer.
|
||||
it is a bug in <application>MPlayer</application>, not a compiler problem or broken
|
||||
file, you have already read the documentation and you could not find a solution,
|
||||
your sound drivers are OK, then you might want to subscribe to the mplayer-advusers
|
||||
list and send your bug report there to get a better and faster answer.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Please be advised that if you post newbie questions or questions answered in the
|
||||
manual there, you will be ignored or flamed instead of getting an appropriate answer.
|
||||
So do not flame us and subscribe to -advusers only if you really know what you are
|
||||
doing and feel like being an advanced MPlayer user or developer. If you meet these
|
||||
criteria it should not be difficult to find out how to subscribe...
|
||||
doing and feel like being an advanced <application>MPlayer</application> user or
|
||||
developer. If you meet these criteria it should not be difficult to find out how to subscribe...
|
||||
</para>
|
||||
|
||||
</sect1>
|
||||
|
||||
@ -13,13 +13,14 @@
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>General SIGILL (signal 4):</para>
|
||||
<para>Problem: you compiled and run MPlayer on different machines
|
||||
(for example compiled on P3 and running on Celeron)</para>
|
||||
<para>Solution: compile MPlayer on the same machine where you will use it!</para>
|
||||
<para>Problem: you compiled and run <application>MPlayer</application> on
|
||||
different machines (for example compiled on P3 and running on Celeron)</para>
|
||||
<para>Solution: compile <application>MPlayer</application> on the same machine
|
||||
where you will use it!</para>
|
||||
<para>Workaround: <command>./configure --disable-sse</command> etc. options</para>
|
||||
</listitem>
|
||||
<listitem>
|
||||
<para>"Internal buffer inconsistency" during MEncoder run:</para>
|
||||
<para>"Internal buffer inconsistency" during <application>MEncoder</application> run:</para>
|
||||
<para>Problem: known problem when lame < 3.90 was compiled with gcc 2.96 or 3.x.</para>
|
||||
<para>Solution: use lame >=3.90.</para>
|
||||
<para>Workaround: compile lame with gcc 2.95.x and remove any already installed
|
||||
@ -53,7 +54,7 @@ it's sound card (driver) problem.
|
||||
<itemizedlist>
|
||||
<listitem>
|
||||
<para>audio buffer problems (buffer size badly detected)</para>
|
||||
<para>Workaround: MPlayer's <option>-abs</option> option</para>
|
||||
<para>Workaround: <application>MPlayer's</application> <option>-abs</option> option</para>
|
||||
</listitem>
|
||||
</itemizedlist>
|
||||
<itemizedlist>
|
||||
|
||||
@ -93,9 +93,9 @@ line with the <option>-dvd-device</option> option.
|
||||
<application>MPlayer</application> uses <systemitem>libdvdread</systemitem> and
|
||||
<systemitem>libdvdcss</systemitem> for DVD decryption and playback. These two
|
||||
libraries are contained in the <filename class="directory">libmpdvdkit2/</filename>
|
||||
subdirectory of the MPlayer source tree, you do not have to install them separately.
|
||||
We opted for this solution because we had to fix a <systemitem>libdvdread</systemitem>
|
||||
bug and apply a patch which adds
|
||||
subdirectory of the <application>MPlayer</application> source tree, you do not have
|
||||
to install them separately. We opted for this solution because we had to fix a
|
||||
<systemitem>libdvdread</systemitem> bug and apply a patch which adds
|
||||
<emphasis role="bold">cracked CSS keys caching support</emphasis> to
|
||||
<systemitem>libdvdcss</systemitem> This results in a large speed increase because the
|
||||
keys do not have to be cracked every time before playing.
|
||||
@ -119,9 +119,10 @@ facilities.
|
||||
<para>
|
||||
Useful if you want to play encoded VOBs from <emphasis role="bold">hard disk</emphasis>.
|
||||
Compile and install <emphasis role="bold">libcss</emphasis> 0.0.1 (not newer) for this
|
||||
(If MPlayer fails to detect it, use the <option>-csslib /path/to/libcss.so</option>
|
||||
option). To use it, you need to be root, use a suid root MPlayer binary or let
|
||||
MPlayer call the suid-root fibmap_mplayer wrapper program.
|
||||
(If <application>MPlayer</application> fails to detect it, use the
|
||||
<option>-csslib /path/to/libcss.so</option> option). To use it, you need to be root,
|
||||
use a suid root <application>MPlayer</application> binary or let
|
||||
<application>MPlayer</application> call the suid-root fibmap_mplayer wrapper program.
|
||||
</para>
|
||||
</formalpara>
|
||||
|
||||
|
||||
@ -531,14 +531,14 @@ decoders:
|
||||
<procedure>
|
||||
<title>COMPILING MPLAYER WITH QUICKTIME LIBRARIES SUPPORT</title>
|
||||
<note><para>currently only 32bit Intel platforms are supported.</para></note>
|
||||
<step><para>download MPlayer CVS</para></step>
|
||||
<step><para>download <application>MPlayer</application> CVS</para></step>
|
||||
<step><para>download QuickTime DLL pack from
|
||||
<ulink url="http://www.mplayerhq.hu/MPlayer/releases/codecs/"/>
|
||||
</para></step>
|
||||
<step><para>extract QuickTime DLL pack to your Win32 codecs directory
|
||||
(default: <filename class="directory">/usr/local/lib/codecs/</filename>)
|
||||
</para></step>
|
||||
<step><para>compile MPlayer</para></step>
|
||||
<step><para>compile <application>MPlayer</application></para></step>
|
||||
</procedure>
|
||||
|
||||
</sect3>
|
||||
@ -726,7 +726,8 @@ libraries. For installation instructions please see the
|
||||
AAC (Advanced Audio Coding) is an audio codec sometimes found in MOV and MP4
|
||||
files. An open source decoder called FAAD is available from
|
||||
<ulink url="http://www.audiocoding.com"/>.
|
||||
MPlayer includes libfaad 2.0RC1, so you do not need to get it separately.
|
||||
<application>MPlayer</application> includes libfaad 2.0RC1, so you do not need
|
||||
to get it separately.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
|
||||
@ -28,7 +28,7 @@
|
||||
|
||||
<book id="index" lang="en">
|
||||
<bookinfo id="toc">
|
||||
<title>MPlayer - The Movie Player for LINUX</title>
|
||||
<title><application>MPlayer</application> - The Movie Player for LINUX</title>
|
||||
<subtitle><ulink url="http://www.mplayerhq.hu"></ulink></subtitle>
|
||||
<date>March 24, 2003</date>
|
||||
<copyright>
|
||||
@ -112,18 +112,19 @@ but the speed is also amazing.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
<application>MEncoder</application> (MPlayer's Movie Encoder) is a simple movie
|
||||
encoder, designed to encode MPlayer-playable movies
|
||||
<application>MEncoder</application> (<application>MPlayer's</application> Movie
|
||||
Encoder) is a simple movie encoder, designed to encode
|
||||
<application>MPlayer</application>-playable movies
|
||||
(<emphasis role="bold">AVI/ASF/OGG/DVD/VCD/VOB/MPG/MOV/VIV/FLI/RM/NUV/NET/PVA</emphasis>)
|
||||
to other MPlayer-playable formats (see below). It can encode with various codecs,
|
||||
like <emphasis role="bold">DivX4</emphasis> (1 or 2 passes), libavcodec,
|
||||
<emphasis role="bold">PCM/MP3/VBR MP3</emphasis> audio. Also has powerful plugin
|
||||
system for video manipulation.
|
||||
to other <application>MPlayer</application>-playable formats (see below). It
|
||||
can encode with various codecs, like <emphasis role="bold">DivX4</emphasis>
|
||||
(1 or 2 passes), libavcodec, <emphasis role="bold">PCM/MP3/VBR MP3</emphasis>
|
||||
audio. Also has powerful plugin system for video manipulation.
|
||||
</para>
|
||||
|
||||
|
||||
<itemizedlist>
|
||||
<title>MEncoder features</title>
|
||||
<title><application>MEncoder</application> features</title>
|
||||
<listitem><simpara>
|
||||
Encoding from the wide range of fileformats and decoders of
|
||||
<application>MPlayer</application>
|
||||
|
||||
@ -25,7 +25,7 @@ How can I support <application>MPlayer</application> development?
|
||||
<answer><para>
|
||||
We are more than happy to accept your hardware and software
|
||||
<ulink url="http://www.mplayerhq.hu/homepage/donations.html">donations</ulink>.
|
||||
They help us in continuously improving MPlayer.
|
||||
They help us in continuously improving <application>MPlayer</application>.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
@ -112,7 +112,7 @@ to 3.1 to solve the problem. How to install gcc is described in the
|
||||
|
||||
<qandaentry>
|
||||
<question><para>
|
||||
Configure ends with this text, and MPlayer won't compile!
|
||||
Configure ends with this text, and <application>MPlayer</application> won't compile!
|
||||
<screen>Your gcc does not support even i386 for '-march' and '-mcpu'</screen>
|
||||
</para></question>
|
||||
<answer><para>
|
||||
@ -144,14 +144,14 @@ Great, I have gcc 3.0.1 from Red Hat/Mandrake, then I'm fine!
|
||||
</para></question>
|
||||
<answer><para>
|
||||
No, since there have been/are issues with these compilers as well.
|
||||
To check the status of current compilers' MPlayer support, see the
|
||||
<link linkend="install">Installation</link> section.
|
||||
To check the status of current compilers' <application>MPlayer</application>
|
||||
support, see the <link linkend="install">Installation</link> section.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
<qandaentry>
|
||||
<question><para>
|
||||
I tried to compile MPlayer, but I got this output:
|
||||
I tried to compile <application>MPlayer</application>, but I got this output:
|
||||
<screen>
|
||||
In file included from /usr/include/g++-v3/bits/std_cwchar.h:42,
|
||||
from /usr/include/g++-v3/bits/fpos.h:40,
|
||||
@ -185,12 +185,13 @@ list (the word 'ideg' is described below):
|
||||
And we have idegs. And our idegcounter overflowed again and again.
|
||||
</para>
|
||||
<para>
|
||||
Unfortunately MPlayer is out of our control. It's used by lamers, Linux
|
||||
users who can't even use Windows, and never tried to compile a kernel. They
|
||||
installed (with default options) Mandrake or Red Hat or SuSE, and without
|
||||
RTFM'ing they send messages saying 'it doesn't work! help me! please! i'm
|
||||
new to Linux! help! oh! help me!'. We can't stop them, but at least we try
|
||||
to force them to RTFM and to read the messages of ./configure and MPlayer.
|
||||
Unfortunately <application>MPlayer</application> is out of our control.
|
||||
It's used by lamers, Linux users who can't even use Windows, and never
|
||||
tried to compile a kernel. They installed (with default options) Mandrake
|
||||
or Red Hat or SuSE, and without RTFM'ing they send messages saying
|
||||
'it doesn't work! help me! please! i'm new to Linux! help! oh! help me!'.
|
||||
We can't stop them, but at least we try to force them to RTFM and to read
|
||||
the messages of ./configure and <application>MPlayer</application>.
|
||||
</para>
|
||||
<para>
|
||||
And you clever guys come and flame us with gcc 2.96 and binary packages.
|
||||
@ -290,8 +291,8 @@ Upgrade your kernel, modutils and <application>MPlayer</application>.
|
||||
|
||||
<qandaentry>
|
||||
<question><para>
|
||||
During 'make', MPlayer complains about X11 libraries. I don't understand,
|
||||
I DO have X installed!?
|
||||
During 'make', <application>MPlayer</application> complains about X11 libraries.
|
||||
I don't understand, I DO have X installed!?
|
||||
</para></question>
|
||||
<answer><para>
|
||||
... but you don't have the X development package installed. Or not correctly.
|
||||
@ -321,7 +322,8 @@ You have to edit SVGAlib's <filename>Makefile.cfg</filename> and comment
|
||||
|
||||
<qandaentry>
|
||||
<question><para>
|
||||
I compiled MPlayer with libdvdcss/libdivxdecore support, but when I try to start it, it says:
|
||||
I compiled <application>MPlayer</application> with libdvdcss/libdivxdecore support,
|
||||
but when I try to start it, it says:
|
||||
<screen>
|
||||
error while loading shared libraries: lib*.so.0: cannot load shared object file: No such file or directory
|
||||
</screen>
|
||||
@ -346,7 +348,7 @@ or newer should be good). Since it is not our fault, please do
|
||||
|
||||
<qandaentry>
|
||||
<question><para>
|
||||
MPlayer dies with segmentation fault upon pthread check!
|
||||
<application>MPlayer</application> dies with segmentation fault upon pthread check!
|
||||
</para></question>
|
||||
<answer><para>
|
||||
<command>chmod 644 /usr/lib/libc.so</command>
|
||||
@ -515,7 +517,7 @@ And what is "Faszom(C)ounter"?
|
||||
</para></question>
|
||||
<answer><para>
|
||||
"Fasz" is a Hungarian word you don't want to know, the others are
|
||||
connected to the perverted minds of the MPlayer developers.
|
||||
connected to the perverted minds of the <application>MPlayer</application> developers.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
@ -601,7 +603,7 @@ to <systemitem>Yes</systemitem></para></listitem>
|
||||
|
||||
<qandaentry>
|
||||
<question><para>
|
||||
How can I run MPlayer in the background?
|
||||
How can I run <application>MPlayer</application> in the background?
|
||||
</para></question>
|
||||
<answer><para>
|
||||
Use:
|
||||
@ -622,7 +624,7 @@ Do you have a stray <filename>codecs.conf</filename> file in
|
||||
<filename>~/.mplayer/</filename>, <filename>/etc/</filename>,
|
||||
<filename>/usr/local/etc/</filename> or a similar location? Remove it,
|
||||
outdated <filename>codecs.conf</filename> files can cause obscure
|
||||
problems. MPlayer will use its builtin one instead.
|
||||
problems. <application>MPlayer</application> will use its builtin one instead.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
@ -665,7 +667,7 @@ then there is a problem with your kernel/libc. Maybe you are using some security
|
||||
patches (for example Solar Designer's OpenWall patch) which forces loading
|
||||
libraries to very low addresses. Because <filename>l3codeca.acm</filename> is a
|
||||
non-relocatable DLL, it must be loaded to <literal>0x00400000</literal>, we can't
|
||||
change this. You should use a non-patched kernel, or use MPlayer's
|
||||
change this. You should use a non-patched kernel, or use <application>MPlayer's</application>
|
||||
<option>-afm 1</option> option to disable using <filename>l3codeca.acm</filename>.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
@ -687,10 +689,11 @@ documentation to see if you can improve performance.
|
||||
<screen>MPlayer interrupted by signal 4 in module: decode_video</screen>
|
||||
</para></question>
|
||||
<answer><para>
|
||||
Try running MPlayer on the machine you compiled on. Or recompile with runtime
|
||||
CPU detection (<command>./configure --enable-runtime-cpudetection</command>).
|
||||
Don't use MPlayer on a CPU different from the one it was compiled on, without
|
||||
using the feature mentioned just now.
|
||||
Try running <application>MPlayer</application> on the machine you compiled on.
|
||||
Or recompile with runtime CPU detection
|
||||
(<command>./configure --enable-runtime-cpudetection</command>).
|
||||
Don't use <application>MPlayer</application> on a CPU different from the one
|
||||
it was compiled on, without using the feature mentioned just now.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
@ -759,7 +762,7 @@ This can have multiple reasons.
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
Your CPU <emphasis role="bold">and/or</emphasis> video card <emphasis role="bold">and/or</emphasis>
|
||||
bus is too slow. MPlayer displays a message if this is the case (and the
|
||||
bus is too slow. <application>MPlayer</application> displays a message if this is the case (and the
|
||||
dropped frames counter goes up fast).
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
@ -884,7 +887,7 @@ I have no sound when playing a video and get error messages similar to this one:
|
||||
<answer><para>
|
||||
Are you running KDE or GNOME with the ARTS or ESD sound daemon? Try disabling
|
||||
the sound daemon or use the <option>-ao arts</option> or <option>-ao esd</option>
|
||||
option to make MPlayer use ARTS or ESD.
|
||||
option to make <application>MPlayer</application> use ARTS or ESD.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
@ -908,8 +911,8 @@ Help me!
|
||||
</para></question>
|
||||
<answer><para>
|
||||
It works only if running as root! It's a DGA limitation. You should become root
|
||||
(<command>su -</command>), and try again. Another solution is making MPlayer SUID
|
||||
root, but it's not recommended!
|
||||
(<command>su -</command>), and try again. Another solution is making
|
||||
<application>MPlayer</application> SUID root, but it's not recommended!
|
||||
<screen>
|
||||
chown root /usr/local/bin/mplayer
|
||||
chmod 755 /usr/local/bin/mplayer
|
||||
@ -918,7 +921,7 @@ root, but it's not recommended!
|
||||
<warning><para>
|
||||
This is a <emphasis role="bold">big</emphasis> security risk! <emphasis role="bold">Never</emphasis>
|
||||
do this on a server or on a computer that you do not control completely because
|
||||
other users can gain root privileges through SUID root MPlayer.
|
||||
other users can gain root privileges through SUID root <application>MPlayer</application>.
|
||||
<emphasis role="bold">You have been warned</emphasis>.
|
||||
</para></warning>
|
||||
</para></answer>
|
||||
@ -1038,7 +1041,7 @@ in <application>MPlayer</application> source, and used by default.
|
||||
|
||||
<qandaentry>
|
||||
<question><para>
|
||||
What about subtitles? Can MPlayer display them?
|
||||
What about subtitles? Can <application>MPlayer</application> display them?
|
||||
</para></question>
|
||||
<answer><para>
|
||||
Yes. See the <link linkend="dvd">DVD chapter</link>.
|
||||
@ -1070,8 +1073,9 @@ Where can I get libdvdread and libdvdcss packages?
|
||||
</para></question>
|
||||
<answer><para>
|
||||
You don't need to. Use <emphasis role="bold">libmpdvdkit2</emphasis>, which is
|
||||
present in the MPlayer source, and used by default. You can get the mentioned
|
||||
packages from the <ulink url="http://www.dtek.chalmers.se/groups/dvd/">Ogle site</ulink>.
|
||||
present in the <application>MPlayer</application> source, and used by default.
|
||||
You can get the mentioned packages from the
|
||||
<ulink url="http://www.dtek.chalmers.se/groups/dvd/">Ogle site</ulink>.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
@ -1100,8 +1104,9 @@ in the <link linkend="drives">CD chapter</link>).
|
||||
<title>Feature requests</title>
|
||||
<qandaentry>
|
||||
<question><para>
|
||||
If MPlayer is paused and I try to seek or press any key at all, MPlayer
|
||||
ceases to be paused. I would like to be able to seek in the paused movie.
|
||||
If <application>MPlayer</application> is paused and I try to seek or press any key at all,
|
||||
<application>MPlayer</application> ceases to be paused. I would like to be able
|
||||
to seek in the paused movie.
|
||||
</para></question>
|
||||
<answer><para>
|
||||
This is very tricky to implement without losing A/V synchronization.
|
||||
@ -1121,7 +1126,8 @@ Feel free to implement it, and send a patch. Don't ask for it.
|
||||
|
||||
<qandaentry>
|
||||
<question><para>
|
||||
How can I make MPlayer remember the options I use for this particular file?
|
||||
How can I make <application>MPlayer</application> remember the options I use
|
||||
for this particular file?
|
||||
</para></question>
|
||||
<answer><para>
|
||||
Create a file named <filename>movie.avi.conf</filename> with the file-specific
|
||||
@ -1138,7 +1144,8 @@ in the same directory as the file.
|
||||
How can I encode?
|
||||
</para></question>
|
||||
<answer><para>
|
||||
Read the <link linkend="mencoder">MEncoder</link> section.
|
||||
Read the <link linkend="mencoder"><application>MEncoder</application></link>
|
||||
section.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
@ -1249,7 +1256,7 @@ How can I put subtitles in the output file?
|
||||
</para></question>
|
||||
<answer><para>
|
||||
Just pass the <option>-sub <filename></option> (or <option>-sid</option>,
|
||||
<option>-vobsub</option>, respectively) option to MEncoder.
|
||||
<option>-vobsub</option>, respectively) option to <application>MEncoder</application>.
|
||||
</para></answer>
|
||||
</qandaentry>
|
||||
|
||||
|
||||
@ -25,7 +25,7 @@ players will not play it, since they expect MPEG1 video and MP2 audio (unlike
|
||||
does not have the necessary fields to describe its video and audio streams).
|
||||
Or you might put MPEG1 video into an AVI file.
|
||||
<ulink url="http://ffmpeg.sourceforge.net/">FFmpeg</ulink> and
|
||||
<link linkend="mencoder">MEncoder</link> can create these files.
|
||||
<link linkend="mencoder"><application>MEncoder</application></link> can create these files.
|
||||
</para>
|
||||
|
||||
|
||||
@ -155,8 +155,8 @@ supported by most players. The file format makes it possible to use VBR
|
||||
audio, but most players expect CBR audio, thus they fail with VBR. VBR is
|
||||
uncommon and Microsoft's AVI specs only describe CBR audio. I also noticed
|
||||
that most AVI encoders/multiplexers create bad files when using VBR audio.
|
||||
There are only two known exceptions:
|
||||
<application>NanDub</application> and <link linkend="mencoder">MEncoder</link>.
|
||||
There are only two known exceptions: <application>NanDub</application> and
|
||||
<link linkend="mencoder"><application>MEncoder</application></link>.
|
||||
</para>
|
||||
</sect3>
|
||||
|
||||
@ -337,8 +337,8 @@ The PVA specifications can be downloaded from the following address:
|
||||
<para>
|
||||
The <emphasis role="bold">GIF</emphasis> format is a common format for web
|
||||
graphics. There are two versions of the GIF spec, GIF87a and GIF89a. The
|
||||
main difference is that GIF89a allows for animation. MPlayer supports both
|
||||
formats through use of <systemitem class="library">libungif</systemitem> or
|
||||
main difference is that GIF89a allows for animation. <application>MPlayer</application>
|
||||
supports both formats through use of <systemitem class="library">libungif</systemitem> or
|
||||
another libgif-compatible library. Non-animated GIFs will be displayed as
|
||||
single frame videos. (Use the <option>-loop</option> and <option>-fixed-vo</option>
|
||||
options to display these longer.)
|
||||
|
||||
@ -6,104 +6,109 @@
|
||||
|
||||
<blockquote><para>
|
||||
This began a year ago... I have tried lots of players under linux
|
||||
(mtv, xmps, dvdview, livid/oms, videolan, xine, xanim, avifile, xmmp) but
|
||||
they all have some problem. Mostly with special files or with audio/video
|
||||
sync. Most of them are unable to play both MPEG1, MPEG2 and AVI (DivX)
|
||||
files. Many players have image quality or speed problems too. So I've
|
||||
decided to write/modify one...
|
||||
(<application>mtv</application>, <application>xmps</application>,
|
||||
<application>dvdview</application>, <application>livid/oms</application>,
|
||||
<application>videolan</application>, <application>xine</application>,
|
||||
<application>xanim</application>, <application>avifile</application>,
|
||||
<application>xmmp</application>) but they all have some problem. Mostly with
|
||||
special files or with audio/video sync. Most of them are unable to play both
|
||||
MPEG1, MPEG2 and AVI (DivX) files. Many players have image quality or speed
|
||||
problems too. So I've decided to write/modify one...
|
||||
</para></blockquote><para>A'rpi, 2001</para>
|
||||
|
||||
<para>
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">mpg12play v0.1-v0.3</emphasis>: Sep 22-25, 2000
|
||||
<emphasis role="bold"><application>mpg12play</application> v0.1-v0.3</emphasis>: Sep 22-25, 2000
|
||||
</para>
|
||||
<para>The first try, hacked together in a half hour! I've used libmpeg3
|
||||
from <ulink url="http://www.heroinewarrior.com"/> up to the version 0.3, but
|
||||
there were image quality and speed problems with it.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">mpg12play v0.5-v0.87</emphasis>: Sep 28-Oct 20, 2000
|
||||
<emphasis role="bold"><application>mpg12play</application> v0.5-v0.87</emphasis>: Sep 28-Oct 20, 2000
|
||||
</para><para>Mpeg codec replaced with DVDview by Dirk Farin, it was a
|
||||
great stuff, but it was slow and was written in C++ (A'rpi hates C++!!!)
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">mpg12play v0.9-v0.95pre5</emphasis>: Oct 21-Nov 2, 2000
|
||||
<emphasis role="bold"><application>mpg12play</application> v0.9-v0.95pre5</emphasis>: Oct 21-Nov 2, 2000
|
||||
</para><para>Mpeg codec was libmpeg2 (mpeg2dec) by Aaron Holtzman and
|
||||
Michel Lespinasse. It's great, optimized very fast C code with perfect
|
||||
image quality and 100% MPEG standard conformance.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer v0.3-v0.9</emphasis>: Nov 18-Dec 4, 2000
|
||||
<emphasis role="bold"><application>MPlayer</application> v0.3-v0.9</emphasis>: Nov 18-Dec 4, 2000
|
||||
</para><para>It was a pack of two programs: mpg12play v0.95pre6 and my
|
||||
new simple AVI player 'avip' based on avifile's Win32 DLL loader.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer v0.10</emphasis>: Jan 1, 2001
|
||||
<emphasis role="bold"><application>MPlayer</application> v0.10</emphasis>: Jan 1, 2001
|
||||
</para><para>The MPEG and AVI player in a single binary!
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer v0.11pre series</emphasis>:
|
||||
</para><para>Some new developers joined and since 0.11 the MPlayer project
|
||||
is a team-work! Added ASF file support, and OpenDivX
|
||||
<emphasis role="bold"><application>MPlayer</application> v0.11pre series</emphasis>:
|
||||
</para><para>Some new developers joined and since 0.11 the <application>MPlayer</application>
|
||||
project is a team-work! Added ASF file support, and OpenDivX
|
||||
(see <ulink url="http://www.projectmayo.com"/>) en/decoding.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer v0.17a "The IdegCounter"</emphasis> Apr 27, 2001
|
||||
<emphasis role="bold"><application>MPlayer</application> v0.17a "The IdegCounter"</emphasis> Apr 27, 2001
|
||||
</para><para>The release version of the 0.11pre after 4 months of heavy
|
||||
development! Try it, and be amazed! Thousands of new features added...
|
||||
and of course old code was improved too, bugs removed etc.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer 0.18 "The BugCounter"</emphasis> Jul 9, 2001
|
||||
<emphasis role="bold"><application>MPlayer</application> 0.18 "The BugCounter"</emphasis> Jul 9, 2001
|
||||
</para><para>2 months since 0.17 and here's a new release.. Completed ASF
|
||||
support, more subtitle formats, introduced libao (similar to libvo but to
|
||||
audio), even more stable than ever, and so on. It's a MUST!
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer 0.50 "The Faszom(C)ounter"</emphasis> Oct 8, 2001
|
||||
<emphasis role="bold"><application>MPlayer</application> 0.50 "The Faszom(C)ounter"</emphasis> Oct 8, 2001
|
||||
</para><para>Hmm. Release again. Tons of new features, beta GUI version,
|
||||
bugs fixed, new vo and ao drivers, ported to many systems, including
|
||||
opensource DivX codecs and much more. Try it!
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer 0.60 "The RTFMCounter"</emphasis> Jan 3, 2002
|
||||
<emphasis role="bold"><application>MPlayer</application> 0.60 "The RTFMCounter"</emphasis> Jan 3, 2002
|
||||
</para><para>MOV/VIVO/RM/FLI/NUV fileformats support, native CRAM, Cinepak,
|
||||
ADPCM codecs, and support for XAnim's binary codecs; DVD subtitles support,
|
||||
first release of MEncoder, TV grabbing, cache, liba52, countless fixes.
|
||||
first release of <application>MEncoder</application>, TV grabbing, cache,
|
||||
liba52, countless fixes.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer 0.90pre10 "The BirthdayCounter"</emphasis> Nov 11, 2002
|
||||
<emphasis role="bold"><application>MPlayer</application> 0.90pre10 "The BirthdayCounter"</emphasis> Nov 11, 2002
|
||||
</para><para> Although this is not a release, I am going to mention it because it
|
||||
came out 2 years after MPlayer v0.01. Happy birthday, MPlayer!
|
||||
came out 2 years after <application>MPlayer</application> v0.01.
|
||||
Happy birthday, <application>MPlayer</application>!
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer 0.90rc1 "The CodecCounter"</emphasis> Dec 7, 2002
|
||||
<emphasis role="bold"><application>MPlayer</application> 0.90rc1 "The CodecCounter"</emphasis> Dec 7, 2002
|
||||
</para><para>Again not a release, but after adding Sorenson 3 (QuickTime)
|
||||
and Windows Media 9 support, MPlayer is the world's first movie player with
|
||||
support for all known video formats!
|
||||
and Windows Media 9 support, <application>MPlayer</application> is the
|
||||
world's first movie player with support for all known video formats!
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer 0.90 "The CounterCounter"</emphasis> Apr 6, 2003
|
||||
<emphasis role="bold"><application>MPlayer</application> 0.90 "The CounterCounter"</emphasis> Apr 6, 2003
|
||||
</para><para>After more than 1 year, we finally concluded that the code was indeed
|
||||
stable again, and ready to be published as a release. Unfortunately we
|
||||
forgot even to increase the version number, and other annoying bugs went
|
||||
in, so get ready for...
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer 0.91</emphasis> Aug 13, 2003
|
||||
<emphasis role="bold"><application>MPlayer</application> 0.91</emphasis> Aug 13, 2003
|
||||
</para><para>The above mentioned and lot of other bugs have been fixed.
|
||||
This is the latest stable version.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer 1.0pre1 "Development on the beach"</emphasis> Sep 1, 2003
|
||||
<emphasis role="bold"><application>MPlayer</application> 1.0pre1 "Development on the beach"</emphasis> Sep 1, 2003
|
||||
</para><para>Although this is not a stable release, I am going to mention
|
||||
it because it is the first pre version of the 1.0 series of MPlayer and
|
||||
it is intended to help the <emphasis>big bug hunting party</emphasis>.
|
||||
it because it is the first pre version of the 1.0 series of <application>MPlayer</application>
|
||||
and it is intended to help the <emphasis>big bug hunting party</emphasis>.
|
||||
This is a huge step forward!
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
<emphasis role="bold">MPlayer 1.0</emphasis> date yet unknown
|
||||
<emphasis role="bold"><application>MPlayer</application> 1.0</emphasis> date yet unknown
|
||||
</para></listitem>
|
||||
</itemizedlist>
|
||||
</para>
|
||||
|
||||
@ -187,7 +187,8 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
|
||||
and encoding. Features:
|
||||
<itemizedlist>
|
||||
<listitem><simpara>
|
||||
1 pass or 2 pass encoding with <link linkend="mencoder">MEncoder</link>
|
||||
1 pass or 2 pass encoding with
|
||||
<link linkend="mencoder"><application>MEncoder</application></link>
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>
|
||||
can play old <emphasis role="bold">DivX3</emphasis> movies much faster than
|
||||
@ -203,7 +204,8 @@ You need a fairly recent system. On Linux, 2.4.x kernels are recommended.
|
||||
Divx4Linux. Features:
|
||||
<itemizedlist>
|
||||
<listitem><simpara>
|
||||
1 pass or 2 pass encoding with <link linkend="mencoder">MEncoder</link>
|
||||
1 pass or 2 pass encoding with
|
||||
<link linkend="mencoder"><application>MEncoder</application></link>
|
||||
</simpara></listitem>
|
||||
<listitem><simpara>
|
||||
it's open-source, so it's multiplatform.
|
||||
@ -426,7 +428,8 @@ it works with the following drivers:
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
If you want to install <application>MEncoder</application> (our great
|
||||
all-purpose encoder), see the <link linkend="mencoder">MEncoder</link> section.
|
||||
all-purpose encoder), see the
|
||||
<link linkend="mencoder"><application>MEncoder</application></link> section.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
If you have a V4L compatible <emphasis role="bold">TV tuner</emphasis> card,
|
||||
@ -463,9 +466,9 @@ copy of it. Check if you have
|
||||
Note that if you have a <filename>codecs.conf</filename> in
|
||||
<filename>~/.mplayer/</filename>, the builtin and system
|
||||
<filename>codecs.conf</filename> will be ignored completely.
|
||||
Do not do this unless you want to fiddle with MPlayer internals as this can
|
||||
can cause many problems. If you want to change the codecs search order, use
|
||||
the <option>-vc</option>, <option>-ac</option>, <option>-vfm</option>,
|
||||
Do not do this unless you want to fiddle with <application>MPlayer</application>
|
||||
internals as this can can cause many problems. If you want to change the codecs
|
||||
search order, use the <option>-vc</option>, <option>-ac</option>, <option>-vfm</option>,
|
||||
or <option>-afm</option> options either on the command line or in your
|
||||
config file (see the manual page).
|
||||
</para>
|
||||
@ -494,8 +497,8 @@ header files (usually the -dev packages) and their version matches. The
|
||||
<para>
|
||||
Though not mandatory, the fonts should be installed in order to gain OSD,
|
||||
and subtitle functionality. The recommended method is installing a TTF
|
||||
font file and telling MPlayer to use it. See the <link linkend="subosd">Subtitles
|
||||
and OSD</link> section for details.
|
||||
font file and telling <application>MPlayer</application> to use it.
|
||||
See the <link linkend="subosd">Subtitles and OSD</link> section for details.
|
||||
</para>
|
||||
|
||||
</sect2>
|
||||
@ -543,8 +546,8 @@ directory.
|
||||
<title>Subtitles and OSD</title>
|
||||
|
||||
<para>
|
||||
MPlayer can display subtitles along with movie files. Currently the
|
||||
following formats are supported:
|
||||
<application>MPlayer</application> can display subtitles along with movie files.
|
||||
Currently the following formats are supported:
|
||||
<itemizedlist>
|
||||
<listitem><para>VobSub</para></listitem>
|
||||
<listitem><para>OGM</para></listitem>
|
||||
@ -563,7 +566,7 @@ following formats are supported:
|
||||
</para>
|
||||
|
||||
<para>
|
||||
MPlayer can dump the previously listed subtitle formats
|
||||
<application>MPlayer</application> can dump the previously listed subtitle formats
|
||||
(<emphasis role="bold">except the three first</emphasis>) into the following
|
||||
destination formats, with the given options:
|
||||
<itemizedlist>
|
||||
@ -576,7 +579,8 @@ destination formats, with the given options:
|
||||
</para>
|
||||
|
||||
<para>
|
||||
MEncoder can dump DVD subtitles into <link linkend="menc-feat-extractsub">VobSub</link> format.
|
||||
<application>MEncoder</application> can dump DVD subtitles into
|
||||
<link linkend="menc-feat-extractsub">VobSub</link> format.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@ -644,7 +648,8 @@ format uses absolute frame numbers for its timing, and therefore the
|
||||
<application>MPlayer</application> has no way to guess the frame rate of
|
||||
the subtitle file, you have to manually convert the frame rate. There is a
|
||||
little perl script in the <filename class="directory">contrib</filename>
|
||||
directory of the MPlayer FTP site to do this conversion for you.
|
||||
directory of the <application>MPlayer</application> FTP site to do this
|
||||
conversion for you.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@ -653,7 +658,7 @@ About DVD subtitles, read the <link linkend="dvd">DVD</link> section.
|
||||
|
||||
|
||||
<sect2 id="mpsub">
|
||||
<title>MPlayer's own subtitle format (MPsub)</title>
|
||||
<title><application>MPlayer's</application> own subtitle format (MPsub)</title>
|
||||
|
||||
<para>
|
||||
<application>MPlayer</application> introduces a new subtitle format called
|
||||
@ -701,8 +706,8 @@ seek bar etc.
|
||||
<title>Installing OSD and subtitles</title>
|
||||
|
||||
<para>
|
||||
You need an MPlayer font package to be able to use OSD/SUB feature.
|
||||
There are many ways to get it:
|
||||
You need an <application>MPlayer</application> font package to be able to use
|
||||
OSD/SUB feature. There are many ways to get it:
|
||||
</para>
|
||||
|
||||
<itemizedlist>
|
||||
@ -720,10 +725,10 @@ library. Version 2.0.9 or greater is mandatory! Then you have two methods:
|
||||
</itemizedlist>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
Download ready-to-use font packages from MPlayer site. Note: currently
|
||||
available fonts are limited for ISO 8859-1/2 support, but there are some
|
||||
other (including Korean, Russian, ISO 8859-8 etc) fonts at contrib/font
|
||||
section of FTP, made by users.
|
||||
Download ready-to-use font packages from <application>MPlayer</application>
|
||||
site. Note: currently available fonts are limited for ISO 8859-1/2 support,
|
||||
but there are some other (including Korean, Russian, ISO 8859-8 etc) fonts at
|
||||
contrib/font section of FTP, made by users.
|
||||
</para><para>
|
||||
<!-- FIXME: this para should be before the list -->
|
||||
Font should have appropriate <filename>font.desc</filename> file which
|
||||
@ -824,7 +829,7 @@ variable in config file, or the <option>-osdlevel</option> command line option.
|
||||
<title>OSD menu</title>
|
||||
|
||||
<para>
|
||||
MPlayer has a completely user definiable OSD Menu interface.
|
||||
<application>MPlayer</application> has a completely user definiable OSD Menu interface.
|
||||
</para>
|
||||
|
||||
<note><simpara>
|
||||
@ -871,7 +876,7 @@ the Preferences menu is currently UNIMPLEMENTED!
|
||||
<sect1 id="rtc">
|
||||
<title>RTC</title>
|
||||
<para>
|
||||
There are three timing methods in MPlayer.
|
||||
There are three timing methods in <application>MPlayer</application>.
|
||||
|
||||
<itemizedlist>
|
||||
<listitem><simpara>
|
||||
|
||||
@ -14,27 +14,28 @@ mails a lot easier. If you do not know them please read
|
||||
are in a hurry) <ulink url="http://www.xs4all.nl/~hanb/documents/quotingguide.html">Quoting HOWTO</ulink>.
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
MPlayer announce list:
|
||||
<application>MPlayer</application> announce list:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-announce"/>
|
||||
List for MPlayer announcements. Subscribe here if you want to get
|
||||
announcements about new features.
|
||||
List for <application>MPlayer</application> announcements.
|
||||
Subscribe here if you want to get announcements about new features.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
MPlayer developers list:
|
||||
<application>MPlayer</application> developers list:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-dev-eng"/>
|
||||
This list is about MPlayer development! Talking about interface/API changes,
|
||||
new libraries, code optimization, configure changes is ontopic here. Send patches
|
||||
but not bug reports, user questions, feature requests or flames here to keep the
|
||||
list traffic low.
|
||||
This list is about <application>MPlayer</application> development!
|
||||
Talking about interface/API changes, new libraries, code optimization,
|
||||
configure changes is ontopic here. Send patches but not bug reports,
|
||||
user questions, feature requests or flames here to keep the list traffic low.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
MPlayer DOCS list:
|
||||
<application>MPlayer</application> DOCS list:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-docs"/>
|
||||
This list is about MPlayer documentation and translation discussions.
|
||||
This list is about <application>MPlayer</application> documentation
|
||||
and translation discussions.
|
||||
Documentation and homepage related CVS logs are also sent here.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
MPlayer users list:
|
||||
<application>MPlayer</application> users list:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-users"/>
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
@ -52,7 +53,7 @@ MPlayer users list:
|
||||
</itemizedlist>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
MPlayer Hungarian users list:
|
||||
<application>MPlayer</application> Hungarian users list:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-felhasznalok"/>
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
@ -64,7 +65,7 @@ MPlayer Hungarian users list:
|
||||
</itemizedlist>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
MPlayer & Matrox G200/G400/G450/G550 users:
|
||||
<application>MPlayer</application> & Matrox G200/G400/G450/G550 users:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-matrox"/>
|
||||
Matrox related questions like
|
||||
<itemizedlist>
|
||||
@ -80,30 +81,30 @@ Matrox related questions like
|
||||
</itemizedlist>
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
MPlayer & DVB card users:
|
||||
<application>MPlayer</application> & DVB card users:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-dvb"/>
|
||||
Things related to the hardware decoder card called DVB (not <emphasis role="bold">DXR3</emphasis>!).
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
MPlayer CVS-log:
|
||||
<application>MPlayer</application> CVS-log:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-cvslog"/>
|
||||
All changes in MPlayer code are automatically sent to this list. Only
|
||||
questions about these changes belong here (if you do not understand why a
|
||||
change is required or you have a better fix or you have noticed a possible
|
||||
bug/problem in the commit).
|
||||
All changes in <application>MPlayer</application> code are automatically
|
||||
sent to this list. Only questions about these changes belong here
|
||||
(if you do not understand why a change is required or you have a better
|
||||
fix or you have noticed a possible bug/problem in the commit).
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
MPlayer Cygwin-porting list:
|
||||
<application>MPlayer</application> Cygwin-porting list:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-cygwin"/>
|
||||
List for discussion about MPlayer's Cygwin port.
|
||||
List for discussion about <application>MPlayer's</application> Cygwin port.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
MPlayer OS/2-porting list:
|
||||
<application>MPlayer</application> OS/2-porting list:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-os2"/>
|
||||
List for discussion about MPlayer's OS/2 port.
|
||||
List for discussion about <application>MPlayer's</application> OS/2 port.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
MPlayer Weekly News' editors and translators list:
|
||||
<application>MPlayer</application> Weekly News' editors and translators list:
|
||||
<ulink url="http://mplayerhq.hu/mailman/listinfo/mplayer-mwn"/>
|
||||
List for discussion about the Weekly News releases.
|
||||
</para></listitem>
|
||||
|
||||
@ -1,7 +1,7 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<chapter id="mencoder">
|
||||
<title>Encoding with MEncoder</title>
|
||||
<title>Encoding with <application>MEncoder</application></title>
|
||||
|
||||
<para>
|
||||
For the complete list of available <application>MEncoder</application> options
|
||||
@ -76,7 +76,7 @@ once, unlike in 2-pass mode. The schematics:
|
||||
mencoder <replaceable>file/DVD</replaceable> -oac copy -ovc lavc -lavcopts vcodec=mpeg4:vpass=1:vbitrate=<replaceable>bitrate</replaceable><!--
|
||||
--></screen>
|
||||
This is the first pass of video encoding. Optionally specify the video
|
||||
bitrate MEncoder printed at the end of the previous pass.
|
||||
bitrate <application>MEncoder</application> printed at the end of the previous pass.
|
||||
</para></step>
|
||||
<step><para>
|
||||
<emphasis>Third pass:</emphasis>
|
||||
@ -118,12 +118,13 @@ audio streams in MPEG files.
|
||||
|
||||
<para>
|
||||
this feature is not very useful right now, aside that it probably has many bugs,
|
||||
but the more importantly because MEncoder currently cannot encode MPEG1 layer 2
|
||||
(MP2) audio, which all other players expect in MPEG files.
|
||||
but the more importantly because <application>MEncoder</application> currently
|
||||
cannot encode MPEG1 layer 2 (MP2) audio, which all other players expect in MPEG files.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
To change MEncoder's output file format, use the <option>-of mpeg</option> option.
|
||||
To change <application>MEncoder's</application> output file format,
|
||||
use the <option>-of mpeg</option> option.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@ -215,8 +216,8 @@ mencoder -idx <replaceable>input.avi</replaceable> -ovc copy -oac copy -o <repla
|
||||
<title>Appending multiple AVI files</title>
|
||||
|
||||
<para>
|
||||
As a side-effect, the broken AVI fixer function enables MEncoder to append
|
||||
2 (or more) AVI files:
|
||||
As a side-effect, the broken AVI fixer function enables <application>MEncoder</application>
|
||||
to append 2 (or more) AVI files:
|
||||
</para>
|
||||
|
||||
<para>
|
||||
|
||||
@ -8,24 +8,25 @@
|
||||
<para>
|
||||
The main development platform is Linux on x86, although
|
||||
<application>MPlayer</application> works on many other Linux ports.
|
||||
Binary packages of MPlayer are available from several sources. However,
|
||||
<emphasis role="bold">none of these packages are supported</emphasis>.
|
||||
Binary packages of <application>MPlayer</application> are available from several
|
||||
sources. However, <emphasis role="bold">none of these packages are supported</emphasis>.
|
||||
Report problems to the authors, not to us.
|
||||
</para>
|
||||
|
||||
<sect2 id="debian">
|
||||
<title>Debian packaging</title>
|
||||
<para>
|
||||
To build a Debian package, run the following command in the MPlayer
|
||||
source directory:
|
||||
To build a Debian package, run the following command in the
|
||||
<application>MPlayer</application> source directory:
|
||||
<screen>fakeroot debian/rules binary</screen>
|
||||
As root you can then install the <filename>.deb</filename> package as usual:
|
||||
<screen>dpkg -i ../mplayer_<replaceable>version</replaceable>.deb</screen>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Christian Marillat has been making unofficial Debian MPlayer, MEncoder and font
|
||||
packages for a while, you can (apt-)get them from his
|
||||
Christian Marillat has been making unofficial Debian
|
||||
<application>MPlayer</application>, <application>MEncoder</application> and
|
||||
font packages for a while, you can (apt-)get them from his
|
||||
<ulink url="http://marillat.free.fr/">homepage</ulink>.
|
||||
</para>
|
||||
</sect2>
|
||||
@ -40,24 +41,25 @@ Dominik Mierzejewski created and maintains official Red Hat RPM packages of
|
||||
|
||||
<para>
|
||||
Mandrake RPM packages are available from the <ulink url="http://plf.zarb.org/">P.L.F.</ulink>.
|
||||
SuSE used to include a crippled version of MPlayer in their distribution.
|
||||
They have removed it in their latest releases. You can get working RPMs
|
||||
from <ulink url="http://packman.links2linux.de/?action=128">links2linux.de</ulink>.
|
||||
SuSE used to include a crippled version of <application>MPlayer</application>
|
||||
in their distribution. They have removed it in their latest releases. You can
|
||||
get working RPMs from
|
||||
<ulink url="http://packman.links2linux.de/?action=128">links2linux.de</ulink>.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
<sect2 id="arm">
|
||||
<title>ARM</title>
|
||||
<para>
|
||||
MPlayer works on Linux PDAs with ARM CPU e.g. Sharp Zaurus, Compaq Ipaq. The
|
||||
easiest way to obtain MPlayer is to get it from one of the
|
||||
<ulink url="http://www.openzaurus.org">OpenZaurus</ulink> package feeds. If
|
||||
<application>MPlayer</application> works on Linux PDAs with ARM CPU e.g. Sharp Zaurus,
|
||||
Compaq Ipaq. The easiest way to obtain <application>MPlayer</application> is to get it
|
||||
from one of the<ulink url="http://www.openzaurus.org">OpenZaurus</ulink> package feeds. If
|
||||
you want to compile it yourself, you should look at the
|
||||
<ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/mplayer?nav=index.html|src/.|src/packages">MPlayer</ulink>
|
||||
and the
|
||||
<ulink url="http://openzaurus.bkbits.net:8080/buildroot/src/packages/libavcodec?nav=index.html|src/.|src/packages">libavcodec</ulink>
|
||||
directory in the OpenZaurus distribution buildroot. These always have the latest
|
||||
Makefile and patches used for building a CVS MPlayer with libavcodec.
|
||||
Makefile and patches used for building a CVS <application>MPlayer</application> with libavcodec.
|
||||
If you need a GUI frontend, you can use xmms-embedded.
|
||||
</para>
|
||||
</sect2>
|
||||
@ -67,24 +69,25 @@ If you need a GUI frontend, you can use xmms-embedded.
|
||||
<title>*BSD</title>
|
||||
<para>
|
||||
<application>MPlayer</application> runs on FreeBSD, OpenBSD, NetBSD,
|
||||
BSD/OS and Darwin. There are ports/pkgsrc/fink/etc versions of MPlayer
|
||||
BSD/OS and Darwin. There are ports/pkgsrc/fink/etc versions of <application>MPlayer</application>
|
||||
available that are probably easier to use than our raw sources.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
To build MPlayer you will need GNU make (gmake - native BSD make
|
||||
will not work) and a recent version of binutils.
|
||||
To build <application>MPlayer</application> you will need GNU make
|
||||
(gmake - native BSD make will not work) and a recent version of binutils.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
If MPlayer complains about not finding <filename>/dev/cdrom</filename> or
|
||||
<filename>/dev/dvd</filename>, create an appropriate symbolic link:
|
||||
If <application>MPlayer</application> complains about not finding <filename>/dev/cdrom</filename>
|
||||
or <filename>/dev/dvd</filename>, create an appropriate symbolic link:
|
||||
<screen>ln -s /dev/<replaceable>your_cdrom_device</replaceable> /dev/cdrom</screen>
|
||||
</para>
|
||||
|
||||
<para>
|
||||
To use Win32 DLLs with MPlayer you will need to re-compile the kernel with
|
||||
"<envar>option USER_LDT</envar>" (unless you run FreeBSD-CURRENT,
|
||||
To use Win32 DLLs with <application>MPlayer</application> you will need to
|
||||
re-compile the kernel with "<envar>option USER_LDT</envar>"
|
||||
(unless you run FreeBSD-CURRENT,
|
||||
where this is the default).
|
||||
</para>
|
||||
|
||||
@ -123,10 +126,10 @@ See the <link linkend="macos">Mac OS</link> section.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
On <emphasis role="bold">UltraSPARCs</emphasis>, MPlayer takes advantage of their
|
||||
<emphasis role="bold">VIS</emphasis> extensions (equivalent to MMX), currently
|
||||
only in <emphasis>libmpeg2</emphasis>, <emphasis>libvo</emphasis> and
|
||||
<emphasis>libavcodec</emphasis>, but not in mp3lib. You can watch a VOB file
|
||||
On <emphasis role="bold">UltraSPARCs</emphasis>, <application>MPlayer</application>
|
||||
takes advantage of their <emphasis role="bold">VIS</emphasis> extensions
|
||||
(equivalent to MMX), currently only in <emphasis>libmpeg2</emphasis>, <emphasis>libvo</emphasis>
|
||||
and <emphasis>libavcodec</emphasis>, but not in mp3lib. You can watch a VOB file
|
||||
on a 400MHz CPU. You'll need
|
||||
<ulink url="http://www.sun.com/sparc/vis/mediaLib.html">mLib</ulink> installed.
|
||||
</para>
|
||||
@ -212,7 +215,7 @@ The hsfs problem can be fixed by installing patch 109764-04 (sparc) / 109765-04
|
||||
<para>
|
||||
On Solaris with an UltraSPARC CPU, you can get some extra speed by using the
|
||||
CPU's VIS instructions for certain time consuming operations. VIS acceleration
|
||||
can be used in MPlayer by calling functions in Sun's
|
||||
can be used in <application>MPlayer</application> by calling functions in Sun's
|
||||
<ulink url="http://www.sun.com/sparc/vis/mediaLib.html">mediaLib</ulink>.
|
||||
</para>
|
||||
|
||||
@ -245,7 +248,7 @@ to:
|
||||
|
||||
$(INSTALL) -m 644 codecs.conf $(CONFDIR)/
|
||||
</programlisting>
|
||||
And then do (from within the MPlayer source dir):
|
||||
And then do (from within the <application>MPlayer</application> source dir):
|
||||
<screen>cp DOCS/mplayer.1 . ; cp etc/codecs.conf .</screen>
|
||||
and then go on with building and installing.
|
||||
</para>
|
||||
@ -268,9 +271,9 @@ since QNX has only X <emphasis>emulation</emphasis> which is VERY slow. Use SDL.
|
||||
<sect1 id="windows">
|
||||
<title>Windows</title>
|
||||
|
||||
<para>Yes, MPlayer runs on Windows under
|
||||
<ulink url="http://www.cygwin.com/">Cygwin</ulink> and
|
||||
<ulink url="http://www.mingw.org/">MinGW</ulink>.
|
||||
<para>Yes, <application>MPlayer</application> runs on Windows under
|
||||
<ulink url="http://www.cygwin.com/"><application>Cygwin</application></ulink> and
|
||||
<ulink url="http://www.mingw.org/"><application>MinGW</application></ulink>.
|
||||
It does not have a GUI yet, but the command line version is almost completely
|
||||
functional. <ulink url="../../tech/patches.txt">Patches</ulink> are always welcome.
|
||||
You should check out the
|
||||
@ -290,16 +293,18 @@ since QNX has only X <emphasis>emulation</emphasis> which is VERY slow. Use SDL.
|
||||
<para>You can use Win32 codecs and Real Win32 codecs (not Real Linux codecs)
|
||||
if you want to. Put the codecs somewhere in your path or pass
|
||||
<option>--with-codecsdir=c:/path/to/your/codecs</option> (alternatively
|
||||
<option>--with-codecsdir=/path/to/your/codecs</option> only on Cygwin) to
|
||||
<filename>configure</filename>. We have had some reports that Real DLLs need
|
||||
to be writable by the user running MPlayer, but only on some systems. Try
|
||||
making them writable if you have problems. QuickTime DLLs also work, but you
|
||||
will have to put them in your Windows system directory
|
||||
<option>--with-codecsdir=/path/to/your/codecs</option> only on
|
||||
<application>Cygwin</application>) to <filename>configure</filename>. We
|
||||
have had some reports that Real DLLs need to be writable by the user running
|
||||
<application>MPlayer</application>, but only on some systems. Try making
|
||||
them writable if you have problems. QuickTime DLLs also work, but you will
|
||||
have to put them in your Windows system directory
|
||||
(<filename class="directory">C:\Windows\system\</filename> or similar).</para>
|
||||
|
||||
<para>The Cygwin/MinGW console is rather slow. Redirecting output or using
|
||||
the <option>-quiet</option> option has been reported to improve performance
|
||||
on some systems. Direct rendering (<option>-dr</option>) may also help.
|
||||
<para>The <application>Cygwin</application>/<application>MinGW</application>
|
||||
console is rather slow. Redirecting output or using the
|
||||
<option>-quiet</option> option has been reported to improve performance on
|
||||
some systems. Direct rendering (<option>-dr</option>) may also help.
|
||||
You can prevent OSD flicker through double buffering with the
|
||||
<option>-double</option> option. If playback is jerky, try
|
||||
<option>-autosync 100</option>. If some of these options help you, you
|
||||
@ -311,7 +316,7 @@ since QNX has only X <emphasis>emulation</emphasis> which is VERY slow. Use SDL.
|
||||
<ulink url="http://www.mplayerhq.hu/homepage/projects.html">our projects page</ulink>.</para>
|
||||
|
||||
<sect2 id="cygwin">
|
||||
<title>Cygwin</title>
|
||||
<title><application>Cygwin</application></title>
|
||||
|
||||
<para>Cygwin versions prior to 1.5.0 do not include <filename>inttypes.h</filename>.
|
||||
Put this
|
||||
@ -322,7 +327,8 @@ since QNX has only X <emphasis>emulation</emphasis> which is VERY slow. Use SDL.
|
||||
<para>DirectX header files need to be extracted to <filename class="directory">/usr/include/</filename> or
|
||||
<filename class="directory">/usr/local/include/</filename>.</para>
|
||||
|
||||
<para>Instructions and files for making SDL run under Cygwin can be found on the
|
||||
<para>Instructions and files for making SDL run under
|
||||
<application>Cygwin</application> can be found on the
|
||||
<ulink url="http://www.libsdl.org/extras/win32/cygwin/">libsdl site</ulink>.</para>
|
||||
|
||||
<para>You can play VCDs by playing the <filename>.DAT</filename> or <filename>.MPG</filename> files
|
||||
@ -342,21 +348,22 @@ since QNX has only X <emphasis>emulation</emphasis> which is VERY slow. Use SDL.
|
||||
|
||||
|
||||
<sect2 id="mingw">
|
||||
<title>MinGW</title>
|
||||
<title><application>MinGW</application></title>
|
||||
|
||||
<para>Installing a version of MinGW that could compile MPlayer used to be quite
|
||||
tricky, but it works out of the box now. Just install MinGW 3.1.0 or later
|
||||
and MSYS 1.0.9 or later and tell the MSYS postinstall that MinGW is
|
||||
installed.</para>
|
||||
<para>Installing a version of <application>MinGW</application> that could
|
||||
compile <application>MPlayer</application> used to be quite tricky, but it
|
||||
works out of the box now. Just install <application>MinGW</application>
|
||||
3.1.0 or later and MSYS 1.0.9 or later and tell the MSYS postinstall that
|
||||
<application>MinGW</application> is installed.</para>
|
||||
|
||||
<para>If you use a version of MinGW before 3.1.0, you need to replace
|
||||
<filename>/mingw/include/sys/types.h</filename> with this
|
||||
<para>If you use a version of <application>MinGW</application> before 3.1.0,
|
||||
you need to replace <filename>/mingw/include/sys/types.h</filename> with this
|
||||
<ulink url="http://www.mplayerhq.hu/MPlayer/releases/win32-beta/contrib/types.h"><filename>types.h</filename></ulink>.</para>
|
||||
|
||||
<para>Extract DirectX header files to <filename class="directory">/mingw/include/</filename>.</para>
|
||||
|
||||
<para>VCDs and DVDs work almost like Cygwin (adjust for the drive letter of your
|
||||
CD-ROM/DVD-ROM):</para>
|
||||
<para>VCDs and DVDs work almost like <application>Cygwin</application> (adjust
|
||||
for the drive letter of your CD-ROM/DVD-ROM):</para>
|
||||
|
||||
<screen>mplayer d:/mpegav/avseq01.dat</screen>
|
||||
|
||||
|
||||
@ -1,10 +1,11 @@
|
||||
<?xml version="1.0" encoding="iso-8859-1"?>
|
||||
<!-- $Revision$ -->
|
||||
<appendix id="skin">
|
||||
<title>MPlayer skin format</title>
|
||||
<title><application>MPlayer</application> skin format</title>
|
||||
<para>
|
||||
The purpose of this document is to describe the MPlayer skin format.
|
||||
The information contained here might be wrong, for
|
||||
The purpose of this document is to describe the
|
||||
<application>MPlayer</application> skin format. The information contained here
|
||||
might be wrong, for
|
||||
<orderedlist>
|
||||
<listitem><para>It is not me who wrote the GUI.</para></listitem>
|
||||
<listitem><para>The GUI is not finished.</para></listitem>
|
||||
@ -21,9 +22,9 @@ So do not be surprised if something does not work as described here.
|
||||
<title>Overview</title>
|
||||
<para>
|
||||
It does not really have anything to do with the skin format, but you should
|
||||
know that MPlayer has <emphasis role="bold">no</emphasis> builtin skin, so
|
||||
<emphasis role="bold">at least one skin must be installed in order to be able
|
||||
to use the GUI.</emphasis>
|
||||
know that <application>MPlayer</application> has <emphasis role="bold">no</emphasis>
|
||||
builtin skin, so <emphasis role="bold">at least one skin must be installed
|
||||
in order to be able to use the GUI.</emphasis>
|
||||
</para>
|
||||
|
||||
<sect2 id="skin-overview-directories">
|
||||
@ -44,9 +45,9 @@ The directories searched for skins are (in order):
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Note that the first path may vary according to the way MPlayer was configured
|
||||
(see the <option>--prefix</option> and <option>--datadir</option> arguments of
|
||||
the <command>configure</command> script).
|
||||
Note that the first path may vary according to the way <application>MPlayer</application>
|
||||
was configured (see the <option>--prefix</option> and <option>--datadir</option>
|
||||
arguments of the <command>configure</command> script).
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@ -62,8 +63,8 @@ listed above, for example:
|
||||
<para>
|
||||
In the main window and in the playbar (see below) you can use images with
|
||||
`transparency': Regions filled with the color #FF00FF (magenta) are fully
|
||||
transparent when viewed by MPlayer. This means that you can even have shaped
|
||||
windows if your X server has the XShape extension.
|
||||
transparent when viewed by <application>MPlayer</application>. This means
|
||||
that you can even have shaped windows if your X server has the XShape extension.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
@ -85,11 +86,11 @@ by a right click).
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
The <emphasis role="bold">main window</emphasis> and/or the
|
||||
<emphasis role="bold">playbar</emphasis> is where you can control MPlayer.
|
||||
The background of the window is an image. Various items can (and must) be placed
|
||||
in the window: <emphasis>buttons</emphasis>, <emphasis>potmeters</emphasis>
|
||||
(sliders) and <emphasis>labels</emphasis>. For every item, you must specify its
|
||||
position and size.
|
||||
<emphasis role="bold">playbar</emphasis> is where you can control
|
||||
<application>MPlayer</application>. The background of the window is an image.
|
||||
Various items can (and must) be placed in the window: <emphasis>buttons</emphasis>,
|
||||
<emphasis>potmeters</emphasis> (sliders) and <emphasis>labels</emphasis>.
|
||||
For every item, you must specify its position and size.
|
||||
</para><para>
|
||||
A <emphasis role="bold">button</emphasis> has three states (pressed, released,
|
||||
disabled), thus its image must be divided into three parts vertically. See the
|
||||
@ -125,12 +126,13 @@ by a right click).
|
||||
</para></listitem>
|
||||
|
||||
<listitem><para>
|
||||
The <emphasis role="bold">skin menu</emphasis> is just a way to control MPlayer by
|
||||
means of menu entries. Two images are required for the menu: one of them is
|
||||
the base image that shows the menu in its normal state, the other one is used
|
||||
to display the selected entries. When you pop up the menu, the first image is
|
||||
shown. If you move the mouse over the menu entries, the currently selected
|
||||
entry is copied from the second image over the menu entry below the mouse pointer
|
||||
The <emphasis role="bold">skin menu</emphasis> is just a way to control
|
||||
<application>MPlayer</application> by means of menu entries. Two images
|
||||
are required for the menu: one of them is the base image that shows the
|
||||
menu in its normal state, the other one is used to display the selected
|
||||
entries. When you pop up the menu, the first image is shown. If you move
|
||||
the mouse over the menu entries, the currently selected entry is copied
|
||||
from the second image over the menu entry below the mouse pointer
|
||||
(the second image is never shown as a whole).
|
||||
</para><para>
|
||||
A menu entry is defined by its position and size in the image (see the
|
||||
@ -141,9 +143,10 @@ by a right click).
|
||||
|
||||
<para>
|
||||
There is an important thing not mentioned yet: For buttons, potmeters and
|
||||
menu entries to work, MPlayer must know what to do if they are clicked. This
|
||||
is done by <link linkend="skin-gui">messages</link> (events). For these items
|
||||
you must define the messages to be generated when they are clicked.
|
||||
menu entries to work, <application>MPlayer</application> must know what to
|
||||
do if they are clicked. This is done by <link linkend="skin-gui">messages</link>
|
||||
(events). For these items you must define the messages to be generated when
|
||||
they are clicked.
|
||||
</para>
|
||||
</sect2>
|
||||
|
||||
@ -154,8 +157,8 @@ You need the following files to build a skin:
|
||||
<itemizedlist>
|
||||
<listitem><para>
|
||||
The configuration file named <link linkend="skin-file">skin</link> tells
|
||||
MPlayer how to put different parts of the skin together and what to do if
|
||||
you click somewhere in the window.
|
||||
<application>MPlayer</application> how to put different parts of the skin
|
||||
together and what to do if you click somewhere in the window.
|
||||
</para></listitem>
|
||||
<listitem><para>
|
||||
The background image for the main window.
|
||||
@ -266,7 +269,7 @@ end
|
||||
The name of an image file must be given without leading directories - images
|
||||
are searched for in the <filename class="directory">Skin</filename> directory.
|
||||
You may (but you need not) specify the extension of the file. If the file does
|
||||
not exist, MPlayer tries to load the file
|
||||
not exist, <application>MPlayer</application> tries to load the file
|
||||
<filename><filename>.<ext></filename>, where <literal>png</literal>
|
||||
and <literal>PNG</literal> are tried for <filename><ext></filename>
|
||||
(in this order). The first matching file will be used.
|
||||
@ -295,8 +298,8 @@ shown in this illustration:
|
||||
Here is an example to make this clear. Suppose that you have an image called
|
||||
<filename>main.png</filename> that you use for the main window:
|
||||
<programlisting>base = main, -1, -1</programlisting>
|
||||
MPlayer tries to load <filename>main</filename>, <filename>main.png</filename>,
|
||||
<filename>main.PNG</filename> files.
|
||||
<application>MPlayer</application> tries to load <filename>main</filename>,
|
||||
<filename>main.png</filename>, <filename>main.PNG</filename> files.
|
||||
</para>
|
||||
|
||||
|
||||
|
||||
@ -82,9 +82,9 @@ dimensions sane.
|
||||
<listitem>
|
||||
<para>
|
||||
Watch out for CPU load. It shouldn't cross the 90% boundary for most of the
|
||||
time. If you have a large capture buffer, MEncoder can survive an overload
|
||||
for few seconds but nothing more. It's better to turn off the 3D OpenGL
|
||||
screensavers and similar stuff.
|
||||
time. If you have a large capture buffer, <application>MEncoder</application>
|
||||
can survive an overload for few seconds but nothing more. It's better to
|
||||
turn off the 3D OpenGL screensavers and similar stuff.
|
||||
</para>
|
||||
</listitem>
|
||||
|
||||
@ -92,10 +92,10 @@ screensavers and similar stuff.
|
||||
<para>
|
||||
Don't mess with the system clock. <application>MEncoder</application> uses the
|
||||
system clock for doing A/V sync. If you adjust the system clock (especially
|
||||
backwards in time), MEncoder gets confused and you will lose frames. This is
|
||||
an important issue if you are hooked to a network and run some time
|
||||
synchronization software like NTP. You have to turn NTP off during the capture
|
||||
process if you want to capture reliably.
|
||||
backwards in time), <application>MEncoder</application> gets confused and you
|
||||
will lose frames. This is an important issue if you are hooked to a network
|
||||
and run some time synchronization software like NTP. You have to turn NTP
|
||||
off during the capture process if you want to capture reliably.
|
||||
</para>
|
||||
</listitem>
|
||||
|
||||
@ -129,7 +129,8 @@ your soundcard via an external cable connection between video card and line-in,
|
||||
or using the built-in ADC in the bt878 chip. In the latter case, you have to
|
||||
load the <emphasis role="bold">btaudio</emphasis> driver. Read the
|
||||
<filename>linux/Documentation/sound/btaudio</filename> file (in the kernel
|
||||
tree, not MPlayer's) for some instructions on using this driver.
|
||||
tree, not <application>MPlayer's</application>) for some instructions on using
|
||||
this driver.
|
||||
</para>
|
||||
</listitem>
|
||||
|
||||
@ -169,10 +170,10 @@ mplayer -tv driver=v4l:width=640:height=480:outfmt=i420 -vc rawi420 -vo xv tv://
|
||||
|
||||
<informalexample>
|
||||
<para>
|
||||
A more sophisticated example. This makes MEncoder capture the full PAL
|
||||
image, crop the margins, and deinterlace the picture using a linear blend
|
||||
algorithm. Audio is compressed with a constant bitrate of 64kbps, using
|
||||
LAME codec. This setup is suitable for capturing movies.
|
||||
A more sophisticated example. This makes <application>MEncoder</application>
|
||||
capture the full PAL image, crop the margins, and deinterlace the picture
|
||||
using a linear blend algorithm. Audio is compressed with a constant bitrate
|
||||
of 64kbps, using LAME codec. This setup is suitable for capturing movies.
|
||||
<screen>
|
||||
mencoder -tv driver=v4l:width=768:height=576 \
|
||||
-ovc lavc -lavcopts vcodec=mpeg4:vbitrate=900 \
|
||||
|
||||
@ -112,8 +112,8 @@ control (using LIRC). See the man page for the complete list of keyboard control
|
||||
|
||||
<para>
|
||||
<application>MPlayer</application> allows you bind any key/button to any
|
||||
MPlayer command using a simple config file. The syntax consist of a key
|
||||
name followed by a command. The default config file location is
|
||||
<application>MPlayer</application> command using a simple config file.
|
||||
The syntax consist of a key name followed by a command. The default config file location is
|
||||
<filename>$HOME/.mplayer/input.conf</filename> but it can be overridden
|
||||
using the <option>-input <replaceable>conf</replaceable></option> option
|
||||
(relative path are relative to <filename>$HOME/.mplayer</filename>).
|
||||
|
||||
@ -76,9 +76,10 @@ Red Hat <ulink url="ftp://updates.redhat.com">ftp server</ulink>, or just
|
||||
go for the 3.0.4 packages offered for version 7.2 and later. You can also
|
||||
get <ulink url="ftp://people.redhat.com/jakub/gcc/3.2.3-11/">gcc-3.2.3-11 packages</ulink>
|
||||
(unofficial, but working fine)
|
||||
and you can install them along the gcc-2.96 you already have. MPlayer will
|
||||
detect it and use 3.2 instead of 2.96. If you do not want to or cannot use
|
||||
the binary packages, here is how you can compile GCC 3 from source:
|
||||
and you can install them along the gcc-2.96 you already have.
|
||||
<application>MPlayer</application> will detect it and use 3.2 instead of 2.96.
|
||||
If you do not want to or cannot use the binary packages, here is how you can
|
||||
compile GCC 3 from source:
|
||||
</para>
|
||||
|
||||
<procedure>
|
||||
@ -173,7 +174,7 @@ because we have little power to help in this matter.
|
||||
<para>
|
||||
Joe Barr became infamous in december 2001 by writing a less than favorable
|
||||
<application>MPlayer</application> review called
|
||||
<ulink url="http://www.linuxworld.com/story/32880.htm">MPlayer: The project from hell</ulink>.
|
||||
<ulink url="http://www.linuxworld.com/story/32880.htm"><application>MPlayer</application>: The project from hell</ulink>.
|
||||
He found <application>MPlayer</application> hard to install, and concluded
|
||||
that the developers were unfriendly and the documentation
|
||||
incomplete and insulting. You be the judge of that.
|
||||
|
||||
@ -219,9 +219,10 @@ Complain to nVidia.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
However, MPlayer contains a <link linkend="vidix">VIDIX</link> driver for most
|
||||
nVidia cards. Currently it is in beta stage, and has some drawbacks. For more
|
||||
information, see <link linkend="vidix-nvidia">nVidia VIDIX</link> section.
|
||||
However, <application>MPlayer</application> contains a
|
||||
<link linkend="vidix">VIDIX</link> driver for most nVidia cards. Currently it
|
||||
is in beta stage, and has some drawbacks. For more information, see
|
||||
<link linkend="vidix-nvidia">nVidia VIDIX</link> section.
|
||||
</para>
|
||||
</sect5>
|
||||
|
||||
@ -288,8 +289,8 @@ support with the Cyberblade XP card.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
Alternatively, MPlayer contains a <link linkend="vidix">VIDIX</link> driver
|
||||
for the Cyberblade/i1 card.
|
||||
Alternatively, <application>MPlayer</application> contains a
|
||||
<link linkend="vidix">VIDIX</link> driver for the Cyberblade/i1 card.
|
||||
</para>
|
||||
|
||||
</sect5>
|
||||
@ -1708,8 +1709,8 @@ for a 16:9 TV: -vf dvbscale=1024,scale=-1:0,expand=-1:576:-1:-1:1
|
||||
<title>Using your DVB card for watching Digital TV (DVB input module)</title>
|
||||
<para>
|
||||
First you need to pass the <literal>dvb_shutdown_timeout=0</literal>
|
||||
parameter to the kernel module <filename>dvb-core</filename>, or MPlayer
|
||||
will die after 10 seconds.
|
||||
parameter to the kernel module <filename>dvb-core</filename>, or
|
||||
<application>MPlayer</application> will die after 10 seconds.
|
||||
</para>
|
||||
</formalpara>
|
||||
|
||||
@ -1733,8 +1734,8 @@ for a 16:9 TV: -vf dvbscale=1024,scale=-1:0,expand=-1:576:-1:-1:1
|
||||
|
||||
<para>
|
||||
Make sure that you have have <emphasis>only</emphasis> Free to Air
|
||||
channels in your <filename>channels.conf</filename> file, or MPlayer
|
||||
will hang on the others.
|
||||
channels in your <filename>channels.conf</filename> file, or
|
||||
<application>MPlayer</application> will hang on the others.
|
||||
</para>
|
||||
|
||||
<para>
|
||||
@ -1810,7 +1811,8 @@ decompression).
|
||||
|
||||
<sect4 id="dxr2">
|
||||
<title>DXR2</title>
|
||||
<para>MPlayer supports hardware accelerated playback with the Creative DXR2 card.</para>
|
||||
<para><application>MPlayer</application> supports hardware accelerated playback
|
||||
with the Creative DXR2 card.</para>
|
||||
<para>
|
||||
First of all you will need properly installed DXR2 drivers. You can find
|
||||
the drivers and installation instructions at the
|
||||
@ -1874,25 +1876,27 @@ that you have a properly configured overlay setup to work right. The easiest
|
||||
way to configure the overlay is to first run autocal. Then run mplayer with
|
||||
dxr3 output and without overlay turned on, run dxr3view. In dxr3view you can
|
||||
tweak the overlay settings and see the effects in realtime, perhaps this feature
|
||||
will be supported by the MPlayer GUI in the future. When overlay is properly set
|
||||
up you will no longer need to use dxr3view.
|
||||
will be supported by the <application>MPlayer</application> GUI in the future.
|
||||
When overlay is properly set up you will no longer need to use dxr3view.
|
||||
<option>prebuf</option> turns on prebuffering. Prebuffering is a feature of the
|
||||
em8300 chip that enables it to hold more than one frame of video at a time. This
|
||||
means that when you are running with prebuffering MPlayer will try to keep the
|
||||
video buffer filled with data at all times. If you are on a slow machine MPlayer
|
||||
will probably use close to, or precisely 100% of CPU. This is especially common
|
||||
if you play pure MPEG streams (like DVDs, SVCDs a.s.o.) since MPlayer will not
|
||||
have to reencode it to MPEG it will fill the buffer very fast.
|
||||
means that when you are running with prebuffering <application>MPlayer</application>
|
||||
will try to keep the video buffer filled with data at all times. If you are on
|
||||
a slow machine <application>MPlayer</application> will probably use close to,
|
||||
or precisely 100% of CPU. This is especially common if you play pure MPEG streams
|
||||
(like DVDs, SVCDs a.s.o.) since <application>MPlayer</application> will not have
|
||||
to reencode it to MPEG it will fill the buffer very fast.
|
||||
With prebuffering video playback is <emphasis role="bold">much</emphasis>
|
||||
less sensitive to other programs hogging the CPU, it will not drop frames unless
|
||||
applications hog the CPU for a long time.
|
||||
When running without prebuffering the em8300 is much more sensitive to CPU load,
|
||||
so it is highly suggested that you turn on MPlayer's <option>-framedrop</option>
|
||||
option to avoid further loss of sync.
|
||||
so it is highly suggested that you turn on <application>MPlayer's</application>
|
||||
<option>-framedrop</option> option to avoid further loss of sync.
|
||||
<option>sync</option> will turn on the new sync-engine. This is currently an
|
||||
experimental feature. With the sync feature turned on the em8300's internal clock
|
||||
will be monitored at all times, if it starts to deviate from MPlayer's clock it
|
||||
will be reset causing the em8300 to drop any frames that are lagging behind.
|
||||
will be monitored at all times, if it starts to deviate from
|
||||
<application>MPlayer's</application> clock it will be reset causing the em8300 to
|
||||
drop any frames that are lagging behind.
|
||||
<option>norm=x</option> will set the TV norm of the DXR3 card without the need
|
||||
for external tools like em8300setup. Valid norms are 5 = NTSC, 4 = PAL-60,
|
||||
3 = PAL. Special norms are 2 (auto-adjust using PAL/PAL-60) and 1 (auto-adjust
|
||||
@ -1948,11 +1952,11 @@ becomes stable. For now all we can do is accept this for a fact.
|
||||
<term><option>-vf expand=-1:-1:-1:-1:1</option></term>
|
||||
<listitem><para>
|
||||
Although the DXR3 driver can put some OSD onto the MPEG1/2/4 video, it has
|
||||
much lower quality than MPlayer's traditional OSD, and has several refresh
|
||||
problems as well. The command line above will firstly convert the input
|
||||
video to MPEG4 (this is mandatory, sorry), then apply an expand filter which
|
||||
won't expand anything (-1: default), but apply the normal OSD onto the picture
|
||||
(that's what the "1" at the end does).
|
||||
much lower quality than <application>MPlayer's</application> traditional OSD,
|
||||
and has several refresh problems as well. The command line above will firstly
|
||||
convert the input video to MPEG4 (this is mandatory, sorry), then apply an
|
||||
expand filter which won't expand anything (-1: default), but apply the normal
|
||||
OSD onto the picture (that's what the "1" at the end does).
|
||||
</para></listitem>
|
||||
</varlistentry>
|
||||
|
||||
@ -2054,8 +2058,8 @@ participating in <emphasis>cinerama</emphasis> is four, so you can build a
|
||||
Finally an important remark: Do not start or stop XawTV on the playback device
|
||||
during playback, it will crash your computer. It is, however, fine to
|
||||
<emphasis role="bold">FIRST</emphasis> start XawTV, <emphasis role="bold">THEN</emphasis>
|
||||
start MPlayer, wait for MPlayer to finish and <emphasis role="bold">THEN</emphasis>
|
||||
stop XawTV.
|
||||
start <application>MPlayer</application>, wait for <application>MPlayer</application>
|
||||
to finish and <emphasis role="bold">THEN</emphasis> stop XawTV.
|
||||
</para>
|
||||
</sect4>
|
||||
|
||||
|
||||
Loading…
Reference in New Issue
Block a user