Documentation Wiki rss-feed

Stringer


Name

Stringer:

image:stringer_expanded.png

8751
stringer

Description

The Stringer is the Agent responsible for providing monophony on a per-course basis for use with the Cello Oscillator and Clarinet Oscillator within EigenD.

Ports

Key input

  • Name:

114 116
key input

  • Input
  • Type: Key

The key input is used mainly to receive key signals from an upstream Agent (normally a Keygroup Output's key output in this case).

Pressure input

  • Name:

128 116
pressure input

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

The pressure input is used to receive key pressure signals from upstream (normally a Keygroup Output's pressure output in this case) and processes them accordingly.

Roll input

  • Name:

131 116
roll input

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

The roll input is used to receive key roll signals from upstream (normally a Keygroup Output's roll output in this case) and processes them accordingly.

Yaw input

  • Name:

132 116
yaw input

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

The yaw input is used to receive key yaw signals from upstream (normally a Keygroup Output's yaw output in this case) and processes them accordingly.

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 to the Stringer Agent.

Enable

  • Name:

5584
enable

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

'Enable' is a parameter used to enable (if set) or disable (if un set) the Stringer's monophonic mode - for instance if set, the Stringer is monophonic per course, if un set, it gives normal polyphonic behaviour. This can also be controlled by the 'toggle enable' verb (explained below).

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
  • Ranger: 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
  • Ranger: -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
  • Ranger: -1 to 1

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

Key output

  • Name:

114 125
key output

  • Output
  • Type: Key

The key output is used to send monophonic key press information to downstream Agents. This is normally passed through a Recorder Agent (into an auxilliary input and out of an auxilliary output) into a Scaler's key input in general usage within EigenD.

Controller output

  • Name:

1775 125
controller output

  • Output
  • Type: Generic

The controller output is used in most cases to pass control information from an upstream Agent such as a Keygroup's courses, octave, scale and tonic to downstream Agents (such as the Scaler's controller input in this case).

Nouns

None

Verbs

Toggle enable:

441 5584 74
toggle enable ify

The 'toggle enable ify' verb is used to toggle the status of the 'enable' Port (explained above).

Examples

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

8751 ? 1131
stringer X listen

where X is the number of the desired Stringer.

Set 'enable'

To set the enable port, use

5584 67
enable set

Un set 'enable'

To un set the enable port, use

5584 6 67
enable un set

Using the 'toggle enable' verb

To toggle the state of the 'enable' port, use

441 5584 74
toggle enable ify

See also