batonSynthImprov Environment

---

This environment is virtually identical to the batonImprov environment, but adds extra MIDI input/output intended for connecting to another computer via MIDI for performance with another batonImprov or synthImprov program. Also may be used to have both radio baton-computer interaction as well as synthesizer keyboard-computer interaction.

User functions:

Identical to the batonImprov program.

Global variables

There are four primary global variables in the batonSynthImprov environment:

Synthesizer computer;

The MIDI I/O interface to another computer (or synthesizer).



RadioDrum baton;

The MIDI I/O interface to the radio drum.



MidiOutput synth;

The MIDI Output only interface to the synthesizer.



long t_time;

A timer that keeps track of the time in milliseconds (1/1000 of a second).

Shown below is a schematic of the device connections inteneded for the batonCompImprov environment. Note that the global objects synth, baton and computer descibed below represents a MIDI synthesizer/keyboard and radio drum as shown in the figure below.



The batonCompImprov environment can also be used with the computer object connected to the MIDI input/output of a synthesizer keyboard as shown in the figure below:



In addition to the three primary global variables, there are some other global variables which are identical to variables inside of the baton object: Baton state variables: The values below are integers in the range from 0 to 127 (7-bit MIDI data). The x-axis goes from left (0) to right (127). The y-axis goes from near (0) to far (127). The z-axis goes from low (127) to high (~0). Positions of the sticks are updated about 50 times per second. Triggers are updated when the sticks pass through the horizontal trigger plane.

position variables:

• short xt1 -- current x-axis position of stick 1. (baton.x1p)
• short yt1 -- current y-axis position of stick 1. (baton.y1p)
• short zt1 -- current z-axis position of stick 1. (baton.z1p)
  
  
• short xt2 -- current x-axis position of stick 2. (baton.x2p)
• short yt2 -- current y-axis position of stick 2. (baton.y2p)
• short zt2 -- current z-axis position of stick 2. (baton.z2p)
  
  
• short pt1 -- current position of potentiometer (dial) 1 (baton.d1p)
• short pt2 -- current position of potentiometer (dial) 2 (baton.d2p)
• short pt3 -- current position of potentiometer (dial) 3 (baton.d3p)
• short pt4 -- current position of potentiometer (dial) 4 (baton.d4p)





trigger variables:

• short wh1 -- whack velocity of stick 1 trigger (baton.w1t)
• short xw1 -- trigger x-axis position of stick 1 (baton.x1t)
• short yw1 -- trigger x-axis position of stick 1 (baton.y1t)
  
  
• short wh2 -- whack velocity of stick2 trigger (baton.w1t)
• short xw2 -- trigger x-axis position of stick 2 (baton.x1t)
• short yw2 -- trigger x-axis position of stick 2 (baton.y1t)

Program template:

The basic structure of a batonImprov program is shown below. You must: (1) include a particular interface (in this case the default console interface defined in the file "batonImprov.h", and (2) define the thirteen user functions (which can be defined as empty as shown below). See the batonSynthImprov examples directory for examples of what to put into the function definitions below.

          #include "batonSynthImprov.h"

          void description(void) { } 
          void initialization(void) { }
          void finishup(void) { }
          void mainloopalgorithms(void) { }
          void stick1trig(void) { }
          void stick2trig(void) { }
          void b14plustrig(void) { }
          void b15plustrig(void) { }
          void b14minusuptrig(void) { }
          void b14minusdowntrig(void) { }
          void b15minusuptrig(void) { }
          void b15minusdowntrig(void) { }
          void keyboardchar(int key) { }

Here is a template file which you can use to create a synthImprov program: batonSynthTemplate.cpp.

Default console interface for the batonImprov environment

The default console interface for the batonImprov environment can be loaded into the batonImprov program by adding the preprocessor line:

      #include "batonSynthImprov.h"

somewhere near the top of your batonImprov program. Described below are the basic commands defined in the console interface. Note that all commands are defines with characters which use the shift key. ch3> batonImprov console interface commands
• "?" print basic interface commands
• "A" baton alive test
• "B" toggle buf display (display of raw sensor measurements)
• "C" calibrate the radio drum with calibration file
• "D" print programmer's description of the program
• "E" toggle MIDI input error message printing
• "I" set MIDI input port for radio drum
• "L" set stick levels (sets the horizontal trigger plane height)
• "M" print more interface commands
• "N" set MIDI output port for synthesizer
• "O" set MIDI output port for radio drum
• "P" toggle position display
• "Q" quit program
• "R" toggle position reporting from radio drum
• "S" silence synthesizer
• "W" write calibration file
• "X" toggle MIDI in trace
• "Y" toggle MIDI out trace
• "Shift-1" center stick 1
• "Shift-2" center stick 2
• "Shift-3" increase z-axis sensitivity
• "Shift-4" decrease z-axis sensitivity
• "Shift-5" increase x-, y-axis sensitivity
• "Shift-6" decrease x-, y-axis sensitivity

---

craig@ccrma.stanford.edu