Documentation Wiki rss-feed

Rectangle Oscillator


Name

Rectangle Oscillator:

image:rectangle_oscillator_expanded.png

1331 1133
rectangle oscillator

Description

The Rectangle Oscillator Agent is EigenD's built-in rectangular-wave oscillator plug-in. This Agent also acts as a square-wave oscillator when the pulse-width parameter is set to 0.5.

Ports

Volume input

  • Name:

212 116
volume input

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

The volume input is normally used to receive volume information from upstream Agents.

Frequency input

  • Name:

1128 116
frequency input

  • Input, Set
  • Type: Number
  • Range: 0 to 96000
  • Default: 440

The frequency input is used in the main to receive frequency signals from an upstream Agent (normally from the Scaler's frequency output in this case) to be processed accordingly, but can also be set by the user.

Pulse Width input

  • Name:

1332 1144 116
pulse width input

  • Input, Set
  • Type: Number
  • Range: 0.1 to 0.9

The pulse width input is the Port on the Rectangle Oscillator which enables pulse width modulation (or PWM). Therefore this can be used as a value set by the user to determine the pulse width (the higher the value the wider the pulse) or there can be a connection made from a Low Frequency Oscillator (LFO) to this input. The Rectangle Oscillator produces a square wave when the pulse width is set to 0.5.

Detune input

  • Name:

2312 116
detune input

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

The detune input is normally used to detune the output frequency of the Rectangle Oscillator using a value (in cents) set by the user.

Audio output

  • Name:

1118 125
audio output

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

The audio output is used for sending audio data to downstream Agents.

Nouns

None

Verbs

None

Examples

Before using the Belcanto examples below, please make sure you have the desired Rectangle Oscillator in the conversation using:

1331 1133 ? 1131
rectangle oscillator X listen

where X is the number of the desired Rectangle Oscillator.

Setting the value of the frequency input

To set the value of the frequency input, use

1128 116 23 ? 67
frequency input to X set

where X is the value of the desired frequency.

Setting the value of the pulse width input

To set the pulse width, use

1332 1144 116 23 ? 67
pulse width input to X set

where X is the value of the desired pulse width.

Setting the value of the detune input

To set the value of the detune input, use

2312 116 23 ? 67
detune input to X set

where X is the value of the desired detune.

See also