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

Whitespace change only. Wrap paragraphs.

Browse source
This commit is contained in:
Murray Stokely 2001-12-10 06:36:10 +00:00
parent e47e0dcb9c
commit 939519687c
Notes: svn2git 2020-12-08 03:00:23 +00:00 
svn path=/head/; revision=11385
2 changed files with 128 additions and 106 deletions
Show stats Download patch file Download diff file Expand all files Collapse all files

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

@ -57,10 +57,10 @@
<indexterm><primary>sound cards</primary></indexterm> <indexterm><primary>sound cards</primary></indexterm>
<para>Before you begin, you should know the model of the card you <para>Before you begin, you should know the model of the card you
have, the chip it uses, and whether it is a PCI or ISA card. have, the chip it uses, and whether it is a PCI or ISA card.
FreeBSD supports a wide variety of both PCI and ISA cards. If you FreeBSD supports a wide variety of both PCI and ISA cards. If
do not see your card in the following list, check the &man.pcm.4; you do not see your card in the following list, check the
manual page. This is not a complete list; however, it does list &man.pcm.4; manual page. This is not a complete list; however,
some of the most common cards.</para> it does list some of the most common cards.</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -166,8 +166,8 @@ device sbc0 at isa? port 0x220 irq 5 drq 1 flags 0x15</programlisting>
<programlisting>device pcm <programlisting>device pcm
device gusc</programlisting> device gusc</programlisting>
<para>to your kernel configuration file. If you have a non-PnP ISA card, you will <para>to your kernel configuration file. If you have a non-PnP
need to add:</para> ISA card, you will need to add:</para>
<programlisting>device pcm <programlisting>device pcm
device gus0 at isa? port 0x220 irq 5 drq 1 flags 0x13</programlisting> device gus0 at isa? port 0x220 irq 5 drq 1 flags 0x13</programlisting>
@ -195,9 +195,9 @@ device csa</programlisting>
<programlisting>device pcm</programlisting> <programlisting>device pcm</programlisting>
<para>to your kernel configuration file. If you have a non-PnP ISA <para>to your kernel configuration file. If you have a non-PnP
sound card that does not have a bridge driver, you will need ISA sound card that does not have a bridge driver, you will
to add:</para> need to add:</para>
<programlisting>device pcm0 at isa? irq 10 drq 1 flags 0x0</programlisting> <programlisting>device pcm0 at isa? irq 10 drq 1 flags 0x0</programlisting>
@ -221,20 +221,22 @@ device csa</programlisting>
<title>Creating and Testing the Device Nodes</title> <title>Creating and Testing the Device Nodes</title>
<indexterm><primary>device nodes</primary></indexterm> <indexterm><primary>device nodes</primary></indexterm>
<para>After you reboot, log in and run <command>dmesg | grep pcm</command> as shown <para>After you reboot, log in and run <command>dmesg | grep
below:</para> pcm</command> as shown below:</para>
<screen>&prompt.root; dmesg | grep pcm <screen>&prompt.root; dmesg | grep pcm
pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen> pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen>
<para>The output from your system may look different. If no <para>The output from your system may look different. If no
<devicename>pcm</devicename> devices show up, something went wrong <devicename>pcm</devicename> devices show up, something went
earlier. If that happens, go through your kernel configuration wrong earlier. If that happens, go through your kernel
file again and make sure you chose the correct device. Consult configuration file again and make sure you chose the correct
the troubleshooting section for additional options.</para> device. Consult the troubleshooting section for additional
options.</para>
<para>If the previous command returned <devicename>pcm0</devicename>, <para>If the previous command returned
you will have to run the following as root:</para> <devicename>pcm0</devicename>, you will have to run the
following as root:</para>
<screen>&prompt.root; cd /dev <screen>&prompt.root; cd /dev
&prompt.root; sh MAKEDEV snd0</screen> &prompt.root; sh MAKEDEV snd0</screen>
@ -327,7 +329,7 @@ pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen>
<row> <row>
<entry><errorname>unsupported subdevice XX</errorname></entry> <entry><errorname>unsupported subdevice XX</errorname></entry>
<entry><para>One or more of the device nodes was not created <entry><para>One or more of the device nodes was not created
correctly. Repeat the steps above.</para></entry> correctly. Repeat the steps above.</para></entry>
</row> </row>
<indexterm><primary>I/O port</primary></indexterm> <indexterm><primary>I/O port</primary></indexterm>
@ -388,15 +390,17 @@ pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen>
<para><application>XMMS</application> can be installed from the <para><application>XMMS</application> can be installed from the
<port>audio/xmms</port> port or package.</para> <port>audio/xmms</port> port or package.</para>
<para><application>XMMS'</application> interface is intuitive, with <para><application>XMMS'</application> interface is intuitive,
a playlist, graphic equalizer, and more. Those familiar with WinAmp with a playlist, graphic equalizer, and more. Those familiar
will find <application>XMMS</application> simple to use.</para> with <application>WinAmp</application> will find
<application>XMMS</application> simple to use.</para>
<para>The <port>audio/mpg123</port> port is an alternative, <para>The <port>audio/mpg123</port> port is an alternative,
command-line MP3 player.</para> command-line MP3 player.</para>
<para><application>mpg123</application> can be run by specifying the <para><application>mpg123</application> can be run by specifying
sound device and the MP3 file on the command line, as shown below:</para> the sound device and the MP3 file on the command line, as
shown below:</para>
<screen>&prompt.root; mpg123 -a <replaceable>/dev/dsp1.0</replaceable> Foobar-GreatestHits.mp3 <screen>&prompt.root; mpg123 -a <replaceable>/dev/dsp1.0</replaceable> Foobar-GreatestHits.mp3
High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2 and 3. High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2 and 3.
@ -425,28 +429,30 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
copying the raw CDDA (CD Digital Audio) data to WAV copying the raw CDDA (CD Digital Audio) data to WAV
files.</para> files.</para>
<para>The <command>cdda2wav</command> tool, which is a part of the <para>The <command>cdda2wav</command> tool, which is a part of
<port>sysutils/cdrtools</port> suite, is used for ripping audio the <port>sysutils/cdrtools</port> suite, is used for ripping
information of CDs and the information associated with it.</para> audio information of CDs and the information associated with
it.</para>
<para>With the audio CD in the drive, the following command <para>With the audio CD in the drive, the following command can
can be issued (as <username>root</username>) to rip an entire be issued (as <username>root</username>) to rip an entire CD
CD into individual (per track) WAV files:</para> into individual (per track) WAV files:</para>
<screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -B</screen> <screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -B</screen>
<para>The <option>-D <replaceable>0,1,0</replaceable></option> <para>The <option>-D <replaceable>0,1,0</replaceable></option>
indicates the SCSI device <devicename>0,1,0</devicename>, which indicates the SCSI device <devicename>0,1,0</devicename>,
corresponds to the output of <command>cdrecord which corresponds to the output of <command>cdrecord
-scanbus</command>.</para> -scanbus</command>.</para>
<para>To rip individual tracks, make use of the <para>To rip individual tracks, make use of the
<option>-t</option> option as shown:</para> <option>-t</option> option as shown:</para>
<screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -t 7</screen> <screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -t 7</screen>
<para>This example rips track seven of the audio CDROM. To rip a range <para>This example rips track seven of the audio CDROM. To rip
of tracks, for example, track one to seven, specify a range:</para> a range of tracks, for example, track one to seven, specify a
range:</para>
<screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -t 1+7</screen> <screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -t 1+7</screen>
@ -480,21 +486,23 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
<para>128 kbits seems to be the standard MP3 bitrate in use. <para>128 kbits seems to be the standard MP3 bitrate in use.
Many enjoy the higher quality 160, or 192. The higher the Many enjoy the higher quality 160, or 192. The higher the
bitrate, the more disk space the resulting MP3 will consume--but bitrate, the more disk space the resulting MP3 will
the quality will be higher. The <option>-h</option> option consume--but the quality will be higher. The
turns on the <quote>higher quality but a little slower</quote> <option>-h</option> option turns on the <quote>higher quality
mode. The options beginning with <option>--t</option> indicate but a little slower</quote> mode. The options beginning with
ID3 tags, which usually contain song information, to be embedded <option>--t</option> indicate ID3 tags, which usually contain
within the MP3 file. Additional encoding options can be found song information, to be embedded within the MP3 file.
by consulting the lame man page.</para> Additional encoding options can be found by consulting the
lame man page.</para>
</sect2> </sect2>
<sect2 id="mp3-decoding"> <sect2 id="mp3-decoding">
<title>Decoding MP3s</title> <title>Decoding MP3s</title>
<para>In order to burn an audio CD from MP3s, they must be converted <para>In order to burn an audio CD from MP3s, they must be
to a non-compressed WAV format. Both <application>XMMS</application> converted to a non-compressed WAV format. Both
and <application>mpg123</application> support the output of MP3 to <application>XMMS</application> and
<application>mpg123</application> support the output of MP3 to
an uncompressed file format.</para> an uncompressed file format.</para>
<para>Writing to Disk in <application>XMMS</application>:</para> <para>Writing to Disk in <application>XMMS</application>:</para>
@ -535,14 +543,15 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
</step> </step>
<step> <step>
<para>Press <literal>Play</literal> &mdash; <application>XMMS</application> <para>Press <literal>Play</literal> &mdash;
will appear as if it is playing the MP3, but no music will be heard. It <application>XMMS</application> will appear as if it is
is actually playing the MP3 to a file.</para> playing the MP3, but no music will be heard. It is
actually playing the MP3 to a file.</para>
</step> </step>
<step> <step>
<para>Be sure to set the default Output Plugin back to what it was before <para>Be sure to set the default Output Plugin back to what
in order to listen to MP3s again.</para> it was before in order to listen to MP3s again.</para>
</step> </step>
</procedure> </procedure>
@ -555,10 +564,12 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
</step> </step>
</procedure> </procedure>
<para><application>XMMS</application> writes a file in the WAV format, while <para><application>XMMS</application> writes a file in the WAV
<application>mpg123</application> converts the MP3 into raw PCM audio data. format, while <application>mpg123</application> converts the
Both of these formats can be used with <application>cdrecord</application> MP3 into raw PCM audio data. Both of these formats can be
or <application>burncd</application> to create audio CDROMs.</para> used with <application>cdrecord</application> or
<application>burncd</application> to create audio
CDROMs.</para>
<para>Read <xref linkend="creating-cds"> for more information on using a <para>Read <xref linkend="creating-cds"> for more information on using a
CD burner in FreeBSD.</para> CD burner in FreeBSD.</para>

