                        INCONTROL - MIDI Manager
                        ------------------------
            Version 1.0 (c) copyright 1991 J.S.Mclennan 5/91
                 written and compiled with GFA Basic 3.5

INcontrol is Freeware, it may be distributed freely provided no payment is 
charged and all the files are included unaltered.

INcontrol runs in medium and high resolution and on large screen monitors.

What is INcontrol?
------------------

INcontrol is a user-definable MIDI controller. It provides the user with 
20 sliders which can be programmed to control your MIDI instruments.

The possible applications included a mixer, which will allow you to 
control the volume of each of the 16 MIDI channels, or a basic synth 
editor.

INcontrol is especially useful for MIDI equipment with features that 
can only be accessed via MIDI, the Roland MT-32 for example.

Running INcontrol
-----------------

Incontrol can work as both a program and an accessory.

To run as a program INCONTRL.PRG must be in the same folder as 
INCONTRL.RSC and INC_COLR.RSC, the program is supplied this way, then 
simply double-click on the INCONTRL.PRG icon.

To run as an accessory copy the folder 'INCONTRL' containing the *.RSC 
and *.INC files to the root directory of your boot drive.
Now copy INCONTRL.PRG from the INCONTRL folder to the root directory and 
rename it INCONTRL.ACC.
Now reboot the computer and INcontrol should be available from the 'Desk' 
menu.

Running INcontrol brings up a dialog box containing 20 sliders, across the 
top is the close box, the 'menu', and the title of the current setup.

Clicking on the close box quits INcontrol, if you are running it as a 
program you will be asked to confirm this.

Clicking on the slider and holding the mouse button down will allow you to 
move the slider, the number in the slider will change but nothing will be 
output over MIDI as yet.

The Pulldown Menu
-----------------

Clicking and holding down the mouse on the 'Menu' in the top bar will pull 
down the menu. This pulldown menu works the same to the menus in Harlekin 
or on the Apple MacIntosh. To select an item keep the mouse button held 
down and move the pointer to the item you want then release the mouse 
button.

The Menu Items
--------------

Info - This brings up the program credits.

Load - Loads in an INcontrol file. Files have the extension '.INC', it 
      will warn you if you try to load an incompatible file.

Save - Saves the current setup as an INcontrol file. If you save a file 
      as DEFAULT.INC it will be automatically loaded whenever you run 
      INcontrol.

Edit - Allows you to edit the title and each of the sliders.

Send All - Sends all the current values of the silders over MIDI.

Quit - Quits INcontrol, same as the close box.


Editing
--------

Selecting the edit item from the menu brings up a dialog box.
At the top is the current title, simply retype to change it then click on 
the 'ok' button. Clicking the close box in the top left exits without 
changing the title.

The block of numbered boxes refer to the sliders, clicking on one of these 
takes you to the slider editing dialog.

At the top is the number (in hexadecimal) of the current slider, the block 
on the left contains the sliders name, the display range, the output 
range, and its mode of operation.

The display range refers to the range that the slider can move in, i.e. if 
the display range is 0 to 100 when you move the slider to the extreme left 
it will show 0 and when you move it to the extreme right it will show 100, 
and all the other values in between, i.e. it will show 50 when the slider 
is half way. The display range can be a maximum of -999 to +999.

The display range is purely for display and has no effect on the MIDI 
output, that is handled by the output range.

The output range works exactly the same except the values are output over 
MIDI as opposed to the screen. It output range can be a maximum of 0 to 
255.

The mode also controls the output. With the mode set to continuous, while 
the slider is being moved MIDI data is output, this may cause too much 
data which can upset some MIDI equipment. Release, on the other hand, will 
only send the MIDI data when you release the Mouse button.

You should move about the dialog using the up and down cursor keys, only 
pressing return when you have finished editing. Clicking on the close box 
will exit without making any changes.

The output string is the most complicated part. It is a list of what is 
output over MIDI each time you move the slider. To effectively programme 
it takes a good knowledge of MIDI, something I can't teach in the space 
of a READ.ME file, there are lots of articles about MIDI in ST magazines 
these days which will help you get the knowledge.

Each entry in the list is either a number (between 0 and 255), a variable, 
an equation, or a checksum.

Variables
---------
A variable is the output from a slider, and as there are 20 sliders there 
are 20 variables (numbered v00 to v14 as all numbers in the output list 
are in hexadecimal). Any of the 20 variables can be included in the list.

