Ignore:
Timestamp:
05/12/2005 06:05:01 PM (19 years ago)
Author:
Manuel Canales Esparcia <manuel@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.1, 6.2, 6.2.0, 6.2.0-rc1, 6.2.0-rc2, 6.3, 6.3-rc1, 6.3-rc2, 6.3-rc3, 7.10, 7.4, 7.5, 7.6, 7.6-blfs, 7.6-systemd, 7.7, 7.8, 7.9, 8.0, 8.1, 8.2, 8.3, 8.4, 9.0, 9.1, basic, bdubbs/svn, elogind, gnome, kde5-13430, kde5-14269, kde5-14686, kea, ken/TL2024, ken/inkscape-core-mods, ken/tuningfonts, krejzi/svn, lazarus, lxqt, nosym, perl-modules, plabs/newcss, plabs/python-mods, python3.11, qt5new, rahul/power-profiles-daemon, renodr/vulkan-addition, systemd-11177, systemd-13485, trunk, upgradedb, xry111/intltool, xry111/llvm18, xry111/soup3, xry111/test-20220226, xry111/xf86-video-removal
Children:
6ef979c9
Parents:
f73bacc
Message:

Tagged mplayer.xml

git-svn-id: svn://svn.linuxfromscratch.org/BLFS/trunk/BOOK@4163 af4574ff-66df-0310-9fd7-8a98e5e911e0

File:
1 edited

Legend:

