Date: Mon, 21 Apr 2014 17:17:07 +0000 (UTC) From: Dru Lavigne <dru@FreeBSD.org> To: doc-committers@freebsd.org, svn-doc-all@freebsd.org, svn-doc-head@freebsd.org Subject: svn commit: r44616 - head/en_US.ISO8859-1/books/handbook/multimedia Message-ID: <201404211717.s3LHH7f2036528@svn.freebsd.org>
next in thread | raw e-mail | index | archive | help
Author: dru Date: Mon Apr 21 17:17:07 2014 New Revision: 44616 URL: http://svnweb.freebsd.org/changeset/doc/44616 Log: Editorial review of MP3 chapter. Sponsored by: iXsystems Modified: head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml Modified: head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml ============================================================================== --- head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml Mon Apr 21 16:23:41 2014 (r44615) +++ head/en_US.ISO8859-1/books/handbook/multimedia/chapter.xml Mon Apr 21 17:17:07 2014 (r44616) @@ -66,7 +66,7 @@ </listitem> <listitem> - <para>Rip CD and <acronym>DVD</acronym> content into + <para>Rip <acronym>CD</acronym> and <acronym>DVD</acronym> content into files.</para> </listitem> @@ -251,13 +251,13 @@ pcm2: <Conexant CX20590 (Analog 2.0+H <para>If all goes well, the sound card should now work in os;. If the <acronym>CD</acronym> or <acronym>DVD</acronym> drive is properly connected to the sound card, one can insert an - audio CD in the drive and play it with + audio <acronym>CD</acronym> in the drive and play it with &man.cdcontrol.1;:</para> <screen>&prompt.user; <userinput>cdcontrol -f /dev/acd0 play 1</userinput></screen> <warning> - <para>Audio CDs have specialized encodings which means that + <para>Audio <acronym>CD</acronym>s have specialized encodings which means that they should not be mounted using &man.mount.8;.</para> </warning> @@ -486,7 +486,7 @@ pcm7: <HDA Realtek ALC889 PCM #3 Digi </info> <para>This section describes some <acronym>MP3</acronym> - players available for &os;, how to rip audio CD tracks, and + players available for &os;, how to rip audio <acronym>CD</acronym> tracks, and how to encode and decode <acronym>MP3</acronym>s.</para> <sect2 xml:id="mp3-players"> @@ -494,146 +494,132 @@ pcm7: <HDA Realtek ALC889 PCM #3 Digi <para>A popular graphical <acronym>MP3</acronym> player is <application>XMMS</application>. - <application>Winamp</application> - skins can be used with <application>XMMS</application> since - the interface is almost identical to that of Nullsoft's - <application>Winamp</application>. - <application>XMMS</application> also has native plug-in - support.</para> - - <para><application>XMMS</application> can be installed from - the <package>multimedia/xmms</package> port - or package.</para> - - <para><application>XMMS</application>'s interface is intuitive, + It supports <application>Winamp</application> + skins and additional plugins. The interface is intuitive, with a playlist, graphic equalizer, and more. Those familiar with <application>Winamp</application> will find - <application>XMMS</application> simple to use.</para> + <application>XMMS</application> simple to use. On &os;, + <application>XMMS</application> can be installed from + the <package>multimedia/xmms</package> port + or package.</para> - <para>The <package>audio/mpg123</package> port + <para>The <package>audio/mpg123</package> package or port provides an alternative, command-line <acronym>MP3</acronym> - player.</para> - - <para><application>mpg123</application> can be run by specifying - the sound device and the <acronym>MP3</acronym> file on the - command line. Assuming the audio device is - <filename>/dev/dsp1.0</filename> and the - <acronym>MP3</acronym> file is - <replaceable>Foobar-GreatestHits.mp3</replaceable>, enter the - following to play the file:</para> - - <screen>&prompt.root; <userinput>mpg123 -a /dev/dsp1.0 <replaceable>Foobar-GreatestHits.mp3</replaceable></userinput> -High Performance MPEG 1.0/2.0/2.5 Audio Player for Layer 1, 2 and 3. -Version 0.59r (1999/Jun/15). Written and copyrights by Michael Hipp. -Uses code from various people. See 'README' for more! -THIS SOFTWARE COMES WITH ABSOLUTELY NO WARRANTY! USE AT YOUR OWN RISK! - - - - + player. Once installed, specify + the <acronym>MP3</acronym> file to play on the + command line. If the system has multiple audio devices, the + sound device can also be specifed:</para> + + <screen>&prompt.root; <userinput>mpg123 <replaceable>-a /dev/dsp1.0 Foobar-GreatestHits.mp3</replaceable></userinput> +High Performance MPEG 1.0/2.0/2.5 Audio Player for Layers 1, 2 and 3 + version 1.18.1; written and copyright by Michael Hipp and others + free software (LGPL) without any warranty but with best wishes Playing MPEG stream from Foobar-GreatestHits.mp3 ... MPEG 1.0 layer III, 128 kbit/s, 44100 Hz joint-stereo</screen> + + <para>Additional <acronym>MP3</acronym> players are available in + the &os; Ports Collection.</para> </sect2> <sect2 xml:id="rip-cd"> - <title>Ripping CD Audio Tracks</title> + <title>Ripping <acronym>CD</acronym> Audio Tracks</title> - <para>Before encoding a CD or CD track to - <acronym>MP3</acronym>, the audio data on the CD must be - ripped to the hard drive. This is done by copying the raw CD + <para>Before encoding a <acronym>CD</acronym> or <acronym>CD</acronym> track to + <acronym>MP3</acronym>, the audio data on the <acronym>CD</acronym> must be + ripped to the hard drive. This is done by copying the raw <acronym>CD</acronym> Digital Audio (<acronym>CDDA</acronym>) data to <acronym>WAV</acronym> files.</para> <para>The <command>cdda2wav</command> tool, which is installed with the <package>sysutils/cdrtools</package> - suite, is used for ripping audio information from CDs and the - information associated with them.</para> + suite, can be used to rip audio information from + <acronym>CD</acronym>s.</para> - <para>With the audio CD in the drive, the following command can - be issued as <systemitem class="username">root</systemitem> to rip an entire CD - into individual (per track) <acronym>WAV</acronym> + <para>With the audio <acronym>CD</acronym> in the drive, the following command can + be issued as <systemitem class="username">root</systemitem> to rip an entire <acronym>CD</acronym> + into individual, per track, <acronym>WAV</acronym> files:</para> <screen>&prompt.root; <userinput>cdda2wav -D <replaceable>0,1,0</replaceable> -B</userinput></screen> - <para>The <option>-D <replaceable>0,1,0</replaceable></option> - indicates the <acronym>SCSI</acronym> device <filename>0,1,0</filename>, - which corresponds to the output of <command>cdrecord - -scanbus</command>.</para> - - <para><application>cdda2wav</application> will support ATAPI - (IDE) CDROM drives. To rip from an IDE drive, specify the - device name in place of the <acronym>SCSI</acronym> unit numbers. For example, - to rip track 7 from an IDE drive:</para> - - <screen>&prompt.root; <userinput>cdda2wav -D <replaceable>/dev/acd0</replaceable> -t 7</userinput></screen> + <para>In this example, the <option>-D <replaceable>0,1,0</replaceable></option> + indicates the <acronym>SCSI</acronym> device + <filename>0,1,0</filename> containing the <acronym>CD</acronym> to rip. + Use <command>cdrecord -scanbus</command> to determine the + correct device parameters for the system.</para> - <para>To rip individual tracks, make use of the - <option>-t</option> as shown:</para> + <para>To rip individual tracks, use + <option>-t</option> to specify the track:</para> <screen>&prompt.root; <userinput>cdda2wav -D <replaceable>0,1,0</replaceable> -t 7</userinput></screen> - <para>This example rips track seven of the audio CDROM. To rip + <para>To rip a range of tracks, such as track one to seven, specify a range:</para> <screen>&prompt.root; <userinput>cdda2wav -D <replaceable>0,1,0</replaceable> -t 1+7</userinput></screen> - <para>&man.dd.1; can also be used to extract audio tracks on - ATAPI drives, as described in <xref linkend="duplicating-audiocds"/>.</para> + <para>To rip from an <acronym>ATAPI</acronym> + (<acronym>IDE</acronym>) <acronym>CDROM</acronym> drive, specify the + device name in place of the <acronym>SCSI</acronym> unit numbers. For example, + to rip track 7 from an IDE drive:</para> + + <screen>&prompt.root; <userinput>cdda2wav -D <replaceable>/dev/acd0 -t 7</replaceable></userinput></screen> + <para>Alternately, <command>dd</command> can be used to extract audio tracks on + <acronym>ATAPI</acronym> drives, as described in <xref linkend="duplicating-audiocds"/>.</para> </sect2> <sect2 xml:id="mp3-encoding"> - <title>Encoding MP3s</title> + <title>Encoding and Decoding MP3s</title> <para> <application>Lame</application> is a popular <acronym>MP3</acronym> encoder which can be installed from the <package>audio/lame</package> port. Due to - licensing restrictions, a package is not available.</para> + patent issues, a package is not available.</para> <para>The following command will convert the ripped - <acronym>WAV</acronym> files + <acronym>WAV</acronym> file <filename><replaceable>audio01.wav</replaceable></filename> to <filename><replaceable>audio01.mp3</replaceable></filename>:</para> - <screen>&prompt.root; <userinput>lame -h -b <replaceable>128</replaceable> \ ---tt "<replaceable>Foo Song Title</replaceable>" \ ---ta "<replaceable>FooBar Artist</replaceable>" \ ---tl "<replaceable>FooBar Album</replaceable>" \ ---ty "<replaceable>2001</replaceable>" \ ---tc "<replaceable>Ripped and encoded by Foo</replaceable>" \ ---tg "<replaceable>Genre</replaceable>" \ -<replaceable>audio01.wav audio01.mp3</replaceable></userinput></screen> + <screen>&prompt.root; <userinput>lame -h -b <replaceable>128</replaceable> --tt "<replaceable>Foo Song Title</replaceable>" --ta "<replaceable>FooBar Artist</replaceable>" --tl "<replaceable>FooBar Album</replaceable>" \ +--ty "<replaceable>2014</replaceable>" --tc "<replaceable>Ripped and encoded by Foo</replaceable>" --tg "<replaceable>Genre</replaceable>" <replaceable>audio01.wav audio01.mp3</replaceable></userinput></screen> - <para>128 kbits is a standard <acronym>MP3</acronym> - bitrate. The 160 and 192 bitrates provide higher quality. + <para>The specified 128 kbits is a standard <acronym>MP3</acronym> + bitrate while the 160 and 192 bitrates provide higher quality. The higher the bitrate, the larger the size of the resulting - <acronym>MP3</acronym>. <option>-h</option> turns on the + <acronym>MP3</acronym>. The <option>-h</option> turns on the <quote>higher quality but a little slower</quote> mode. The - options beginning with <option>--t</option> indicate ID3 tags, + options beginning with <option>--t</option> indicate <acronym>ID3</acronym> tags, which usually contain song information, to be embedded within the <acronym>MP3</acronym> file. Additional encoding options can be found in the <application>lame</application> manual page.</para> - </sect2> - - <sect2 xml:id="mp3-decoding"> - <title>Decoding MP3s</title> - <para>In order to burn an audio CD from <acronym>MP3</acronym>s, + <para>In order to burn an audio <acronym>CD</acronym> from <acronym>MP3</acronym>s, they must first be converted to a non-compressed - <acronym>WAV</acronym> format. Both - <application>XMMS</application> and - <application>mpg123</application> support the output of - <acronym>MP3</acronym> to an uncompressed file format.</para> - - <para>Writing to Disk in <application>XMMS</application>:</para> + file format. <application>XMMS</application> can be used to convert to the + <acronym>WAV</acronym> format, while + <application>mpg123</application> can be used to convert to the + raw Pulse-Code Modulation (<acronym>PCM</acronym>) audio data + format.</para> + + <para>To convert <filename>audio01.mp3</filename> + using <application>mpg123</application>, specify the name of + the <acronym>PCM</acronym> file:</para> + + <screen>&prompt.root; <userinput>mpg123 -s <replaceable>audio01.mp3</replaceable> > <replaceable>audio01.pcm</replaceable></userinput></screen> + + <para>To use <application>XMMS</application> to convert a + <acronym>MP3</acronym> to <acronym>WAV</acronym> format, use + these steps:</para> <procedure> + <title>Converting to <acronym>WAV</acronym> Format in <application>XMMS</application></title> <step> <para>Launch <application>XMMS</application>.</para> </step> @@ -683,34 +669,20 @@ MPEG 1.0 layer III, 128 kbit/s, 44100 Hz </step> </procedure> - <para>Writing to stdout in - <application>mpg123</application>:</para> - - <procedure> - <step> - <para>Run <command>mpg123 -s - <replaceable>audio01.mp3</replaceable> > - <replaceable>audio01.pcm</replaceable></command></para> - </step> - </procedure> - - <para><application>XMMS</application> writes a file in the - <acronym>WAV</acronym> format, while - <application>mpg123</application> converts the - <acronym>MP3</acronym> into raw PCM audio data. Both of these + <para>Both the <acronym>WAV</acronym> and <acronym>PCM</acronym> formats can be used with <application>cdrecord</application> - to create audio CDs, whereas &man.burncd.8; requires a raw - Pulse-Code Modulation (<acronym>PCM</acronym>). When using + to create audio <acronym>CD</acronym>s, whereas <application>burncd</application> requires the + <acronym>PCM</acronym> format. When using <acronym>WAV</acronym> files, there will be a small tick sound at the beginning of each track. This sound is the - header of the <acronym>WAV</acronym> file. One can remove the - header with <application>SoX</application>, which can be - installed from the <package>audio/sox</package> port or package:</para> + header of the <acronym>WAV</acronym> file. The + <package>audio/sox</package> port or package can be used to remove the + header:</para> <screen>&prompt.user; <userinput>sox -t wav -r 44100 -s -w -c 2 <replaceable>track.wav track.raw</replaceable></userinput></screen> <para>Refer to <xref linkend="creating-cds"/> for more - information on using a CD burner in &os;.</para> + information on using a <acronym>CD</acronym> burner in &os;.</para> </sect2> </sect1>
Want to link to this message? Use this URL: <https://mail-archive.FreeBSD.org/cgi/mid.cgi?201404211717.s3LHH7f2036528>