workbench/devs/AHI/Examples/Extras/CloneAudioModes/README

   1
   2 This is a small tool to create new mode files from an existing
   3 one. For audio drivers that can handle multiple boards, each board
   4 requires a mode file that defines the audio modes.
   5
   6
   7 *** NOTE! *** Not all audio drivers support multiple boards! *** NOTE! ***
   8
   9
  10 Usage: CloneAudioModes <Template mode file> <New mode file> [<Board number>]
  11
  12 If <Board number> is not specified, the board ID will just be increased
  13 by one in the new mode file.
  14
  15 Example: The mode file "DEVS:AudioModes/EMU10KX" defines the following
  16 modes for the SoundBlaster Live! sound card:
  17
  18  0x001E0001 "EMU10kx:HiFi 16 bit mono"
  19  0x001E0002 "EMU10kx:HiFi 16 bit stereo++"
  20  0x001E0003 "EMU10kx:16 bit mono"
  21  0x001E0004 "EMU10kx:16 bit stereo++"
  22
  23 To use a second SB Live! card, you must create a new mode file
  24 "DEVS:AudioModes", preferably called "EMU10KX-2":
  25
  26 1> CloneAudioModes DEVS:AudioModes/EMU10KX DEVS:AudioModes/EMU10KX-2
  27
  28 This will create the following modes:
  29
  30  0x001E1001 "EMU10kx-2:HiFi 16 bit mono"
  31  0x001E1002 "EMU10kx-2:HiFi 16 bit stereo++"
  32  0x001E1003 "EMU10kx-2:16 bit mono"
  33  0x001E1004 "EMU10kx-2:16 bit stereo++"
  34
  35 To create mode files for a third card, use either one of the following
  36 commands:
  37
  38 1> CloneAudioModes DEVS:AudioModes/EMU10KX-2 DEVS:AudioModes/EMU10KX-3
  39
  40 or
  41
  42 1> CloneAudioModes DEVS:AudioModes/EMU10KX DEVS:AudioModes/EMU10KX-3 3
  43
  44 When using more than one sound card, one might find it a bit annoying
  45 that the second sound card shows up before the first (because of the
  46 ASCII sort order) CloneAudioModes can be used to rename the modes in
  47 the original mode file to end in "-1":
  48
  49 1> CloneAudioModes DEVS:AudioModes/EMU10KX DEVS:AudioModes/EMU10KX-1 1
  50 1> Delete DEVS:AudioModes/EMU10KX