User's Manual
Table Of Contents
- 1 Welcome
- 2 Quick Start
- 3 MIDI Setup Guide
- 4 Program Interface
- 5 MIDI Translator Concepts
- 6 The Project
- 7 The Preset
- 8 The Translator Entry
- 9 Actions
- 9.1 MIDI
- 9.2 Keystrokes
- 9.3 Timer
- 9.4 Preset Change
- 9.5 Disable/Enable Processing Actions
- 9.6 Mouse (Outgoing)
- 9.7 Execute File (Outgoing)
- 9.8 Serial Port
- 9.9 AppleScript
- 10 Rules and Variables
- 11 Settings
- 12 Behind the Scenes
- 13 Tips & Tricks
- 14 Usage Example
- 15 MIDI Translator in Hardware: the BomeBox
- 16 Reference
Bome MIDI Translator: User's Manual 10 Rules and Variables
Expression rules use basic arithmetic (plus:+,minus:-,multiply:*,divide:/,
modulo: %) or binary operators (AND:&,OR:|,XOR:^, shift right: >>, shift
left: <<) to enter a value into a variable. A variable is selected from a drop-
down box on the left side of the equation, while the two variables and/or
numbers and operator are selected on the right side of the equation.
Expression rules are useful for processing basic operators on incoming
values to, for example, increase them or decrease them parametrically.
Expression Operators:
+ plus
Add the left operand to the right operand. Example:
pp=10
g0=pp+110
g0 has the value 120.→
Note: variables use a signed 32-bit range, i.e. they wrap at
2147483647 and -2147483648.
- minus
Subtract the right operand from the left operand. Example:
pp=99
g0=pp-110
g0 has the value -11.→
Note: variables use a signed 32-bit range, i.e. they wrap at
2147483647 and -2147483648.
* multiply
Multiply the left operand with the right operand. Example:
pp=2 * 22
pp has the value 44.→
Note: variables use a signed 32-bit range, i.e. multiplying
where the result exceeds 2147483647 will cause a truncated
result.
/ divide
Divide the left operand by the right operand and truncate the
decimals. Example:
pp=10
qq=127 / pp
qq has the value 12→
Note: prevent a division by 0! (undefined)
% modulo
Calculate the remainder of the division of the left operand by
the right operand. Example:
pp=10
qq=104 % pp
qq has the value 4→
Note: prevent modulo 0! (undefined)
& bit-wise AND
Calculate the combination of the left operand's bits AND the
right operand's bits. A given bit is set in the result when it is
set in both the left and right operand. Example:
tt=0x98 & 15
tt has the value 8→
Note: variables and calculations use 32-bit signed integer
numbers.
(c) 2019 by Bome Software GmbH & Co. KG page 67