cdda2wav.1

刻录光盘的程序

'\" t
.\" @(#)cdda2wav.1	1.4 00/01/02 Copyright 1998,1999,2000 Heiko Eissfeldt
.TH CDDA2WAV 1
.SH NAME
cdda2wav \- a sampling utility that dumps CD audio data into wav sound
files
.SH SYNOPSIS
.B cdda2wav
.RB [ -c
.IR chans ]
.RB [ -s ]
.RB [ -m ]
.RB [ -b
.IR bits ]
.RB [ -r
.IR rate ]
.RB [ -a
.IR divider ]
.RB [ -t
.IR track [ +endtrack ]]
.RB [ -i
.IR index ]
.RB [ -o
.IR offset ]
.RB [ -d
.IR duration ]
.RB [ -x ]
.RB [ -q ]
.RB [ -w ]
.RB [ -v ]
.RB [ -V ]
.RB [ -Q ]
.RB [ -J ]
.RB [ -R ]
.RB [ -P
.IR sectors ]
.RB [ -F ]
.RB [ -G ]
.RB [ -T ]
.RB [ -e ]
.RB [ -p
.IR percentage ]
.RB [ -n
.IR sectors ]
.RB [ -l
.IR buffers ]
.RB [ -N ]
.RB [ -J ]
.RB [ -H ]
.RB [ -g ]
.RB [ -B ]
.RB [ -D
.IR device ]
.RB [ -A
.IR auxdevice ]
.RB [ -I
.IR interface ]
.RB [ -O
.IR audiotype ]
.RB [ -C
.IR input-endianess ]
.RB [ -E
.IR output-endianess ]
.RB [ -M
.IR count ]
.RB [ -S
.IR speed ]
.RI [ audio.wav ]
.SH DESCRIPTION
.B cdda2wav
can retrieve audio tracks from CDROM drives (see README for a list of drives) that are
capable of reading audio data digitally to the host
.RB ( CDDA ).
Other drives may have been added as well when you read this.
.SH OPTIONS
.TP
.BI \-D " device  --device"
uses
.B device
as the source for CDDA reading:
For example /dev/cdrom for the
.B cooked_ioctl
interface and Bus,ID,Lun for the 
.B generic_scsi
interface. This has to correspond with the interface setting (see below).
The setting of the environment variable
.B CDDA_DEVICE
is overridden by this option.
.TP
.BI \-A " auxdevice  --auxdevice"
uses
.B auxdevice
as CDROM drive for ioctl usage.
.TP
.BI \-I " interface  --interface"
specifies the interface for CDROM access:
.B generic_scsi
or (on Linux systems)
.BR cooked_ioctl .
.TP
.BI \-c " channels  --channels"
uses
.B 1
for mono, or
.B 2
for stereo recording,
or
.B s
for stereo recording with both channels swapped.
.TP
.B \-s " --stereo"
sets to stereo recording.
.TP
.B \-m " --mono"
sets to mono recording.
.TP
.B \-x " --max"
sets maximum (CD) quality.
.TP
.BI \-b " bits  --bits-per-sample"
sets bits per sample per channel:
.BR 8 ,
.B 12
or
.BR 16 .
.TP
.BI \-r " rate  --rate"
sets rate in samples per second.  Possible values are listed with the
.B \-R
option.
.TP
.BI \-a " divider  --divider"
sets rate to 44100Hz / divider.  Possible values are listed with the
.B \-R
option.
.TP
.B \-R " --dump-rates"
shows a list of all sample rates and their dividers.
.TP
.B \-P " sectors  --set-overlap"
sets the initial number of overlap
.I sectors
for jitter correction.
.TP
.BI \-n " sectors  --sectors-per-request"
reads 
.I sectors
per request.
.TP
.BI \-l " buffers  --buffers-in-ring"
uses a ring buffer with 
.I buffers
total.
.TP
.BI \-t " track+endtrack  --track"
selects the start track and optionally the end track.
.TP
.BI \-i " index  --index"
selects the start index.
.TP
.BI \-o " offset  --offset"
starts
.I offset
sectors behind start track (one sector equivalents 1/75 seconds).
.TP
.B \-O " audiotype  --output-format"
can be 
.I wav
(for wav files) or
.I aiff
(for apple/sgi aiff files) or
.I aifc
(for apple/sgi aifc files) or
.I au
or
.I sun
(for sun .au PCM files) or
.I cdr
or
.I raw
(for headerless files to be used for cd writers).
.TP
.BI \-C " endianess  --cdrom-endianess"
sets endianess of the input samples to 'little', 'big' or 'guess' to override defaults.
.TP
.BI \-E " endianess  --output-endianess"
sets endianess of the output samples to 'little' or 'big' to override defaults.
.TP
.BI \-d " duration  --duration"
sets recording time in seconds or frames.
Frames (sectors) are indicated by a 'f' suffix (like 75f for 75 sectors).
.B 0
sets the time for whole track.
.TP
.B \-B " --bulk"
copies each track into a seperate file.
.TP
.B \-w " --wait"
waits for signal, then start recording.
.TP
.B \-F " --find-extremes"
finds extrem amplitudes in samples.
.TP
.B \-G " --find-mono"
finds if input samples are in mono.
.TP
.B \-T " --deemphasize"
undo the effect of pre-emphasis in the input samples.
.TP
.B \-e " --echo"
copies audio data to sound device e.g.
.BR /dev/dsp .
.TP
.B \-p " percentage --set-pitch"
changes pitch of audio data copied to sound device.
.TP
.B \-v " level  --verbose-level"
prints verbose information about the CD.
.B Level
is a sum of powers of two in the range 0 up to 63. Each power of two controls the type of information to be reported.
.TS H
center box ;
r| l|.
.TH CDDA2WAV 1
Power	Description
_
1	show table of contents
2	show a summary of the recording parameters
4	determine and display index offsets
8	retrieve and display the media catalog number MCN
16	retrieve and display all Intern. Standard Recording Codes ISRC
32	show the table of contents in start sector notation
64	show the table of contents with track titles (when available)
.TE
.TP
.B \-N " --no-write"
does not write to a file, it just reads (for debugging purposes).
.TP
.B \-J " --info-only"
does not write to a file, it just gives information about the disc.
.TP
.B \-H " --no-infofile"
does not write an info file and a cddb file.
.TP
.B \-g " --gui"
formats the output to be better parsable by gui frontends.
.TP
.B \-M " count --md5"
enables calculation of MD-5 checksum for 'count' bytes from a beginning of a
track.
.TP
.B \-S " speed --speed-select"
sets the cdrom device to one of the selectable speeds for reading.
.TP
.B \-q " --quiet"
quiet operation, no screen output.
.TP
.B \-V " --verbose-SCSI"
enable SCSI command logging to the console. This is mainly used for debugging.
.TP
.B \-Q " --silent-SCSI"
suppress SCSI command error reports to the console. This is mainly used for guis.
.TP
.B \-J " --version"
display version of cdda2wav on standard output.
.TP
Defaults depend on the
.B Makefile
and
.B environment variable
settings (currently
.B CDDA_DEVICE
).
.SH "ENVIRONMENT VARIABLES"
.B CDDA_DEVICE
is used to set the device name. The device naming is compatible with J鰎g
Schilling's cdrecord package.
.SH "DISCUSSION"
.B cdda2wav
is able to read parts of an
.B audio
CD or
.B multimedia
CDROM (containing audio parts) directly digitally. These parts can be
written to a file, a pipe, or to a sound device.
.PP
.B cdda2wav
stands for
.B CDDA
to
.B WAV
(where
.B CDDA
stands for compact disc digital audio and
.B WAV
is a sound sample format introduced by MS Windows).  It
allows copying
.B CDDA
audio data from the CDROM drive into a file on your ram-, hard-, floppy-
or whatever-disk in 
.B WAV
or other formats.
.PP
The latest versions try to get higher real-time scheduling priorities to ensure
smooth (uninterrupted) operation. These priorities are available for super users
and are higher than those of 'normal' processes. Thus delays are minimized.
Please note that you need newer kernels and c libraries to take advantage of this feature.
.PP
If your CDROM (not yet for SCSI drives) is on device
.B /dev/cdrom
and it is loaded with an audio CD, you may simply invoke
.B cdda2wav
and it will create the sound file
.B audio.wav
recording the whole track beginning with track 1 in stereo at 16 bit at 44100
Hz sample rate, if your file system has enough space free.  Otherwise
recording time will be limited. SCSI drives have to use different devices
(see files
.B README
and
.B README.INSTALL
for details).
.SH "HINTS ON OPTIONS"
.IP "Options"
Most of the options are used to control the format of the WAV file. In
the following text all of them are described.
.IP "Select Device"
.BI \-D " device"
selects the CDROM drive device to be used.
The specifier given should correspond to the selected interface (see below).
.B CHANGE!
For the cooked_ioctl interface this is the cdrom device descriptor as before.
.B The SCSI devices used with the generic SCSI interface however are now
.B addressed with their SCSI-Bus, SCSI-Id, and SCSI-Lun instead of the generic
.B SCSI device descriptor!!!
One example for a SCSI CDROM drive on bus 0 with SCSI ID 3 and lun 0 is -D0,3,0.
.IP "Select Auxiliary device"
.BI \-A " auxdevice"
is necessary for CD-Extra handling. For Non-SCSI-CDROM drives this is the
same device as given by -D (see above). For SCSI-CDROM drives it is the
CDROM drive (SCSI) device (i.e.  
.B /dev/sr0
) corresponding to the SCSI device (i.e.
.B 0,3,0
). It has to match the device used for sampling.
.IP "Select Interface"
.BI \-I " interface"
selects the CDROM drive interface. For SCSI drives use generic_scsi
(cooked_ioctl may not yet be available for all devices):
.B generic_scsi
and
.BR cooked_ioctl .
The first uses the generic SCSI interface, the latter uses the ioctl of
the CDROM driver. The latter variant works only when the kernel driver supports
.B CDDA
reading. This entry has to match the selected CDROM device (see above).
.IP "Enable echo to soundcard"
.B \-e
copies audio data to the sound card while recording, so you hear it nearly
simultaneously. The soundcard gets the same data that is recorded. This
is time critical, so it works best with the
.B \-q
option.  To use
.B cdda2wav
as a pseudo CD player without recording in a file you could use
.B "cdda2wav \-q \-e \-t2 \-d0 \-N"
to play the whole second track. This feature reduces the recording speed
to at most onefold speed. You cannot make better recordings than your sound card
can play (since the same data is used).
.IP "Change pitch of echoed audio"
.B "\-p percentage"
changes the pitch of all audio echoed to a sound card. Only the copy
to the soundcard is affected, the recorded audio samples in a file
remain the same.
Normal pitch, which is the default, is given by 100%.
Lower percentages correspond to lower pitches, i.e.
-p 50 transposes the audio output one octave lower.
See also the script