home *** CD-ROM | disk | FTP | other *** search
/ Audio 4.94 - Over 11,000 Files / audio-11000.iso / amiga / midi / mstuffpr.zoo / MIDIstuff / README < prev   
Text File  |  1990-08-26  |  7KB  |  161 lines
  1.     M    I    D    I    S    T    U    F    F
  2.     ~    ~    ~    ~    ~    ~    ~    ~    ~
  3.  
  4.     Release 1.0 - - - MIDIstuff part I - - - Date: 16 Aug 1990
  5.  
  6.         Ok, so this is my little MIDI tool package. It's the first
  7.              release, it's my first Amiga release anyway. :-)
  8.       Introducing: This package contains 4 little tools that use the
  9.       MIDI.library so that they can use MIDI at the same time and can
  10.                    easily be combined in a modular way.
  11.  
  12. MIDIkeys    V1.0    "Virtual MIDI Keyboard"
  13. ~~~~~~~~
  14.  Simulates a MIDI keyboard by painting a 10-octave (!) (full MIDI note range)
  15.  into a window, all incoming MIDI notes (kinda OMNI ON) are displayed by
  16.  highlighting the keys, the colours change depending on the velocity, when
  17.  the window is activated a piano keyboard is simulated on the Amiga keyboard
  18.  which is converted into outgoing MIDI events. Input and output streams are
  19.  by default sent to the MIDI interface.
  20.  
  21.     SYNOPSYS: [run] MIDIkeys [-i <Input>] [-o <Output>] [-t] [<Name>]
  22.     ~~~~~~~~
  23.  With the <i> and <o> options MIDI input & output streams can be redirected,
  24.  if a stream doesn't exist then the keyboard simply won't have it, e.g.
  25.  "MIDIkeys -i none" will cause MIDIkeys to not have any input to show.
  26.  The <t> enables an additional "thru" route between the input and output.
  27.  The <Name> is by default "Keyboard", it is the name used in the public MIDI
  28.  routing lists, you can use an other if you use more than one keyboard, the
  29.  new name will appear in the titlebar of the window.
  30.  
  31.  For other notifications the screen titlebar is used. MIDIkeys has a few
  32.  special keys: Right-Amiga-[`] toggles MIDI thru, also F10 does.
  33.  F2 and F1 respectively increment and decrement the channel the keyboard
  34.  sends on, which by default is 1.
  35.  And there also is a silly surprise key hidden somewhere...
  36.  
  37. MIDIdump    V1.0    "Simple MIDI SysX Dumper"
  38. ~~~~~~~~
  39.  Receives & Sends MIDI "System Exclusive" data, (sysx, patch data for
  40.  synthesizers etc.). Data can be stored and retrieved from DOS.
  41.  
  42.     SYNOPSYS: [run] MIDIdump
  43.     ~~~~~~~~
  44.  This tool always connects directly to the MIDI ports. It allocates 50000
  45.  bytes of buffer space for sysx data at startup. It opens a text window
  46.  and displays the list of commands, it uses the ARP FileRequester for
  47.  data storage. The program is self-explicatory (I hope!).
  48.  
  49. MIDIrec        V1.0    "Little MIDI Recorder"
  50. ~~~~~~~
  51.  Records or plays back note data from the musical instrument digital
  52.  interface (MIDI) using MIDI realtime information as timing clock.
  53.  Sequential music data can be stored and retrieved from DOS.
  54.  
  55.     SYNOPSYS: [run] MIDIrec [-i <Input>] [-o <Output>] [-t] [<Name>]
  56.     ~~~~~~~~
  57.  Arguments and options are identical to those of MIDIkeys, but, if a MIDI
  58.  socket doesn't exist the program complains.
  59.  
  60.  You'll be surprised when you run it, it has no "PLAY" or "STOP" keys,
  61.  in fact it expects START and STOP events to come from MIDI along with the
  62.  timing information, so the only key there needs to be is the "RECORD"
  63.  gadget which toggles recording and playback, when pressed it automatically
  64.  'rewinds' so that recording or playback can be started immediately without
  65.  even stopping the clock, unless you have a drum machine or sequencer
  66.  attached, which would get out of sync. When activating the "RECORD" gadget
  67.  the buffer is automatically deleted, no "tape merging" can be done!
  68.  A MIDI-start-event rewinds the tape too, so the "REWIND" gadget isn't
  69.  usually needed. For notifications the screen titlebar is used.
  70.  Further functions can be obtains by picking menu items or pressing the
  71.  equivalent keys. The functions and keys are:
  72.  
  73.     Load    (right-amiga-"l")    Choose a file to load.
  74.     Save As    (right-amiga-"s")    Choose a filename to save music to.
  75.     Re-Read    (right-amiga-"r")    Load that file again.
  76.     Write    (right-amiga-"w")    Save it again.
  77.     Help    (right-amiga-".")    Give info about "tape".
  78.     Thru    (right-amiga-"`")    Toggle the thru function.
  79.  
  80. MIDIclock    V1.0    "MIDI Clock Generator"
  81. ~~~~~~~~~
  82.  Should be a reliable source of MIDI realtime clock information, but it
  83.  isn't. I warn you, this program generates a lot of load, too. It is better
  84.  to avoid using it, rather have clock events come in from the real MIDI.
  85.  But if you have no other choice...
  86.  
  87.     SYNOPSYS: [run] MIDIclock [-o <Output>] [<Name>]
  88.     ~~~~~~~~
  89.  Redirect the output as usual, use <Name> if you want more then one
  90.  (bleargh!) MIDI clock in your system! (to generate MIDI coughs etc..)
  91.  
  92.  The MIDIclock is called by the timer.device 96 times per quarter note, it
  93.  then outputs a clock event to its MIDI port, which can be redirected
  94.  into the recorder or anywhere else. It has 3 buttons, START, STOP and
  95.  CONTINUE, which do what they're supposed to, a proportional gadget
  96.  changes the speed, which by default is set to 120 b/m.
  97.  
  98.      BUGS:    Amiga may halt when too much overhead is generated.
  99.      ~~~~
  100.  This happens all too easy, for example when doing lots of multi-tasking
  101.  like running a mouse accelerator or other load. It also can happen when
  102.  you use the speed gadget while the clock is running, so always stop it
  103.  when changing output speed, better not change it at all, it does strange
  104.  things sometimes! The MIDIclock has a little overhead detecting routine,
  105.  it will toggle the power-LED when overhead is detected. If the flashing
  106.  rapidly increases you better click the MIDIclock away and start a new one.
  107.  
  108. List of files the binaries package should include:
  109. ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~
  110. README
  111. MIDIclock        The executables
  112. MIDIdump
  113. MIDIkeys
  114. MIDIrec
  115. EXEC.ME            A script to run a typical configuration
  116.  
  117. Libs            The libraries used by the executables
  118. Libs/ARP.Library    I'm not sure if they are the latest releases.
  119. Libs/MIDI.Library    Put them in libs: if you don't have them.
  120.  
  121. SeQuences        Data files that can be played by MIDIrec.
  122. SeQuences/Bass & Tubes        [Lynx'86]        One channel, non-dynamic.
  123. SeQuences/Castagna Groove     [Lynx'89]        Dynamic, multi-channel.
  124.  
  125. SysX            Data files for MIDIdump
  126. SysX/CasioRequest.x    A sysx data dump request for Casio CZ synths.
  127.  
  128. COPYRIGHT NOTICE
  129.  The binaries package is placed into public domain, this also includes the
  130.  music files. Spread this data in whatever way you want, but leave my name
  131.  in it, please. The package is provided "as is". I don't guarantee the
  132.  functionality of any data provided with this package.
  133.  Source-code and binaries are in seperated packages, the source is available
  134.  but not in public domain, read the copyright notice provided with the
  135.  source package.
  136.  
  137.  Follow-up MIDIstuff packages may contain more efficient versions of
  138.  these programs, but also new MIDI modules like a MIDI-to-Amiga-Audio
  139.  interface, enhanced recording software like a MIDI sequencer, a
  140.  screen-sharing interface for all modules, REXX interfaces, etc...
  141.  
  142. CONCLUDING...
  143.  Hope this helps you MIDIaners out there, enjoy music, enjoy MIDIstuff! :-)
  144.  Btw, none of the executables can be made resident.
  145.  
  146. Material encouragements to:
  147.  
  148.     ~~~    Carl "Lynx" v. Loesch
  149.     $ $      Georgenstr. 142
  150.      v     D - 8 Muenchen 40
  151.     \_/           ~~~~~~~~        "West" Germany...
  152.  
  153. Virtual encouragements and suggestions to:
  154.  
  155.     loesch @ informatik.tu-muenchen.de
  156.         (valid till october'90 i hope)
  157.     lynx % suttner @ uniol.informatik.uni-oldenburg.de
  158.         (if the mailers manage to get through to this machine)
  159.     gebhart @ informatik.tu-muenchen.de
  160.         (if the above doesn't works; a dear friend of mine)
  161.