The
"Interaction" window
Suppose
that the project "-gr.koto
3"
has been loaded. Before playing the first item, BP2 loads interactive code
file "-in.abc1" that contains the actual information the project needs for
external control. The file is loaded just before the first item is played if
"Interactive (use input)" is checked on the "Settings" dialog.
File
"-in.abc1" appears as follows:
BP2
script
Note
convention = English
IN
Synchronize start ON-OFF F#4 channel 15 [toggle]
IN
Repeat 'v' times D5 channel 15
IN
End repeat G5 channel 15
IN
Repeat forever E5 channel 15
IN
Derive further A4 channel 15
IN
Reset weights B4 channel 15
IN
Quit F5 channel 15
IN
Use each substitution G#4 channel 15
IN
Set computation time to 'v' F4 channel 15
IN
Smooth-striated time E4 channel 15
IN
Use-ignore object constraints C#5 channel 15
IN
Skip next item D4 channel 15
IN
Play again item D#5 channel 15
IN
Min 10 ticks in 3 sec C6 max 20 ticks in 3 sec C7 channel 15
IN
Synchro tag W1 = C3 channel 15
IN
Synchro tag W2 = C#3 channel 15
IN
Synchro tag W7 = D3 channel 15
IN
Synchro tag W8 = D#3 channel 15
IN
Parameter K10 = velocity C8 channel 15
IN
Param K1 = controller #7 channel 15
IN
Param K2 = controller #17 channel 15
IN
Param K9 = controller #0 channel 15
This
file is actually a
script.
Instructions appearing in the "Interaction" window belong to the subset of
well-formed script instructions. (See the entire set in the "Script" men
u.)
The
order of instructions in the "Interaction" window is not relevant. The only
instructions that should appear on top are "BP2 script" and "Note convention =
..." indicating the convention used for interpreting the following
instructions. If another note convention is selected in the "Misc" menu, the
content of the "Interaction" window is automatically translated to the new
convention, and the second instruction is modified or created accordingly. In
this way, interactive files remain consistent with projects using different
note conventions.
The
compiler checks the consistency of instructions: if for instance the same key
or controller is assigned several tasks, an error message will be displayed.
New
instructions are entered by pulling down the "Script" menu when the
"Interaction" window is active. Slots may then be filled with the required
values. Remember that you can enter note names by hitting a key on the MIDI
keyboard once "Type from MIDI [toggle
]"
(cmd-j) is active. All instructions are documented on-line: type cmd-? and
pick an instruction in the "Script" menu.