Documentation Wiki rss-feed

Scaler

Name

Scaler:

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

Activation input

  • Name:

1435 116
activation input

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

The Activation Input receives activation 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 input

  • Name:

114 116
key input

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

The key input receives information from the upstream Keygroup and stringer in order to produce monophonic behaviour.

K Pitch Bend input

  • Name:

error 2314 2317 116
Error pitch bend input

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

The K 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.

K Bend Range input

  • Name:

error 2317 3121 116
Error bend range input

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

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

Global Bend Range input

  • Name:

4584 2317 3121 116
global bend range input

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

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

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

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

The ocatve input sets the desired ocatve

Base note input

  • Name:

1812 124 116
base note input

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

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.

Override

  • Name:

1765
override

  • Input, Set
  • Type: On/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

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.

Activation output

  • Name:

1435 125
activation output

  • Output
  • Type: Generic

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

Pressure output

  • Name:

128 125
pressure output

  • Output
  • Type: Generic

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

Roll output

  • Name:

131 125
roll output

  • Output
  • Type: Generic

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

Yaw output

  • Name:

132 125
yaw output

  • Output
  • Type: Generic

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: Generic

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

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

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 K Pitch Bend Range

To set the k pitch bend range:

error 2317 3121 23 ? 67
Error bend range to X set

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

error 2317 3121 23 12 67
Error 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 k pitch bend inputs) to linear.

See also