Ignore:
Timestamp:
06/14/2004 02:50:57 AM (20 years ago)
Author:
Bruce Dubbs <bdubbs@…>
Branches:
10.0, 10.1, 11.0, 11.1, 11.2, 11.3, 12.0, 12.1, 6.0, 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:
d8a5def6
Parents:
8d8631b5
Message:

XML update for Chapter 39

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

File:
1 edited

Legend:

Unmodified
Added
Removed

  • multimedia/videoutils/mplayer.xml

    r8d8631b5 r01062dd  
     1<!DOCTYPE sect1 PUBLIC "-//OASIS//DTD DocBook XML V4.3//EN"
     2   "http://www.oasis-open.org/docbook/xml/4.3/docbookx.dtd" [
     3  <!ENTITY % general-entities SYSTEM "../../general.ent">
     4  %general-entities;
     5 
     6  <!ENTITY mplayer-download-http "http://www1.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.bz2">
     7  <!ENTITY mplayer-download-ftp  "ftp://ftp1.mplayerhq.hu/MPlayer/releases/MPlayer-&mplayer-version;.tar.bz2">
     8  <!ENTITY mplayer-size          "4.7 MB">
     9  <!ENTITY mplayer-buildsize     "51 MB">
     10  <!ENTITY mplayer-time          "1.80 SBU">
     11]>
     12
    113<sect1 id="mplayer" xreflabel="MPlayer-&mplayer-version;">
    214<?dbhtml filename="mplayer.html"?>
    315<title>MPlayer-&mplayer-version;</title>
    416
    5 &mplayer-intro;
    6 &mplayer-inst;
    7 &mplayer-exp;
    8 &mplayer-config;
    9 &mplayer-desc;
     17<sect2>
     18<title>Introduction to <application>MPlayer</application></title>
     19
     20<para>The <application>MPlayer</application> package contains an audio/video player that is able to
     21play almost every audio and video <acronym>CODEC</acronym> and can be
     22controlled via the command
     23line or a <acronym>GUI</acronym>.</para>
     24
     25<sect3><title>Package information</title>
     26<itemizedlist spacing='compact'>
     27<listitem><para>Download (HTTP): <ulink url="&mplayer-download-http;"/></para></listitem>
     28<listitem><para>Download (FTP): <ulink url="&mplayer-download-ftp;"/></para></listitem>
     29<listitem><para>Download size: &mplayer-size;</para></listitem>
     30<listitem><para>Estimated Disk space required: &mplayer-buildsize;</para></listitem>
     31<listitem><para>Estimated build time: &mplayer-time;</para></listitem></itemizedlist>
     32</sect3>
     33
     34<sect3><title>Additional downloads</title>
     35<itemizedlist spacing='compact'>
     36<listitem><para>Proprietary <acronym>CODEC</acronym>s: <ulink
     37url="http://www1.mplayerhq.hu/MPlayer/releases/codecs/extralite.tar.bz2"/></para></listitem>
     38<listitem><para>Default <acronym>GUI</acronym> skin: <ulink
     39url="http://www1.mplayerhq.hu/MPlayer/Skin/default-1.8.tar.bz2"/></para></listitem>
     40<listitem><para>Prerendered fonts: <ulink
     41url="http://www1.mplayerhq.hu/MPlayer/releases/fonts/font-arial-iso-8859-1.tar.bz2"/></para>
     42</listitem>
     43</itemizedlist>
     44
     45<note><para>The additional downloads are not required to build and use MPlayer. You can
     46find many more <acronym>CODEC</acronym>s, skins and fonts at <ulink
     47url="http://www.mplayerhq.hu/">MPlayer's homepage</ulink>.</para></note>
     48
     49</sect3>
     50
     51<sect3><title><application>MPlayer</application> dependencies</title>
     52<sect4><title>Optional</title>
     53<para>
     54X (<xref linkend="xfree86"/> or <xref linkend="xorg"/>),
     55<xref linkend="libpng"/>,
     56<xref linkend="libjpeg"/>,
     57<xref linkend="GTK"/>,
     58<xref linkend="DirectFB"/>,
     59<xref linkend="SVGAlib"/>,
     60<xref linkend="freetype2"/>,
     61<xref linkend="fontconfig"/>,
     62<xref linkend="libungif"/>,
     63<xref linkend="libogg"/>
     64<xref linkend="libvorbis"/>,
     65<xref linkend="aalib"/>,
     66<xref linkend="SDL"/>,
     67<xref linkend="xvid"/>,
     68<xref linkend="arts"/>,
     69<xref linkend="alsa"/>,
     70<xref linkend="esound"/>,
     71<xref linkend="LZO"/>,
     72<xref linkend="libmad"/>,
     73<xref linkend="CDParanoia"/>,
     74<xref linkend="libdv"/>,
     75<xref linkend="libdvdread"/>,
     76<xref linkend="nas"/>,
     77<xref linkend="samba3"/>,
     78<xref linkend="lame"/>,
     79<xref linkend="xmms"/>,
     80<xref linkend="flac"/>,
     81<xref linkend="libfame"/>,
     82<ulink url="http://www.theora.org/">Theora</ulink>,
     83<ulink url="http://prdownloads.sourceforge.net/zapping/mp1e-1.9.3.tar.bz2">MP1E</ulink>,
     84<ulink url="http://faac.sourceforge.net/">FAAD2</ulink>,
     85<ulink url="http://www.ggi-project.org/">GGI</ulink>,
     86<ulink url="http://fribidi.sourceforge.net/">FriBidi</ulink>,
     87<ulink url="http://www.unrarlib.org/">unrarlib</ulink>,
     88<ulink url="http://www.lirc.org/">LIRC</ulink>,
     89<ulink url="http://www.dolda2000.cjb.net/~fredrik/lirccd/">lirccd</ulink> and
     90<ulink url="http://www.live.com/mplayer/">LIVE.COM Streaming Media</ulink>
     91</para></sect4>
     92</sect3>
     93
     94</sect2>
     95
     96<sect2>
     97<title>Installation of <application>MPlayer</application></title>
     98
     99<para>If you downloaded any proprietary <acronym>CODEC</acronym>s,
     100extract them at some system-wide location (like <filename
     101class="directory">/usr/lib/mplayer/codecs</filename>) and add
     102<parameter>--with-codecsdir=<replaceable>[location]</replaceable></parameter>
     103option to the configure script.</para>
     104
     105<note><para>The package maintainers recommend building without any
     106optimizations.</para></note>
     107
     108<para>Install <application>MPlayer</application> by running the following commands:</para>
     109
     110<screen><userinput><command>./configure --prefix=/usr --confdir=/etc/mplayer \
     111    --enable-largefiles --enable-shared-pp &amp;&amp;
     112make &amp;&amp;
     113make install &amp;&amp;
     114make -C libavcodec/libpostproc install</command></userinput></screen>
     115
     116<para>You will need <filename>codecs.conf</filename> only if you want to
     117change its properties, as the main binary contains an internal copy of
     118it:</para>
     119
     120<screen><userinput><command>cp etc/codecs.conf /etc/mplayer</command></userinput></screen>
     121
     122<para>The <acronym>GUI</acronym> version of
     123<application>MPlayer</application> requires a skin. Extract the default
     124one to the recommended location:</para>
     125
     126<screen><userinput><command>install -d /usr/share/mplayer/Skin &amp;&amp;
     127tar xjvf ../default-1.8.tar.bz2 -C /usr/share/mplayer/Skin</command></userinput></screen>
     128
     129<sect3>
     130<title>Installation for <acronym>DVD</acronym> playback</title>
     131
     132<para>If you want <acronym>DVD</acronym> playback with
     133<application>MPlayer</application>, you need to make a link
     134from your <acronym>DVD</acronym> drive to <filename>/dev/dvd</filename>:</para>
     135
     136<screen><userinput><command>ln -s /dev/<replaceable>[dvd drive]</replaceable> /dev/dvd</command></userinput></screen>
     137
     138<para>Replace <replaceable>[dvd drive]</replaceable> with whatever
     139device is appropriate, for example <filename>/dev/hdc</filename>. If
     140you don't know which device to choose, type:</para>
     141
     142<screen><userinput><command>dmesg | grep DVD</command></userinput></screen>
     143
     144<para>It should result in an output like:</para>
     145
     146<screen><userinput>hdc: Pioneer DVD-ROM ATAPIModel DVD-114 0110,
     147ATAPI CD/DVD-ROM drive</userinput></screen>
     148
     149<para>If you have SCSI-Emulation activated for the drives, you'll need
     150to get the right SCSI-device. Every CD/DVD-ROM drive is mapped in the
     151same order as in <acronym>IDE</acronym> devices to the devices named
     152<filename>/dev/scd0</filename>,
     153<filename>/dev/scd1</filename> and so on.</para>
     154
     155</sect3>
     156
     157</sect2>
     158
     159<sect2>
     160<title>Command explanations</title>
     161
     162<para><option>--enable-shared-pp</option>: This enables the
     163building of a shared <filename
     164class="libraryfile">libpostproc</filename> (library for post processing, featuring
     165filters like sharpen).</para>
     166
     167<para><option>--enable-gui</option>: This switch tells
     168<application>MPlayer</application> to compile the <acronym>GUI</acronym>
     169code (requires <xref linkend="GTK"/>).</para>
     170
     171<para><option>--enable-menu</option>:  This
     172switch enables the new menu support.  It's like an
     173<acronym>OSD</acronym>, but you can
     174also run a shell with it.</para>
     175
     176</sect2>
     177
     178<sect2>
     179<title>Configuring MPlayer</title>
     180
     181<sect3><title>Config files</title>
     182<para><filename>/etc/mplayer/*</filename>, <filename>~/.mplayer/*</filename></para>
     183</sect3>
     184
     185<sect3><title>Configuration Information</title>
     186
     187
     188<para>If you wish to utilize a <application>FreeType</application> font,
     189you need to link a <acronym>TTF</acronym>
     190file to your <filename class="directory">~/.mplayer</filename> directory.  For example:
     191<screen><userinput><command>ln -sf /usr/X11R6/lib/X11/fonts/TTF/luxisri.ttf ~/.mplayer/subfont.ttf
     192</command></userinput></screen>
     193otherwise
     194<screen><userinput><command>tar xjvf ../font-arial-iso-8859-1.tar.bz2 -C /usr/share/mplayer/font &amp;&amp;
     195cd /usr/share/mplayer/font &amp;&amp;
     196ln -sf font-arial-iso-8859-1/font-arial-<replaceable>[font size]</replaceable>-iso-8859-1/* .</command></userinput></screen>
     197You can chose your font size of 14, 18, 24 or 28.
     198</para>
     199
     200<para>Set the proper ownership for <acronym>CODEC</acronym>s, skins and fonts:</para>
     201
     202<screen><userinput><command>chown -R root:root <replaceable>[CODECs location]</replaceable> &amp;&amp;
     203chown -R root:root /usr/share/mplayer</command></userinput></screen>
     204
     205<para>Optionally, set up the <acronym>GUI</acronym> with the following commands:</para>
     206
     207<screen><userinput><command>cat &gt; /etc/mplayer/mplayer.conf &lt;&lt; "EOF"</command>
     208gui = yes
     209skin = default
     210<command>EOF</command></userinput></screen>
     211
     212<para>The first line, <userinput>gui = yes</userinput>, will make
     213MPlayer start in <acronym>GUI</acronym> mode automatically. If you want to decide whether to start
     214in <acronym>GUI</acronym> mode or not, leave that line out and start
     215<command>mplayer</command> with
     216<option>-gui</option> or as <command>gmplayer</command> (e.g.,
     217when starting from a Window Manager menu or command prompt). Note that
     218the main configuration file is called <filename>config</filename> if it
     219is placed in the <filename class="directory">~/.mplayer</filename> directory.</para>
     220
     221</sect3>
     222
     223</sect2>
     224
     225<sect2>
     226<title>Contents</title>
     227
     228<para>The <application>MPlayer</application> package contains <command>mplayer</command>,
     229<command>gmplayer</command> and <command>mencoder</command>.</para>
     230
     231</sect2>
     232
     233<sect2><title>Description</title>
     234
     235<sect3><title>mplayer</title>
     236<para><command>mplayer</command> manages the input formats, the
     237<acronym>CODEC</acronym>s and the output
     238formats to play video files, <acronym>DVD</acronym>s,
     239(S)<acronym>VCD</acronym>s or network streams containing
     240audio and/or video information on your system.</para>
     241<para>Examples:</para>
     242
     243<screen><command>mplayer -fs blfs.avi
     244mplayer -vo fbdev -fb /dev/fb0 dvd://1 -aid 128 -sub en -framedrop
     245mplayer -fs vcd://1    # works both for VCDs and SVCDs
     246mplayer http://www.students.uni-marburg.de/~Klossa/hapkidofight_lo.mpg</command></screen>
     247
     248<para>For further information, look at the very good
     249documentation included with the package in the source tree subdirectory <filename
     250class="directory">DOCS/</filename>.
     251</para></sect3>
     252
     253<sect3><title>gmplayer</title>
     254<para><command>gmplayer</command> is <application>MPlayer</application> with a graphical user interface.</para></sect3>
     255
     256<sect3><title>mencoder</title>
     257<para><command>mencoder</command> is used to encode any
     258<application>MPlayer</application> playable movie to DivX4,
     259<application>XviD</application> or any <acronym>CODEC</acronym> in libavcodec with
     260<acronym>PCM</acronym>/MP3/VBRMP3 audio.</para>
     261
     262<para>Example:</para>
     263
     264<screen><userinput><command>rm frameno.avi
     265mencoder -dvd 1 -aid 128 -ovc frameno -oac mp3lame \
     266-lameopts vbr=3 -o frameno.avi</command>
     267
     268# mencoder should output bitrates for average encodings
     269# now, choose one you like best! In the following lines,
     270# replace &lt;bitrate&gt; and &lt;name.avi&gt; with statements of your
     271# personal liking.
     272
     273<command>mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
     274-lavcopts vcodec=mpeg4:vpass=1:vhq:vbitrate=&lt;bitrate&gt; -o &lt;name.avi&gt;
     275mencoder -dvd 1 -aid 128 -oac copy -ovc lavc \
     276-lavcopts vcodec=mpeg4:vpass=2:vhq:vbitrate=&lt;bitrate&gt; -o &lt;name.avi&gt;
     277mencoder -forceidx &lt;name.avi&gt;</command></userinput></screen>
     278</sect3>
     279
     280</sect2>
    10281
    11282</sect1>
Note: See TracChangeset for help on using the changeset viewer.