home *** CD-ROM | disk | FTP | other *** search
/ Club Amiga de Montreal - CAM / CAM_CD_1.iso / files / 112.lha / Director_Midi / readme < prev    next >
Text File  |  1986-11-20  |  2KB  |  62 lines
  1.  
  2.     Included is a freely distributable prototype of a replacement for 
  3.     the Director's sound module that provides MIDI note input.  It can 
  4.     be used to synchronize Director animations with external MIDI 
  5.     instruments, synthesizers, sequencers, etc.
  6.  
  7.     At present, you MUST leave the module named sound.mod, or the
  8.     Director will not be able to link with it.
  9.  
  10.     The new module runs all the original sound commands, and adds 
  11.     2 new commands:
  12.  
  13.         SOUND v,"midi",channel,sendoff
  14.         SOUND <variable>,<string>,<expr>,<expr>
  15.  
  16.     This command initializes the MIDI port, and signals what MIDI-channel
  17.     note on/off signals to pay attention to.  
  18.  
  19.     Variable 'v' is a status return variable and returns no specific 
  20.     information for this command.
  21.  
  22.     "midi" is the sound command.
  23.  
  24.     'channel' is the midi channel number that the module will pay attention
  25.     to.
  26.  
  27.     'sendoff' if a 1, will enable the recognition of both note-on and 
  28.     note-off commands, if a 0, only note-on commands will be recognized.
  29.     This allows you to mask out note-off commands if you only need simple
  30.     triggering based on note-on.
  31.  
  32.  
  33.         SOUND v,"wait"
  34.         SOUND <variable>,<string>
  35.  
  36.     This command will wait for the next note-on or note-off on the specified
  37.     channel.  All other MIDI commands will be ignored.
  38.  
  39.     Variable 'v' will return both the note and velocity information.
  40.     To extract this information, use the following computations:
  41.  
  42.         note = v%256
  43.         velocity = v/256
  44.  
  45.     If velocity is 0, then it is a note off command.
  46.  
  47.  
  48.     An accompanying script, 'miditest' is an example of the use of
  49.     these new MIDI features.  The .film file miditest.film can be
  50.     used with the release version of the projector (V1.2), even if
  51.     you don't have the Director.
  52.  
  53.     To use, run the miditest.film file with the projector or director.
  54.     When all disk activity stops, the program will then respond to
  55.     MIDI note-on/off commands on MIDI channel 1.  To change the
  56.     MIDI channel, edit the script 'miditest' to modify the sound
  57.     command as described above.  Make sure the Amiga sound is
  58.     connected, as there are accompanying effects.
  59.  
  60. Keith Doyle        2/27/88
  61.  
  62.