home *** CD-ROM | disk | FTP | other *** search
/ PC Online 1999 November / PCONLINE_11_99.ISO / filesbbs / OS2 / CDR18A24.ZIP / doc / cdda2wav.man next >
Encoding:
Text File  |  1999-05-13  |  37.0 KB  |  859 lines

  1.  
  2.  
  3.  
  4. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  5.  
  6.  
  7.  
  8. NNNNAAAAMMMMEEEE
  9.      cdda2wav - a sampling utility that dumps CD audio data  into
  10.      wav sound files
  11.  
  12. SSSSYYYYNNNNOOOOPPPPSSSSIIIISSSS
  13.      ccccddddddddaaaa2222wwwwaaaavvvv [----cccc _c_h_a_n_s]  [----ssss]  [----mmmm]  [----bbbb  _b_i_t_s]  [----rrrr  _r_a_t_e]  [----aaaa
  14.      _d_i_v_i_d_e_r]  [----tttt  _t_r_a_c_k[+_e_n_d_t_r_a_c_k]]  [----iiii _i_n_d_e_x] [----oooo _o_f_f_s_e_t] [----dddd
  15.      _d_u_r_a_t_i_o_n] [----xxxx] [----qqqq] [----wwww] [----vvvv] [----VVVV] [----JJJJ]  [----RRRR]  [----PPPP  _s_e_c_t_o_r_s]
  16.      [----FFFF]  [----GGGG]  [----TTTT]  [----eeee]  [----pppp  _p_e_r_c_e_n_t_a_g_e]  [----nnnn  _s_e_c_t_o_r_s]  [----llll
  17.      _b_u_f_f_e_r_s] [----NNNN] [----JJJJ] [----HHHH] [----BBBB] [----DDDD _d_e_v_i_c_e] [----AAAA _a_u_x_d_e_v_i_c_e]  [----IIII
  18.      _i_n_t_e_r_f_a_c_e]  [----OOOO  _a_u_d_i_o_t_y_p_e] [----CCCC _i_n_p_u_t-_e_n_d_i_a_n_e_s_s] [----EEEE _o_u_t_p_u_t-
  19.      _e_n_d_i_a_n_e_s_s] [----MMMM _c_o_u_n_t] [----SSSS _s_p_e_e_d] [_a_u_d_i_o._w_a_v]
  20.  
  21. DDDDEEEESSSSCCCCRRRRIIIIPPPPTTTTIIIIOOOONNNN
  22.      ccccddddddddaaaa2222wwwwaaaavvvv can retrieve audio tracks from  CDROM  drives  (see
  23.      README  for  a  list  of drives) that are capable of reading
  24.      audio data digitally to the host (CCCCDDDDDDDDAAAA).  Other  drives  may
  25.      have been added as well when you read this.
  26.  
  27. OOOOPPPPTTTTIIIIOOOONNNNSSSS
  28.      ----DDDD _d_e_v_i_c_e  --_d_e_v_i_c_e
  29.           uses ddddeeeevvvviiiicccceeee as the source for CDDA reading:  For  exam-
  30.           ple  /dev/cdrom  for  the  ccccooooooookkkkeeeedddd____iiiiooooccccttttllll  interface  and
  31.           Bus,ID,Lun for the ggggeeeennnneeeerrrriiiicccc____ssssccccssssiiii interface. This has  to
  32.           correspond with the interface setting (see below).  The
  33.           setting of  the  environment  variable  CCCCDDDDDDDDAAAA____DDDDEEEEVVVVIIIICCCCEEEE  is
  34.           overridden by this option.
  35.  
  36.      ----AAAA _a_u_x_d_e_v_i_c_e  --_a_u_x_d_e_v_i_c_e
  37.           uses aaaauuuuxxxxddddeeeevvvviiiicccceeee as CDROM drive for ioctl usage.
  38.  
  39.      ----IIII _i_n_t_e_r_f_a_c_e  --_i_n_t_e_r_f_a_c_e
  40.           specifies the interface for CDROM access:  ggggeeeennnneeeerrrriiiicccc____ssssccccssssiiii
  41.           or (on Linux systems) ccccooooooookkkkeeeedddd____iiiiooooccccttttllll.
  42.  
  43.      ----cccc _c_h_a_n_n_e_l_s  --_c_h_a_n_n_e_l_s
  44.           uses 1111 for mono, or 2222 for stereo recording,  or  ssss  for
  45.           stereo recording with both channels swapped.
  46.  
  47.      ----ssss  --------sssstttteeeerrrreeeeoooo
  48.           sets to stereo recording.
  49.  
  50.      ----mmmm  --------mmmmoooonnnnoooo
  51.           sets to mono recording.
  52.  
  53.      ----xxxx  --------mmmmaaaaxxxx
  54.           sets maximum (CD) quality.
  55.  
  56.      ----bbbb _b_i_t_s  --_b_i_t_s-_p_e_r-_s_a_m_p_l_e
  57.           sets bits per sample per channel:  8888, 11112222 or 11116666.
  58.  
  59.      ----rrrr _r_a_t_e  --_r_a_t_e
  60.  
  61.  
  62.  
  63. SunOS 5.4                 Last change:                          1
  64.  
  65.  
  66.  
  67.  
  68.  
  69.  
  70. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  71.  
  72.  
  73.  
  74.           sets rate in samples per second.  Possible  values  are
  75.           listed with the ----RRRR option.
  76.  
  77.      ----aaaa _d_i_v_i_d_e_r  --_d_i_v_i_d_e_r
  78.           sets rate to 44100Hz / divider.   Possible  values  are
  79.           listed with the ----RRRR option.
  80.  
  81.      ----RRRR  --------dddduuuummmmpppp----rrrraaaatttteeeessss
  82.           shows a list of all sample rates and their dividers.
  83.  
  84.      ----PPPP  sssseeeeccccttttoooorrrrssss  --------sssseeeetttt----oooovvvveeeerrrrllllaaaapppp
  85.           sets the initial number of overlap _s_e_c_t_o_r_s  for  jitter
  86.           correction.
  87.  
  88.      ----nnnn _s_e_c_t_o_r_s  --_s_e_c_t_o_r_s-_p_e_r-_r_e_q_u_e_s_t
  89.           reads _s_e_c_t_o_r_s per request.
  90.  
  91.      ----llll _b_u_f_f_e_r_s  --_b_u_f_f_e_r_s-_i_n-_r_i_n_g
  92.           uses a ring buffer with _b_u_f_f_e_r_s total.
  93.  
  94.      ----tttt _t_r_a_c_k+_e_n_d_t_r_a_c_k  --_t_r_a_c_k
  95.           selects the start track and optionally the end track.
  96.  
  97.      ----iiii _i_n_d_e_x  --_i_n_d_e_x
  98.           selects the start index.
  99.  
  100.      ----oooo _o_f_f_s_e_t  --_o_f_f_s_e_t
  101.           starts _o_f_f_s_e_t sectors behind start  track  (one  sector
  102.           equivalents 1/75 seconds).
  103.  
  104.      ----OOOO  aaaauuuuddddiiiioooottttyyyyppppeeee  --------oooouuuuttttppppuuuutttt----ffffoooorrrrmmmmaaaatttt
  105.           can be _w_a_v (for wav files) or _a_i_f_f (for apple/sgi  aiff
  106.           files)  or _a_i_f_c (for apple/sgi aifc files) or _a_u or _s_u_n
  107.           (for sun .au PCM files) or _c_d_r or _r_a_w  (for  headerless
  108.           files to be used for cd writers).
  109.  
  110.      ----CCCC _e_n_d_i_a_n_e_s_s  --_c_d_r_o_m-_e_n_d_i_a_n_e_s_s
  111.           sets endianess of the input samples to 'little',  'big'
  112.           or 'guess' to override defaults.
  113.  
  114.      ----EEEE _e_n_d_i_a_n_e_s_s  --_o_u_t_p_u_t-_e_n_d_i_a_n_e_s_s
  115.           sets endianess of the output  samples  to  'little'  or
  116.           'big' to override defaults.
  117.  
  118.      ----dddd _d_u_r_a_t_i_o_n  --_d_u_r_a_t_i_o_n
  119.           sets recording time in seconds or 0000 for whole track.
  120.  
  121.      ----BBBB  --------bbbbuuuullllkkkk
  122.           copies each track into a seperate file.
  123.  
  124.      ----wwww  --------wwwwaaaaiiiitttt
  125.           waits for signal, then start recording.
  126.  
  127.  
  128.  
  129. SunOS 5.4                 Last change:                          2
  130.  
  131.  
  132.  
  133.  
  134.  
  135.  
  136. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  137.  
  138.  
  139.  
  140.      ----FFFF  --------ffffiiiinnnndddd----eeeexxxxttttrrrreeeemmmmeeeessss
  141.           finds extrem amplitudes in samples.
  142.  
  143.      ----GGGG  --------ffffiiiinnnndddd----mmmmoooonnnnoooo
  144.           finds if input samples are in mono.
  145.  
  146.      ----TTTT  --------ddddeeeeeeeemmmmpppphhhhaaaassssiiiizzzzeeee
  147.           undo the effect of pre-emphasis in the input samples.
  148.  
  149.      ----eeee  --------eeeecccchhhhoooo
  150.           copies audio data to sound device e.g.  ////ddddeeeevvvv////ddddsssspppp.
  151.  
  152.      ----pppp  ppppeeeerrrrcccceeeennnnttttaaaaggggeeee --------sssseeeetttt----ppppiiiittttcccchhhh
  153.           changes pitch of audio data copied to sound device.
  154.  
  155.      ----vvvv  lllleeeevvvveeeellll  --------vvvveeeerrrrbbbboooosssseeee----lllleeeevvvveeeellll
  156.           prints verbose information about the CD.   LLLLeeeevvvveeeellll  is  a
  157.           sum  of  powers  of  two  in the range 0 up to 63. Each
  158.           power of two controls the type  of  information  to  be
  159.           reported.  center box ; r| l|.
  160.  
  161.  
  162.  
  163.  
  164.  
  165.  
  166.  
  167.  
  168.  
  169.  
  170.  
  171.  
  172.  
  173.  
  174.  
  175.  
  176.  
  177.  
  178.  
  179.  
  180.  
  181.  
  182.  
  183.  
  184.  
  185.  
  186.  
  187.  
  188.  
  189.  
  190.  
  191.  
  192.  
  193.  
  194.  
  195. SunOS 5.4                 Last change:                          3
  196.  
  197.  
  198.  
  199.  
  200.  
  201.  
  202. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  203.  
  204.  
  205.  
  206.      Power     Description  _   1    show   table   of   contents
  207.      2    show  a summary of the recording parameters 4    deter-
  208.      mine and display index offsets 8    retrieve and display the
  209.      media  catalog  number  MCN  16   retrieve  and  display all
  210.      Intern. Standard Recording Codes ISRC 32   show the table of
  211.      contents  in  start  sector  notation 64   show the table of
  212.      contents with track titles (when available)
  213.  
  214.      ----NNNN  --------nnnnoooo----wwwwrrrriiiitttteeee
  215.           does not write to a file, it just reads (for  debugging
  216.           purposes).
  217.  
  218.      ----JJJJ  --------iiiinnnnffffoooo----oooonnnnllllyyyy
  219.           does not write to a file,  it  just  gives  information
  220.           about the disc.
  221.  
  222.      ----HHHH  --------nnnnoooo----iiiinnnnffffooooffffiiiilllleeee
  223.           does not write an info file and a cddb file.
  224.  
  225.      ----MMMM  ccccoooouuuunnnntttt --------mmmmdddd5555
  226.           enables calculation of MD-5 checksum for 'count'  bytes
  227.           from a beginning of a track.
  228.  
  229.      ----SSSS  ssssppppeeeeeeeedddd --------ssssppppeeeeeeeedddd----sssseeeelllleeeecccctttt
  230.           sets the cdrom device to one of the  selectable  speeds
  231.           for reading.
  232.  
  233.      ----qqqq  --------qqqquuuuiiiieeeetttt
  234.           quiet operation, no screen output.
  235.  
  236.      ----VVVV  --------vvvveeeerrrrbbbboooosssseeee----SSSSCCCCSSSSIIII
  237.           enable SCSI command logging to  the  console.  This  is
  238.           mainly used for debugging
  239.  
  240.      ----JJJJ  --------vvvveeeerrrrssssiiiioooonnnn
  241.           display version of cdda2wav on standard output.
  242.  
  243.      Defaults depend on the
  244.           MMMMaaaakkkkeeeeffffiiiilllleeee and eeeennnnvvvviiiirrrroooonnnnmmmmeeeennnntttt vvvvaaaarrrriiiiaaaabbbblllleeee  settings  (currently
  245.           CCCCDDDDDDDDAAAA____DDDDEEEEVVVVIIIICCCCEEEE ).
  246.  
  247. EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT VVVVAAAARRRRIIIIAAAABBBBLLLLEEEESSSS
  248.      CCCCDDDDDDDDAAAA____DDDDEEEEVVVVIIIICCCCEEEE is used to set the device name. The device  nam-
  249.      ing is compatible with J÷rg Schilling's cdrecord package.
  250.  
  251. DDDDIIIISSSSCCCCUUUUSSSSSSSSIIIIOOOONNNN
  252.      ccccddddddddaaaa2222wwwwaaaavvvv is able to read parts of an aaaauuuuddddiiiioooo CD or  mmmmuuuullllttttiiiimmmmeeeeddddiiiiaaaa
  253.      CDROM  (containing  audio  parts)  directly digitally. These
  254.      parts can be written to a file, a pipe, or to a  sound  dev-
  255.      ice.
  256.  
  257.  
  258.  
  259.  
  260.  
  261. SunOS 5.4                 Last change:                          1
  262.  
  263.  
  264.  
  265.  
  266.  
  267.  
  268. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  269.  
  270.  
  271.  
  272.      ccccddddddddaaaa2222wwwwaaaavvvv stands for CCCCDDDDDDDDAAAA to WWWWAAAAVVVV (where CCCCDDDDDDDDAAAA stands for  com-
  273.      pact  disc  digital  audio  and WWWWAAAAVVVV is a sound sample format
  274.      introduced by MS Windows).  It  allows  copying  CCCCDDDDDDDDAAAA  audio
  275.      data  from  the CDROM drive into a file on your ram-, hard-,
  276.      floppy- or whatever-disk in WWWWAAAAVVVV or other formats.
  277.  
  278.      The latest versions try to get higher  real-time  scheduling
  279.      priorities to ensure smooth (uninterrupted) operation. These
  280.      priorities are available for super users and are higher than
  281.      those  of  'normal'  processes.  Thus  delays are minimized.
  282.      Please note that you need newer kernels and c  libraries  to
  283.      take advantage of this feature.
  284.  
  285.      If your CDROM  (not  yet  for  SCSI  drives)  is  on  device
  286.      ////ddddeeeevvvv////ccccddddrrrroooommmm and it is loaded with an audio CD, you may simply
  287.      invoke ccccddddddddaaaa2222wwwwaaaavvvv and it will create the sound file  aaaauuuuddddiiiioooo....wwwwaaaavvvv
  288.      recording  the  whole track beginning with track 1 in stereo
  289.      at 16 bit at 44100 Hz sample rate, if your file  system  has
  290.      enough  space  free.   Otherwise recording time will be lim-
  291.      ited. SCSI drives have to use different devices  (see  files
  292.      RRRREEEEAAAADDDDMMMMEEEE and RRRREEEEAAAADDDDMMMMEEEE....IIIINNNNSSSSTTTTAAAALLLLLLLL for details).
  293.  
  294. HHHHIIIINNNNTTTTSSSS OOOONNNN OOOOPPPPTTTTIIIIOOOONNNNSSSS
  295.      Options
  296.           Most of the options are used to control the  format  of
  297.           the  WAV  file.  In  the following text all of them are
  298.           described.
  299.  
  300.      Select Device
  301.           ----DDDD _d_e_v_i_c_e selects the CDROM drive device  to  be  used.
  302.           The  specifier  given should correspond to the selected
  303.           interface (see below).  CCCCHHHHAAAANNNNGGGGEEEE!!!!  For  the  cooked_ioctl
  304.           interface  this  is  the  cdrom  device  descriptor  as
  305.           before.  TTTThhhheeee SSSSCCCCSSSSIIII ddddeeeevvvviiiicccceeeessss uuuusssseeeedddd wwwwiiiitttthhhh tttthhhheeee aaaaddddddddrrrreeeesssssssseeeedddd  wwwwiiiitttthhhh
  306.           tttthhhheeeeiiiirrrr  SSSSCCCCSSSSIIII----BBBBuuuussss,,,, SSSSCCCCSSSSIIII----IIIIdddd,,,, aaaannnndddd SSSSCCCCSSSSIIII ddddeeeevvvviiiicccceeee ddddeeeessssccccrrrriiiippppttttoooorrrr!!!!!!!!!!!!
  307.           One example for a SCSI CDROM drive on bus 0  with  SCSI
  308.           ID 3 and lun 0 is -D0,3,0.
  309.  
  310.      Select Auxiliary device
  311.           ----AAAA _a_u_x_d_e_v_i_c_e is necessary for  CD-Extra  handling.  For
  312.           Non-SCSI-CDROM  drives this is the same device as given
  313.           by -D (see above). For  SCSI-CDROM  drives  it  is  the
  314.           CDROM  drive (SCSI) device (i.e. ////ddddeeeevvvv////ssssrrrr0000 ) correspond-
  315.           ing to the SCSI device (i.e.  0000,,,,3333,,,,0000 ). It has to  match
  316.           the device used for sampling.
  317.  
  318.      Select Interface
  319.           ----IIII _i_n_t_e_r_f_a_c_e selects the  CDROM  drive  interface.  For
  320.           SCSI  drives use generic_scsi (cooked_ioctl may not yet
  321.           be  available  for  all  devices):   ggggeeeennnneeeerrrriiiicccc____ssssccccssssiiii   and
  322.           ccccooooooookkkkeeeedddd____iiiiooooccccttttllll.   The  first uses the generic SCSI inter-
  323.           face, the latter uses the ioctl of  the  CDROM  driver.
  324.  
  325.  
  326.  
  327. SunOS 5.4                 Last change:                          2
  328.  
  329.  
  330.  
  331.  
  332.  
  333.  
  334. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  335.  
  336.  
  337.  
  338.           The  latter  variant  works only when the kernel driver
  339.           supports CCCCDDDDDDDDAAAA reading. This  entry  has  to  match  the
  340.           selected CDROM device (see above).
  341.  
  342.      Enable echo to soundcard
  343.           ----eeee copies audio data to the sound card while recording,
  344.           so  you  hear  it  nearly simultaneously. The soundcard
  345.           gets the same data that is recorded. This is time crit-
  346.           ical,  so  it  works  best  with the ----qqqq option.  To use
  347.           ccccddddddddaaaa2222wwwwaaaavvvv as a pseudo CD player without recording  in  a
  348.           file  you  could  use ccccddddddddaaaa2222wwwwaaaavvvv ----qqqq ----eeee ----tttt2222 ----dddd0000 ----NNNN to play
  349.           the  whole  second  track.  This  feature  reduces  the
  350.           recording  speed  to  at most onefold speed. You cannot
  351.           make better recordings than your sound  card  can  play
  352.           (since the same data is used).
  353.  
  354.      Change pitch of echoed audio
  355.           ----pppp ppppeeeerrrrcccceeeennnnttttaaaaggggeeee changes the pitch of all audio echoed  to
  356.           a  sound  card.  Only  the  copy  to  the  soundcard is
  357.           affected, the recorded audio samples in a  file  remain
  358.           the same.  Normal pitch, which is the default, is given
  359.           by  100%.   Lower  percentages  correspond   to   lower
  360.           pitches,  i.e.   -p  50 transposes the audio output one
  361.           octave lower.  See also  the  script  ppppiiiittttcccchhhhppppllllaaaayyyy  as  an
  362.           example. This option was contributed by Raul Sobon.
  363.  
  364.      Select mono or stereo recording
  365.           ----mmmm or ----cccc 1111 selects mono recording (both stereo channels
  366.           are mixed), ----ssss or ----cccc 2222 or ----cccc ssss selects stereo recording
  367.           (doubles file size). Parameter s will swap  both  sound
  368.           channels.
  369.  
  370.      Select maximum quality
  371.           ----xxxx will set stereo, 16 bits  per  sample  at  44.1  KHz
  372.           (full  CD  quality).   Note  that  other format options
  373.           given later can change this setting.
  374.  
  375.      Select sample quality
  376.           ----bbbb 8888 specifies 8 bit (1 Byte) for each sample  in  each
  377.           channel;  ----bbbb 11112222 specifies 12 bit (2 Byte) for each sam-
  378.           ple in each channel; ----bbbb 11116666 specifies 16  bit  (2  Byte)
  379.           for  each sample in each channel (Ensure that your sam-
  380.           ple player or sound card is capable of  playing  12-bit
  381.           or  16-bit  samples).  Selecting  12 or 16 bits doubles
  382.           file size.  12-bit samples are aligned to  16-bit  sam-
  383.           ples, so they waste some disk space.
  384.  
  385.      Select sample rate
  386.           ----rrrr _s_a_m_p_l_e_r_a_t_e selects a sample rate.  _s_a_m_p_l_e_r_a_t_e can be
  387.           in  a  range between 44100 and 900. Option ----RRRR lists all
  388.           available rates.
  389.  
  390.  
  391.  
  392.  
  393. SunOS 5.4                 Last change:                          3
  394.  
  395.  
  396.  
  397.  
  398.  
  399.  
  400. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  401.  
  402.  
  403.  
  404.      Select sample rate divider
  405.           ----aaaa _d_i_v_i_d_e_r selects a sample rate divider.  _d_i_v_i_d_e_r  can
  406.           be  minimally  1  and  maximally  50.5  and  everything
  407.           between in steps of 0.5.  Option ----RRRR lists all available
  408.           rates.
  409.  
  410.           To make the sound smoother  at  lower  sampling  rates,
  411.           ccccddddddddaaaa2222wwwwaaaavvvv  sums  over _n samples (where _n is the specific
  412.           dividend). So for 22050 Hertz output  we  have  to  sum
  413.           over  2  samples,  for 900 Hertz we have to sum over 49
  414.           samples.  This  cancels  higher  frequencies.  Standard
  415.           sector  size of an audio CD (ignoring additional infor-
  416.           mation) is 2352 Bytes. In order to finish  summing  for
  417.           an  output  sample at sector boundaries the rates above
  418.           have to be choosen.  Arbitrary sampling rates  in  high
  419.           quality  would require some interpolation scheme, which
  420.           needs much more sophisticated programming.
  421.  
  422.      List a table of all sampling rates
  423.           ----RRRR shows a list of all sample rates and their dividers.
  424.           Dividers can range from 1 to 50.5 in steps of 0.5.
  425.  
  426.      Select start track and optionally end track
  427.           ----tttt _n+_m selects nnnn as the start track and optionally mmmm as
  428.           the last track of a range to be recorded.  These tracks
  429.           must be from the table  of  contents.   This  sets  the
  430.           track  where  recording  begins.  Recording can advance
  431.           through the following tracks as well  (limited  by  the
  432.           optional  end track or otherwise depending on recording
  433.           time). Whether one file or  different  files  are  then
  434.           created depends on the ----BBBB option (see below).
  435.  
  436.      Select start index
  437.           ----iiii  _n  selects  the  index  to  start  recording  with.
  438.           Indices  other  than  1  will invoke the index scanner,
  439.           which will take some time to  find  the  correct  start
  440.           position.  An  offset  may  be  given additionally (see
  441.           below).
  442.  
  443.      Set recording time
  444.           ----dddd  nnnn sets recording time to _n seconds or set recording
  445.           time  for whole track if _n is zero. Please note that if
  446.           track ranges are being used they define  the  recording
  447.           time  as  well  thus overriding any ----dddd option specified
  448.           times.
  449.  
  450.           Recording time is defined as  the  time  the  generated
  451.           sample  will  play  (at the defined sample rate). Since
  452.           it's related to the amount of generated  samples,  it's
  453.           not  the time of the sampling process itself (which can
  454.           be less or more).  It's neither strictly  coupled  with
  455.           the  time  information  on  the audio CD (shown by your
  456.  
  457.  
  458.  
  459. SunOS 5.4                 Last change:                          4
  460.  
  461.  
  462.  
  463.  
  464.  
  465.  
  466. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  467.  
  468.  
  469.  
  470.           hifi CD player).  Differences can occur by the usage of
  471.           the   ----oooo option (see below). Notice that recording time
  472.           will be shortened, unless  enough  disk  space  exists.
  473.           Recording  can  be  aborted  at anytime by pressing the
  474.           break character (signal SIGQUIT).
  475.  
  476.      Record a complete audio CD in one go in different files
  477.           ----BBBB copies each track into a seperate file. A base  name
  478.           can  be given. File names have an appended track number
  479.           and an extension corresponding to the audio format.  To
  480.           record  all audio tracks of a CD, use a sufficient high
  481.           duration (i.e. -d99999).
  482.  
  483.      Set start sector offset
  484.           ----oooo _s_e_c_t_o_r_s increments start sector of the track by _s_e_c_-
  485.           _t_o_r_s.   By  this  option you are able to skip a certain
  486.           amount at the beginning of a  track  so  you  can  pick
  487.           exactly  the  part  you want. Each sector runs for 1/75
  488.           seconds, so you have very fine control. If your  offset
  489.           is  so  high  that  it  would  not fit into the current
  490.           track, a warning message is issued and  the  offset  is
  491.           ignored.   Recording  time  is  not  reduced.  (To skip
  492.           introductory quiet passages automagically, use the  ---- wwww
  493.           option see below.)
  494.  
  495.      Wait for signal option
  496.           ----wwww Turning on this option will suppress all silent out-
  497.           put  at startup, reducing possibly file size.  ccccddddddddaaaa2222wwwwaaaavvvv
  498.           will watch for any signal  in  the  output  signal  and
  499.           switches on writing to file.
  500.  
  501.      Find extrem samples
  502.           ----FFFF Turning on this option will display the  most  nega-
  503.           tive  and  the  most positive sample value found during
  504.           recording for both channels. This  can  be  useful  for
  505.           readjusting  the volume. The values shown are not reset
  506.           at track boundaries, they cover the  complete  sampling
  507.           process.  They  are taken from the original samples and
  508.           have the same format (i.e. they are independent of  the
  509.           selected output format).
  510.  
  511.      Find if input samples are in mono
  512.           ----GGGG If this option is  given,  input  samples  for  both
  513.           channels  will  be  compared. At the end of the program
  514.           the result is  printed.  Differences  in  the  channels
  515.           indicate stereo, otherwise when both channels are equal
  516.           it will indicate mono.
  517.  
  518.      Undo the pre-emphasis in the input samples
  519.           ----TTTT Some older audio CDs are recorded  with  a  modified
  520.           frequency  response  called pre-emphasis. This is found
  521.           mostly in classical recordings. The correction  can  be
  522.  
  523.  
  524.  
  525. SunOS 5.4                 Last change:                          5
  526.  
  527.  
  528.  
  529.  
  530.  
  531.  
  532. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  533.  
  534.  
  535.  
  536.           seen  in  the flags of the Table Of Contents often. But
  537.           there are recordings, that show this  setting  only  in
  538.           the  subchannels. If you know you have a pre-emphasized
  539.           recording and want cdda2wav to undo this, you  have  to
  540.           specify this option. A reverse filtering is done before
  541.           the samples are written into the audio file.
  542.  
  543.      Set audio format
  544.           ----OOOO  aaaauuuuddddiiiioooottttyyyyppppeeee can be _w_a_v (for wav files) or _a_u  or  _s_u_n
  545.           (for sun PCM files) or _c_d_r or _r_a_w (for headerless files
  546.           to be used for cd writers).  All file samples are coded
  547.           in  linear  pulse code modulation (as done in the audio
  548.           compact disc format). This holds for all audio formats.
  549.           Wav  files  are compatible to Wind*ws sound files, they
  550.           have lsb,msb byte order as being used on the audio  cd.
  551.           The  default  filename  extension  is '.wav'.  Sun type
  552.           files are not like  the  older  common  logarithmically
  553.           coded  .au files, but instead as mentioned above linear
  554.           PCM is used. The byte order is msb,lsb to  be  compati-
  555.           ble. The default filename extension is '.au'.  The AIFF
  556.           and the newer variant AIFC  from  the  Apple/SGI  world
  557.           store  their  samples in bigendian format (msb,lsb). In
  558.           AIFC no compression is used.  Finally the easiest 'for-
  559.           mat', the cdr aka raw format. It is done per default in
  560.           msb,lsb byte order to satisfy the order wanted by  most
  561.           cd  writers.  Since  there  is no header information in
  562.           this format, the sample parameters can only be  identi-
  563.           fied by playing the samples on a soundcard or similiar.
  564.           The default filename extension is '.cdr' or '.raw'.
  565.  
  566.      Select cdrom drive reading speed
  567.           ----SSSS  ssssppppeeeeeeeedddd allows to switch the cdrom drive to a certain
  568.           level  of  speed  in  order  to reduce read errors. The
  569.           actual speed factor can generally be  given  completely
  570.           freely,  since  there are often less settings than fac-
  571.           tors possible. Details depend very much  on  the  cdrom
  572.           drives.   An  argument  of  0  for example is often the
  573.           default speed of the drive, a value of 1 often  selects
  574.           single speed.
  575.  
  576.      Enable MD5 checksums
  577.           ----MMMM  ccccoooouuuunnnntttt enables  calculation  of  MD-5  checksum  for
  578.           'count'  bytes  from the beginning of a track. This was
  579.           introduced for quick comparisons of tracks.
  580.  
  581.      Do linear or overlapping reading of sectors
  582.           ----PPPP  sssseeeeccccttttoooorrrrssss sets the given number of sectors  for  ini-
  583.           tial  overlap sampling for jitter correction. Two cases
  584.           are to be distinguished. For nonzero values, some  sec-
  585.           tors are read twice to enable cdda2wav's jitter correc-
  586.           tion.  If an argument of zero is given, no overlap sam-
  587.           pling  will be used.  NNNNEEEEWWWWSSSS!!!! For nonzero overlap sectors
  588.  
  589.  
  590.  
  591. SunOS 5.4                 Last change:                          6
  592.  
  593.  
  594.  
  595.  
  596.  
  597.  
  598. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  599.  
  600.  
  601.  
  602.           cdda2wav dynamically adjusts the  setting  during  sam-
  603.           pling  (like  cdparanoia  does).   If  no  match can be
  604.           found, cdda2wav retries  the  read  with  an  increased
  605.           overlap.   If  the  amount  of jitter is lower than the
  606.           current overlapped samples, cdda2wav reduces the  over-
  607.           lap  setting, resulting in a higher reading speed.  The
  608.           argument given has to be lower than the total number of
  609.           sectors  per  request  (see option -_n below).  Cdda2wav
  610.           will check this setting and issues a error message oth-
  611.           erwise.   The  case of zero sectors is nice on low load
  612.           situations or errorfree (perfect) cdrom drives and per-
  613.           fect (not scratched) audio cds.
  614.  
  615.      Set the transfer size
  616.           ----nnnn  sssseeeeccccttttoooorrrrssss will set the transfer size to the specified
  617.           sectors per request.
  618.  
  619.      Set number of ring buffer elements
  620.           ----llll  bbbbuuuuffffffffeeeerrrrssss will allocate the specified number of  ring
  621.           buffer elements.
  622.  
  623.      Set endianess of input samples
  624.           ----CCCC  eeeennnnddddiiiiaaaannnneeeessssssss will override the default settings of the
  625.           input format.  Endianess can be set explicitly to "lit-
  626.           tle" or "big" or to the automatic  endianess  detection
  627.           based on voting with "guess".
  628.  
  629.      Set endianess of output samples
  630.           ----EEEE  eeeennnnddddiiiiaaaannnneeeessssssss (endianess can be "little" or "big") will
  631.           override the default settings of the output format.
  632.  
  633.      Verbose option
  634.           ----vvvv  lllleeeevvvveeeellll prints more information. A binary mask allows
  635.           selection of different information.
  636.  
  637.           0000 keeps quiet
  638.  
  639.           1111 displays the table of contents
  640.  
  641.           2222 displays a summary of recording parameters
  642.  
  643.           4444 invokes the index scanner and  displays  start  posi-
  644.           tions of indices
  645.  
  646.           8888 retrieves and displays a media catalog number
  647.  
  648.           11116666  retrieves  and  displays   international   standard
  649.           recording codes
  650.  
  651.           33332222 displays track start positions  in  absolute  sector
  652.           notation
  653.  
  654.  
  655.  
  656.  
  657. SunOS 5.4                 Last change:                          7
  658.  
  659.  
  660.  
  661.  
  662.  
  663.  
  664. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  665.  
  666.  
  667.  
  668.           To combine several requests just add  the  numbers  and
  669.           give the sum as argument.
  670.  
  671.      The table of contents
  672.           The display will show the table of contents with number
  673.           of tracks and total time (displayed in _m_m:_s_s._h_h format,
  674.           _m_m=minutes, _s_s=seconds, _h_h=rounded 1/100 seconds).  The
  675.           following list displays track number and track time for
  676.           each  entry.   The  summary  gives  a  line  per  track
  677.           describing the type of the track.
  678.  
  679.            ttttrrrraaaacccckkkk pppprrrreeeeeeeemmmmpppphhhhaaaassssiiiissss ccccooooppppyyyyppppeeeerrrrmmmmiiiitttttttteeeedddd ttttrrrraaaacccckkkkttttyyyyppppeeee cccchhhhaaaannnnssss
  680.  
  681.           The ttttrrrraaaacccckkkk column holds the track  number.   pppprrrreeeeeeeemmmmpppphhhhaaaassssiiiissss
  682.           shows  if  that  track has been given a non linear fre-
  683.           quency response.  NOTE: You can undo this  effect  with
  684.           the  ----TTTT option.  ccccooooppppyyyy----ppppeeeerrrrmmmmiiiitttttttteeeedddd indicates if this track
  685.           is allowed to copy.  ttttrrrraaaacccckkkkttttyyyyppppeeee can be data or audio. On
  686.           multimedia  CDs  (except hidden track CDs) both of them
  687.           should be  present.   cccchhhhaaaannnnnnnneeeellllssss  is  defined  for  audio
  688.           tracks only. There can be two or four channels.
  689.  
  690.      No file output
  691.           ----NNNN this debugging option  switches  off  writing  to  a
  692.           file.
  693.  
  694.      No infofile generation
  695.           ----HHHH this option switches off creation of  an  info  file
  696.           and a cddb file.
  697.  
  698.      Verbose SCSI logging
  699.           ----VVVV this option switches on logging  of  SCSI  commands.
  700.           This  will produce a lot of output, which is needed for
  701.           debugging purposes. The format is  the  same  as  being
  702.           used  with the cdrecord package from J÷rg Schilling.  I
  703.           will not describe it here.
  704.  
  705.      Quiet option
  706.           ----qqqq suppresses all screen output except error  messages.
  707.           Further  it avoids any sub q channel requests for posi-
  708.           tion reports in the recording display. That reduces cpu
  709.           time  resources  and  allows  feeding  a soundcard with
  710.           audio data on the fly.
  711.  
  712.      Just show information option
  713.           ----JJJJ does not write a file, it  only  prints  information
  714.           about  the  disc  (depending on the ----vvvv option). This is
  715.           just for information purposes.
  716.  
  717. HHHHIIIINNNNTTTTSSSS OOOONNNN UUUUSSSSAAAAGGGGEEEE
  718.      Don't create samples you cannot read. First check your  sam-
  719.      ple  player  software and sound card hardware. I experienced
  720.  
  721.  
  722.  
  723. SunOS 5.4                 Last change:                          8
  724.  
  725.  
  726.  
  727.  
  728.  
  729.  
  730. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  731.  
  732.  
  733.  
  734.      problems with very low sample rates (stereo <= 1575 Hz, mono
  735.      <=  3675  Hz)  when  trying  to  play them with standard WAV
  736.      players for sound blaster (maybe they are not legal  in  WWWWAAAAVVVV
  737.      format). Most CD-Writers insist on audio samples in a bigen-
  738.      dian format.  Now cdda2wav supports the ----EEEE  eeeennnnddddiiiiaaaannnneeeessssssss option
  739.      to control the endianess of the written samples.
  740.  
  741.      If your hardware is fast enough  to  run  cdda2wav  uninter-
  742.      rupted  and  your CD drive is one of the 'perfect' ones, you
  743.      will gain speed when switching all overlap sampling off with
  744.      the ----PPPP  0000 option. Further fine tuning can be done with the ----
  745.      nnnn  sssseeeeccccttttoooorrrrssss option. You can specify how much  sectors  should
  746.      be requested in one go.
  747.  
  748.      Cdda2wav supports ppppiiiippppeeeessss now. Use a filename  of   ----  to  let
  749.      cdda2wav output its samples to standard output.
  750.  
  751.      Conversion to other sound formats can be done using the  ssssooooxxxx
  752.      program  package  (although  the  use  of ssssooooxxxx ----xxxx to get byte
  753.      swaps should be no more necessary; see option ----EEEE  to  change
  754.      the output byteorder).
  755.  
  756.      If you really want to sample more than one track in  one  go
  757.      into different files, this is currently possible with the ----BBBB
  758.      option. When recording time exceeds the track  limit  a  new
  759.      file will be opened for the next track.
  760.  
  761. WWWWAAAARRRRNNNNIIIINNNNGGGG
  762.      IIIIMMMMPPPPOOOORRRRTTTTAAAANNNNTTTT:::: it is prohibited to sell  copies  of  copyrighted
  763.      material  by  noncopyright  holders. This program may not be
  764.      used to circumvent copyrights.
  765.  
  766. BBBBUUUUGGGGSSSS
  767.      A kernel bug (version < 1.1.20) prevented successful  opera-
  768.      tion of mode select commands.
  769.  
  770.      Performance may not be optimal on slower systems.
  771.  
  772.      The index scanner may give timeouts.
  773.  
  774.      The resampling (rate conversion code) uses polynomial inter-
  775.      polation, which is not optimal.
  776.  
  777.      Enhanced CD extra information gathering is incomplete due to
  778.      lack  of  documentation. Donations for purchase of a copy of
  779.      the Blue Book might help.
  780.  
  781.      CD Text extra information gathering  is  incomplete  due  to
  782.      lack  of  the  latest Red Book additions. Donations for pur-
  783.      chase of a copy of the Red Book are welcome.
  784.  
  785.      Cdda2wav should use threads.
  786.  
  787.  
  788.  
  789. SunOS 5.4                 Last change:                          9
  790.  
  791.  
  792.  
  793.  
  794.  
  795.  
  796. CDDA2WAV(1)               User Commands               CDDA2WAV(1)
  797.  
  798.  
  799.  
  800.      The paranoia code is currently disabled.
  801.  
  802.      When using jitter correction with ATAPI cdrom drives,  track
  803.      endings are not handled correctly.
  804.  
  805. AAAACCCCKKKKNNNNOOOOWWWWLLLLEEEEDDDDGGGGEEEEMMMMEEEENNNNTTTTSSSS
  806.      Thanks  goto   Project   MODE   (http://www.mode.net/)   and
  807.      Fraunhofer  Institut  f ⁿr integrierte Schaltungen (FhG-IIS)
  808.      (http://www.iis.fhg.de/) for financial support.   Rammi  has
  809.      helped  a lot with the debugging and showed a lot of stamina
  810.      when hearing 100 times the first 16  seconds  of  the  first
  811.      track  of  the  Krupps  CD.  Paranoia patches contributed by
  812.      Monty xiphmont@mit.edu.
  813.  
  814. AAAAUUUUTTTTHHHHOOOORRRR
  815.      Heiko Eissfeldt heiko@colossus.escape.de
  816.  
  817. DDDDAAAATTTTEEEE
  818.      25 Mar 1999
  819.  
  820.  
  821.  
  822.  
  823.  
  824.  
  825.  
  826.  
  827.  
  828.  
  829.  
  830.  
  831.  
  832.  
  833.  
  834.  
  835.  
  836.  
  837.  
  838.  
  839.  
  840.  
  841.  
  842.  
  843.  
  844.  
  845.  
  846.  
  847.  
  848.  
  849.  
  850.  
  851.  
  852.  
  853.  
  854.  
  855. SunOS 5.4                 Last change:                         10
  856.  
  857.  
  858.  
  859.