home *** CD-ROM | disk | FTP | other *** search
/ Dream 52 / Amiga_Dream_52.iso / Amiga / Applications / Musique / PlayMF_VU.lha / PianoMeter / PianoMeter.Doc < prev    next >
Text File  |  1998-04-13  |  5KB  |  191 lines
  1.  
  2.            -----------------------------------------------------
  3.               PianoMeter - graphical MIDI note visualisation
  4.            -----------------------------------------------------
  5.  
  6.  
  7. This  is  a  little  eyecandy.  It will show MIDI notes on a virtual piano.
  8. You  can  separately  switch  on  and off the display of each MIDI channel.
  9. Furthermore  the  program will inform you about the activity on all 16 MIDI
  10. channels.
  11.  
  12. Piano  Meter  is now able to control the MIDI player "playmf" which is part
  13. of this software package.
  14.  
  15. The  program  is  (very  slightly)  based on the "vu" example from the CAMD
  16. developer package.
  17.  
  18.  
  19. Requirements
  20. ------------
  21.  
  22. * OS 3.0 or better.
  23.  
  24. * installed camd.library (available on Aminet)
  25.  
  26. * any MIDI software using CAMD (e.g. Deluxe Music II, playmf)
  27.   or an external MIDI interface for feeding MIDI notes.
  28.  
  29. * some free pens on your Workbench screen.
  30.  
  31.  
  32. Usage
  33. -----
  34.  
  35. The command can be started from shell or Workbench
  36.  
  37. The template for the shell command line is as follows
  38.  
  39. "LINK/K,OCT=OCTAVES/K/N,WINX/K/N,WINY/K/N,GM/S,GS/S,XG/S,MT32/S,NOHOOKS/S"
  40.  
  41. Description
  42.  
  43. * LINK/K  (Keyword)
  44.  
  45. The MIDI cluster to hook into.  Default is "out.0".  This will show you the
  46. notes  that  are  going  to any external MIDI hardware.  Ideal for use with
  47. playmf.
  48.  
  49. "in.0"  would  show  you  all  notes  that are coming from an external MIDI
  50. interface at your serial port.
  51.  
  52. * OCT=OCTAVES/K/N   (Keyword, numeric argument)
  53.  
  54. This  keyword  specifies  the  number  of  octaves  to show.  Minimum is 1.
  55. Maximum  is  11.  The center octave of the piano will always be note No #60
  56. which is c-3, I think.  The number of octaves will be reduced if the window
  57. would not fit on screen.
  58.  
  59. * WINX/K/N, WINY/K/N   (Keywords, numeric arguments)
  60.  
  61. The initial window position.
  62.  
  63. * GM/S, GS/S, XG/S, MT32/S   (switches)
  64.  
  65. these  correspond  to  the  same  switches  of PlayMF.  Please refer to the
  66. PlayMF documentation for more details.
  67.  
  68. * NH=NOHOOKS/S   (switch)
  69.  
  70. disables  the filetype recognition hooks in ASL filerequesters.  Will speed
  71. things  up  and  fixes  compatibility  problems with some ASL replacements.
  72. Make  sure to set this switch when using Mui-Asl (at least until the author
  73. fixes the problem).
  74.  
  75.  
  76.  
  77. Bugs
  78. ----
  79.  
  80. well, seems to work fine, except...
  81.  
  82. it can't make coffee.
  83.  
  84.  
  85. History
  86. -------
  87.  
  88. Release 1: initial release
  89.  
  90. Release 2: cdtv reported an enforcer hit (LONG write to 0).
  91.            This was caused by a GA_Previous tag during gadget
  92.            creation. I didn't know a NULL parameter is invalid.
  93.  
  94.            Implemented a simple Workbench interface. Can be
  95.            started from Icon now.
  96.  
  97.            Added WinX, WinY parameter
  98.  
  99.            Implemented window resizing and "intelligent" gadget
  100.            layout.
  101.  
  102.            Added Intuition menu strip
  103.  
  104.            Added CAMD cluster (link) selection requester
  105.  
  106. Release 3: added fireworks tool
  107.  
  108. Release 4: speeded up the BOOPSI classes (piano, channel LED)
  109.            when using Cybergraphics
  110.  
  111.            active MIDI cluster is now shown in window title.
  112.  
  113.            added menu option to release all notes. Useful when
  114.            notes are hanging after a buffer overrun.
  115.  
  116.            changing MIDI clusters will now flush all notes and
  117.            reset the keyboard.
  118.  
  119. bugfixed
  120. Release 4: fixed the piano display with Cybergraphics. Finally.
  121.  
  122. Release 5: no changes to this tool.
  123.  
  124. Release 6: no changes to this tool.
  125.  
  126. Release 7: dropped the name "vu". A piano has nothing in common
  127.            with a VU-Meter.
  128.  
  129.            technology transfer from Fireworks to PlayMF. Allows
  130.            asynchronous requester handling, saving of preferences,
  131.            Drag&Drop for MIDI files, and remote controlling PlayMF.
  132.  
  133.  
  134. Future
  135. ------
  136.  
  137. * tool type support.
  138.  
  139. * develop more BOOPSI classes for displaying MIDI information
  140.  
  141. * transform the GUI into a Betty GUI.
  142.  
  143. * implement the display of XG instrument and effect information
  144.  
  145. * use these BOOPSI classes for a MIDI datatype
  146.  
  147.  
  148. See Also
  149. --------
  150.  
  151. "playmf".   A Standard MIDI file player using the CAMD library.  Originally
  152. provided as an example by Commodore.  Now overhauled, bugfixed and improved
  153. by me.
  154.  
  155. "Fireworks"  from  this  distribution  -  a  thrilling MIDI fireworks tool.
  156. Makes your music explode. Amazingly fast with Picasso 96.
  157.  
  158. GMPlay  1.3 - available on Aminet.  Uses your CPU to play MIDI music.  Does
  159. not require any MIDI synthesizer, but lots of CPU power and RAM.
  160.  
  161.  
  162. Contact
  163. -------
  164.  
  165. for comments, bug reports and suggestions:
  166.  
  167. The author: Christian Buchner
  168.  
  169.             flowerp@eikon.e-technik.tu-muenchen.de
  170.  
  171.  
  172. Greetings
  173. ---------
  174.  
  175. Rafai Mantiuk - for the BCC precompiler that allows to programm
  176.                 MUI/BOOPSI classes with C++ syntax.
  177.  
  178. Tim Stack     - for his excellent Betty GUI system. This really
  179.                 deserves more public attention. My future application
  180.                 programs will be based on Betty. 
  181.                 see http://www.cs.utah.edu/~stack/betty/
  182.  
  183. CDTV (Tino    - for organizing the cool computer meetings in Erfurt
  184. Wildenhain)     and for testing PlayMF and PianoMeter and for his
  185.                 suggestions
  186.  
  187. Martin Gierich- for his midi.datatype which is based on the original
  188.                 "playmf" as well. However it is not reentrant and
  189.                 will crash when loading the second MIDI file.
  190.                 Hey, have a look at my playmf source code! ;-)
  191.