home *** CD-ROM | disk | FTP | other *** search
/ The Datafile PD-CD 4 / DATAFILE_PDCD4.iso / midi / _remidi / _help < prev    next >
Text File  |  1996-08-22  |  6KB  |  157 lines
  1.  
  2.  
  3.                 Manual for ReMIDI
  4.                 
  5.  
  6.             ReMIDI is (c) Michael-Dennis Biemans
  7.                 DataVox is (c) Philip Banks            
  8.           ReMIDI banner designed by Tim Wye (mendip@argonet.co.uk)
  9.  
  10.  
  11. ReMIDI can play General MIDI files, and it needs samples to do so.  The first
  12. thing you'll have to do is getting the sample-set, but you may already have
  13. it as ReMIDI uses the very same patches (the name for this sampleformat) as
  14. TiMidity. After that you must edit the !Path file to point to your patches:
  15. (but if you install the patches into the directories inside !ReMIDI, the
  16.  path is already set correctly)
  17.  
  18. example:
  19.  
  20. Set ReMIDIPatches$Path ADFS::HardDisc4.$.Music.patches.,ADFS::HardDisc4.$.Music.patches1.
  21.  
  22. Don't forget to add a . after each directoryname !  The !Path file is inside the
  23. !ReMIDI directory, hold down shift and double-click !ReMIDI.
  24.  
  25.  
  26. For 16 bit audio, I have made a soundhandler (based on code by Chris Poole) to replace 
  27. the Player module ESP.
  28.  
  29. For 8 bit audio a module called DataVox is used, which is written by 
  30. Philip Banks. Used with permission.
  31.  
  32.  
  33. Ok, now we should be able to play a MIDI file. The filetype is MIDI (&fd4).
  34. Double-click a file to start ! If you double-click more files they will be
  35. added to the playlist.
  36.  
  37.  
  38. *** Main window
  39.  
  40. The main window shows information about the MIDI file that is playing, 
  41. and also the lyrics of the file are displayed (if there are any). The
  42. optionbutton for realtime-text means that every time there is an update
  43. in the lyrics, there will be a wimp_poll so the display gets updated.
  44.  
  45. The controls speak for themselves, but wind and rewind don't work
  46. immediately because ReMIDI uses soundbuffers. When the next button is
  47. pressed the next file in the playlist is loaded.  
  48.  
  49. Via the menu an options-window, control-window and a playlist-window can be
  50. opened. Note that every change you make will take some time to take effect,
  51. because the output is buffered.
  52.  
  53.  
  54. *** Options-window
  55.  
  56. The options-window is divided in two parts, the options that can be changed
  57. when a file is playing, and options that can only be changed when there is
  58. no file playing. Pressing the "Use values now"-button will pass the new 
  59. values to ReMIDI. The options are:
  60.  
  61. - polyphony         : maximum number of simultaneous soundchannels.
  62.  
  63. - shift #bits       : only used in 8 bit mode, to fit the sound-output into 8 
  64.                       bits the values have to be shifted by a number of bits. 
  65.                       Setting this too low will cause the output to be 
  66.                       distorted, setting it too high will decrease the volume 
  67.                       of the output.
  68.                    
  69. - speed factor      : use this to increase or decrease the tempo.
  70.  
  71. - polling interval  : used to control multitasking. The lower the value, the 
  72.                       more wimp_polls are done.
  73.                       
  74. - filtering         : the output is filtered when the number is higher than 1,
  75.                       1 means no filtering.
  76.                       
  77. - interpolation     : when this is used the soundquality is better, but it costs
  78.                       more time to compute.
  79.                       
  80. - interpolation control: when the computer can't keep up and the interpolation is on,
  81.               then interpolation is turned off. When the computer catches up,
  82.               the interpolation is switched on again.
  83.                       
  84. - envelope emulation: the patch-format has some information on an attack-decay-sustain
  85.               envelope, I tried implementing it, but it adds more clicks in the
  86.               output. This may be done better in the future....
  87.                       
  88. - auto-play         : when the box is ticked, you don't have to press play to
  89.                       start the MIDI file.
  90.                       
  91. - auto-open playlist: when the box is ticked the playlist will be opened every
  92.                       time a new file is added to it. Otherwise you'll have to
  93.                       open it manually through the menu.
  94.                       
  95.                       
  96. - samplerate        : this is the output-samplerate in Hz.
  97.  
  98. - soundbuffer       : size of the soundbuffers.
  99.  
  100. - drumchannel       : the MIDI channel for drums.
  101.  
  102. - mono/stereo       : obvious :)
  103.  
  104. - direct audio/
  105.   to file           : when "to file" is selected, the output will be written to
  106.                       a file with the name set in the "outputfile" icon. The
  107.                       format is raw/unsigned.
  108.                       
  109. - 8/16 bit          : outputmode for direct audio and output to file.
  110.  
  111. - downsample        : when selected, samples that have a samplerate above the
  112.                       frequency specified will be halved in size (in memory only,
  113.                       not on disc). This will reduce the soundquality dramatically,
  114.                       so only use this when you don't have sufficient memory to play
  115.                       a certain MIDI file.
  116.  
  117. - rescale volumes   : when the patches are loaded the volumes are rescaled.
  118.  
  119. - filter samples    : pre-filter the patches when loaded. 
  120.                       (doesn't work properly yet)
  121.  
  122. - outputfile        : name for the outputfile.
  123.  
  124.  
  125. - save as default   : the optionsfile is written to disk.
  126.  
  127.  
  128.  
  129. *** Playlist
  130.  
  131. Very simple: it displays the files to be played. You can remove files by
  132. pressing the button.
  133.  
  134.  
  135.  
  136. *** Control
  137.  
  138. In this window you can see which patches are loaded in which MIDI channel,
  139. but you can't change them. The volume can be changed, and you can also 
  140. mute a channel or let a channel play solo.
  141.  
  142.  
  143.  
  144. --------------------------------------------------------------------------------
  145.  
  146. To obtain the full version of ReMIDI, please send a 5 pound note (or equivalent
  147. in your own currency, no cheques) to:
  148.  
  149. Michael-Dennis Biemans
  150. Willem Frisostraat 20
  151. 5616 BE Eindhoven
  152. The Netherlands
  153.  
  154. For 5UKP I can't do a snail-mail distribution, so if you want it and you don't 
  155. have e-mail, you'll have to ask a friend with an e-mail address, so I can send
  156. the program to him/her. 
  157.