os/doc
3
0
Fork 0
Code Issues Pull requests Projects Releases Wiki Activity

Update MPlayer section to match current version available in our ports

Browse source 
tree.
This commit is contained in:
Marc Fonvieille 2004-09-17 18:07:12 +00:00
parent a9bf11e7be
commit 2c0ae18ae2
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=22386
1 changed files with 36 additions and 32 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

68
en_US.ISO8859-1/books/handbook/multimedia/chapter.sgml
View file

@ -1065,38 +1065,35 @@ no adaptors present</screen>
another. Therefore, it is important to build it from
ports and not to use a binary package. Additionally, a
number of options can be specified in the <command>make</command>
command line, as described at the start of the build.</para>
command line, as described in the <filename>Makefile</filename> and at the start of the build:</para>
<screen>&prompt.root; <userinput>cd /usr/ports/multimedia/mplayer</userinput>
&prompt.root; <userinput>make</userinput>
You can enable additional compilation optimizations
by defining WITH_OPTIMIZED_CFLAGS
You can enable GTK GUI by defining WITH_GUI.
You can enable DVD support by defining WITH_DVD.
You can enable SVGALIB support by defining WITH_SVGALIB.
You can enable VORBIS sound support by defining WITH_VORBIS.
You can enable XAnim DLL support by defining WITH_XANIM.
N - O - T - E
Take a careful look into the Makefile in order
to learn how to tune mplayer towards you personal preferences!
For example,
make WITH_GTK1
builds MPlayer with GTK1-GUI support.
If you want to use the GUI, you can either install
/usr/ports/multimedia/mplayer-skins
or download official skin collections from
http://www.mplayerhq.hu/homepage/dload.html
</screen>
<para>If you have <filename
role="package">x11-toolkits/gtk12</filename> installed, then
you might as well enable the GUI. Otherwise, it is not
worth the effort. If you intend to play (possibly CSS
encoded) DVD's with <application>MPlayer</application> you must enable the DVD support
option here <footnote><para>Unauthorized DVD playback is a
serious criminal act in some countries. Check local laws
before enabling this option.</para> </footnote>. Some
reasonable options are:</para>
<screen>&prompt.root; <userinput>make WITH_DVD=yes WITH_SVGALIB=yes</userinput></screen>
<para>The default port options should be sufficient for most
users. However, if you need the XviD codec, you have to
specify the <makevar>WITH_XVID</makevar> option in the
command line. The default DVD device can also be defined
with the <makevar>WITH_DVD_DEVICE</makevar> option, by
default <filename>/dev/acd0</filename> will be used.</para>
<para>As of this writing, the <application>MPlayer</application> port will build its HTML
documentation and one executable,
<command>mplayer</command>. It can also be made to build an
encoder, <command>mencoder</command>, which is a tool for
re-encoding video. A modification to the
<filename>Makefile</filename> can enable it. It may be
enabled by default in subsequent versions of the port.</para>
documentation and two executables,
<command>mplayer</command>, and
<command>mencoder</command>, which is a tool for
re-encoding video.</para>
<para>The HTML documentation for <application>MPlayer</application> is very informative.
If the reader finds the information on video hardware and
@ -1142,14 +1139,23 @@ You can enable XAnim DLL support by defining WITH_XANIM.
with hardware.</para>
<para>To play from a DVD, replace the
<filename>testfile.avi</filename> with <option>-dvd <replaceable>N</replaceable>
<filename>testfile.avi</filename> with <option>dvd://<replaceable>N</replaceable> -dvd-device
<replaceable>DEVICE</replaceable></option> where <replaceable>N</replaceable> is
the title number to play and
<filename><replaceable>DEVICE</replaceable></filename> is the
device node for the DVD-ROM. For example, to play title 3
from <filename>/dev/dvd</filename>:</para>
<screen>&prompt.root; <userinput>mplayer -vo dga -dvd 3 /dev/dvd</userinput></screen>
<screen>&prompt.root; <userinput>mplayer -vo xv dvd://3 -dvd-device /dev/dvd</userinput></screen>
<note>
<para>The default DVD device can be defined during the build
of the <application>MPlayer</application> port via the
<makevar>WITH_DVD_DEVICE</makevar> option. By default,
this device is <filename>/dev/acd0</filename>. More
details can be found in the port
<filename>Makefile</filename>.</para>
</note>
<para>To stop, pause, advance and so on, consult the
keybindings, which are output by running <command>mplayer
@ -1171,7 +1177,7 @@ zoom=yes</programlisting>
DVD title into a <filename>.vob</filename> file. To dump
out the second title from a DVD, type this:</para>
<screen>&prompt.root; <userinput>mplayer -dumpstream -dumpfile out.vob -dvd 2 /dev/dvd</userinput></screen>
<screen>&prompt.root; <userinput>mplayer -dumpstream -dumpfile out.vob dvd://2 -dvd-device /dev/dvd</userinput></screen>
<para>The output file, <filename>out.vob</filename>, will be
MPEG and can be manipulated by the other packages described
@ -1184,9 +1190,7 @@ zoom=yes</programlisting>
<primary>mencoder</primary>
</indexterm>
<para>If you opt to install <command>mencoder</command> when
you build <application>MPlayer</application>, be forewarned
that it is still an experimental component. Before using
<para>Before using
<command>mencoder</command> it is a good idea to
familiarize yourself with the options from the HTML
documentation. There is a manual page, but it is not very
@ -1214,7 +1218,7 @@ zoom=yes</programlisting>
and <command>xine</command>.</para>
<para><filename>input.avi</filename> can be replaced with
<option>-dvd 1 /dev/dvd</option> and run as
<option>dvd://1 -dvd-device /dev/dvd</option> and run as
<username>root</username> to re-encode a DVD title
directly. Since you are likely to be dissatisfied with
your results the first time around, it is recommended you