117
en_US.ISO8859-1/books/handbook/sound/chapter.sgml
View file

@ -57,10 +57,10 @@
<indexterm><primary>sound cards</primary></indexterm> <indexterm><primary>sound cards</primary></indexterm>
<para>Before you begin, you should know the model of the card you <para>Before you begin, you should know the model of the card you
have, the chip it uses, and whether it is a PCI or ISA card. have, the chip it uses, and whether it is a PCI or ISA card.
FreeBSD supports a wide variety of both PCI and ISA cards. If you FreeBSD supports a wide variety of both PCI and ISA cards. If
do not see your card in the following list, check the &man.pcm.4; you do not see your card in the following list, check the
manual page. This is not a complete list; however, it does list &man.pcm.4; manual page. This is not a complete list; however,
some of the most common cards.</para> it does list some of the most common cards.</para>
<itemizedlist> <itemizedlist>
<listitem> <listitem>
@ -166,8 +166,8 @@ device sbc0 at isa? port 0x220 irq 5 drq 1 flags 0x15</programlisting>
<programlisting>device pcm <programlisting>device pcm
device gusc</programlisting> device gusc</programlisting>
<para>to your kernel configuration file. If you have a non-PnP ISA card, you will <para>to your kernel configuration file. If you have a non-PnP
need to add:</para> ISA card, you will need to add:</para>
<programlisting>device pcm <programlisting>device pcm
device gus0 at isa? port 0x220 irq 5 drq 1 flags 0x13</programlisting> device gus0 at isa? port 0x220 irq 5 drq 1 flags 0x13</programlisting>
@ -195,9 +195,9 @@ device csa</programlisting>
<programlisting>device pcm</programlisting> <programlisting>device pcm</programlisting>
<para>to your kernel configuration file. If you have a non-PnP ISA <para>to your kernel configuration file. If you have a non-PnP
sound card that does not have a bridge driver, you will need ISA sound card that does not have a bridge driver, you will
to add:</para> need to add:</para>
<programlisting>device pcm0 at isa? irq 10 drq 1 flags 0x0</programlisting> <programlisting>device pcm0 at isa? irq 10 drq 1 flags 0x0</programlisting>
@ -221,20 +221,22 @@ device csa</programlisting>
<title>Creating and Testing the Device Nodes</title> <title>Creating and Testing the Device Nodes</title>
<indexterm><primary>device nodes</primary></indexterm> <indexterm><primary>device nodes</primary></indexterm>
<para>After you reboot, log in and run <command>dmesg | grep pcm</command> as shown <para>After you reboot, log in and run <command>dmesg | grep
below:</para> pcm</command> as shown below:</para>
<screen>&prompt.root; dmesg | grep pcm <screen>&prompt.root; dmesg | grep pcm
pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen> pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen>
<para>The output from your system may look different. If no <para>The output from your system may look different. If no
<devicename>pcm</devicename> devices show up, something went wrong <devicename>pcm</devicename> devices show up, something went
earlier. If that happens, go through your kernel configuration wrong earlier. If that happens, go through your kernel
file again and make sure you chose the correct device. Consult configuration file again and make sure you chose the correct
the troubleshooting section for additional options.</para> device. Consult the troubleshooting section for additional
options.</para>
<para>If the previous command returned <devicename>pcm0</devicename>, <para>If the previous command returned
you will have to run the following as root:</para> <devicename>pcm0</devicename>, you will have to run the
following as root:</para>
<screen>&prompt.root; cd /dev <screen>&prompt.root; cd /dev
&prompt.root; sh MAKEDEV snd0</screen> &prompt.root; sh MAKEDEV snd0</screen>
@ -327,7 +329,7 @@ pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen>
<row> <row>
<entry><errorname>unsupported subdevice XX</errorname></entry> <entry><errorname>unsupported subdevice XX</errorname></entry>
<entry><para>One or more of the device nodes was not created <entry><para>One or more of the device nodes was not created
correctly. Repeat the steps above.</para></entry> correctly. Repeat the steps above.</para></entry>
</row> </row>
<indexterm><primary>I/O port</primary></indexterm> <indexterm><primary>I/O port</primary></indexterm>
@ -388,15 +390,17 @@ pcm0: &lt;SB16 DSP 4.11&gt; on sbc0</screen>
<para><application>XMMS</application> can be installed from the <para><application>XMMS</application> can be installed from the
<port>audio/xmms</port> port or package.</para> <port>audio/xmms</port> port or package.</para>
<para><application>XMMS'</application> interface is intuitive, with <para><application>XMMS'</application> interface is intuitive,
a playlist, graphic equalizer, and more. Those familiar with WinAmp with a playlist, graphic equalizer, and more. Those familiar
will find <application>XMMS</application> simple to use.</para> with <application>WinAmp</application> will find
<application>XMMS</application> simple to use.</para>
<para>The <port>audio/mpg123</port> port is an alternative, <para>The <port>audio/mpg123</port> port is an alternative,
command-line MP3 player.</para> command-line MP3 player.</para>
<para><application>mpg123</application> can be run by specifying the <para><application>mpg123</application> can be run by specifying
sound device and the MP3 file on the command line, as shown below:</para> the sound device and the MP3 file on the command line, as
shown below:</para>
<screen>&prompt.root; mpg123 -a <replaceable>/dev/dsp1.0</replaceable> Foobar-GreatestHits.mp3 <screen>&prompt.root; mpg123 -a <replaceable>/dev/dsp1.0</replaceable> Foobar-GreatestHits.mp3
High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2 and 3. High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2 and 3.
@ -425,28 +429,30 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
copying the raw CDDA (CD Digital Audio) data to WAV copying the raw CDDA (CD Digital Audio) data to WAV
files.</para> files.</para>
<para>The <command>cdda2wav</command> tool, which is a part of the <para>The <command>cdda2wav</command> tool, which is a part of
<port>sysutils/cdrtools</port> suite, is used for ripping audio the <port>sysutils/cdrtools</port> suite, is used for ripping
information of CDs and the information associated with it.</para> audio information of CDs and the information associated with
it.</para>
<para>With the audio CD in the drive, the following command <para>With the audio CD in the drive, the following command can
can be issued (as <username>root</username>) to rip an entire be issued (as <username>root</username>) to rip an entire CD
CD into individual (per track) WAV files:</para> into individual (per track) WAV files:</para>
<screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -B</screen> <screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -B</screen>
<para>The <option>-D <replaceable>0,1,0</replaceable></option> <para>The <option>-D <replaceable>0,1,0</replaceable></option>
indicates the SCSI device <devicename>0,1,0</devicename>, which indicates the SCSI device <devicename>0,1,0</devicename>,
corresponds to the output of <command>cdrecord which corresponds to the output of <command>cdrecord
-scanbus</command>.</para> -scanbus</command>.</para>
<para>To rip individual tracks, make use of the <para>To rip individual tracks, make use of the
<option>-t</option> option as shown:</para> <option>-t</option> option as shown:</para>
<screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -t 7</screen> <screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -t 7</screen>
<para>This example rips track seven of the audio CDROM. To rip a range <para>This example rips track seven of the audio CDROM. To rip
of tracks, for example, track one to seven, specify a range:</para> a range of tracks, for example, track one to seven, specify a
range:</para>
<screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -t 1+7</screen> <screen>&prompt.root; cdda2wav -D <replaceable>0,1,0</replaceable> -t 1+7</screen>
@ -480,21 +486,23 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
<para>128 kbits seems to be the standard MP3 bitrate in use. <para>128 kbits seems to be the standard MP3 bitrate in use.
Many enjoy the higher quality 160, or 192. The higher the Many enjoy the higher quality 160, or 192. The higher the
bitrate, the more disk space the resulting MP3 will consume--but bitrate, the more disk space the resulting MP3 will
the quality will be higher. The <option>-h</option> option consume--but the quality will be higher. The
turns on the <quote>higher quality but a little slower</quote> <option>-h</option> option turns on the <quote>higher quality
mode. The options beginning with <option>--t</option> indicate but a little slower</quote> mode. The options beginning with
ID3 tags, which usually contain song information, to be embedded <option>--t</option> indicate ID3 tags, which usually contain
within the MP3 file. Additional encoding options can be found song information, to be embedded within the MP3 file.
by consulting the lame man page.</para> Additional encoding options can be found by consulting the
lame man page.</para>
</sect2> </sect2>
<sect2 id="mp3-decoding"> <sect2 id="mp3-decoding">
<title>Decoding MP3s</title> <title>Decoding MP3s</title>
<para>In order to burn an audio CD from MP3s, they must be converted <para>In order to burn an audio CD from MP3s, they must be
to a non-compressed WAV format. Both <application>XMMS</application> converted to a non-compressed WAV format. Both
and <application>mpg123</application> support the output of MP3 to <application>XMMS</application> and
<application>mpg123</application> support the output of MP3 to
an uncompressed file format.</para> an uncompressed file format.</para>
<para>Writing to Disk in <application>XMMS</application>:</para> <para>Writing to Disk in <application>XMMS</application>:</para>
@ -535,14 +543,15 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
</step> </step>
<step> <step>
<para>Press <literal>Play</literal> &mdash; <application>XMMS</application> <para>Press <literal>Play</literal> &mdash;
will appear as if it is playing the MP3, but no music will be heard. It <application>XMMS</application> will appear as if it is
is actually playing the MP3 to a file.</para> playing the MP3, but no music will be heard. It is
actually playing the MP3 to a file.</para>
</step> </step>
<step> <step>
<para>Be sure to set the default Output Plugin back to what it was before <para>Be sure to set the default Output Plugin back to what
in order to listen to MP3s again.</para> it was before in order to listen to MP3s again.</para>
</step> </step>
</procedure> </procedure>
@ -555,10 +564,12 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo
</step> </step>
</procedure> </procedure>
<para><application>XMMS</application> writes a file in the WAV format, while <para><application>XMMS</application> writes a file in the WAV
<application>mpg123</application> converts the MP3 into raw PCM audio data. format, while <application>mpg123</application> converts the
Both of these formats can be used with <application>cdrecord</application> MP3 into raw PCM audio data. Both of these formats can be
or <application>burncd</application> to create audio CDROMs.</para> used with <application>cdrecord</application> or
<application>burncd</application> to create audio
CDROMs.</para>
<para>Read <xref linkend="creating-cds"> for more information on using a <para>Read <xref linkend="creating-cds"> for more information on using a
CD burner in FreeBSD.</para> CD burner in FreeBSD.</para>