diff options
Diffstat (limited to 'DOCS/xml/en/install.xml')
| -rw-r--r-- | DOCS/xml/en/install.xml | 413 |
1 files changed, 7 insertions, 406 deletions
diff --git a/DOCS/xml/en/install.xml b/DOCS/xml/en/install.xml index 1ab56f1cc4..68f8020ab2 100644 --- a/DOCS/xml/en/install.xml +++ b/DOCS/xml/en/install.xml @@ -24,77 +24,9 @@ answers. <sect1 id="softreq"> <title>Software requirements</title> -<itemizedlist> -<listitem><para> - <emphasis role="bold">POSIX system</emphasis> - You need a POSIX-compatible - shell and POSIX-compatible system tools like grep, sed, awk, etc. in your - path. -</para></listitem> -<listitem><para> - <emphasis role="bold">GNU make</emphasis> 3.81 or later -</para></listitem> -<listitem><para> - <emphasis role="bold">binutils</emphasis> - GNU binutils 2.11 or later - is known to work. -</para></listitem> -<listitem><para> - <emphasis role="bold">compiler</emphasis> - We mostly use gcc, the - recommended versions on x86 are 2.95 and 3.4+. On PowerPC, use 4.x+. - icc 10.1+ is also known to work. -</para></listitem> -<listitem><para> - <emphasis role="bold">Xorg/XFree86</emphasis> - recommended version is - 4.3 or later. Make sure the - <emphasis role="bold">development packages</emphasis> are installed, - too, otherwise it won't work. - You don't absolutely need X, some video output drivers work without it. -</para></listitem> -<listitem><para> - <emphasis role="bold">FreeType</emphasis> - 2.0.9 or later is required - for the OSD and subtitles -</para></listitem> -<listitem><para> - <emphasis role="bold">ALSA</emphasis> - optional, for ALSA audio output - support. At least 0.9.0rc4 is required. -</para></listitem> -<listitem><para> - <emphasis role="bold">libjpeg</emphasis> - - required for the optional JPEG video output driver -</para></listitem> -<listitem><para> - <emphasis role="bold">libpng</emphasis> - - required for the optional PNG video output driver -</para></listitem> -<listitem><para> - <emphasis role="bold">directfb</emphasis> - optional, 0.9.22 or later - required for the directfb/dfbmga video output drivers -</para></listitem> -<listitem><para> - <emphasis role="bold">lame</emphasis> - 3.90 or later is recommended, - necessary for encoding MP3 audio with <application>MEncoder</application>. -</para></listitem> -<listitem><para> - <emphasis role="bold">zlib</emphasis> - recommended, many codecs use it. -</para></listitem> -<listitem><para> - <emphasis role="bold"><ulink url="http://www.live555.com/mplayer/">LIVE555 Streaming Media</ulink></emphasis> - - optional, needed for some RTSP/RTP streams -</para></listitem> -<listitem><para> - <emphasis role="bold">cdparanoia</emphasis> - optional, for CDDA support -</para></listitem> -<listitem><para> - <emphasis role="bold">libxmms</emphasis> - optional, for XMMS input plugin - support. At least 1.2.7 is required. -</para></listitem> -<listitem><para> - <emphasis role="bold">libsmb</emphasis> - optional, for SMB networking support -</para></listitem> -<listitem><para> - <emphasis role="bold"><ulink url="http://www.underbit.com/products/mad/">libmad</ulink></emphasis> - - optional, for fast integer-only MP3 decoding on FPU-less platforms -</para></listitem> -</itemizedlist> +<para> +OUTDATED CONTENT REMOVED +</para> </sect1> @@ -104,71 +36,8 @@ answers. <sect1 id="features"> <title>Features</title> -<itemizedlist> -<listitem><para> - If you want to install <application>MEncoder</application> (our great - 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, - and wish to watch/grab and encode movies with - <application>MPlayer</application>, - read the <link linkend="tv-input">TV input</link> section. -</para></listitem> -<listitem><para> - If you have a V4L compatible <emphasis role="bold">radio tuner</emphasis> - card, and wish to listen and capture sound with - <application>MPlayer</application>, - read the <link linkend="radio">radio</link> section. -</para></listitem> -<listitem><para> - There is a neat <emphasis role="bold">OSD Menu</emphasis> support ready to be - used. Check the <link linkend="subosd">OSD menu</link> section. -</para></listitem> -</itemizedlist> - -<para> -Then build <application>MPlayer</application>: -<screen> -./configure -make -make install -</screen> -</para> - -<para> -At this point, <application>MPlayer</application> is ready to use. -Check if you have a <filename>codecs.conf</filename> file in your home -directory at (<filename>~/.mplayer/codecs.conf</filename>) left from old -<application>MPlayer</application> versions. If you find one, remove it. -</para> - <para> -Debian users can build a .deb package for themselves, it's very simple. -Just exec -<screen>fakeroot debian/rules binary</screen> -in <application>MPlayer</application>'s root directory. See -<link linkend="debian">Debian packaging</link> for detailed instructions. -</para> - -<para> -<emphasis role="bold">Always browse the output of</emphasis> -<filename>./configure</filename>, and the -<filename>config.log</filename> file, they contain information about -what will be built, and what will not. You may also want to view -<filename>config.h</filename> and <filename>config.mak</filename> files. -If you have some libraries installed, but not detected by -<filename>./configure</filename>, then check if you also have the proper -header files (usually the -dev packages) and their version matches. The -<filename>config.log</filename> file usually tells you what is missing. -</para> - -<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 <application>MPlayer</application> to use it. -See the <link linkend="subosd">Subtitles and OSD</link> section for details. +OUTDATED CONTENT REMOVED </para> </sect1> @@ -195,136 +64,9 @@ frontends page</ulink> for a list of existing GUIs. <title>Fonts and OSD</title> <para> -You need to tell <application>MPlayer</application> which font to use to -enjoy OSD and subtitles. Any TrueType font or special bitmap fonts will -work. However, TrueType fonts are recommended as they look far better, -can be properly scaled to the movie size and cope better with different -encodings. -</para> - -<!-- ********** --> - -<sect2 id="truetype-fonts"> -<title>TrueType fonts</title> - -<para> -There are two ways to get TrueType fonts to work. The first is to pass -the <option>-font</option> option to specify a TrueType font file on -the command line. This option will be a good candidate to put in your -configuration file (see the manual page for details). -The second is to create a symlink called <filename>subfont.ttf</filename> -to the font file of your choice. Either -<screen> -ln -s <replaceable>/path/to/sample_font.ttf</replaceable> ~/.mplayer/subfont.ttf -</screen> -for each user individually or a system-wide one: -<screen> -ln -s <replaceable>/path/to/sample_font.ttf</replaceable> $PREFIX/share/mplayer/subfont.ttf -</screen> -</para> - -<para> -If <application>MPlayer</application> was compiled with -<systemitem class="library">fontconfig</systemitem> support, the above methods -won't work, instead <option>-font</option> expects a -<systemitem class="library">fontconfig</systemitem> font name -and defaults to the sans-serif font. Example: -<screen> -mplayer -font <replaceable>'Bitstream Vera Sans'</replaceable> <replaceable>anime.mkv</replaceable> -</screen> -</para> - -<para> -To get a list of fonts known to -<systemitem class="library">fontconfig</systemitem>, -use <command>fc-list</command>. -</para> -</sect2> - -<!-- ********** --> - -<sect2 id="bitmap-fonts"> -<title>bitmap fonts</title> - -<para> -If for some reason you wish or need to employ bitmap fonts, download a set -from our homepage. You can choose between various -<ulink url="http://www.mplayerhq.hu/MPlayer/releases/fonts/">ISO fonts</ulink> -and some sets of fonts -<ulink url="http://www.mplayerhq.hu/MPlayer/contrib/fonts/">contributed by users</ulink> -in various encodings. -</para> - -<para> -Uncompress the file you downloaded to -<filename class="directory">~/.mplayer</filename> or -<filename class="directory">$PREFIX/share/mplayer</filename>. -Then rename or symlink one of the extracted directories to -<filename class="directory">font</filename>, for example: -<screen> -ln -s <replaceable>~/.mplayer/arial-24</replaceable> ~/.mplayer/font -</screen> -<screen> -ln -s <replaceable>$PREFIX/share/mplayer/arial-24</replaceable> $PREFIX/share/mplayer/font -</screen> -</para> - -<para> -Fonts should have an appropriate <filename>font.desc</filename> file -which maps Unicode font positions to the actual code page of the -subtitle text. Another solution is to have UTF-8-encoded subtitles -and use the <option>-utf8</option> option or give the subtitles -file the same name as your video file with a <filename>.utf</filename> -extension and have it in the same directory as the video file. +OUTDATED CONTENT REMOVED </para> -</sect2> - -<!-- ********** --> -<sect2 id="osdmenu"> -<title>OSD menu</title> - -<para> -<application>MPlayer</application> has a completely user-definable -OSD Menu interface. -</para> - -<note><para> -the Preferences menu is currently UNIMPLEMENTED! -</para></note> - -<orderedlist> -<title>Installation</title> -<listitem><para> - compile <application>MPlayer</application> by passing the - <option>--enable-menu</option> to <filename>./configure</filename> -</para></listitem> -<listitem><para> - make sure you have an OSD font installed -</para></listitem> -<listitem><para> - copy <filename>etc/menu.conf</filename> to your - <filename class="directory">.mplayer</filename> directory -</para></listitem> -<listitem><para> - copy <filename>etc/input.conf</filename> to your - <filename class="directory">.mplayer</filename> directory, or to the - system-wide <application>MPlayer</application> config dir (default: - <filename class="directory">/usr/local/etc/mplayer</filename>) -</para></listitem> -<listitem><para> - check and edit <filename>input.conf</filename> to enable menu movement keys - (it is described there). -</para></listitem> -<listitem><para> - start <application>MPlayer</application> by the following example: - <screen>mplayer -menu <replaceable>file.avi</replaceable></screen> - </para></listitem> -<listitem><para> - push any menu key you defined -</para></listitem> -</orderedlist> -</sect2> </sect1> @@ -334,111 +76,9 @@ the Preferences menu is currently UNIMPLEMENTED! <sect1 id="codec-installation"> <title>Codec installation</title> -<!-- ********** --> - -<sect2 id="xvid"> -<title>Xvid</title> - -<para> -<ulink url="http://www.xvid.org">Xvid</ulink> is a free software MPEG-4 ASP -compliant video codec. Note that Xvid is not necessary to decode Xvid-encoded -video. <systemitem class="library">libavcodec</systemitem> is used by -default as it offers better speed. -</para> - -<procedure> -<title>Installing <systemitem class="library">Xvid</systemitem></title> <para> - Like most open source software, it is available in two flavors: - <ulink url="http://www.xvid.org/downloads.html">official releases</ulink> - and the CVS version. - The CVS version is usually stable enough to use, as most of the time it - features fixes for bugs that exist in releases. - Here is what to do to make <systemitem class="library">Xvid</systemitem> - CVS work with <application>MEncoder</application>: +OUTDATED CONTENT REMOVED </para> -<step><para> - <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid login</screen> -</para></step> -<step><para> - <screen>cvs -z3 -d:pserver:anonymous@cvs.xvid.org:/xvid co xvidcore</screen> -</para></step> -<step><para> - <screen>cd xvidcore/build/generic</screen> -</para></step> -<step><para> - <screen>./bootstrap.sh && ./configure</screen> - You may have to add some options (examine the output of - <command>./configure --help</command>). -</para></step> -<step><para> - <screen>make && make install</screen> -</para></step> -<step><para> - Recompile <application>MPlayer</application>. -</para></step> -</procedure> -</sect2> - -<!-- ********** --> - -<sect2 id="x264"> -<title><systemitem class="library">x264</systemitem></title> - -<para> -<ulink url="http://developers.videolan.org/x264.html"><systemitem class="library">x264</systemitem></ulink> -is a library for creating H.264 video. -<application>MPlayer</application> sources are updated whenever -an <systemitem class="library">x264</systemitem> API change -occurs, so it is always suggested to use -<application>MPlayer</application> from Subversion. -</para> - -<para> -If you have a GIT client installed, the latest x264 -sources can be gotten with this command: -<screen>git clone git://git.videolan.org/x264.git</screen> - -Then build and install in the standard way: -<screen>./configure && make && make install</screen> - -Now rerun <filename>./configure</filename> for -<application>MPlayer</application> to pick up -<systemitem class="library">x264</systemitem> support. -</para> -</sect2> - -<!-- ********** --> - -<sect2 id="amr"> -<title>AMR</title> - -<para> -MPlayer can use the OpenCORE AMR libraries through FFmpeg. -Download the libraries for AMR-NB and AMR-WB from the -<ulink url="http://sourceforge.net/projects/opencore-amr/">opencore-amr</ulink> -project and install them according to the instructions on that page. -</para> -</sect2> - -<sect2 id="xmms"> -<title>XMMS</title> - -<para> -<application>MPlayer</application> can use <application>XMMS</application> input -plugins to play many file formats. There are plugins for SNES game tunes, SID -tunes (from Commodore 64), many Amiga formats, .xm, .it, VQF, Musepack, Bonk, -shorten and many others. You can find them at the -<ulink url="http://www.xmms.org/plugins.php?category=input">XMMS input plugin page</ulink>. -</para> - -<para> -For this feature you need to have <application>XMMS</application> and compile -<application>MPlayer</application> with -<filename>./configure --enable-xmms</filename>. -</para> -</sect2> - </sect1> @@ -449,46 +89,7 @@ For this feature you need to have <application>XMMS</application> and compile <title>RTC</title> <para> -There are three timing methods in <application>MPlayer</application>. - -<itemizedlist> -<listitem><para> - <emphasis role="bold">To use the old method</emphasis>, you don't have to do - anything. It uses <systemitem>usleep()</systemitem> to tune - A/V sync, with +/- 10ms accuracy. However sometimes the sync has to be - tuned even finer. -</para></listitem> -<listitem> - <para> - <emphasis role="bold">The new timer</emphasis> code uses the RTC (RealTime - Clock) for this task, because it has precise 1ms timers. - The <option>-rtc</option> option enables it, - but a properly set up kernel is required. - If you are running kernel 2.4.19pre8 or later you can adjust the maximum RTC - frequency for normal users through the <systemitem class="systemname">/proc - </systemitem> file system. Use one of the following two commands to - enable RTC for normal users: - <screen>echo 1024 > /proc/sys/dev/rtc/max-user-freq</screen> - <screen>sysctl dev/rtc/max-user-freq=1024</screen> - You can make this setting permanent by adding the latter to - <filename>/etc/sysctl.conf</filename>. - </para> - <para> - You can see the new timer's efficiency in the status line. - The power management functions of some notebook BIOSes with speedstep CPUs - interact badly with RTC. Audio and video may get out of sync. Plugging the - external power connector in before you power up your notebook seems to help. - In some hardware combinations (confirmed during usage of non-DMA DVD drive - on an ALi1541 board) usage of the RTC timer causes skippy playback. It's - recommended to use the third method in these cases. - </para> -</listitem> -<listitem><para> - <emphasis role="bold">The third timer code</emphasis> is turned on with the - <option>-softsleep</option> option. It has the efficiency of the RTC, but it - doesn't use RTC. On the other hand, it requires more CPU. -</para></listitem> -</itemizedlist> +OUTDATED CONTENT REMOVED </para> </sect1> |