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

- Use replaceable elements appropriately [1]

Browse source 
- Enclose lame into application element [2]

PR:		docs/123132 [1], docs/123135 [2]
Submitted by:	pgj
This commit is contained in:
Gabor Kovesdan 2008-04-27 12:10:52 +00:00
parent 6ea22d1579
commit 6eb9277a95
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=31919
1 changed files with 22 additions and 22 deletions
Download patch file Download diff file Expand all files Collapse all files

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

@ -293,7 +293,7 @@ kld snd_ich (1p/2r/0v channels duplex default)</screen>
<screen>&prompt.user; <userinput>cat <replaceable>filename</replaceable> &gt; /dev/dsp</userinput></screen> <screen>&prompt.user; <userinput>cat <replaceable>filename</replaceable> &gt; /dev/dsp</userinput></screen>
<para>where <replaceable>filename</replaceable> can be any file. <para>where <filename><replaceable>filename</replaceable></filename> can be any file.
This command line should produce some noise, confirming the This command line should produce some noise, confirming the
sound card is actually working.</para> sound card is actually working.</para>
@ -494,7 +494,7 @@ Playing MPEG stream from Foobar-GreatestHits.mp3 ...
MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
</screen> </screen>
<para><literal>/dev/dsp1.0</literal> should be replaced with the <para><devicename><replaceable>/dev/dsp1.0</replaceable></devicename> should be replaced with the
<devicename>dsp</devicename> device entry on your system.</para> <devicename>dsp</devicename> device entry on your system.</para>
</sect2> </sect2>
@ -556,8 +556,8 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
<filename role="package">audio/lame</filename> in the ports tree.</para> <filename role="package">audio/lame</filename> in the ports tree.</para>
<para>Using the ripped WAV files, the following command will <para>Using the ripped WAV files, the following command will
convert <filename>audio01.wav</filename> to convert <filename><replaceable>audio01.wav</replaceable></filename> to
<filename>audio01.mp3</filename>:</para> <filename><replaceable>audio01.mp3</replaceable></filename>:</para>
<screen>&prompt.root; <userinput>lame -h -b <replaceable>128</replaceable> \ <screen>&prompt.root; <userinput>lame -h -b <replaceable>128</replaceable> \
--tt "<replaceable>Foo Song Title</replaceable>" \ --tt "<replaceable>Foo Song Title</replaceable>" \
@ -577,7 +577,7 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
<option>--t</option> indicate ID3 tags, which usually contain <option>--t</option> indicate ID3 tags, which usually contain
song information, to be embedded within the MP3 file. song information, to be embedded within the MP3 file.
Additional encoding options can be found by consulting the Additional encoding options can be found by consulting the
lame man page.</para> <application>lame</application> man page.</para>
</sect2> </sect2>
<sect2 id="mp3-decoding"> <sect2 id="mp3-decoding">
@ -644,7 +644,7 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
<procedure> <procedure>
<step> <step>
<para>Run <command>mpg123 -s <replaceable>audio01.mp3</replaceable> <para>Run <command>mpg123 -s <replaceable>audio01.mp3</replaceable>
&gt; audio01.pcm</command></para> &gt; <replaceable>audio01.pcm</replaceable></command></para>
</step> </step>
</procedure> </procedure>
@ -1069,18 +1069,18 @@ http://www.mplayerhq.hu/homepage/dload.html
through one of the various video interfaces set the through one of the various video interfaces set the
<option>-vo</option> option:</para> <option>-vo</option> option:</para>
<screen>&prompt.user; <userinput>mplayer -vo xv testfile.avi</userinput></screen> <screen>&prompt.user; <userinput>mplayer -vo xv <replaceable>testfile.avi</replaceable></userinput></screen>
<screen>&prompt.user; <userinput>mplayer -vo sdl testfile.avi</userinput></screen> <screen>&prompt.user; <userinput>mplayer -vo sdl <replaceable>testfile.avi</replaceable></userinput></screen>
<screen>&prompt.user; <userinput>mplayer -vo x11 testfile.avi</userinput></screen> <screen>&prompt.user; <userinput>mplayer -vo x11 <replaceable>testfile.avi</replaceable></userinput></screen>
<screen>&prompt.root; <userinput>mplayer -vo dga testfile.avi</userinput></screen> <screen>&prompt.root; <userinput>mplayer -vo dga <replaceable>testfile.avi</replaceable></userinput></screen>
<screen>&prompt.root; <userinput>mplayer -vo 'sdl:dga' testfile.avi</userinput></screen> <screen>&prompt.root; <userinput>mplayer -vo 'sdl:dga' <replaceable>testfile.avi</replaceable></userinput></screen>
<para>It is worth trying all of these options, as their relative <para>It is worth trying all of these options, as their relative
performance depends on many factors and will vary significantly performance depends on many factors and will vary significantly
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> -dvd-device <filename><replaceable>testfile.avi</replaceable></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
@ -1141,7 +1141,7 @@ zoom=yes</programlisting>
or bad performance. Here are a couple of examples to get or bad performance. Here are a couple of examples to get
you going. First a simple copy:</para> you going. First a simple copy:</para>
<screen>&prompt.user; <userinput>mencoder input.avi -oac copy -ovc copy -o output.avi</userinput></screen> <screen>&prompt.user; <userinput>mencoder <replaceable>input.avi</replaceable> -oac copy -ovc copy -o <replaceable>output.avi</replaceable></userinput></screen>
<para>Improper combinations of command line options can yield <para>Improper combinations of command line options can yield
output files that are output files that are
@ -1149,16 +1149,16 @@ zoom=yes</programlisting>
just want to rip to a file, stick to the <option>-dumpfile</option> just want to rip to a file, stick to the <option>-dumpfile</option>
in <command>mplayer</command>.</para> in <command>mplayer</command>.</para>
<para>To convert <filename>input.avi</filename> to the MPEG4 <para>To convert <filename><replaceable>input.avi</replaceable></filename> to the MPEG4
codec with MPEG3 audio encoding (<filename role="package">audio/lame</filename> is required):</para> codec with MPEG3 audio encoding (<filename role="package">audio/lame</filename> is required):</para>
<screen>&prompt.user; <userinput>mencoder input.avi -oac mp3lame -lameopts br=192 \ <screen>&prompt.user; <userinput>mencoder <replaceable>input.avi</replaceable> -oac mp3lame -lameopts br=192 \
-ovc lavc -lavcopts vcodec=mpeg4:vhq -o output.avi</userinput></screen> -ovc lavc -lavcopts vcodec=mpeg4:vhq -o <replaceable>output.avi</replaceable></userinput></screen>
<para>This has produced output playable by <command>mplayer</command> <para>This has produced output playable by <command>mplayer</command>
and <command>xine</command>.</para> and <command>xine</command>.</para>
<para><filename>input.avi</filename> can be replaced with <para><filename><replaceable>input.avi</replaceable></filename> can be replaced with
<option>dvd://1 -dvd-device /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
@ -1202,7 +1202,7 @@ zoom=yes</programlisting>
<para>Alternatively, it may be invoked to play a file immediately <para>Alternatively, it may be invoked to play a file immediately
without the GUI with the command:</para> without the GUI with the command:</para>
<screen>&prompt.user; <userinput>xine -g -p mymovie.avi</userinput></screen> <screen>&prompt.user; <userinput>xine -g -p <replaceable>mymovie.avi</replaceable></userinput></screen>
</sect3> </sect3>
@ -1230,11 +1230,11 @@ WITH_MJPEG=yes -DWITH_XVID=yes</userinput></screen>
example to show how to convert a DivX file into a PAL MPEG-1 example to show how to convert a DivX file into a PAL MPEG-1
file (PAL VCD):</para> file (PAL VCD):</para>
<screen>&prompt.user; <userinput>transcode -i input.avi -V --export_prof vcd-pal -o output_vcd</userinput> <screen>&prompt.user; <userinput>transcode -i <replaceable>input.avi</replaceable> -V --export_prof vcd-pal -o output_vcd</userinput>
&prompt.user; <userinput>mplex -f 1 -o output_vcd.mpg output_vcd.m1v output_vcd.mpa</userinput></screen> &prompt.user; <userinput>mplex -f 1 -o <replaceable>output_vcd.mpg output_vcd.m1v output_vcd.mpa</replaceable></userinput></screen>
<para>The resulting MPEG file, <para>The resulting MPEG file,
<filename>output_vcd.mpg</filename>, is ready to be played with <filename><replaceable>output_vcd.mpg</replaceable></filename>, is ready to be played with
<application>MPlayer</application>. You could even burn the <application>MPlayer</application>. You could even burn the
file on a CD-R media to create a Video CD, in this case you will file on a CD-R media to create a Video CD, in this case you will
need to install and use both <filename need to install and use both <filename
@ -1728,7 +1728,7 @@ device `epson:/dev/uscanner0' is a Epson GT-8200 flatbed scanner</screen>
example, our USB scanner uses the device node example, our USB scanner uses the device node
<filename>/dev/uscanner0</filename> which is owned by the <filename>/dev/uscanner0</filename> which is owned by the
<groupname>operator</groupname> group. Adding the user <groupname>operator</groupname> group. Adding the user
<username>joe</username> to the <username><replaceable>joe</replaceable></username> to the
<groupname>operator</groupname> group will allow him to use <groupname>operator</groupname> group will allow him to use
the scanner:</para> the scanner:</para>