                          MIDI MOUSE MUSIC
                          

                      A MIDI Performance Program
                          for the Atari ST

           Copyright 1994 - MEGASTAR SYNTHESISER COLLECTIVE
                            Version 1.1

         Program written and compiled in GFA Basic Version 3.5
                          by GARETH JONES


     This is a Public Domain program and you are free to copy and distribute
this program freely, provided that:-

   i) All the files included are retained, and not altered in any way.
   ii) The program is not sold for profit.

In the MMMUSIC folder you should find the following files-

               MMMUSIC.PRG - The main program
               MMMUSIC.TXT - This document

     To run this program you will need an Atari ST working in Medium or High
resolution mode, and a external MIDI sound module. Best results will be
obtained if the synthesiser, workstation, or drum-machine is multi-timbral.
However the program is perfectly happy to work with a smaller system, such as
a single channel synthesiser.



ABOUT MIDI MOUSE MUSIC

     Tired of playing the same old tunes on your keyboard ??  Fed up with
trying to get your fingers round that F#minor 7th sus 4 aug 13 chord ??
Fustrated with having to plough through dozens of windows and sub-windows just
to record a four note bass line on your sequencer ??  Do you remember when
music was fun, not a chore ?? - Then MIDI MOUSE MUSIC could be the program for
you!!!

     MIDI MOUSE MUSIC turns your humble computer mouse into a "powerful" MIDI
controller allowing you create music from the sweep of a hand. The program
allows you to perform music in five different ways:-


KEYBOARD mode. - Play notes by moving the mouse accross a virtual keyboard.

MATRIX mode - Here the screen is split into 20 divisions, horizontally and
vertically. Each division corresponds to the notes of two scales, one along
the x-axis and another along the y-axis. Each of these scales can have
different MIDI channels, transpositions etc., allowing the performance of
duets.

STRUM mode - Enables the user to "strum" chords in guitar fashion. The screen
is divided in 10 horizontal areas, corresponding to a set chord. Each area in
turn is divided into the ten notes of each chord. A chord is produced by
moving the mouse horizontally over an area. The chords are selected from the
PROG CHORD page which is called from the STRUM parameter display.

STAVE mode - Moving the mouse vertically across the screen will result the
playing of a C Major scale. The notes produced correspond to their positions
on the treble and bass clefs.

JOYSTICK mode - Simulates the action of joystick control over any ( 7-bit)
MIDI controllers. For example you could have filter-cutoff on one axis, and
volume on another.( see your instruments manual to see which controllers
correspond with which functions ).



GUIDE TO FUNCTIONS


      EXIT:Returns you to the desktop.

PROG SCALE:( MAJOR - DECEND MIN )
           Selects scales for X and Y-axises.

     VELOC:( 1 - 127 )
           This controls the velocity value of the MIDI notes generated.

      CHAN:( 0 - 16 )
           Sets the MIDI channel for each axes. The zero setting switches
           the axis off.

      TRAN:( C - B )
           Controls the transposition in semi-tones, of each axis.

    OCTAVE:( 0 - 6 )
           Controls the transposition in octaves, of each axis.

   SUSTAIN:( ON - OFF )
           Sustains notes after left-button is released, until button is
           pressed again.

     MOUSE:( 0 - 7 )
           Selects mouse type.

CONTROLLER:( 0 - 120 )
           Selects which MIDI 7-bit controller data is transmitted in JOYSTICK
           mode.

PROG CHORD:Produces the Program Chord page from the STRUM parameter display.





USING THE MOUSE

     All parameters can be altered using either the left or right mouse
buttons. To change a value just position the pointer over the corresponding
button and use the left button to raise ,the right to lower. With switches
a left-click swithes the parameter On, right OFF. This makes MIDI MOUSE
MUSIC a very easy program to operate.



GETTING STARTED

     First make sure that the MIDI OUT socket of you ST is connected to the
MIDI in socket of your sound generator. Then double-click on the MMMUSIC icon,
then after a few seconds the main screen appears on the monitor.
     Select the KEYBOARD option by left-clicking the appropiate box, and the
KEYBOAORD parameters should be displayed. Should you want to change one of
parameters such as MIDI chammel, then use the method outlined above in "Using
the Mouse". Once satisfied with the current parameter set, left-click the
KEYBOARD box.
     You should now see a five-octave keyboard on your monitor. Place your
mouse over one of the notes and left-click. The resulting note will sound for
as long as the left mouse button is held down. If you move the mouse along the
keyboard while the left button is still down, then a series of notes will be
sounded producing a glissando effect. Every time the mouse moves from one note
to another, or off the keyboard the last note selected will automatically be
silenced. To return to the parameter display, place the mouse over the
keyboard and right-click.
     Now left-click the SUSTAIN box to "ON" and try playing the keyboard now.
You find that the last note selected by the left button will sound unil a new
note is selected, regardless of the postion of the mouse.
     To return to the main screen right-click to get the parameter dislay
back, and left-click the EXIT box.
     All the modes work to the same principles as the KEYBOARD mode and should
not require any futher explaination. Now let's have some fun!!!!!



SCALE DATA

Notes relative to C as root of scale.

        MAJOR  C  D  E  F  G  A  B  ..... repeats at higher octaves.
        MINOR  C  D  D# F  G  A# B# .....
       DORIAN  C  D  D# F  G  A  A# .....
       ARABIC  C  D  E  F  G# A  B  .....
  PENTAPHONIC  C  D  E  G  A  .....
         BLUE  C  C# D  D# E  G  G# A  .....
      GAMELAN  C  E  F  G  B  .....
     JAPANESE  C  E  F  A  B  .....
    CHROMATIC  C  D  E  F# G# A# .....
    SEMI-TONE  C  C# D  D# E  F  F# G  G# A  A# B .....
 MAJ ARPEGGIO  C  E  G  ..... G  E  C
 MIN ARPEGGIO  C  D# G  ..... G  D# C
  MAJ 7TH ARP  C  E  G  B  ..... B  G  E  C
  MIN 7TH ARP  C  D# G  A# ..... A  G  D# C
      7TH ARP  C  E  G  A# ..... A# G  E  C
  MAJ 6TH ARP  C  E  G  A  ..... A  G  E  C
  MIN 6TH ARP  C  D# G  G# ..... G# G  D# C
  DIM 7TH ARP  C  D# F# A  ..... A  F# D# C
ASCENDING MIN  C  D  D# F  G  A  B  C  .....
DESCENDNG MIN  C  D  E  F  G  G# A# C  .....


CLOSING

     If you have any queries or comments about this program please don't
hesitate to write to me at the address below. Any donations, suggestions,
etc. would be gratefully accepted.

    10th October 1994
    Copyright Megastar Synthesiser Collective.

Write to :

                  Mr. G.W. Jones .
                  36 Tarn Drive ,
                  Creekmoor ,
                  Poole ,
                  Dorset ,
                  BH17 7DQ ,
                  Great Britain .


BYE  BYE  !


The Megastar Synthesiser Collective - "As good today, as they've always been."

DISCLAIMER- Mr G.W. Jones and the MEGASTAR SYNTHESISER COLLECTIVE take
            absolutely no responsibilty for any resultant damage to hardware,
            software, data, or state of mind of anyone running one of their
            programs.    "NOTHING TO DO WITH US GUV!"
