home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Amiga / Applications / Musique / CAMD_Toolkit.lha / SoftSynth / SoftSynth.doc < prev    next >
Text File  |  1998-04-18  |  7KB  |  242 lines
  1.  
  2.                   --------------------------------------
  3.                      SoftSynth - the future of GMPlay
  4.                   --------------------------------------
  5.  
  6.                >>> very early release: WORK IN PROGRESS! <<<
  7.  
  8.  
  9. This  type  of program is called a "software synthesizer".  It eats up your
  10. CPU power in order to produce MIDI music.
  11.  
  12. The CAMD interface makes this program a very versatile utility.  Use it for
  13. listening  to  MIDI  files (with PlayMF).  Use it as a cheap MIDI expander.
  14. Or  use  it  to  play  the  notes  from  Deluxe  Music II or any other CAMD
  15. compatible MIDI sequencer.
  16.  
  17.  
  18.  
  19. Requirements
  20. ------------
  21.  
  22. * currently OS 2.0 or better.
  23.  
  24. * a working GMPlay 1.3 installation
  25.  
  26. * installed camd.library (available on Aminet)
  27.  
  28. * any MIDI software using CAMD (e.g. Deluxe Music II, playmf)
  29.   or an external MIDI interface for feeding MIDI notes.
  30.  
  31. * perferrably a fast CPU (030 or better recommended)
  32.  
  33.  
  34.  
  35. The future of GMPlay?
  36. ---------------------
  37.  
  38. This  program  is  a  "child"  of  GMPlay.   All  of  you  who  expected an
  39. extraordinary   and   feature-loaded  GMPlay  1.4  release  might  be  very
  40. disappointed now.
  41.  
  42. But  let  me  tell  you:   This  program and future GMPlay releases will be
  43. developed  in  parallel  (the  synthesizer  engine  is  directly taken from
  44. GMPlay).
  45.  
  46. This  program  offers  a  better  opportunity  for testing and evolving the
  47. GMPlay synthesizer engine.  All of the enhancements made to the engine will
  48. quickly become a part of GMPlay.
  49.  
  50.  
  51.  
  52. Installation
  53. ------------
  54.  
  55. IMPORTANT: THIS PROGRAM REQUIRES A WORKING GMPLAY 1.3 INSTALLATION.
  56.  
  57. Place   the   updated   14bit.driver   in   your   GM:SoundDrivers   and/or
  58. DEVS:SoundDrivers  directory.  I may (or may not?) fix some replay problems
  59. with Piasso96 or Cybergfx boards.
  60.  
  61. If you are using Picasso96, set the environment variable
  62.  
  63. ENV:Picasso96/AmigaVideo
  64.  
  65. to "31kHz".  This will enable sampling rates up to 56kHz for 14 bit replay.
  66.  
  67.  
  68.  
  69. General Program Usage
  70. ---------------------
  71.  
  72. In the current state of development, this program is CLI-ONLY !
  73.  
  74. After  starting  the program, you will see a window showing piano keyboards
  75. for  all  16 MIDI channels.  This looks rather cheaply and was a very quick
  76. hack.  Expect this to change soon.
  77.  
  78. The  numbers  to  the  right  of the piano keyboards indicate the currently
  79. active programs (=instruments) for each channel.  Future SoftSynth versions
  80. will show the instrument names.
  81.  
  82. The  program  will use GMPlay's 14bit.driver for audio output.  There is no
  83. other driver available yet.
  84.  
  85. The  program  tries  to provide a pseudo-realtime response to MIDI signals.
  86. This  means  that  SoftSynth  must use an extremely small audio mix buffer.
  87. The  drawback  of  this method is that the CPU is easily "overloaded" which
  88. results in an interrupted audio stream.
  89.  
  90.  
  91.  
  92. CLI Usage
  93. ---------
  94.  
  95. The template for the shell command line is as follows
  96.  
  97. LINK/K,TONES/K,DRUMS/K,VOL=VOLUME/K/N,FREQ=FREQUENCY/K/N
  98. TICKS/K/N,POLY=POLYPHONY/K/N,PRI=PRIORITY/K/N,MONO/S
  99.  
  100. Description
  101.  
  102. * LINK/K  (Keyword)
  103.  
  104. The MIDI cluster to hook into.  Default is "out.0".
  105.  
  106. "in.0"  would  allow you to use your Amiga as a MIDI expander.
  107.  
  108. * TICKS/K/N
  109.  
  110. The  number  of  ticks indirectly defines the size of the audio mix buffer.
  111. In  order  to achieve a realtime MIDI response, the mix buffer must be very
  112. small.  A tick value of 1 means that SoftSynth will mix one second of audio
  113. before reacting to MIDI input.  The default value is 50.  So SoftSynth will
  114. react  to  MIDI  events every 1/50 second (=20 msec).  The maximum value is
  115. 100 ticks per second resulting in 10msec response time.
  116.  
  117.  
  118. All  the  other  options are compatible to GMPlay 1.3.  Please refer to the
  119. GMPlay 1.3 documentation.
  120.  
  121. Some  options (tone and drum filter etc) are still missing.  The ENV:GMOPTS
  122. option file is not used by this program.
  123.  
  124. The  only  difference  is  in the VOLUME option.  The maximum value is 1000
  125. (instead  of  500  for  GMPlay).  However when using values between 500 and
  126. 1000, you might get an overmodulated (distorted) audio signal.
  127.  
  128.  
  129.  
  130. General Tips
  131. ------------
  132.  
  133. Set  the  priority to 21 (PRI option).  So Intuition will not interrupt the
  134. program when moving windows, scrolling text etc.
  135.  
  136. If  your  CPU  is  too  slow,  increase the PRIORITY, reduce the FREQUENCY,
  137. enable  MONO  mode, reduce the number of TICKS or play MIDI files with less
  138. notes ;-)
  139.  
  140. If  a  different instrument (MIDI program) is selected, SoftSynth first has
  141. to  load  this  instrument.   If this happens within a MIDI file, the audio
  142. stream will be interrupted. The same applies for drums.
  143.  
  144. When  playing  one MIDI file for the second time, the instruments and drums
  145. are already loaded.
  146.  
  147. Better decompress all of GMPlay's instruments for faster loading.
  148.  
  149. XPack GM:Tones/#? ALL
  150. XPack GM:Drums/#? ALL
  151.  
  152. XPack  is  a  part  of the XPK user archive available from the internet URL
  153. http://www.amigaworld.com/support/xpk/ or from every Aminet mirror.
  154.  
  155.  
  156.  
  157. Limitations and Problems
  158. ------------------------
  159.  
  160. -  Directly  based  on  the GMPlay 1.3 synthesizer engine.  All limitations
  161. that apply to GMPlay 1.3 also apply here.
  162.  
  163. - this program has a very crude GUI.
  164.  
  165. - loading new instruments or drums will interrupt the audio stream.
  166.  
  167. - there is no AHI support yet.
  168.  
  169.  
  170.  
  171. Bugs
  172. ----
  173.  
  174. - nothing serious known yet.
  175.  
  176.  
  177.  
  178. History
  179. -------
  180.  
  181. Release 8: (of the CAMD_Toolkit package)
  182.  
  183.            initial release of SoftSynth.
  184.  
  185.  
  186.  
  187. Future
  188. ------
  189.  
  190. * improve the GUI
  191.  
  192. * make this program a Commodity
  193.  
  194. * add an option to flush unused instruments/drums
  195.  
  196. * add an option to preload all instruments/drums (only for
  197.   people with lots of RAM)
  198.  
  199. * adapt PlayMF to pre-select all MIDI instruments and drums
  200.   before playing the MIDI file (only if SoftSynth is running).
  201.   So SoftSynth can load all samples right _before_ playing.
  202.  
  203. * improve the synthesizer engine (all TODO options from the
  204.   GMPlay 1.3 documentation also apply here)
  205.  
  206.  
  207.  
  208. See Also
  209. --------
  210.  
  211. "playmf".   A Standard MIDI file player using the CAMD library.  Originally
  212. provided as an example by Commodore.  Now overhauled, bugfixed and improved
  213. by me.
  214.  
  215. PianoMeter  -  an  experimental  graphical note visualisation utility using
  216. BOOPSI  classes.   Try  it!   It  is  a real eyecandy ;-) Based on the "vu"
  217. example in the CAMD developer package.
  218.  
  219. "Fireworks"  from  this  distribution  -  a  thrilling MIDI fireworks tool.
  220. Makes your music explode. Amazingly fast with Picasso 96.
  221.  
  222. GMPlay  1.3 - available on Aminet.  Uses your CPU to play MIDI music.  Does
  223. not require any MIDI synthesizer, but lots of CPU power and RAM.
  224.  
  225.  
  226.  
  227. Contact
  228. -------
  229.  
  230. for comments, bug reports and suggestions:
  231.  
  232. The author: Christian Buchner
  233.  
  234.             flowerp@eikon.e-technik.tu-muenchen.de
  235.  
  236.  
  237. Greetings
  238. ---------
  239.  
  240. Alessandro  de  Luca  - for beginning the GMPlay project and passing me the
  241.                         source code. Thanks, man!
  242.