Once you have chosen which device, channel and category you want, there will be a list of items you can set for that category of that device. Items that have already been set to something will have an asterisk beside them.
When you have clicked on something here, the right hand side will show what it is set to, so you can modify it, or show a blank form you can fill in. Make sure you click Apply before you choose another item in this list, or whatever changes you made will be lost.
The Format Box
The first thing on the right hand side is the Format box. You don’t have to change it. It is purely a matter of preference. For some MIDI items, and all non-MIDI items, the format box will be locked to a particular format.
The format box specifies what format you want to specify the value in. If you prefer to think of the MIDI value as being between 0 and 127 then choose that. If you prefer to think of the MIDI value as being between 0 and 1 then choose that. Or choose any other format. Whichever one you choose is going to be how you have to specify the value in the boxes underneath, unless you use the “Convert From Source Range” button. Even if you choose “Convert From Source Range”, you still need to use the format you choose in the “Limit Output to Range” box.
But whatever format you specify the value in, the computer will later convert it into the correct format for MIDI messages when it sends them.
The default format is 0..1, which means you specify everything as a fraction between 0 and 1. Like 0.75 for 75%.
If you never want to set the value to the maximum or minimum possible, but just want to adjust it within a certain range, then tick this “Limit Output To Range” check-box. When it is checked two more boxes appear specifying the maximum and minimum values (in whatever format you chose). So if you chose the format 0..1, but you don’t want the volume or whatever you are setting to go above 90%, check the box and put 0.9 in the maximum box. On the other hand, if you chose the format 0..127, then you need to put 114.3 in the box instead to stop it going over 90%. Note that decimals are allowed, and often necessary. The maximum and minimum values you choose here are what the source range will be converted to, if you choose “Convert From Source Range” below.
You don’t need to choose anything here, most of the time.
In the “Input Source” area, you need to choose where the input is going to come from, that you are using to control the output. Or you can choose a constant, or a mathematical expression that you want the output to be set to.
If you want to set it to a constant value, just type it into the “Part of device, or numeric value, or expression” box. Or choose a constant from the drop down box. If you want to set it to a string (text) value, then you need to put it in quotation marks. For example, file names need quotation marks around them. Then you just need to click “Apply”.
On the other hand, if you want to use a device to control the output, then choose which kind of device in the first drop-down box called “Input Device”. The “Remote” device only works on COM Port 2, and only if you enable it from the Troubleshooter menu, and only for a few remotes, like the one that comes with the Pinnacle PCTV card. The Screen and Window devices only return constant values, and aren’t much use in most cases. But the other input devices work for most occasions.
If you don’t want to use any of the devices in the list, just leave it blank, and type what value you want to set it to in the next box.
Once you have selected a device, the number box appears next to it. You normally leave it blank to just use the default device, but if you want to use a specific joystick, or a specific glove, or a specific mouse or keyboard, then choose the number here, starting from 1 being the first device of that kind. Sometimes there is a special 0 device for keyboards or mouses, which represents a virtual software device used for Remote Desktop in Windows XP Pro. MIDI device 0 is the MIDI Mapper, which you can set in Control Panel. But normal devices are numbered starting from 1, with 1 being the first device of that type.
Reading multiple mice and keyboards independently is currently only implemented on Windows XP (or possibly Vista, which isn’t tested). To use all the mice combined into 1 virtual mouse, like Windows normally does, just leave the number box blank. The same applies to keyboards.
Part of device, or numeric value, or expression
In this box will be a list of all the different parts or values that device supports. It may be a long list, and some of them make no sense to use, so choose wisely.
You can also type something in the box. For example, to use a glove gesture to control something, you should select “Glove” in the device box, and type in the five letter code in the “part of device” box, with one letter representing each finger like this:
In this case, x means don’t care (about the thumb), l (that’s the letter L) means the finger is straight (the index finger in this case), r means the finger is partly bent (the middle finger here) and n means the finger is very bent. The shape of the letter corresponds to its function.
Or if you leave the “device” box blank, you can type in any expression that GlovePIE understands in the “part of device” box.
For midi input, if you need to specify the channel, there is no box for it. So you need to add the channel to the front of this “part of device” box. Specify the channel like this: channel4.volume (where “volume” could be any part of the device).
Convert From Source Range
The “Convert From Source Range” box is used to convert the input device value from whatever range it uses (for example 0 to 63 for glove finger bends) into the correct values for your chosen format and output range. This box is automatically activated for some common device parts, but you can still turn it on or off manually if you want. When it is checked, two more boxes appear for the minimum and maximum. You should specify the minimum and maximum for the range in these boxes, using whatever units you choose in the “Units” box.
If you want the range to be backwards, for example because the screen and glove use opposite directions for “y”, then just swap the min and max values around. So that max is smaller than min.
Choose the units that you are using for the source value in the “Units” box. If there are no units for that particular value, then just leave it set to “Units”. The Units box is mostly used with the “Convert From Source Range” range, but it can also be used by itself to specify what units the value in the “part of device” box will use. Make sure you use appropriate units for the value you choose, for example speeds should be in meters per second or kilometres per hour rather than in something nonsensical for a speed, like degrees. Of course you can use degrees per second for angular velocities.