Documentation Wiki rss-feed

Arranger


Name

Arranger:

image:arranger_expanded.png

747
arranger

Description

The Arranger is EigenD's step sequencer. Belcanto commands are assigned to each course of the Arranger (much like a Talker). This allows the user to schedule much more than the playback of musical notes - for example scale and key changes, tempo changes, time signature changes, recorded take playback and drum loop playback.

The following terms will be used when describing the Arranger Agent:

  • Arrange Grid: a virtual grid of 'musical' time (i.e. the definition of the division and size of this grid depend on an arbitrary pulse of a certain speed, given by EigenD's Metronome Agent) on which events can be scheduled by the Arranger Agent.
  • Event: - a predefined Belcanto phrase on the Arranger.
  • Mode Keys: - the keys which control the Arranger's behaviour
  • Active Window: - an of the Eigenharp keyboard which act as a physical view point onto the virtual arrange grid defined by the geometry of the upstream Keygroup.

The Arranger Agent is accessed and controlled via an area of keys (normally for ease 'grid-like' in its orientation) on the Eigenharp called the active window. This area of keys and the LED feedback associated with the Arranger give you a physical visual representation of the arrange grid.

The arrange window can be thought of as a grid with two axes, 'rows' and 'columns'. Assuming a 'standard arrangement' of the upstream Keygroup (i.e. one in which the keys in each course are sequential, and the courses are sequentially defined), the along-course axis ('column') represents a predefined division (in beats or fractions thereof) of musical time; the across-course axis ('row') represents a predefined Belcanto phrase (hereafter described as an 'event').

The Arranger's arrange window can be of indefinite size, both in the number of 'rows' to which Belcanto phrases are assigned and also in terms of the length (in musical time) of the arrange window.

When the EigenD's Metronome is running, the Arranger tracks the current song beat. If the Keygroup Output connected to the Arranger is selected, the 'mode keys' and the 'active grid' and hereafter referred to as the 'active grid' (defined by geometry of the upstream Keygroup - see below), are available on the Eigenharp.

Events can be placed onto the arrange window by pressing a key within your 'active grid'. The LED adjacent to the key you pressed will light red, to indicate an event which will be triggered when the Arranger is playing. To remove the event from your active grid, press the key again, at which point the LED will turn off - the event will no longer be triggered.

Events are triggered when the Metronome's song beat corresponds with the relevant point in the Arranger's 'loop window'. This is defined by the user by setting the 'Beginning' and 'End' points of the loop window within the arrange window, either within the 'Set loop start and end points' mode (explained below) or using Belcanto (also explained below).

Upon the start of the Metronome, the Arranger will project a representation (comprising of a strip of green LEDs) of the current 'Position', the Arranger's equivalent of a 'transport bar', onto the active grid. This will then cycle between the 'Beginning' and 'End' points of the loop window, triggering events when scheduled at the time which corresponds to the current 'Position'.

The Arranger has a number of different mode keys (marked on page 22 of the Alpha Quick Reference Guide):

  • Scroll keys - the Arranger has four scroll keys, which scroll the arrange window up, down, left and right to allow the placement of events outside of the physical area of keys on the keyboard yet still within the virtual arrange window.
  • Set loop start and end points - this mode allows you to set the 'Beginning' and 'End' (explained in further detail below) points of the length in musical time of the Arrange window. The 'Beginning' of the musical looping section of the Arrange window is marked by a strip of keys with red LEDs, and the 'End' is marked with a strip of keys with amber LEDs. The current 'Position' of the Arranger's 'transport' is represented by a strip of keys with green LEDs. Any of these can be adjusted by tapping a key marked with the relevant LED colour, then tapping a key which represents the desired position of the relevant section of the loop.
  • Arranger on/off - this is a toggle key which acts in exactly the same way as the 'Play' and 'Un Play' verbs detailed below - it turns the triggering of the Arranger's events on and off.

When the Arranger Agent is created, first of all a Keygroup must be connected upstream of it. This keygroup must have at least two courses - the first course contains all the mode and scroll keys related to the Arranger:

  • Key 1 of Course 1 is used to scroll the view point onto the arrange window to the right
  • Key 2 of Course 1 is used to scroll the view point onto the arrange window to the left
  • Key 3 of Course 1 is used to scroll the view point onto the arrange window down
  • Key 4 of Course 1 is used to scroll the view point onto the arrange window up
  • Key 5 of Course 1 is used to turn the arranger on/off
  • Key 6 of Course 1 is used to turn 'event mode' on or off
  • Key 7 of Course 1 is used to turn 'set loop start and end points' mode on or off
  • Key 8 of Course 1 is used to reset the active window to view the first row and column (new functionality supported in 1.1.6-testing onwards)
  • Key 10 of Course 1 is used to clear all of the events (when doubletapped)

The remaining course(s) define the keys available for the 'active grid'.

Arranger rows are as explained above defined in the same manner as Talker Events . A few examples of Belcanto phrases commonly assigned to Arranger rows are explained in the Arranger Row article.

The playback of musical notes from EigenD instruments using the Arranger uses the a command initiated from the relevant instrument's Player Agent in which you specify the note number, velocity and sometimes duration of the note, as well as the Arranger you wish to use. Please see the Arranger Row article for more information.

Ports

Controller Input

  • Name:

1775 116
controller input

  • Input
  • Type: Generic

The controller input is used in most cases to pass information from an upstream Agent such as a Keygroup's courses, octave, scale and tonic.

Key input

  • Name:

114 116
key input

  • Input
  • Type: Key

The key input receives key signals from upstream agents.

Pressure Input

  • Name:

128 116
pressure input

  • Input
  • Type: Number
  • Range: 0 to 1

The pressure input receives key pressure signals from upstream agents.

Roll Input

  • Name:

131 116
roll input

  • Input
  • Type: Number
  • Range: -1 to 1

The Roll Input receives key roll signals from upstream agents.

Yaw Input

  • Name:

132 116
yaw input

  • Input
  • Type: Number
  • Range: -1 to 1

The Yaw Input receives key yaw signals from upstream agents.

Song Beat Input

  • Name:

652 127 116
song beat input

  • Input
  • Type: Generic

The song beat input is used to indicate to the Arranger the current position of the song when the Metronome is running - as a consequence you have to connect the 'song beat output' of the Metronome to this input for the Arranger to work correctly.

Running Input

  • Name:

1488 116
running input

  • Input
  • Type: Generic

The running input is used to indicate to the Arranger that the Metronome is running - as a consequence you have to connect the 'running output' of the Metronome to this input for the Arranger to work correctly.

Light output

  • Name:

3122 125
light output

  • Input
  • Type: Generic

The light output is a connection made against the normal flow of signals to send data back to the Keyboard Agent to determine which LEDs should be lit at the appropriate time.

Beginning

  • Name:

446
beginning

  • Input, Set
  • Type: Integer
  • Range: 1 to 10000

Beginning refers to the Arranger's start point (in steps). This can also be set on the Arranger itself using the 'set loop start and end points' mode, tapping within the row of red LEDs, then choosing a new position within the arrange window.

End

  • Name:

447
end

  • Input, Set
  • Type: Integer
  • Range: 1 to 10000
  • Default: 16

End refers to the Arranger's end point (in steps). This can also be set on the Arranger itself using the 'set loop start and end points' mode, tapping a key within the row of amber LEDs, then choosing a new position within the arrange window.

Doubletap

  • Name:

8835
doubletap

  • Input, Set
  • Type: Float
  • Range: 0.5 to 20
  • Default: 0.5

Doubletap is the interval within which a second tap on the same key is considered a confirmation for that key's action. This is used for instance to clear out all arranger events without risky to do so with a single tap.

Step

  • Name:

746
step

  • Input, Set
  • Type: Number
  • Range: 1 to 100
  • Default: 1

The Arranger's step size (in beats) is determined by dividing the Arranger's 'Step' parameter by its 'Fraction' parameter.

Fraction

  • Name:

8714
fraction

  • Input, Set
  • Type: Number
  • Range: 1 to 100
  • Default: 2

The Arranger's step size (in beats) is determined by dividing the Arranger's 'Step' parameter by its 'Fraction' parameter.

Position

  • Name:

1464
position

  • Input, Set
  • Type:

Position refers to the current position of the Arranger's 'transport' bar. This is controlled by EigenD when the metronome is running to determine the events within the arrange windows to be played at that moment in time (represented by a strip of green LEDs). The normal way of adjusting this is within the 'set loop start and end points' mode - to adjust the 'position', tap a key anywhere within the current arrange window (marked by one red strip of LEDs and one amber strip of LEDs - see 'Beginning' and 'End').

Nouns

None:

Verbs

Play

187
play

The 'play' verb is used to start the Arranger events playing (it is also available as a toggle key - 'Arranger On/Off' in the Quick Reference Guide).

Un Play

6 187
un play

The 'un play' verb is used to stop the Arranger events playing (it is also available as a toggle key - 'Arranger On/Off' in the Quick Reference Guide).

Cancel

1823
cancel

The 'cancel' verb is used to cancel the phrase assigned to an Arranger row.

Clear

228
clear

The 'clear' verb is used to remove all the Arranger events.

Do

47
do

The 'do' verb is used to schedule an Arranger event.

Examples

Before using the Belcanto examples below, please make sure you have the desired Arranger in the conversation using

747 ? 1131
arranger X listen

where X is the number of the desired Arranger.

Play the Arranger

To play the Arranger (i.e. start triggering the Arranger's events) use

187
play

Un Play the Arranger

To un play the Arranger (i.e. stop triggering the Arranger's events) use

6 187
un play

Cancel an Arranger row assignment

To cancel a Belcanto assignment to a row, use

? 1823
X cancel

where X is the number of the row to which the Belcanto phrase is assigned (this number corresponds to the number of the Course defined in the upstream Keygroup to which that row belongs).

Clear all events in the Arranger

To clear all event, use

228
clear

Schedule a new Belcanto phrase on an Arranger row

To schedule a Belcanto phrase, use

76 ? 76 32 ? 1124 ? 47
' X ' when Y called Z do

where X is the Belcanto phrase you want to schedule, Y is the Arranger row and Z and the name of the action, typically just a number so that it can be identified later. It's possible to add multiple Belcanto phrases to the same Arranger row by using different action names. If you don't want to use a specific name, the 'called' part can be omitted at which point the next available action number will be used.

See also