Unmodified
Added
Removed

  • multimedia/videoutils/mplayer.xml

    rf73bacc rf29d6ee  
     1<?xml version="1.0" encoding="ISO-8859-1"?>
    12<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.4//EN"
    23   "http://www.oasis-open.org/docbook/xml/4.4/docbookx.dtd" [
    … …  
    2526
    2627<sect1 id="mplayer" xreflabel="MPlayer-&mplayer-version;">
    27 <sect1info>
    28 <othername>$LastChangedBy$</othername>
    29 <date>$Date$</date>
    30 </sect1info>
    31 <?dbhtml filename="mplayer.html"?>
    32 <title><application>MPlayer</application>-&mplayer-version;</title>
    33 <indexterm zone="mplayer">
    34 <primary sortas="a-MPlayer">MPlayer</primary></indexterm>
    35 
    36 <sect2>
    37 <title>Introduction to <application>MPlayer</application></title>
    38 
    39 <para>The <application>MPlayer</application> package contains an audio/video
    40 player controlled via the command line or a graphical interface which is
    41 able to play almost every popular audio and video file format
    42 and <acronym>CODEC</acronym> (COder/DECoder, also COmpressor/DECompressor).
    43 With supported video hardware and additional drivers,
    44 <application>MPlayer</application> can play video files without an
    45 <application>X</application> window system installed.</para>
    46 
    47 <para>For <application>MPlayer</application> general information and available
    48 features, including a full list of file formats, <acronym>CODEC</acronym>s and
    49 output devices supported by <application>MPlayer</application>, visit the
    50 <ulink url="http://www1.mplayerhq.hu/homepage/design7/info.html">
    51 <application>MPlayer</application> web site</ulink>.</para>
    52 
    53 <sect3><title>Package information</title>
    54 <itemizedlist spacing='compact'>
    55 <listitem><para>Download (HTTP):
    56 <ulink url="&mplayer-download-http;"/></para></listitem>
    57 <listitem><para>Download (FTP):
    58 <ulink url="&mplayer-download-ftp;"/></para></listitem>
    59 <listitem><para>Download MD5 sum: &mplayer-md5sum;</para></listitem>
    60 <listitem><para>Download size: &mplayer-size;</para></listitem>
    61 <listitem><para>Estimated disk space required:
    62 &mplayer-buildsize;</para></listitem>
    63 <listitem><para>Estimated build time:
    64 &mplayer-time;</para></listitem></itemizedlist>
    65 </sect3>
    66 
    67 <sect3><title>Additional downloads</title>
    68 <para><emphasis>Patches</emphasis></para>
    69 <itemizedlist spacing='compact'>
    70 <listitem><para>Required Patch (for fbdev driver support): <ulink
    71 url="&patch-root;/MPlayer-&mplayer-version;-kernel_2.6-1.patch"/></para>
    72 </listitem>
    73 </itemizedlist>
    74 
    75 <para><emphasis><acronym>CODEC</acronym>s</emphasis></para>
    76 <itemizedlist spacing='compact'>
    77 <listitem><para>Proprietary <acronym>CODEC</acronym>s: <ulink
    78 url="http://www.mplayerhq.hu/MPlayer/releases/codecs/&mplayer-codec;"/></para>
    79 </listitem>
    80 <listitem><para>Download MD5 sum: &mplayer-codec-md5sum;</para></listitem>
    81 <listitem><para>Download size: &mplayer-codec-size;</para></listitem>
    82 <listitem><para>Additional <acronym>CODEC</acronym>s: <ulink
    83 url="http://www.mplayerhq.hu/MPlayer/releases/codecs/"/></para>
    84 </listitem>
    85 </itemizedlist>
    86 
    87 <para><emphasis>Skins</emphasis></para>
    88 <itemizedlist spacing='compact'>
    89 <listitem><para>Default <acronym>GUI</acronym> skin: <ulink
    90 url="http://www1.mplayerhq.hu/MPlayer/Skin/&mplayer-skin;"/></para>
    91 </listitem>
    92 <listitem><para>Download MD5 sum: &mplayer-skin-md5sum;</para></listitem>
    93 <listitem><para>Download size: &mplayer-skin-size;</para></listitem>
    94 <listitem><para>Additional skins: <ulink
    95 url="http://www1.mplayerhq.hu/MPlayer/Skin/"/></para>
    96 </listitem></itemizedlist>
    97 
    98 <para><emphasis>Fonts</emphasis></para>
    99 <itemizedlist spacing='compact'>
    100 <listitem><para>Prerendered fonts: <ulink
    101 url="http://www1.mplayerhq.hu/MPlayer/releases/fonts/&mplayer-font;.tar.bz2"/>
    102 </para></listitem>
    103 <listitem><para>Download MD5 sum: &mplayer-font-md5sum;</para></listitem>
    104 <listitem><para>Download size: &mplayer-font-size;</para></listitem>
    105 <listitem><para>Additional fonts: <ulink
    106 url="http://www1.mplayerhq.hu/MPlayer/releases/fonts/"/></para>
    107 </listitem></itemizedlist>
    108 
    109 <note><para>The <acronym>CODEC</acronym>s, skins and fonts are not required to
    110 build and use <application>MPlayer</application>.</para></note>
    111 </sect3>
    112 
    113 <sect3><title><application>MPlayer</application> dependencies</title>
    114 <sect4><title>Optional input drivers and libraries</title>
    115 <para><xref linkend="cdparanoia"/>,
    116 <xref linkend="libdv"/>,
    117 <xref linkend="libdvdread"/>,
    118 <xref linkend="samba3"/>,
    119 <ulink url="http://www.live.com/mplayer/">LIVE.COM Streaming Media</ulink>,
    120 <ulink url="http://www.matroska.org/downloads/linux.html">libmatroska</ulink>
    121 (requires
    122 <ulink url="http://dl.matroska.org/downloads/libebml/">libebml</ulink>),
    123 <ulink url="http://www.linuxtv.org/">DVB drivers</ulink>
    124 and <ulink url="http://www.metzlerbros.org/dvb/">DVB</ulink></para>
    125 </sect4>
    126 
    127 <sect4><title>Optional audio output drivers and libraries</title>
    128 <para><xref linkend="alsa"/>,
    129 <xref linkend="arts"/>,
    130 <xref linkend="esound"/>,
    131 <xref linkend="nas"/>,
    132 <xref linkend="sdl"/> (also used for video output),
    133 <xref linkend="xmms"/>,
    134 <ulink url="http://0pointer.de/lennart/projects/polypaudio/">Polypaudio</ulink>,
    135 <ulink url="http://bio2jack.sourceforge.net/">bio2jack</ulink> (requires
    136 <ulink url="http://jackit.sourceforge.net/">JACK</ulink>)</para>
    137 </sect4>
    138 
    139 <sect4><title>Optional video output drivers and libraries</title>
    140 <para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
    141 <xref linkend="libpng"/>,
    142 <xref linkend="libjpeg"/>,
    143 <xref linkend="libungif"/> or <xref linkend="giflib"/>,
    144 <xref linkend="GTK"/>,
    145 <xref linkend="freetype2"/>,
    146 <xref linkend="fontconfig"/>,
    147 <xref linkend="aalib"/>,
    148 <ulink url="http://www.directfb.org/">DirectFB</ulink>,
    149 <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
    150 <ulink url="http://www.ggi-project.org/">GGI</ulink>,
    151 <ulink url="http://sam.zoy.org/projects/libcaca/">libcaca</ulink>,
    152 <ulink url="http://www.ladspa.org/">LADSPA</ulink>,
    153 <ulink url="http://dxr2.sourceforge.net/">Dxr2</ulink>,
    154 <ulink url="http://dxr3.sourceforge.net/">libdxr3</ulink>,
    155 <ulink url="http://prdownloads.sourceforge.net/zapping/">MP1E</ulink>,
    156 <ulink url="http://freedesktop.org/Software/FriBidi">FriBidi</ulink> and
    157 <ulink url="http://trific.ath.cx/software/enca/">Enca</ulink></para>
    158 </sect4>
    159 
    160 <sect4><title>Optional <acronym>CODEC</acronym>s</title>
    161 <para><xref linkend="libvorbis"/>,
    162 <xref linkend="xvid"/>,
    163 <xref linkend="LZO"/>,
    164 <xref linkend="libmad"/>,
    165 <xref linkend="lame"/>,
    166 <xref linkend="libfame"/>,
    167 <ulink url="http://www.theora.org/">Theora</ulink>,
    168 <ulink url="http://www.xiph.org/ogg/vorbis/index.html">Tremor</ulink>,
    169 <ulink url="http://sourceforge.net/projects/faac">FAAD2</ulink>,
    170 <ulink url="http://www.divx.com/divx/linux/">DivX4Linux</ulink>,
    171 <ulink url="http://sourceforge.net/projects/toolame">TooLAME</ulink>,
    172 <ulink url="http://www.dolda2000.cjb.net/~fredrik/lirccd/">lirccd</ulink>
    173 and <ulink url="http://www.lirc.org/">LIRC</ulink></para>
    174 </sect4>
    175 </sect3>
    176 
    177 </sect2>
    178 
    179 <sect2>
    180 <title>Installation of <application>MPlayer</application></title>
    181 
    182 <sect3>
    183 <title><acronym>CODEC</acronym> installation (optional)</title>
    184 
    185 <para>If you downloaded any proprietary <acronym>CODEC</acronym>s
    186 (which can provide support for additional audio and video formats such as
    187 Real, Indeo and QuickTime), extract them to
    188 <filename class="directory">/usr/lib/mplayer/codecs</filename>
    189 using the following commands as the root user (substitute and/or add different
    190 <acronym>CODEC</acronym> filenames, if necessary):</para>
    191 
    192 <screen><userinput role='root'><command>install -v -d -m755 /usr/lib/mplayer/codecs &amp;&amp;
     28  <?dbhtml filename="mplayer.html"?>
     29
     30  <sect1info>
     31    <othername>$LastChangedBy$</othername>
     32    <date>$Date$</date>
     33  </sect1info>
     34
     35  <title>MPlayer-&mplayer-version;</title>
     36
     37  <indexterm zone="mplayer">
     38    <primary sortas="a-MPlayer">MPlayer</primary>
     39  </indexterm>
     40
     41  <sect2 role="package">
     42    <title>Introduction to MPlayer</title>
     43
     44    <para>The <application>MPlayer</application> package contains an audio/video
     45    player controlled via the command line or a graphical interface which is able
     46    to play almost every popular audio and video file format and CODEC
     47    (COder/DECoder, also COmpressor/DECompressor). With supported video
     48    hardware and additional drivers, <application>MPlayer</application> can play
     49    video files without an <application>X Window System</application> installed.</para>
     50
     51    <para>For <application>MPlayer</application> general information and
     52    available features, including a full list of file formats, CODECs and
     53    output devices supported by <application>MPlayer</application>, visit the
     54    <ulink url="http://www1.mplayerhq.hu/homepage/design7/info.html">
     55    <application>MPlayer</application> web site</ulink>.</para>
     56
     57    <bridgehead renderas="sect3">Package Information</bridgehead>
     58    <itemizedlist spacing="compact">
     59      <listitem>
     60        <para>Download (HTTP): <ulink url="&mplayer-download-http;"/></para>
     61      </listitem>
     62      <listitem>
     63        <para>Download (FTP): <ulink url="&mplayer-download-ftp;"/></para>
     64      </listitem>
     65      <listitem>
     66        <para>Download MD5 sum: &mplayer-md5sum;</para>
     67      </listitem>
     68      <listitem>
     69        <para>Download size: &mplayer-size;</para>
     70      </listitem>
     71      <listitem>
     72        <para>Estimated disk space required: &mplayer-buildsize;</para>
     73      </listitem>
     74      <listitem>
     75        <para>Estimated build time: &mplayer-time;</para>
     76      </listitem>
     77    </itemizedlist>
     78
     79    <bridgehead renderas="sect3">Additional Downloads</bridgehead>
     80   
     81    <itemizedlist spacing='compact'>
     82      <title>Patches</title>
     83      <listitem>
     84        <para>Required Patch (for fbdev driver support): <ulink
     85        url="&patch-root;/MPlayer-&mplayer-version;-kernel_2.6-1.patch"/></para>
     86      </listitem>
     87    </itemizedlist>
     88
     89    <itemizedlist spacing='compact'>
     90      <title>CODECs</title>
     91      <listitem>
     92        <para>Proprietary CODECs: <ulink
     93        url="http://www.mplayerhq.hu/MPlayer/releases/codecs/&mplayer-codec;"/></para>
     94      </listitem>
     95      <listitem>
     96        <para>Download MD5 sum: &mplayer-codec-md5sum;</para>
     97      </listitem>
     98      <listitem>
     99        <para>Download size: &mplayer-codec-size;</para>
     100      </listitem>
     101        <listitem><para>Additional CODECs: <ulink
     102        url="http://www.mplayerhq.hu/MPlayer/releases/codecs/"/></para>
     103      </listitem>
     104    </itemizedlist>
     105
     106    <itemizedlist spacing='compact'>
     107      <title>Skins</title>
     108      <listitem>
     109        <para>Default GUI skin: <ulink
     110        url="http://www1.mplayerhq.hu/MPlayer/Skin/&mplayer-skin;"/></para>
     111      </listitem>
     112      <listitem>
     113        <para>Download MD5 sum: &mplayer-skin-md5sum;</para>
     114      </listitem>
     115      <listitem>
     116        <para>Download size: &mplayer-skin-size;</para>
     117      </listitem>
     118      <listitem>
     119        <para>Additional skins: <ulink
     120        url="http://www1.mplayerhq.hu/MPlayer/Skin/"/></para>
     121      </listitem>
     122    </itemizedlist>
     123
     124    <itemizedlist spacing='compact'>
     125      <title>Fonts</title>
     126      <listitem>
     127        <para>Prerendered fonts: <ulink
     128        url="http://www1.mplayerhq.hu/MPlayer/releases/fonts/&mplayer-font;.tar.bz2"/></para>
     129      </listitem>
     130      <listitem>
     131        <para>Download MD5 sum: &mplayer-font-md5sum;</para>
     132      </listitem>
     133      <listitem>
     134        <para>Download size: &mplayer-font-size;</para>
     135      </listitem>
     136      <listitem>
     137        <para>Additional fonts: <ulink
     138        url="http://www1.mplayerhq.hu/MPlayer/releases/fonts/"/></para>
     139      </listitem>
     140    </itemizedlist>
     141
     142    <note>
     143      <para>The CODECs, skins and fonts are not required to
     144      build and use <application>MPlayer</application>.</para>
     145    </note>
     146
     147    <bridgehead renderas="sect3">MPlayer Dependencies</bridgehead>
     148   
     149    <bridgehead renderas="sect4">Optional Input Drivers and Libraries</bridgehead>
     150    <para><xref linkend="cdparanoia"/>,
     151    <xref linkend="libdv"/>,
     152    <xref linkend="libdvdread"/>,
     153    <xref linkend="samba3"/>,
     154    <ulink url="http://www.live.com/mplayer/">LIVE.COM Streaming Media</ulink>,
     155    <ulink url="http://www.matroska.org/downloads/linux.html">libmatroska</ulink>
     156    (requires
     157    <ulink url="http://dl.matroska.org/downloads/libebml/">libebml</ulink>),
     158    <ulink url="http://www.linuxtv.org/">DVB drivers</ulink>
     159    and <ulink url="http://www.metzlerbros.org/dvb/">DVB</ulink></para>
     160   
     161    <bridgehead renderas="sect4">Optional Audio Output Drivers and Libraries</bridgehead>
     162    <para><xref linkend="alsa"/>,
     163    <xref linkend="arts"/>,
     164    <xref linkend="esound"/>,
     165    <xref linkend="nas"/>,
     166    <xref linkend="sdl"/> (also used for video output),
     167    <xref linkend="xmms"/>,
     168    <ulink url="http://0pointer.de/lennart/projects/polypaudio/">Polypaudio</ulink>,
     169    <ulink url="http://bio2jack.sourceforge.net/">bio2jack</ulink> (requires
     170    <ulink url="http://jackit.sourceforge.net/">JACK</ulink>)</para>
     171   
     172    <bridgehead renderas="sect4">Optional Video Output Drivers and Libraries</bridgehead>
     173    <para>X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
     174    <xref linkend="libpng"/>,
     175    <xref linkend="libjpeg"/>,
     176    <xref linkend="libungif"/> or <xref linkend="giflib"/>,
     177    <xref linkend="GTK"/>,
     178    <xref linkend="freetype2"/>,
     179    <xref linkend="fontconfig"/>,
     180    <xref linkend="aalib"/>,
     181    <ulink url="http://www.directfb.org/">DirectFB</ulink>,
     182    <ulink url="http://www.svgalib.org/">SVGAlib</ulink>,
     183    <ulink url="http://www.ggi-project.org/">GGI</ulink>,
     184    <ulink url="http://sam.zoy.org/projects/libcaca/">libcaca</ulink>,
     185    <ulink url="http://www.ladspa.org/">LADSPA</ulink>,
     186    <ulink url="http://dxr2.sourceforge.net/">Dxr2</ulink>,
     187    <ulink url="http://dxr3.sourceforge.net/">libdxr3</ulink>,
     188    <ulink url="http://prdownloads.sourceforge.net/zapping/">MP1E</ulink>,
     189    <ulink url="http://freedesktop.org/Software/FriBidi">FriBidi</ulink> and
     190    <ulink url="http://trific.ath.cx/software/enca/">Enca</ulink></para>
     191   
     192    <bridgehead renderas="sect4">Optional CODECs</bridgehead>
     193    <para><xref linkend="libvorbis"/>,
     194    <xref linkend="xvid"/>,
     195    <xref linkend="LZO"/>,
     196    <xref linkend="libmad"/>,
     197    <xref linkend="lame"/>,
     198    <xref linkend="libfame"/>,
     199    <ulink url="http://www.theora.org/">Theora</ulink>,
     200    <ulink url="http://www.xiph.org/ogg/vorbis/index.html">Tremor</ulink>,
     201    <ulink url="http://sourceforge.net/projects/faac">FAAD2</ulink>,
     202    <ulink url="http://www.divx.com/divx/linux/">DivX4Linux</ulink>,
     203    <ulink url="http://sourceforge.net/projects/toolame">TooLAME</ulink>,
     204    <ulink url="http://www.dolda2000.cjb.net/~fredrik/lirccd/">lirccd</ulink>
     205    and <ulink url="http://www.lirc.org/">LIRC</ulink></para>
     206
     207  </sect2>
     208
     209  <sect2 role="installation">
     210    <title>Installation of MPlayer</title>
     211
     212    <sect3>
     213      <title>CODEC Installation (Optional)</title>
     214
     215      <para>If you downloaded any proprietary CODECs (which can provide support
     216      for additional audio and video formats such as Real, Indeo and QuickTime),
     217      extract them to <filename class="directory">/usr/lib/mplayer/codecs</filename>
     218      using the following commands as the <systemitem
     219      class="username">root</systemitem> user (substitute and/or add different
     220      CODEC filenames, if necessary):</para>
     221
     222<screen role="root"><userinput>install -v -d -m755 /usr/lib/mplayer/codecs &amp;&amp;
    193223tar -jvxf ../&mplayer-codec; \
    194224    -C /usr/lib/mplayer/codecs --strip-components=1 &amp;&amp;
    195 chown -v -R root:root /usr/lib/mplayer/codecs</command></userinput></screen>
    196 
    197 <para>If you installed any <acronym>CODEC</acronym>s, ensure you add
    198 <option>--with-codecsdir=/usr/lib/mplayer/codecs</option>
    199 to the <command>configure</command> script.</para>
    200 </sect3>
    201 
    202 <sect3>
    203 <title><acronym>GUI</acronym> installation (optional)</title>
    204 
    205 <para>To enable building the <acronym>GUI</acronym> version of
    206 <application>MPlayer</application> (requires <xref linkend="GTK"/>), add
    207 <option>--enable-gui</option> to the <command>configure</command>
    208 script. You'll also need to extract at least one skin. Extract the desired
    209 skin and create the default location (as the root user):</para>
    210 
    211 <screen><userinput role='root'><command>install -v -d -m755 /usr/share/mplayer/Skin &amp;&amp;
     225chown -v -R root:root /usr/lib/mplayer/codecs</userinput></screen>
     226
     227      <para>If you installed any CODECs, ensure you add
     228      <option>--with-codecsdir=/usr/lib/mplayer/codecs</option>
     229      to the <command>configure</command> script.</para>
     230
     231    </sect3>
     232
     233    <sect3>
     234      <title>GUI Installation (Optional)</title>
     235
     236      <para>To enable building the GUI version of
     237      <application>MPlayer</application> (requires <xref linkend="GTK"/>), add
     238      <option>--enable-gui</option> to the <command>configure</command>
     239      script. You'll also need to extract at least one skin. Extract the desired
     240      skin and create the default location (as the <systemitem
     241      class="username">root</systemitem> user):</para>
     242
     243<screen role="root"><userinput>install -v -d -m755 /usr/share/mplayer/Skin &amp;&amp;
    212244tar -jvxf ../&mplayer-skin; \
    213245    -C /usr/share/mplayer/Skin &amp;&amp;
    214246chown -v -R root:root /usr/share/mplayer/Skin/Blue &amp;&amp;
    215247chmod -v 0755 /usr/share/mplayer/Skin/Blue{,/icons} &amp;&amp;
    216 ln -sfv Blue /usr/share/mplayer/Skin/default</command></userinput></screen>
    217 </sect3>
    218 
    219 <sect3>
    220 <title>Installing <acronym>OSD</acronym> and subtitles support
    221 (optional)</title>
    222 
    223 <para>To enable <acronym>OSD</acronym> (On Screen Display) and subtitles
    224 support, add <option>--enable-menu</option> to the
    225 <command>configure</command> script. You'll also need to set up at least one
    226 font (see font installation instructions a little later).</para>
    227 </sect3>
    228 
    229 <sect3>
    230 <title>Main <application>MPlayer</application> installation</title>
    231 
    232 <note><para>The package maintainers recommend building without any
    233 optimizations.</para></note>
    234 
    235 <para><application>MPlayer</application> can build a shared post-processing
    236 library from the internal <application>FFmpeg</application> package which other
    237 packages can link to. This requires <application>MPlayer</application> to link
    238 dynamically to this library instead of the default statically linked method.
    239 If you desire to build the shared library,
    240 add <option>--enable-shared-pp</option> and
    241 <option>--disable-fastmemcpy</option> to the <command>configure</command>
    242 script. The <option>--disable-fastmemcpy</option> parameter is required to
    243 avoid <computeroutput>undefined reference</computeroutput> errors when other
    244 packages link to the shared library.</para>
    245 
    246 <para>You may wish to examine the output from
    247 <command>./configure --help</command> to find out what additional parameters
    248 to <command>configure</command> are needed to include the dependencies you
    249 have installed on your system.</para>
    250 
    251 <para>Install <application>MPlayer</application> by running the following
    252 commands:</para>
    253 
    254 <screen><userinput><command>patch -Np1 -i ../MPlayer-&mplayer-version;-kernel_2.6-1.patch &amp;&amp;
     248ln -sfv Blue /usr/share/mplayer/Skin/default</userinput></screen>
     249
     250    </sect3>
     251
     252    <sect3>
     253      <title>Installing OSD and Subtitles Support (Optional)</title>
     254
     255      <para>To enable OSD (On Screen Display) and subtitles support, add
     256      <option>--enable-menu</option> to the <command>configure</command>
     257      script. You'll also need to set up at least one font (see font installation
     258      instructions a little later).</para>
     259
     260    </sect3>
     261
     262    <sect3>
     263      <title>Main MPlayer Installation</title>
     264
     265      <note>
     266        <para>The package maintainers recommend building without any
     267        optimizations.</para>
     268      </note>
     269
     270      <para><application>MPlayer</application> can build a shared post-processing
     271      library from the internal <application>FFmpeg</application> package which
     272      other packages can link to. This requires <application>MPlayer</application>
     273      to link dynamically to this library instead of the default statically linked method.
     274      If you desire to build the shared library, add <option>--enable-shared-pp</option>
     275      and <option>--disable-fastmemcpy</option> to the <command>configure</command>
     276      script. The <option>--disable-fastmemcpy</option> parameter is required to
     277      avoid <computeroutput>undefined reference</computeroutput> errors when other
     278      packages link to the shared library.</para>
     279
     280      <para>You may wish to examine the output from
     281      <command>./configure --help</command> to find out what additional
     282      parameters to <command>configure</command> are needed to include
     283      the dependencies you have installed on your system.</para>
     284
     285      <para>Install <application>MPlayer</application> by running the following
     286      commands:</para>
     287
     288<screen><userinput>patch -Np1 -i ../MPlayer-&mplayer-version;-kernel_2.6-1.patch &amp;&amp;
    255289./configure --prefix=/usr --confdir=/etc/mplayer \
    256290    --enable-largefiles &amp;&amp;
    257 make</command></userinput></screen>
    258 
    259 <para>This package does not come with a test suite.</para>
    260 
    261 <para>Now, as the root user:</para>
    262 
    263 <screen><userinput role='root'><command>make install &amp;&amp;
     291make</userinput></screen>
     292
     293      <para>This package does not come with a test suite.</para>
     294
     295      <para>Now, as the <systemitem class="username">root</systemitem> user:</para>
     296
     297<screen role="root"><userinput>make install &amp;&amp;
    264298install -v -m755 -d /usr/share/doc/mplayer-&mplayer-version; &amp;&amp;
    265 cp -v -R DOCS/* /usr/share/doc/mplayer-&mplayer-version;</command></userinput></screen>
    266 
    267 <para>Passing parameters to <command>configure</command> may result in the
    268 creation of <filename class='libraryfile'>libdha.so.1.0</filename>. If so,
    269 you may wish to create a symlink to this library in case other packages link
    270 to <filename class='libraryfile'>libdha.so</filename>. Use the following
    271 command as the root user to create the symlink:</para>
    272 
    273 <screen><userinput role='root'><command>ln -v -s libdha.so.1.0 /usr/lib/libdha.so</command></userinput></screen>
    274 
    275 <para>You will need <filename>codecs.conf</filename> only if you want to
    276 change its properties, as the main binary contains an internal copy of
    277 it. Ensure any changes you make to <filename>codecs.conf</filename> achieve
    278 the desired results, as incorrect entries in this file have been known to
    279 cause errors and render the player unusable. If necessary, create the file
    280 using the following command.</para>
    281 
    282 <screen><userinput role='root'><command>install -m644 etc/codecs.conf /etc/mplayer</command></userinput></screen>
    283 
    284 <para>You may also want to copy all the default configuration files to
    285 <filename class='directory'>/etc/mplayer</filename> for future reference or
    286 more customization ability.</para>
    287 
    288 <screen><userinput role='root'><command>install -m644 etc/*.conf /etc/mplayer</command></userinput></screen>
    289 </sect3>
    290 
    291 <sect3>
    292 <title><acronym>OSD</acronym> and subtitles font installation
    293 (required if <parameter>--enable-menu</parameter> was passed to
    294 <command>configure</command>)</title>
    295 
    296 <para>The recommended method to set up a font for
    297 <application>MPlayer</application> is to link a <acronym>TTF</acronym> file to
    298 your <filename class="directory">~/.mplayer</filename> directory. A link
    299 should be created in each user's home directory who may use
    300 <application>MPlayer</application>. For example:</para>
    301 
    302 <screen><userinput><command>install -v -m750 -d ~/.mplayer &amp;&amp;
     299cp -v -R DOCS/* /usr/share/doc/mplayer-&mplayer-version;</userinput></screen>
     300
     301      <para>Passing parameters to <command>configure</command> may result
     302      in the creation of <filename class='libraryfile'>libdha.so.1.0</filename>. If so,
     303      you may wish to create a symlink to this library in case other packages link
     304      to <filename class='libraryfile'>libdha.so</filename>. Use the following
     305      command as the <systemitem class="username">root</systemitem> user
     306      to create the symlink:</para>
     307
     308<screen role="root"><userinput>ln -v -s libdha.so.1.0 /usr/lib/libdha.so</userinput></screen>
     309
     310      <para>You will need <filename>codecs.conf</filename> only if you want to
     311      change its properties, as the main binary contains an internal copy of
     312      it. Ensure any changes you make to <filename>codecs.conf</filename> achieve
     313      the desired results, as incorrect entries in this file have been known to
     314      cause errors and render the player unusable. If necessary, create the file
     315      using the following command.</para>
     316
     317<screen role="root"><userinput>install -m644 etc/codecs.conf /etc/mplayer</userinput></screen>
     318
     319      <para>You may also want to copy all the default configuration files to
     320      <filename class='directory'>/etc/mplayer</filename> for future reference or
     321      more customization ability.</para>
     322
     323<screen role="root"><userinput>install -m644 etc/*.conf /etc/mplayer</userinput></screen>
     324
     325    </sect3>
     326
     327    <sect3>
     328      <title>OSD and Subtitles Font Installation (Required if '--enable-menu' Was
     329      Passed to 'configure')</title>
     330
     331      <para>The recommended method to set up a font for
     332      <application>MPlayer</application> is to link a TTF file to
     333      your <filename class="directory">~/.mplayer</filename> directory. A link
     334      should be created in each user's home directory who may use
     335      <application>MPlayer</application>. For example:</para>
     336
     337<screen><userinput>install -v -m750 -d ~/.mplayer &amp;&amp;
    303338ln -v -sf /usr/X11R6/lib/X11/fonts/TTF/luxisri.ttf \
    304     ~/.mplayer/subfont.ttf</command></userinput></screen>
    305 
    306 <para>There are several other ways to set up a font package. To use a
    307 prerendered <application>MPlayer</application> font package, extract and link
    308 one of the font tarballs using the following commands:</para>
    309 
    310 <screen><userinput role='root'><command>tar -jvxf ../&mplayer-font;.tar.bz2 \
     339    ~/.mplayer/subfont.ttf</userinput></screen>
     340
     341      <para>There are several other ways to set up a font package. To use a
     342      prerendered <application>MPlayer</application> font package, extract
     343      and link one of the font tarballs using the following commands:</para>
     344
     345<screen role="root"><userinput>tar -jvxf ../&mplayer-font;.tar.bz2 \
    311346    -C /usr/share/mplayer/font &amp;&amp;
    312347chown -v -R root:root /usr/share/mplayer/font &amp;&amp;
    313348cd /usr/share/mplayer/font &amp;&amp;
    314 ln -v -sf &mplayer-font;/font-arial-<replaceable>[font size]</replaceable>-iso-8859-1/* .</command></userinput></screen>
    315 
    316 <para>Available font sizes are 14, 18, 24 or 28.</para>
    317 
    318 <para>Additional information as well as additional methods to set up an
    319 <application>MPlayer</application> font package can be found at <ulink
    320 url="http://www.mplayerhq.hu/DOCS/HTML/en/subosd.html#mpsub-install"/>.</para>
    321 </sect3>
    322 
    323 <sect3>
    324 <title>Installation for <acronym>DVD</acronym> playback (optional)</title>
    325 
    326 <para>If you want <acronym>DVD</acronym> playback with
    327 <application>MPlayer</application>, you need to ensure a link exists
    328 from your <acronym>DVD</acronym> drive to <filename>/dev/dvd</filename>. If
    329 necessary, create the link using the following commands:</para>
    330 
    331 <screen><userinput role='root'><command>cat &gt;&gt; /etc/udev/rules.d/24-dvd.rules &lt;&lt; "EOF"</command>
    332 # Create a /dev/dvd symlink
     349ln -v -sf &mplayer-font;/font-arial-<replaceable>[font size]</replaceable>-iso-8859-1/* .</userinput></screen>
     350
     351      <para>Available font sizes are 14, 18, 24 or 28.</para>
     352
     353      <para>Additional information as well as additional methods to set up an
     354      <application>MPlayer</application> font package can be found at <ulink
     355      url="http://www.mplayerhq.hu/DOCS/HTML/en/subosd.html#mpsub-install"/>.</para>
     356
     357    </sect3>
     358
     359    <sect3>
     360      <title>Installation for DVD Playback (Optional)</title>
     361
     362      <para>If you want DVD playback with <application>MPlayer</application>,
     363      you need to ensure a link exists from your DVD drive to
     364      <filename>/dev/dvd</filename>. If necessary, create the link using the
     365      following commands:</para>
     366
     367<screen role="root"><userinput>cat &gt;&gt; /etc/udev/rules.d/24-dvd.rules &lt;&lt; "EOF"
     368<literal># Create a /dev/dvd symlink
    333369 
    334 KERNEL="<replaceable>[dvd drive]</replaceable>", SYMLINK="dvd"
     370KERNEL="<replaceable>[dvd drive]</replaceable>", SYMLINK="dvd"</literal>
    335371 
    336 <command>EOF
    337 udevstart</command></userinput></screen>
    338 
    339 <para>Replace <replaceable>[dvd drive]</replaceable> with whatever
    340 device is appropriate, for example <filename>hdc</filename>. If
    341 you don't know which device to choose, type:</para>
    342 
    343 <screen><userinput><command>dmesg | grep DVD</command></userinput></screen>
    344 
    345 <para>It should result in an output like:</para>
    346 
    347 <screen><userinput>hdc: Pioneer DVD-ROM ATAPIModel DVD-114 0110,
    348 ATAPI CD/DVD-ROM drive</userinput></screen>
    349 </sect3>
    350 
    351 </sect2>
    352 
    353 <sect2>
    354 <title>Configuring <application>MPlayer</application></title>
    355 
    356 <sect3 id="mplayer-config"><title>Config files</title>
    357 <para><filename>/etc/mplayer/*</filename>,
    358 <filename>~/.mplayer/*</filename></para>
    359 <indexterm zone="mplayer mplayer-config">
    360 <primary sortas="e-AA.mplayer">~/.mplayer/*</primary></indexterm>
    361 <indexterm zone="mplayer mplayer-config">
    362 <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary></indexterm>
    363 </sect3>
    364 
    365 <sect3><title>Configuration information</title>
    366 <para>Typically, there's no configuration required for the system-wide files
    367 in <filename class='directory'>/etc/mplayer</filename> (in fact, this
    368 directory is empty unless you copied the default files as mentioned above).
    369 Configuration can be accomplished by choosing the configuration button located
    370 on the <application>MPlayer</application> <acronym>GUI</acronym>. Any
    371 configuration changes made here will be copied to the user's
    372 <filename class='directory'>~/.mplayer</filename> directory.</para>
    373 </sect3>
    374 
    375 </sect2>
    376 
    377 <sect2>
    378 <title>Contents</title>
    379 
    380 <segmentedlist>
    381 <segtitle>Installed Programs</segtitle>
    382 <segtitle>Installed Libraries</segtitle>
    383 <segtitle>Installed Directories</segtitle>
    384 <seglistitem>
    385 <seg>gmplayer, mplayer and mencoder</seg>
    386 <seg>libdha.so and optionally, libpostproc.so</seg>
    387 <seg>~/.mplayer, /etc/mplayer, /usr/include/postproc, /usr/lib/mplayer,
    388 /usr/share/mplayer and /usr/share/doc/mplayer-&mplayer-version;</seg>
    389 </seglistitem>
    390 </segmentedlist>
    391 
    392 <variablelist>
    393 <bridgehead renderas="sect3">Short Descriptions</bridgehead>
    394 <?dbfo list-presentation="list"?>
    395 
    396 <varlistentry id="gmplayer">
    397 <term><command>gmplayer</command></term>
    398 <listitem><para>is a symlink to <command>mplayer</command> which brings up
    399 the graphical user interface component of
    400 <application>MPlayer</application>.</para>
    401 <indexterm zone="mplayer gmplayer">
    402 <primary sortas="b-gmplayer">gmplayer</primary></indexterm>
    403 </listitem>
    404 </varlistentry>
    405 
    406 <varlistentry id="mplayer-prog">
    407 <term><command>mplayer</command></term>
    408 <listitem><para> manages the input formats, the <acronym>CODEC</acronym>s and
    409 the output formats to play video files, <acronym>DVD</acronym>s,
    410 (S)<acronym>VCD</acronym>s or network streams containing audio and/or video
    411 information on your system.</para>
    412 <indexterm zone="mplayer mplayer-prog">
    413 <primary sortas="b-mplayer">mplayer</primary></indexterm>
    414 
    415 <para>Examples:</para>
    416 
    417 <screen><userinput><command>mplayer -fs blfs.avi
     372EOF
     373udevstart</userinput></screen>
     374
     375      <para>Replace <replaceable>[dvd drive]</replaceable> with whatever
     376      device is appropriate, for example <filename>hdc</filename>. If
     377      you don't know which device to choose, type:</para>
     378
     379<screen><userinput>dmesg | grep DVD</userinput></screen>
     380
     381      <para>It should result in an output like:</para>
     382
     383<screen><computeroutput>hdc: Pioneer DVD-ROM ATAPIModel DVD-114 0110,
     384ATAPI CD/DVD-ROM drive</computeroutput></screen>
     385
     386    </sect3>
     387
     388  </sect2>
     389
     390  <sect2 role="configuration">
     391    <title>Configuring MPlayer</title>
     392
     393    <sect3 id="mplayer-config">
     394      <title>Config Files</title>
     395
     396      <para><filename>/etc/mplayer/*</filename> and
     397      <filename>~/.mplayer/*</filename></para>
     398
     399      <indexterm zone="mplayer mplayer-config">
     400        <primary sortas="e-AA.mplayer">~/.mplayer/*</primary>
     401      </indexterm>
     402
     403      <indexterm zone="mplayer mplayer-config">
     404        <primary sortas="e-etc-mplayer">/etc/mplayer/*</primary>
     405      </indexterm>
     406
     407    </sect3>
     408
     409    <sect3>
     410      <title>Configuration Information</title>
     411
     412      <para>Typically, there's no configuration required for the system-wide files
     413      in <filename class='directory'>/etc/mplayer</filename> (in fact, this
     414      directory is empty unless you copied the default files as mentioned above).
     415      Configuration can be accomplished by choosing the configuration button located
     416      on the <application>MPlayer</application> GUI. Any
     417      configuration changes made here will be copied to the user's
     418      <filename class='directory'>~/.mplayer</filename> directory.</para>
     419
     420    </sect3>
     421
     422  </sect2>
     423
     424  <sect2 role="content">
     425    <title>Contents</title>
     426
     427    <segmentedlist>
     428      <segtitle>Installed Programs</segtitle>
     429      <segtitle>Installed Libraries</segtitle>
     430      <segtitle>Installed Directories</segtitle>
     431
     432      <seglistitem>
     433        <seg>gmplayer, mplayer, and mencoder</seg>
     434        <seg>libdha.so and optionally, libpostproc.so</seg>
     435        <seg>~/.mplayer, /etc/mplayer, /usr/include/postproc, /usr/lib/mplayer,
     436        /usr/share/mplayer, and /usr/share/doc/mplayer-&mplayer-version;</seg>
     437      </seglistitem>
     438    </segmentedlist>
     439
     440    <variablelist>
     441      <bridgehead renderas="sect3">Short Descriptions</bridgehead>
     442      <?dbfo list-presentation="list"?>
     443      <?dbhtml list-presentation="table"?>
     444
     445      <varlistentry id="gmplayer">
     446        <term><command>gmplayer</command></term>
     447        <listitem>
     448          <para>is a symlink to <command>mplayer</command> which
     449          brings up the graphical user interface component of
     450          <application>MPlayer</application>.</para>
     451          <indexterm zone="mplayer gmplayer">
     452            <primary sortas="b-gmplayer">gmplayer</primary>
     453          </indexterm>
     454        </listitem>
     455      </varlistentry>
     456
     457      <varlistentry id="mplayer-prog">
     458        <term><command>mplayer</command></term>
     459        <listitem>
     460          <para> manages the input formats, the CODECs and
     461          the output formats to play video files, DVDs,
     462          (S)VCDs or network streams containing audio and/or video
     463          information on your system.</para>
     464
     465          <para>Examples:</para>
     466
     467<screen><userinput>mplayer -fs blfs.avi
    418468mplayer -vo fbdev -fb /dev/fb0 dvd://1 -aid 128 -sub en -framedrop
    419469mplayer -fs vcd://1    # works both for VCDs and SVCDs
    420 mplayer http://www.students.uni-marburg.de/~Klossa/hapkidofight_lo.mpg</command></userinput></screen>
    421 
    422 <para>For further information, look at the very good documentation included
    423 with the package in the source tree subdirectory
    424 <filename class="directory">DOCS</filename> (also installed at
    425 <filename class='directory'>/usr/share/doc/mplayer</filename>).</para>
    426 </listitem>
    427 </varlistentry>
    428 
    429 <varlistentry id="mencoder">
    430 <term><command>mencoder</command></term>
    431 <listitem><para>is used to encode any <application>MPlayer</application>
    432 playable movie to DivX4, <application>XviD</application> or any
    433 <acronym>CODEC</acronym> in
    434 <filename class='libraryfile'>libavcodec</filename> with
    435 <acronym>PCM</acronym>/MP3/VBRMP3 audio.</para>
    436 <indexterm zone="mplayer mencoder">
    437 <primary sortas="b-mencoder">mencoder</primary></indexterm>
    438 
    439 <para>Example:</para>
    440 
    441 <screen><userinput><command>rm frameno.avi
     470mplayer http://www.students.uni-marburg.de/~Klossa/hapkidofight_lo.mpg</userinput></screen>
     471
     472          <para>For further information, look at the very good documentation included
     473          with the package in the source tree subdirectory
     474          <filename class="directory">DOCS</filename> (also installed at
     475          <filename class='directory'>/usr/share/doc/mplayer</filename>).</para>
     476          <indexterm zone="mplayer mplayer-prog">
     477            <primary sortas="b-mplayer">mplayer</primary>
     478          </indexterm>
     479        </listitem>
     480      </varlistentry>
     481
     482      <varlistentry id="mencoder">
     483        <term><command>mencoder</command></term>
     484        <listitem>
     485          <para>is used to encode any <application>MPlayer</application>
     486          playable movie to DivX4, <application>XviD</application> or any
     487          CODEC in <filename class='libraryfile'>libavcodec</filename> with
     488          PCM/MP3/VBRMP3 audio.</para>
     489
     490          <para>Example:</para>
     491
     492<screen><userinput>rm frameno.avi
    442493mencoder -dvd 1 -aid 128 -ovc frameno -oac mp3lame \
    443 -lameopts vbr=3 -o frameno.avi</command>
    444 
    445 # mencoder should output bitrates for average encodings
     494-lameopts vbr=3 -o frameno.avi
     495
     496<literal># mencoder should output bitrates for average encodings
    446497# now, choose one you like best! In the following lines,
    447498# replace &lt;bitrate&gt; and &lt;name.avi&gt; with statements of your
    448 # personal liking.
    449 
    450 <command>mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
     499# personal liking.</literal>
     500
     501mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
    451502-lavcopts vcodec=mpeg4:vpass=1:vhq:vbitrate=&lt;bitrate&gt; -o &lt;name.avi&gt;
    452503mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
    453504-lavcopts vcodec=mpeg4:vpass=2:vhq:vbitrate=&lt;bitrate&gt; -o &lt;name.avi&gt;
    454 mencoder -forceidx &lt;name.avi&gt;</command></userinput></screen>
    455 </listitem>
    456 </varlistentry>
    457 
    458 <varlistentry id="libdha">
    459 <term><filename class='libraryfile'>libdha.so</filename></term>
    460 <listitem><para>contains functions used by the
    461 <application>MPlayer</application> programs.</para>
    462 <indexterm zone="mplayer libdha">
    463 <primary sortas="c-libdha">libdha.so</primary></indexterm>
    464 </listitem>
    465 </varlistentry>
    466 
    467 <varlistentry id="libpostproc">
    468 <term><filename class='libraryfile'>libpostproc.so</filename></term>
    469 <listitem><para>is a post-processing filter library used by the
    470 <application>MPlayer</application> programs and other packages.</para>
    471 <indexterm zone="mplayer libpostproc">
    472 <primary sortas="c-libpostproc">libpostproc.so</primary></indexterm>
    473 </listitem>
    474 </varlistentry>
    475 </variablelist>
    476 
    477 </sect2>
     505mencoder -forceidx &lt;name.avi&gt;</userinput></screen>
     506          <indexterm zone="mplayer mencoder">
     507            <primary sortas="b-mencoder">mencoder</primary>
     508          </indexterm>
     509        </listitem>
     510      </varlistentry>
     511
     512      <varlistentry id="libdha">
     513        <term><filename class='libraryfile'>libdha.so</filename></term>
     514        <listitem>
     515          <para>contains functions used by the
     516          <application>MPlayer</application> programs.</para>
     517          <indexterm zone="mplayer libdha">
     518            <primary sortas="c-libdha">libdha.so</primary>
     519          </indexterm>
     520        </listitem>
     521      </varlistentry>
     522
     523      <varlistentry id="libpostproc">
     524        <term><filename class='libraryfile'>libpostproc.so</filename></term>
     525        <listitem>
     526          <para>is a post-processing filter library used by the
     527          <application>MPlayer</application> programs and other packages.</para>
     528          <indexterm zone="mplayer libpostproc">
     529            <primary sortas="c-libpostproc">libpostproc.so</primary>
     530          </indexterm>
     531        </listitem>
     532      </varlistentry>
     533
     534    </variablelist>
     535
     536  </sect2>
    478537
    479538</sect1>
Note: See TracChangeset for help on using the changeset viewer.