Events

TonesInTune events are inserted into a spreadsheet in order to define musical events. Each event marks a cell - the event cell - that is an anchor point for the musical event. The properties of the event are defined by the values in the event cell and cells below it in the same column (or, in case of Horizontal event-layout, adjacent cells to the right in the same row).

There are three classes of TonesInTune events, Note, Part, and Global events:

Note events define musical events on note level. Note events are played by parts as defined in the Setup dialog.

A note event has the following layout of properties:

  • Pitch: a numeric value in the event is interpreted as a frequency value (in Hz).
  • Time: the 1st cell below is interpreted as time of onset. Musical time is measured in terms of beats.
  • Duration: the 2nd cell is interpreted as duration. Musical time is measured in terms of beats.
  • Expression: the 3rd cell is interpreted as expression, e.g. MIDI velocity. Values between 0 and 1 are legal values (translated into MIDI velocity 0..127).
  • Part: the 4th cell determines which part should play the note event. Valid values are Part Numbers as defined in the Setup dialog.

Part events define musical events on a part level, ie. events that will influence all notes played by a particular part. A text string in the event cell is interpreted as its name. The property-layout for Part events depends on the name:

  • Name = "program" (~MIDI Program Change) or "bend" (~MIDI Pitch Bend):
    • Time: the 1st cell below is interpreted as time of onset. Musical time is measured in terms of beats.
    • Value: the 2nd cell contains the value of the event. For program events, the value is interpreted as MIDI program number (0..127). For bend events, values between 0 and 1 are translated into MIDI values 0..127.
    • Part: the 3rd cell determines the part as defined in the Setup dialog.
  • Name = "control" (~MIDI Control Change):
    • Time: the 1st cell below is interpreted as time of onset. Musical time is measured in terms of beats.
    • Control: the 2nd cell contains the MIDI control number, e.g. 7 for Volume Control.
    • Value: the 3rd cell contains the value of the event. Values between 0 and 1 are translated into MIDI values 0..127.
    • Part: the 4th cell determines the part as defined in the Setup dialog.

Global events define musical events that affect all parts.

A global event has the following layout of properties:

  • Name: a text string in the event is interpreted as the name of the event, e.g. "tempo" signifies a tempo change.
  • Time: the 1st cell below is interpreted as time of onset. Musical time is measured in terms of beats.
  • Value: the 2nd cell contains the value of the event; if the event is a tempo event then the value is interpreted in beats-per-minute (BPM).