MIDI/Peer control value fields use a text based system to determine their output values. It's worth reading this bit.
In general, modes can't be mixed but modifiers can. The order that modifiers are specified does not dictate the order in which they are processed. The order of processing for modifiers is: Range->AND->OR.
Mode | Token | Description | |||||||||||||||
No mode | N | Specifies that no value will be sent. Cannot be used in conjunction with any other modes. | |||||||||||||||
Velocity mode | V | Specifies that the value should be derived from the velocity used to trigger the event. Can be used in conjunction with both relative and range modes. If no range token is found, values will be generated from the target parameter's full value range. | |||||||||||||||
Inverse Velocity mode | VI or IV | Same as velocity mode but values are inverted so that a low velocity is treated as high and vice-versa. | |||||||||||||||
Random mode | R | Specifies that the value should be random. Can be used in conjunction with both relative and range modes. If no range token is found, values will be generated from the target parameter's full value range. 'R' will send the same random value to all tracks/channels. See Notes. | |||||||||||||||
Multi-Random mode | M or RM | Same as Random mode but sends a different random value to each track/channel. | |||||||||||||||
Note mode | ' | Allows entry of note and octave values eg. 'C#4. Enter 'O ('Off) for note-off and 'P ('Pass) to pass the triggering note as the value. Use + and - with 'P to transpose the value eg. 'P+12. You can also specify a range of notes to allow eg. 'P(C4-B6). For non-note parameters, the note value (as a percentage of the note range) will be mapped to a percentage of the parameter range. |
|||||||||||||||
Range modifier | : | Used in conjunction with the relative, random, velocity and note modes. Specifies that values should be constrained to within a given range. Can be used in two forms :20 (range is 0-20) or :10-20 (range is 10-20). | |||||||||||||||
Peer Only | |||||||||||||||||
Previous mode | P | Off-values only. Causes the parameter to be restored to the value it had before the Event was triggered. Cannot be used in conjunction with any other modes. Not available for parameters which are only visible in the pattern editor. | |||||||||||||||
Relative Add switch | + | Causes the value to be added to the parameter's current value until it reaches the upper limit of the current range. Not available for parameters which are only visible in the pattern editor. | |||||||||||||||
Relative Subtract switch | - | Causes the value to be subtracted from the parameter's current value until it reaches the lower limit of the current range. Not available for parameters which are only visible in the pattern editor. | |||||||||||||||
Relative Wrap switch | W | Used with the relative modes. Specifies that when the upper/lower boundary of the value range is reached, the value sequence will be resumed at the opposite end of the range. For example a value of +1W for a parameter with the value range 1-3 will result in the sequence 1, 2, 3, 1, 2, 3, 1 etc. | |||||||||||||||
Bitwise AND modifier | & | Can be used in conjunction with relative, random and velocity modes. Applies a bitwise AND mask to the value. Mask values are always in hexadecimal format. For example, the value R&0F will result in the mask 0x0F being applied to a randomly generated value. For more information on bitwise operations see wikipedia.org. If both AND and OR are present, AND is applied first. | |||||||||||||||
Bitwise OR modifier | | | Can be used in conjunction with relative, random and velocity modes. Applies a bitwise OR mask to the value. Mask values are always in hexadecimal format. For example, the value R|0100 will result in the mask 0x0100 being applied to a randomly generated value. For more information on bitwise operations see wikipedia.org. If both AND and OR are present, AND is applied first. | |||||||||||||||
Value Type specifiers |
|