diff options
Diffstat (limited to 'doc/tdeioslave/audiocd.docbook')
| -rw-r--r-- | doc/tdeioslave/audiocd.docbook | 208 |
1 files changed, 0 insertions, 208 deletions
diff --git a/doc/tdeioslave/audiocd.docbook b/doc/tdeioslave/audiocd.docbook deleted file mode 100644 index 371d0aa4..00000000 --- a/doc/tdeioslave/audiocd.docbook +++ /dev/null @@ -1,208 +0,0 @@ -<article lang="&language;" id="audiocd"> -<title>audiocd</title> -<articleinfo> -<authorgroup> -<author>&Rik.Hemsley; &Rik.Hemsley.mail;</author> -<author><personname><firstname>Benjamin</firstname><surname>Meyer</surname></personname></author> -<!-- TRANS:ROLES_OF_TRANSLATORS --> -</authorgroup> - -<date>2004-09-16</date> -<releaseinfo>2.30.00</releaseinfo> - -</articleinfo> - -<para>Allows treating audio <acronym>CD</acronym>s like a -<quote>real</quote> filesystem, where tracks are represented as files -and, when copied from the folder, are digitally extracted from the -<acronym>CD</acronym>. This ensures a perfect copy of the audio -data.</para> - -<para>To see how this slave works, insert an audio <acronym>CD</acronym> -in your &CD-ROM; drive and type <userinput>audiocd:/</userinput> into -&konqueror;. Within a few seconds you should see a list of tracks and -some folders.</para> - -<para>Audio <acronym>CD</acronym>s don't really have folders, but -the audiocd slave provides them as a convenience. If you look inside -these folders you will see that they all contain the same number of -tracks. If you are connected to the Internet, some folders will have -the actual track titles shown as the filenames.</para> - -<para>The reason that these separate folders exist are so that you -can choose in which format you would like to listen to (or copy) the -tracks on the <acronym>CD</acronym>.</para> - -<para>If you drag a track from the <filename class="directory">Ogg -Vorbis</filename> folder and drop it on another &konqueror; window -open at your home folder, you should see a progress window showing -you that the track is being extracted from the <acronym>CD</acronym> and -saved to a file. Note that Ogg Vorbis is a compressed format, so the -file in your home folder will appear a great deal smaller than it -would have been if you had copied the raw data.</para> - -<para>The mechanism behind this is quite simple. When the audiocd slave -is asked to retrieve a track from the <filename class="directory">Ogg -Vorbis</filename> folder, it starts extracting the digital audio data -from the <acronym>CD</acronym>. As it sends the data over to the file in -your home folder, it simultaneously encodes it in Ogg Vorbis format -(<acronym>CD</acronym> audio is in an uncompressed format to start -with).</para> - -<para>You could also try dragging a file ending in <literal -role="extension">.wav</literal> and dropping it on the &kde; Media -Player, &noatun;. In this case, the procedure that happens behind the -scenes is similar, except that instead of encoding the audio data in Ogg -Vorbis format, it is put through a very simple conversion, from raw -binary data (which the <literal role="extension">.cda</literal> files in -the toplevel folder represent) to <quote>RIFF WAV</quote> format, a -non-compressed format that most media players understand.</para> - -<para>&noatun; should quite happily play the <literal -role="extension">.wav</literal> file, but if it has trouble, you may -consider using the <option>paranoia_level</option> option, explained -below.</para> - -<variablelist> -<title>Options</title> - -<varlistentry> -<term><option>device</option></term> -<listitem> -<para>Set the path to the audio <acronym>CD</acronym> device, ⪚ -<userinput>audiocd:/<option>?device</option>=<parameter>/dev/sdc</parameter></userinput>. -Normally, the slave will try to find a <acronym>CD</acronym> drive with -an audio <acronym>CD</acronym> inserted, but if it fails or you have -more than one <acronym>CD</acronym> drive, you may want to try this -option. Note that the configuration dialog allows you to set a default -value for this option.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><option>fileNameTemplate</option></term> -<listitem> -<para>Set the file name template, ⪚ -<userinput>audiocd:/<option>?fileNameTemplate</option>=<parameter>Track %{number}</parameter></userinput>. Note that the configuration dialog allows you to set a default value for this option. A warning that if you set it to an empty string no files will show up.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><option>albumNameTemplate</option></term> -<listitem> -<para>Set the album name template, ⪚ -<userinput>audiocd:/<option>?albumNameTemplate</option>=<parameter>%{albumartist} %{albumtitle}</parameter></userinput>. Note that the configuration dialog allows you to set a default value for this option.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><option>niceLevel</option></term> -<listitem> -<para>Sets the process nice level for encoders, ⪚ -<userinput>audiocd:/<option>?albumNameTemplate</option>=<parameter>niceLevel=10</parameter></userinput>. Note that the configuration dialog allows you to set a default value for this option.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><option>paranoia_level</option></term> -<listitem> -<para>Set the amount of error detection and correction used when -extracting data.</para> - -<variablelist> -<varlistentry> -<term>Level 0</term> -<listitem> -<para>No detection or correction. Only useful if you have a perfect -<acronym>CD</acronym> drive (unlikely).</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Level 1</term> -<listitem> -<para>Enable basic error checking and correction.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term>Level 2</term> -<listitem> -<para>Default. Specifies that only a perfect extraction will be -accepted.</para> -</listitem> -</varlistentry> -</variablelist> - -<para>Note that there is a disadvantage to level 2. Extraction can be -very slow, so real-time digital playback may not work properly. If you -have a good quality <acronym>CD</acronym> drive (note that more -expensive does not necessarily mean better quality) then you probably -won't experience very slow extraction, but a poor drive may take days -(!) to extract the audio from one <acronym>CD</acronym>.</para> -</listitem> -</varlistentry> - -<varlistentry> -<term><option>cddbChoice</option></term> -<listitem> - -<para>Specify which Internet <acronym>CD</acronym> Database entry to use. Audio -<acronym>CD</acronym>s don't have track names, but the Internet -<acronym>CD</acronym> Database is a clever system which uses a special -unique identifier generated from the number and length of tracks on each -<acronym>CD</acronym> to cross-reference a track listing. Track listings -are contributed by the Internet community and made available to -all. Occasionally there will be multiple entries. You can specify which one to use.</para> - -<para>You can submit your own track listings using &kscd;, the &kde; -<acronym>CD</acronym> player.</para> - -<para>By default audiocd tries to pick the best one.</para> -</listitem> -</varlistentry> -</variablelist> - -<variablelist> -<title>Examples</title> -<varlistentry> -<term><userinput>audiocd:/?device=/dev/scd0&paranoia_level=0&cddbChoice=0</userinput></term> -<listitem> -<para>Gives a listing of the tracks on the audio <acronym>CD</acronym> -inserted in <filename class="devicefile">/dev/scd0</filename>, which on -&Linux; specifies the first <acronym>SCSI</acronym> &CD-ROM; device. If -you copy tracks from the <acronym>CD</acronym>, digital extraction will -be performed without error correction or detection. The -<acronym>CDDB</acronym> Database entry 0 will be used.</para> -</listitem> -</varlistentry> -</variablelist> - -<qandaset> -<title>Frequently Asked Question</title> -<qandaentry> -<question> -<para>I get <errorname>The file or folder / does not -exist</errorname>. How do I fix that? I have an audio -<acronym>CD</acronym> in my drive!</para> -</question> - -<answer> -<para>Try running <userinput><command>cdparanoia</command> -<option>-vsQ</option></userinput> as yourself (not <systemitem -class="username">root</systemitem>). Do you see a track list? If not, -make sure you have permission to access the <acronym>CD</acronym> -device. If you're using <acronym>SCSI</acronym> emulation (possible if -you have an <acronym>IDE</acronym> <acronym>CD</acronym> writer) then -make sure you check that you have read and write permissions on the -generic <acronym>SCSI</acronym> device, which is probably <filename -class="devicefile">/dev/sg0</filename>, <filename -class="devicefile">/dev/sg1</filename>, &etc;. If it still doesn't work, -try typing <userinput>audiocd:/?device=/dev/sg0</userinput> (or similar) -to tell tdeio_audiocd which device your &CD-ROM; is.</para> -</answer> -</qandaentry> -</qandaset> - - -</article> |