The "Interaction" window

Suppose that the project "-gr.koto3" 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" menu.)

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.