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