home *** CD-ROM | disk | FTP | other *** search
/ GEMini Atari / GEMini_Atari_CD-ROM_Walnut_Creek_December_1993.iso / files / music / stosmidi / midistos.doc < prev    next >
Text File  |  1985-11-19  |  7KB  |  282 lines
  1. **********************************
  2. *   -------- MIDISTOS --------   *
  3. *      STOS utility package      *
  4. *         By Russell Moll        *
  5. **********************************
  6.  
  7. **********************************
  8. * This package is SHAREWARE. If  *
  9. * you find this useful, please   *
  10. * send $10 to:                   *
  11. *                                *
  12. * Russell Moll                   *
  13. * 728 Meadowbrook Dr.            *
  14. * N. Tonawanda, NY 14120         *
  15. *                                *
  16. * This package represents months *
  17. * of time and effort.            *
  18. **********************************
  19.  
  20. **********************************
  21.            Installation
  22. **********************************
  23.  
  24. This package contains the following
  25. files:
  26.  
  27.     MIDI.BAS - Basic MIDI player
  28.                routines.
  29.  
  30.     MIDI.PRG - Assembly MIDI player
  31.                routines.
  32.  
  33.     MIDIPLAY.BAS - Example program
  34.                    using assembly
  35.                    routines.
  36.  
  37.     MUSIC2.ACB - STOS music accesory
  38.                  modified to read and
  39.                  play MIDI notes.
  40.  
  41.     Replace your current music
  42. accesory with MUSIC2.ACB. Use MIDI.PRG
  43. for optimum performance to play STOS
  44. music through the MIDI port. Use
  45. MIDI.BAS for the same thing if
  46. MIDI.PRG does not work for some
  47. reason. Run MIDIPLAY.BAS for an
  48. example of using MIDI.PRG.
  49.  
  50. *************************************
  51.         MIDI.PRG INSTRUCTIONS
  52. *************************************
  53.  
  54. 1. Load your basic program.
  55.  
  56. 2. Reserve a memory bank as data 5000
  57.    bytes large.
  58.  
  59. 3. Load the binary file MIDI.PRG into
  60.    the memory bank. Use BLOAD.
  61.  
  62. 4. Load in the music file (memory bank
  63.    3).
  64.  
  65. 5. At the start of the program
  66.    initialize:
  67.  
  68.       AREG(4)=START(3)
  69.       AREG(5)=START(x)+1924
  70.          where x is the bank MIDI.PRG
  71.          resides in.
  72.  
  73. 6. Before the music is played, Set:
  74.  
  75.       DREG(7)=MUSNUM
  76.          where MUSNUM is the music
  77.              number.
  78.       DREG(6)=P1
  79.          where P1 is the synth tone #
  80.              for channel 1.
  81.          Use -1 if the tone is
  82.              specified in the music.
  83.       DREG(5)=P2
  84.          where P2 is the synth tone #
  85.              for channel 2.
  86.          Use -1 if the tone is
  87.              specified in the music.
  88.       DREG(4)=P3
  89.          where P3 is the synth tone #
  90.              for channel 3.
  91.          Use -1 if the tone is
  92.               specified in the music.
  93.  
  94.       Note that the tone numbers start
  95.       at zero, MUSNUM starts at one.
  96.  
  97. 7. To start the music use:
  98.  
  99.       CALL START(x)
  100.          where x is the bank
  101.          containing MIDI.PRG
  102.  
  103. 8. You must use the following command
  104.    in a loop to continually play
  105.    music:
  106.  
  107.       CALL START(x)+530
  108.          where x is the bank
  109.          containing MIDI.PRG
  110.  
  111. 9. To end the music use:
  112.  
  113.       DREG(7)=0 : CALL START(x)
  114.          where x is the bank
  115.          containing MIDI.PRG
  116.  
  117.     Check out the file MIDIPLAY.BAS to
  118. see an example using this method.
  119.  
  120. **************************************
  121.          MIDI.BAS INSTRUCTIONS
  122. **************************************
  123.  
  124. 1. Merge the file MIDI.BAS into your
  125.    program.
  126.  
  127. 2. Set MUSNUM to the music number,
  128.        PA1 to the synth tone number
  129.                 of channel 1, or
  130.            to -1 if the tone is                        specified in the music
  131.        PA2 to the synth tone number
  132.                 of channel 2, or
  133.            to -1 if the tone is
  134.                 specified in the music
  135.        PA3 to the synth tone number
  136.                 of channel 3, or
  137.            to -1 if the tone is
  138.                 specified in the music
  139.  
  140. 3. To start the music:
  141.          GOSUB 60000
  142.  
  143. 4. To continually play the music, you
  144.    must have this in the main loop:
  145.          GOSUB 61000
  146.  
  147. 5. To end the music:
  148.          GOSUB 62000
  149.  
  150. **************************************
  151.        MUSIC2.ACB INSTRUCTIONS
  152. **************************************
  153.  
  154.     This is a modified version of the
  155.  music accessory that came with STOS.
  156.  Now it is much easier to enter music
  157.  with this accesory. You can enter
  158.  notes using your synth in one of
  159.  three input modes. Also, music can be
  160.  played back through the synth and
  161.  tones can be specified.
  162.  
  163. 1. Configuring the MIDI input:
  164.  
  165.     a) Under the TOOLS menu, select
  166.        "Setup MIDI".
  167.  
  168.     b) Left Click on the Input Mode
  169.        Bar to choose between the three
  170.        modes.
  171.  
  172.     c) Right click on the Tempo Bar to
  173.        increase the tempo (number of
  174.        quarter notes input in a
  175.        minute).
  176.  
  177.     d) Left click on the Tempo Bar to
  178.        decrease the tempo.
  179.  
  180.     e) Left or Right click on the
  181.        Resolution Bar to change the
  182.        resolution (smallest note that
  183.        can be input).
  184.  
  185.     f) Left Click OK to enter those
  186.        values, or CANCEL to exit.
  187.  
  188. 2. Playing in MANUAL mode:
  189.  
  190.     Try different keys on the synth
  191.  until you find the note you want.
  192.  Hold down the key for the desired
  193.  duration. When you have a note of the
  194.  desired frequency and duration, press
  195.  return to enter the note.
  196.  
  197.     Note that the C5 key (midi code
  198.  84, highest on the keyboard for the
  199.  CASIO MT240) will not return a note
  200.  in this mode, but is used for
  201.  entering rests.
  202.  
  203.     Hit any Tone key on the synth,
  204.  then return to change the tone.
  205.  
  206.     Hit Rhythm key 2 to transpose down
  207.  an octave, key 3 to transpose up an
  208.  octave then return to enter it (midi
  209.  codes 1, and 2).
  210.  
  211. 3. Playing in AUTO mode:
  212.  
  213.     This works the same as MANUAL mode
  214.  except that notes are entered
  215.  automatically, you don't have to hit
  216.  return.
  217.  
  218. 4. Playing in TIMED mode:
  219.  
  220.     This mode is used for real-time
  221.  playing. Hit Rhythm Key 1 (midi code
  222.  0), or any key on the synth keyboard
  223.  to start playing. While no keys are
  224.  being pressed, rests are entered in
  225.  this mode. It works almost like a
  226.  recorder.
  227.  
  228.     Hit Rhythm Key 1 (midi code 0) to
  229.  stop playing.
  230.  
  231.     Key C5 enters its note as normal.
  232.  
  233.     All other keys work the same as
  234.  the other modes.
  235.  
  236. 5. Playing Back the Music
  237.  
  238.     a) Choose PLAY or PUT AND PLAY as
  239.        normal from the menu.
  240.  
  241.     b) If the tones are not specified
  242.        in the music, then first hit a
  243.        number key corrosponding to the
  244.        channel (1,2, or 3). Then hit
  245.        two more digits corrosponding
  246.        to the two-digit tone number.
  247.        Do this for each channel.
  248.  
  249.     c) Hit M to start or stop the MIDI
  250.        music.
  251.  
  252.     d) All other keys work as normal.
  253.  
  254. **************************************
  255.         HARDWARE CONSIDERATIONS
  256. **************************************
  257.  
  258.     This package was developed using a
  259.  CASIO MT-240. This is a fairly
  260.  primitive synthesizer (although it
  261.  has high quality tone banks). I
  262.  cannot guarantee that all features
  263.  will work on all synths, however the
  264.  features implemented are basic enough
  265.  that there should not be any major
  266.  problems. Of course, none of the
  267.  features of more expensive synths are
  268.  implemented. Probably the most
  269.  problems you may have would be with
  270.  the keys used as input in the
  271.  MUSIC.ACB accesory. That is why I
  272.  have given the MIDI codes in the
  273.  documentation. If you do not have a
  274.  synth, I recommend the CASIO-MT240
  275.  for beginners, or computer hobbiests
  276.  like me. The sound quality is high
  277.  for many of the tones (some tones do
  278.  fade in the low range). It has a
  279.  great Piano tone. Also, it is
  280.  inexpensive (I saw one at a Hills for
  281.  $99).
  282.