Documentation Wiki rss-feed

Scaler


Name

Scaler:

image:scaler_expanded.png

147
scaler

Description

The Scaler applies a scale, tonic and octave to incoming key press information.

The Scaler also deals with pitch bend within EigenD. There are two types of pitch bend - global pitch bend, which affects all currently playing notes, and k pitch bend, which allows individual pitch bend per key.

Ports

Key input

  • Name:

114 116
key input

  • Input
  • Type: Key

The Key Input receives key signals from upstream agents (often the Recorder).

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 is receives key yaw signals from upstream agents.

Controller input

  • Name:

1775 116
controller input

  • Input
  • Type: Generic

The controller input is used to pass information from the upstream Keygroup to the scaler, effecting the[Keygroup]]'s courses, octave, scale and tonic.

Key Pitch Bend input

  • Name:

114 2314 2317 116
key pitch bend input

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

The Key/Pitch Pitch Bend Input receives information from an EigenD controller (often the upstream roll output) to control pitch bend on a per key basis.

Global Pitch Bend input

  • Name:

4584 2314 2317 116
global pitch bend input

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

The Global Pitch Bend Input receives information from an EigenD controller (often the upstream strip controller output) to control pitch bend on a global basis.

Key Bend Range input

  • Name:

114 2317 3121 116
key bend range input

  • Input, Set
  • Type: Number
  • Range: 0 to 72
  • Default: 1

The Key Bend Range Input determines the amount of pitch bend (in semitones) for the Key Pitch Bend input.

Global Bend Range input

  • Name:

4584 2317 3121 116
global bend range input

  • Input, Set
  • Type: Number
  • Range: 0 to 72
  • Default: 12

The Global Bend Range Input determines the amount of pitch bend (in semitones) for the Global Pitch Bend Input.

Scale input

  • Name:

135 116
scale input

  • Input, Set
  • Type: Text
  • Range: Scale
  • Default: [0,2,4,5,7,9,11,12]

The scale input is normally used to set the scale of your Scaler to any predefined Belcanto scale or to a user defined scale.

Tonic input

  • Name:

145 116
tonic input

  • Input, Set
  • Type: Number
  • Range: 0 to 12
  • Default: 0

The tonic input sets the tonic of the scale

0 = C, 1 = C#, 2 = D, 3 = D#, 4 = E, 5 = F, 6 = F#, 7 = G, 8 = G#, 9 = A, 10 = A#, 11 = or 12 = C.

Octave input

  • Name:

324 116
octave input

  • Input, Set
  • Type: Number
  • Range: -1 to 9
  • Default: 3

The octave input sets the desired octave

Base note input

  • Name:

1812 124 116
base note input

  • Input, Set
  • Type: Number
  • Range: -20 to 20
  • Default: 0

The base note input is an offset from the tonic, to allow you to start your current Keygroup from a note other than the tonic.

Modifier input

  • Name:

2321 116
modifier input

  • Input, Set
  • Type: Number
  • Range: -10 to 10
  • Default: 0

The modifier input is an offset in semitones to temporarily change the scaler's frequency, this is for instance used by the Fingerer agent.

Override

  • Name:

1765
override

  • Input, Set
  • Type: On/Off
  • Default: Off

The port override function allows you to play in different scales, keys and octaves in various areas of the keyboard.

If the keygroup has a scale, tonic and octave set, this overrides the scaler scale. You can in turn override the Keygroup scale by setting override within the scaler.

Relative Octave input

  • Name:

8821 324 116
relative octave input

  • Input, Set
  • Type: Number
  • Range: -10 to 10

The relative octave input allows you to offset an instrument (in ocatves) from the other instruments in that keygroup.

Curve

  • Name:

1512
curve

  • Input, Set
  • Type: Integer
  • Range: 1 to 4
  • Default: 2

The pitch bend curve parameter can also be set within the Scaler. There are four available curves: linear, quadratic, cubic and step. This is represented by a number between 1 and 4 - 1 represents linear, 2 represents quadratic, 3 represents cubic and 4 represents step. In basic terms this allows you to apply an adjustment to the pitch bend values with varying degrees of severity.

