home *** CD-ROM | disk | FTP | other *** search
/ Groovy Bytes: Behind the Moon / groovybytes.iso / GROOVY / SND_TOOL / WM10.ZIP / DOC.DAT / midtolst.txt < prev    next >
Encoding:
Text File  |  1995-08-30  |  5.8 KB  |  112 lines
  1.  WM MIDtoLST
  2.  ───────────
  3.  
  4.  WM MIDtoLST reads a Standard MIDI file (Level 0 or Level 1) {WMMID} and 
  5.  creates a human-readable LST (WM playlist) file which may be viewed and
  6.  edited with any standard text editor before rendering with WM LSTtoWAV
  7.  {LSTtoWAV}.
  8.  
  9.  The instruments "played" by MIDtoLST/LSTtoWAV are described by the PRG files 
  10.  stored in WAVmaker's PRG\ subdirectory (an alternate directory, i.e. an 
  11.  alternate instrument bank, can be selected with the /PRG option). PRG 
  12.  filenames are just MIDI program numbers: when MIDtoLST encounters a MIDI 
  13.  program change event to (say) program number 37, it goes looking for the file 
  14.  37.PRG (or D37.PRG if the /d option {MIDtoLST 94} has been set for the 
  15.  track and channel containing the event in question). You can edit existing 
  16.  instruments and create new ones using PRGed {PRGed}. 
  17.  
  18.  PRG files map sample files to keys and contain performance parameters. Most
  19.  electronic musicians would probably refer to them as "patches". The actual 
  20.  sample files are kept in the WAV\ subdirectory.
  21.  
  22.  The default PRG and WAV library supplied with WAVmaker is General MIDI (GM)
  23.  compliant, i.e. the program (instrument) numbers and the keyboard maps used
  24.  for the drum kits (the assignment of samples to keys) follow the industry 
  25.  standard used by most computer music hardware and software (but see the Note
  26.  on drum channel assignments {MIDtoLST 94}). Most MIDI files which you are 
  27.  likely to encounter on the Internet or on BBSs are General MIDI (or Roland 
  28.  GS, a fairly compatible superset of General MIDI) so if you intend to modify 
  29.  the default library extensively, you should probably work on copies of the 
  30.  original files, and keep them in separate directories.
  31.  
  32.  
  33. ─── The LST file format ────────────────────────────────────────────────────────
  34.  
  35.  LST files are easy to read once you understand the format. 
  36.  
  37.  The first line is the max event time (often, the last Note Off event) in 
  38.  milliseconds. It is used by WM LSTtoWAV to create an empty WAV file of the 
  39.  specified duration prior to actual rendering. This way, (almost all) the 
  40.  necessary disk space is allocated right away, reducing the risk for out-of-
  41.  space errors occurring somewhere in midrun, especially if you are using a 
  42.  multitasking environment with other processes also using the disk (although 
  43.  the WAV file will often need to be extended later on, to accomodate a release 
  44.  section following the last Note Off event; if you are out of luck, that 
  45.  release section will be the proverbial straw...) and fatal errors will still 
  46.  leave you with something to listen to (everything rendered before their 
  47.  occurrence) without having WM LSTtoWAV constantly updating the WAV header for 
  48.  the current file length (a slow affair, due to long disk seek times). 
  49.  
  50.  The rest of the file is made up of one or more Sample Blocks delimited by 
  51.  curly brackets. 
  52.  
  53.  Each Sample Block is headed by a line listing the sample file name, the base 
  54.  key number, the base volume, the base panpot, and the various controller and 
  55.  envelope parameters specified in the PRG file, in the same order as in the
  56.  PRG file. 
  57.  
  58.  In the subsequent lines, there are one or more Note Blocks, one for each note 
  59.  produced using the current sample file (low notes are listed first). Note 
  60.  Blocks are delimited by square brackets.
  61.  
  62.  The first line in each Note Block is the note number. 
  63.  
  64.  The subsequent lines are time-ordered events, on the general format 
  65.  <event time in milliseconds> <event codes> <event parameter>. The event 
  66.  code/parameter combination should be one of the following:
  67.  
  68.                   ■ ON  <velocity>   (Note On)
  69.                   ■ OFF <velocity>   (Note Off)
  70.                   ■ PRS <pressure>   (Channel or Polyphonic Pressure)
  71.                   ■ MOD <modulation> (Modulation Wheel)
  72.                   ■ VOL <volume>     (Volume)
  73.                   ■ PAN <position>   (Stereo Panning)
  74.                   ■ EXP <expression> (Expression)
  75.                   ■ BND <bend>       (Pitch Bend)
  76.  
  77.  
  78. ─── WM MIDtoLST usage ──────────────────────────────────────────────────────────
  79.  
  80.  Usage:   MIDtoLST <source> [<destination>]
  81.  
  82.           If no <destination> is given, the <source> filename is used. The 
  83.           default extensions are MID and LST, respectively. The default 
  84.           directories are MID\ and LST\; you can override these choices with 
  85.           the /MID and /LST options. The default directory for PRGs is PRG\;
  86.           you can override this choice with the /PRG options.
  87.  
  88.  Options: /MID <alternate MID source directory>
  89.           /LST <alternate LST destination directory>
  90.           /PRG <alternate PRG instrument direcory>
  91.           /d   <track>:<channel> (use Drum PRGs for this track and channel)
  92.           /q   (quiet mode: no screen output)
  93.  
  94.  Note:    General MIDI and GS files use MIDI channel number 10 for drums. WM
  95.           MIDtoLST does not use ANY channel for drums unless instructed to do
  96.           so with the /drums option. If the file is Standard MIDI Level 0 (you
  97.           can use WM MIDscan to find out {MIDscan}), there is only one track, 
  98.           so "/d 1:10" will do. With Level 1 files, try "/d ALL:10": this 
  99.           instructs WM MIDtoLST to use drums for channel number 10, regardless 
  100.           of track number. The ALL keyword works for channels too, by the way. 
  101.           Writing "/d 1:ALL" would cause drums to be used for track number
  102.           1, regardless of channel number. 
  103.  
  104.           See {WMMID} if the difference between MIDI tracks and MIDI channels
  105.           is not clear to you!
  106.  
  107.  The following title:value pairs are written to WAVmaker's public Function key
  108.  file {FnKeys} upon successful termination:
  109.  
  110.                              File #1      : <source>
  111.                              File #2      : <destination>
  112.