The syntax for a variable is:-

Vxx

Where xx is the number of the variable(in hexadecimal)


Equations
---------
An equation is a variable +,-,* or \ by a number or another variable.

The syntax for an equation is:-

Vxx+yy

Where xx is the variable number
      yy is a number between 0 - 255

or

Vxx+Vyy

Where xx is a variable number
      yy is another variable number


Checksums
---------
Checksums are used for error checking.
There are two types available:-
CK1 is the 7-bit sum format used by Yamaha
CK2 is the two's compliment format used by Roland

The syntax for a checksum is:-

CKx(yy,zz)

where x  is the type of checksum (1 or 2)
      yy is the list position from where the checksum starts
      zz is the list position where the checksum stops


When you have finished programming the output string click on the 'ok' 
button. If you have made a syntax error an alert box will appear and the 
cursor will be placed at the incorrect line.


Some preprogrammed files are included with INcontrol. Below is a 
description of their uses and operation.

MIXER.INC - 8 channel MIDI mixer
--------------------------------

This is a simple MIDI mixing desk with 8 volume faders and 8 panpots.
It uses MIDI controllers 7 and 10 and should work with almost any MIDI 
device that supports these. 

When the slider at the top left is 0 the faders and panpots control MIDI 
channels 1 to 8, when it is 1 they control MIDI channels 9-16. Giving you 
volume and pan control over all 16 MIDI channels.


R50_MIXR.INC - Kawai R-50 Mixer
-------------------------------

Similar to the MIDI mixer in operation, this uses system exclusive codes 
to control the volume and pan of all 24 instruments in the Kawai.
It only has 8 volume faders and panpots as in the MIDI mixer, to access 
all instruments use the 'Edit sound bank No.' slider.
i.e. when the 'Edit sound bank no.' is set to 1, 'volume BD1/BD2/BD3' 
controls the volume of BD1. When the 'Edit sound bank no.' is set to 3, 
'volume BD1/BD2/BD3' controls the volume of BD3.

The MIDI Channel slider should be set to the same channel as the MIDI 
system exclusive receive channel on the R-50. See page 36 of the owners 
manual.

When Manual pan is off the panpot sliders have no effect as the original 
PAD pan setting is used. See page 10 of the owners manual.

This file may work with the R-50e or R-100 but I havn't tested this.
If it doesn't then it should only need a simple adjustment.
The MIDI data format page in the owners manual should have section 
marked '2.2 Parameter Change', the sixth entry in the list of codes should 
be 'Machine id'. Read off this number and replace the sixth line in the 
output strings of sliders 5 to 20 and 2 with it.


MT32PERF.INC - MT-32 Performance Editor
---------------------------------------

This file is a good example of how INcontrol can access features only 
available over MIDI.

Only 'Reverb Mode' can be accessed from the front panel of an MT-32, this 
should really be called 'Reverb level' as that is what it adjusts.
INcontrol allows you to set the 'Reverb Mode' (0=Room, 1=Hall 2=Plate, 
3=Tap Delay), the 'Reverb Time' (0 to 7) and the 'Reverb Level' (0 to 7).

'Master Volume' (0 to 100) has the same effect as the 'master volume' on 
the MT-32.

'Master Tune' also has the same effect as on the MT-32.

'Edit part no.' and the other remaining sliders control the settings for 
each part.

Select which part you want to edit with the 'Edit part No.' slider.

'Output volume' (0 to 100) adjusts the part's volume.

'Panpot' (-7 to 7) adjusts the part's stereo position.

'Reverb switch' (0 or 1) controls whether the reverb affects that part.

'Timbre No.' (1 to 64) selects a sound form the current timbre group.

'Timbre group' (1=Group A, 2=Group B, 3=Memory, 4=Rhythm) sets the current 
timbre group.

'Assign mode' (1=Poly 1, 2=Poly 2, 3=Poly 3, 4=Poly 4) adjusts how the MT-
32 assigns polyphony for the part.

'Key shift' (-24 to 24) shifts the pitch in semitones.

'Fine tune' (-50 to 50) allows fine tuning of the part in cents.

'Bender Range' (0 to 24) sets the pitch bend range for the part.

More details on these controls can be found in the MT-32 owner's manual.