Key output

  • Name:

114 125
key output

  • Output
  • Type: Key

The key output is normally used to send key information to downstream Agents.

Pressure output

  • Name:

128 125
pressure output

  • Output
  • Type: Numeric
  • Range: 0 to 1

The pressure output is used to send key pressure information to downstream Agents.

Roll output

  • Name:

131 125
roll output

  • Output
  • Type: Numeric
  • Range: -1 to 1

The roll output is used to send key roll information to downstream Agents.

Yaw output

  • Name:

132 125
yaw output

  • Output
  • Type: Numeric
  • Range: -1 to 1

The yaw output is used to send key yaw information to downstream Agents.

Scale note output

  • Name:

135 124 125
scale note output

  • Output
  • Type: Generic

The scale note output sends scale note information to downstream Agents.

Frequency output

  • Name:

1128 125
frequency output

  • Output
  • Type: Numeric
  • Range: 0 to 96000

The frequency output sends the frequency information produced by the scaler to downstream Agents (e.g. oscillators).

Light output

  • Name:

3122 125
light output

  • Output
  • Type: Light

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.

Nouns

None

Verbs

Choose:

122
choose

'Choose' is used in the Scaler as a synonym for 'Set' - please use the examples containing 'Set' below as the use of 'Choose' will be discontinued.

Examples

Before using the commands below, make sure you have the desired scaler in the conversation using:

147 ? 1131
scaler X listen

where X is the number of your desired scaler.

Setting the scale

To set the Scaler scale using Belcanto:

135 23 ? 67
scale to X set

where X is the name of a Belcanto scale, e.g.

135 23 4153 67
scale to major set

You can also set the scale using explicit numbers in semitone increments, including fractional numbers expressed with decimal points, like this:

135 23 11 8716 12 8716 12 33 12 8716 13 8716 13 33 13 8716 14 67
scale to 1 , 2 , 2 . 2 , 3 , 3 . 3 , 4 set

which will give you a very odd sounding scale indeed. You can also define your own scales in a file and then set the scaler to use these. Details of how to do this can be found here.

Setting the tonic

To set the tonic/key of your instrument via the scaler, the general Belcanto format would be:

145 23 ? 67
tonic to noteX set

where X is your Belcanto tonic, eg.

145 23 8717 67
tonic to notecsharp set

Setting the octave

To set the octave of your Scaler, the general Belcanto format is:

324 23 ? 67
octave to X set

where X corresponds to the octave your tonic would be if it were a MIDI note, e.g. A4 would be 440Hz - the octave would be 4.

Setting the base note:

To set the base note in the scaler:

1812 124 23 ? 67
base note to X set

where X is the desired offset from the tonic, e.g.

1812 124 23 26 12 67
base note to - 2 set

would set the base note to two notes below the tonic.

Overriding the Keygroup scale, tonic and octave

To set override within the scaler use:

1765 67
override set

And you can turn the 'override' parameter off using:

1765 6 67
override un set

Setting the relative octave in the Scaler:

To set the relative octave in the Scaler:

8821 324 23 ? 67
relative octave to X set

where X is the desired offset from the keygroup octave, e.g.

8821 324 23 26 12 67
relative octave to - 2 set

would set the scaler two octaves lower than the keygroup octave.

Setting the Global Pitch Bend Range:

To set the global pitch bend range:

4584 2317 3121 23 ? 67
global bend range to X set

where X is your desired global pitch bend range, e.g.

4584 2317 3121 23 11 12 67
global bend range to 1 2 set

Setting the Key Pitch Bend Range

To set the key pitch bend range:

114 2317 3121 23 ? 67
key bend range to X set

where X is your desired key pitch bend range, e.g.

114 2317 3121 23 12 67
key bend range to 2 set

Setting the pitch bend curve

To set the pitch bend curve:

1512 23 ? 67
curve to X set

where X is the number which corresponds to the desired curve, e.g.

1512 23 11 67
curve to 1 set

sets the pitch bend curve (which applies to both the global and key pitch bend inputs) to linear.

See also