home *** CD-ROM | disk | FTP | other *** search
/ Millennium Time Capsule / AC2000.BIN / disks / ac5_disk / mtools / mtools_v.120 / mtools.txt < prev   
Text File  |  1999-01-01  |  11KB  |  263 lines
  1. ===========================================================================
  2. MTools v1.20 - Unregistered Version - By Mark Wherry (c)1997
  3. ===========================================================================
  4.  
  5.  
  6. Welcome to MTools!
  7. ------------------
  8. MTools is a realtime MIDI harmonisation program, meaning that you can play 
  9. a note on your MIDI keyboard, and MTools will harmonise on what you've 
  10. played immediately, in real time, and non-modally!  So you can play a one 
  11. note melody, and it could sound as if you are playing the keyboard with 
  12. both hands!  This is just the tip of the ice-berg as to what is possible. 
  13.  
  14.  
  15. Requirements
  16. ------------
  17. In order to run this program you will need:
  18.  
  19.     * An Atari compatible operating system capable of sending MIDI
  20.     data.  (MTools is fully compatible with NVDI, Freedom...)
  21.     (MTools has been fully tested on TOS 1.2, 1.6 and MagiC5, if you
  22.     want to become a beta-tester for another configuration, please
  23.     contact me.)  If you are running MTools will a multi-tasking
  24.     operating system, eg. MagiC5, on an unaccelerated ST, you will
  25.     get a slightly smoother ride if you run it in single-tasking
  26.     mode.  
  27.     
  28.     * A MIDI input device (eg. a keyboard) capable of transmitting
  29.     on MIDI channel 1.  MTools will only receive data on channel 1.
  30.     However, this is channel 99% of MIDI devices default to.
  31.     
  32.     * A MIDI sound source.  The input and output device can be the 
  33.     same, eg. a keyboard with MIDI in and out.  However, if they are
  34.     the same, you will need to set local mode 'off'.  Otherwise the 
  35.     keyboard note will sound as well as the output from the computer.  
  36.     If you don't think this will cause a problem, try the the transpose
  37.     feature.....things get a bit messy, don't they?!
  38.     
  39.  
  40. What can MTools do?
  41. -------------------
  42.  
  43.     * Harmonise on a note played.  This only works monophonically,
  44.     ie. YOU can only play one note at a time.  There would be no
  45.     point in you playing more than one note, as the computer is
  46.     going to do this for you!
  47.     v1.20 addendum: It is now possible to play as many input notes as
  48.     you like.  However, the more you play, the slower things get.  This
  49.     facility has been implemented so you can slur notes, without having
  50.     to worry about monophonic restrictions.  It is advised you keep to a
  51.     MAXIMUM of TWO NOTES when playing animated harmonies.
  52.     
  53.     * There is a selection of availiable harmonies.  Some are even
  54.     velocity sensitive, for example, if you play the note at one
  55.     strength you will here a chord, if you play it harder you could
  56.     hear the seventh as well.
  57.     
  58.     * In addition, there are now animated harmonies.  These are 
  59.     settings that will vary everytime you play a note.  The setting
  60.     provided in this unregistered version changes the position of 
  61.     the melody note in the harmony everytime you play.  These work 
  62.     better when different harmony notes play on different channels, 
  63.     eg, different sounds.
  64.     
  65.     * You can play in any key.
  66.     
  67.     * You can transpose from any key.  For example, you play in C,
  68.     but it sound as if you're playing in D.
  69.     
  70.     * There is a selection of availiable scales, eg. major and minors.
  71.     
  72.     * Each user/harmony note can be output to a different MIDI 
  73.     channel.  This means your one note melody can be harmonised by
  74.     a string quartet, a folk band or even a heavy metal rockers!
  75.     
  76.     * You can define the velocity edge for the main/user note, so the
  77.     tune can play louder than the harmony.
  78.     
  79.     * You can define the point at which the velocity split occurs.
  80.     
  81.     * There are a number of presets which can store combinations 
  82.     of all the above paramters!
  83.     
  84.     * Whats more, all this happens without delaying another programs
  85.     you might have running. 
  86.     
  87.  
  88. Shareware.....
  89. --------------
  90. MTools is shareware, meaning if you like the program and use it regularly,
  91. you must register your copy with me.  To provide an incentive for you to 
  92. register I have applied the following limitations:
  93.  
  94.     * There are only five harmonies, two of them are velocity 
  95.     sensitive and one is animated.  In the registered version there 
  96.     are over 50 harmonies with many velocity sensitive and aniamted 
  97.     settings.
  98.     
  99.     * There are only three scales.  In the registered version,
  100.     there are over 30 scales.
  101.     
  102.     * There are only ten presets.  In the registered version there
  103.     are 80 and they are automatically loaded and saved for you.
  104.     
  105. If you register you also get:
  106.     
  107.     * A proper printed manual.
  108.     
  109.     * A master disk.
  110.     
  111.     * On-line ST-Guide context-sensitive help.
  112.     
  113.     * Free minor upgrades, and cheap major upgrades.
  114.     
  115. The registration price is set at £10 including P+P and all of the above.
  116.  
  117. Send software, registrations, letters, encouragement, criticism, requests
  118. to become a beta-tester to:
  119.         Mark Wherry,
  120.         4 Fernpark Close,
  121.         Topsham Road,
  122.         Exeter,
  123.         Devon,
  124.         EX2 6AW
  125.     
  126.     
  127. Legal
  128. -----
  129. I'm sorry, I hate doing this, but all programs seem to have these 
  130. nowadays, so...
  131.  
  132. DISCLAIMER:  The author of this program, or anyone who distributes it are 
  133. in no way responsible for any damage, or loss of data caused from your use
  134. of this program.  The user uses this program entirely at their own risk.
  135.  
  136. It really isn't that bad :-)
  137.  
  138. Apart from Thomas Much's excellent BubbleGEM distribution, all files are
  139. the copyright of Mark Wherry.  They must NOT be modified under any
  140. circumstance.  However, feel free to distribute this Freeware version as
  141. much as you like, put it on CD-ROMS, magazines, hell- why not deliver it
  142. through letter boxes!
  143.     
  144.  
  145. Operation
  146. ---------
  147. The program is fairly easy to operate, but if you want full instructions, 
  148. you'll have to register!  
  149. BubbleGEM has been implemented in this version, so if you're really stuck,
  150. or want a helpful hint, click LMB in a value box, and a relevant piece
  151. of information will appear before your very eyes.  Move the mouse, or RMB
  152. and the bubble will disappear.
  153. BubbleGEM has been included in the 'full' distribution of MTools. To 
  154. install it, just drag BUBBLE.APP into your MagiC START foler (or similar).
  155. Don't be afraid of the German!    
  156.  
  157. As a guide, when you move the mouse over an area that can be clicked on 
  158. to change a parameter, the shape will change from an arrow to a pointy 
  159. hand.  If you click the left mouse button, the value will be increased by 
  160. one, and if you click the right mouse button, the value will be decreased 
  161. by one.  If you click either mouse button to edit the current scale or
  162. harmony, a dialog box will appear at the mouse position offering a list
  163. of possible options.  Simply click LMB to select one, and the dialog box 
  164. will automatically disappear.
  165.  
  166. When you first run the program, (or if you top the window when switching
  167. applications in a multi-tasking environment) MTools automatically 
  168. defaults to an 'off' status.  This is so the internal MIDI buffer can be
  169. drained, in case you played the keyboard whilst MTools wasn't active.
  170. To switch MTools 'on', click on the 'off' word and it will turn to 'on', 
  171. and another click will turn it to 'thru' mode.  'Thru' mode is a simple
  172. MIDI thru function, ie. the input will not be harmonised, whereas 'on' is
  173. fully blown harmonising!
  174.  
  175. 'Key' sets the key you will play in.  Obviously, for intelligent harmony,
  176. this must be set correctly.
  177.  
  178. 'Transpose' allows you to play in one key, but it sounds as if you are
  179. playing in another. eg. Playing in C with transpose +2, will sound in D!
  180.  
  181. 'Scale' sets the scale you will play in.  If you play a note, not featured
  182. in the scale (ie. a wrong note!! (see bottom of text)), there will be no
  183. harmonisation.
  184.  
  185. To alter which notes are sent to which MIDI channels, click on the 'SET'
  186. button, and the window will be extended, revealing more functions.  The
  187. harmony note assignments are as follows:
  188.     1. The melody note, ie. the note you played.
  189.     2. First harmony note.
  190.     3. Second harmony note.
  191.     4. Third harmony note. (The added seventh, where needed)
  192.     5. Not used.
  193.     6. Always the bass note.
  194.     
  195. Note: If MIDI channel 0 is selected, the harmony note selected will not
  196. be played.  
  197.     
  198. The velocity edge, is the 'edge' the main melody note has over the 
  199. harmonising.  The greater this value, the quieter the harmony.
  200.  
  201. The velocity split point is the division line set between the two types of
  202. harmony available on a special harmony setting.  If you play a note with 
  203. velocity of the given value or higher, one type will be played (ie. 
  204. added sevenths).  If you play a note with a lower velocity, another type 
  205. will be played (ie. no sevenths).  If the harmony is velocity sensitive, 
  206. the name will start with: '(v)'.
  207.  
  208. Another click on 'SET' will shrink the window back to the normal size. 
  209.  
  210. Note: The presets store ALL settings automatically.  To see what I mean,
  211. change some settings and try switching to preset 2, then switching back to 
  212. preset 1.  Useful, isn't it?!
  213.  
  214.  
  215. History
  216. -------
  217. v1.00b: The original idea realised.
  218.  
  219. v1.01 (24/2/97): -Bugfix: It wouldn't work under TOS :-(.
  220.                   As a consequence, there are now two seperate 
  221.                   versions for TOS and MagiC5.
  222.                   
  223. v1.10 (10/2/97): -Universal version, works under both Magic5 and TOS :-).
  224.                  -Iconification added, ON/OFF/THRU switch availiable on 
  225.                   iconified window :-)).
  226.                  -AP_TERM support added :-))).
  227.                  -Grow/Shrink boxes implemented (For Stewart users!) :-)))).
  228.                  -Support for Thomas Much's BubbleGEM.  Click LMB in the
  229.                   box which holds a value, and if BubbleGEM is installed
  230.                   (multi-tasking ONLY) a handy piece of relevant information
  231.                   will appear. :-))))). 
  232.                  -BubbleGEM added to full distribution of MTools. :-)))))).
  233.                   (Just incase!!)
  234.                   
  235. v1.20 (27/3/97): -Loading picture dialog added.
  236.                  -Scale and harmony selection is now in dialog box 
  237.                   (called by either mouse button).
  238.                  -Dialogs appear at the position of the mouse.
  239.                  -Improved redraw handling.
  240.                  -Animated harmonies added
  241.                  -Harmony notes can be turned off, via a setting of 
  242.                   MIDI channel 0.                       
  243.                  -Rewrite of MIDI input handling.  More than one note at
  244.                   once is now possible and things are generally smoother.
  245.                   To acheive this, about 5% of the speed has been
  246.                   sacrificed.  Tell me what you think!
  247.  
  248.  
  249. Bottom Of Text
  250. --------------
  251. WRONG NOTES: It must be understood that this is a relative term, and 
  252. applies only to those examples performed by somebody else!
  253.  
  254. See you soon, hope to receive your registration even sooner!
  255.  
  256. Enjoy MTools, I have/do.  
  257.  
  258. Remember to experiment, especially with different sounds...
  259.  
  260.  
  261. Mark Wherry, Sunday 30th March 1997 at 11:56pm!  (I'm a fool!) 
  262. (v1.10, Monday 10th March 1997 at 8:25pm.) 
  263. (v1.01, Monday 24th February 1997 at 9:45pm.)