Documentation Wiki rss-feed

Delay

Name

Delay

1421
delay

Description

The Delay Agent is a stereo delay effect that can have delay taps inserted on each of the delay lines which can then be controlled independently. Feedback from the delay taps can be controlled by gains or filtered by low-pass filters. The tap output and feedback can be mixed into the other channels by left and right volumes that define the panning of the output and feedback signals.

Ports

Left Audio input

  • Name:

118 1118 116
left audio input

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

The Left Audio Input is used to receive left channel audio signals from upstream Agents.

Right Audio input

  • Name:

121 1118 116
right audio input

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

The Right Audio Input is used to receive right channel audio signals from upstream Agents.

Tap interval

  • Name:

456 1241
tap interval

  • Input, Set
  • Type: Number
  • Range: 0 to 100000, default = 0.5

The Tap Interval is used to determine the delay time of a newly created tap. For example with a tap interval of 0.5 (half a beat) each new tap will be created with a delay time half a beat larger than the previous tap. So if you were to start with one tap with a delay time of 1 beat, create a new tap and it will have a delay time of 1.5 beats, create another tap and it will have a delay time of 2 beats, and so on.

Mix

  • Name:

457
mix

  • Input, Set
  • Type: Number
  • Range: 0 to 1, default = 0.5

The Mix Input acts as the global wet/dry mix of the Delay effect - it is often a value set by the user, but can also be connected to by an EigenD controller (e.g. strip controller). 0 is equivalent to full dry (i.e. no effect) and 1 is equivalent to full wet (effect only).

Master feedback

  • Name:

182 1126
master feedback

  • Input, Set
  • Type: Number
  • Range: 0 to 2, default = 1

The Master Feedback Input acts as a global master feedback control for the Delay effect - it is often set by the user, but can also be connected to by an EigenD controller (e.g. strip controller).

Offset feedback

  • Name:

1436 1126
offset feedback

  • Input, Set
  • Type: Number
  • Range: -2 to 2, default = 0

The Offset Feedback Input offsets the master feedback. This enables control from an EigenD controller (eg. strip controller) but allowing the 'rest' value of the master feedback to remain different from the rest value of the controller.

Tempo input

  • Name:

168 116
tempo input

  • Input, Set
  • Type: Number
  • Range: 0 to 100000, default = 120

The Tempo Input is normally used as an input from the Metronome agent to determine the tempo to which the Delay effect should synchronise - it can also be a value set by the user.

Left Audio output

  • Name:

118 1118 125
left audio output

  • Output
  • Type: Audio

The Left Audio Output sends left channel audio signals from the Delay to downstream Agents (e.g. Console Mixer)

Right Audio output

  • Name:

121 1118 125
right audio output

  • Output
  • Type: Audio

The Right Audio Output sends right channel audio signals from the Delay to downstream Agents (e.g. Console Mixer)

Enable

  • Name:

5584
enable

  • Input, Set
  • Type: On/Off

Enable allows you to turn the delay on or off.

Enable Time Input

  • Name:

5584 1147 116
enable time input

  • Input, Set
  • Type: Number
  • Range: 0 to 100000 (milliseconds), default = 100

To save CPU, the delay will turn itself off after it has been inactive for a certain amount of time. Enable Time allows you to specify how long the delay will wait before turning itself off.

Verbs

Create:

111
create

The verb 'create' is used to create new taps.

Un Create:

6 111
un create

The verb 'un create' is used to remove existing taps.

Clear:

228
clear

The verb clear is used to clear the delay line.

Belcanto Examples

Global Delay Controls:

To turn the delay on:

5584 67
enable set

To turn the delay off:

5584 6 67
enable un set

To set the master mix:

457 23 ? 67
mix to X set

where X is a value between 0 and 1 (0 is full dry, 1 is full wet).

To set the master feedback:

182 1126 23 ? 67
master feedback to X set

where X is a value between 0 and 2.

To set the offset feedback:

1436 1126 23 ? 67
offset feedback to X set

where X is a value between 0 and 2.

To set the tempo of the delay:

168 23 ? 67
tempo to X set

where X a tempo in bpm between 0 and 100000.

To set the tap interval:

456 1241 23 ? 67
tap interval to X set

where X is a value in beats between 0 and 100000, default is 0.5 (one quaver, or eighth note).

To change the delay enable time:

5584 1147 23 ? 67
enable time to X set

where X is a value in milliseconds between 0 and 100000.

To clear the delay:

228
clear

Tap Controls

Delay taps can be create as needed and are independently customizable.

The delay time can be set in beats or in seconds, negative values indicate seconds and positive values indicate beats. This can be alternative set using the second and beat qualifiers, which will automatically handle to appropriate positive/negative signs.

To set the delay time in seconds:

456 ? 63 1122 1147 23 ? 234 67
tap X all channel time to Y second set

where X is the tap number and Y is a time in seconds between 0 and 4.

Alternatively the left and right channels can have different delay times. To set the delay time of the left channel in seconds:

456 ? 118 1122 1147 23 ? 234 67
tap X left channel time to Y second set

where X is the tap number and Y is a time in seconds between 0 and 4.

Or to set the delay time of the right channel in seconds:

456 ? 121 1122 1147 23 ? 234 67
tap X right channel time to Y second set

where X is the tap number and Y is a time in seconds between 0 and 4.

To set the delay time in beats:

456 ? 63 1122 1147 23 ? 127 67
tap X all channel time to Y beat set

where X is the tap number and Y is a number of beats, e.g. 0.5 is a quaver, 2 is a minim, etc..

Alternatively the left and right channels can have different delay times. To set the delay time of the left channel in beats:

456 ? 118 1122 1147 23 ? 127 67
tap X left channel time to Y beat set

where X is the tap number and Y is a number of beats, e.g. 0.5 is a quaver, 2 is a minim, etc..

Or to set the delay time of the right channel in beats:

456 ? 121 1122 1147 23 ? 127 67
tap X right channel time to Y beat set

where X is the tap number and Y is a number of beats, e.g. 0.5 is a quaver, 2 is a minim, etc..

Each channel of each tap has it's own feedback gain, these are offset by the master feedback and offset feedback settings detailed above.

To set the feedback gain of both channels of a tap simultaneously:

456 ? 63 1122 1126 23 ? 67
tap X all channel feedback to Y set

where X is the tap number and Y is a value between 0 and 2.

To set the feedback gain of a tap's left channel:

456 ? 118 1122 1126 23 ? 67
tap X left channel feedback to Y set

where X is the tap number and Y is a value between 0 and 2.

To set the feedback gain of a tap's right channel:

456 ? 121 1122 1126 23 ? 67
tap X right channel feedback to Y set

where X is the tap number and Y is a value between 0 and 2.

There is a low pass filter built in to the feedback path of each channel. To turn the filter on:

456 ? 63 1122 1127 67
tap X all channel filter set

where X is the tap number.

To turn the filter off:

456 ? 63 1122 1127 6 67
tap X all channel filter un set

where X is the tap number.

You could replace

63 1122
all channel

with either

118 1122
left channel

or

121 1122
right channel
.

Each low pass filter has a configurable cutoff frequency filter.

To set the cutoff frequency of the low pass filters:

456 ? 63 1122 4314 23 ? 67
tap X all channel cutoff to Y set

(sets both left and right channels simultaneously) X is the tap number and Y is a value in hertz between 0 and 20000.

To set the cutoff frequency of the left channel only:

456 ? 118 1122 4314 23 ? 67
tap X left channel cutoff to Y set

where X is the tap number and Y is a value in hertz between 0 and 20000.

To set the cutoff frequency of the right channel only:

456 ? 121 1122 4314 23 ? 67
tap X right channel cutoff to Y set

where X is the tap number and Y is a value in hertz between 0 and 20000.

Output Volume Panning:

Each channel has both left and right outputs, by default the left channel is sent to the left output only and the right channel is sent to the right output only; by adjusting a channel's left and right output volumes you can affect the channel's position in the stereo field.

To set the left output volume of a channel:

456 ? ? 1122 118 212 23 ? 67
tap X Y channel left volume to Z set

where X is the tap number, Y specifies the channel ('left', 'right' or to adjust both channels at once use 'all') and Z is a value between 0 and 1.

To set the right output volume of a channel:

456 ? ? 1122 121 212 23 ? 67
tap X Y channel right volume to Z set

where X is the tap number, Y specifies the channel ('left', 'right' or to adjust both channels at once use 'all') and Z is a value between 0 and 1.

To set a channel's left and right output volumes simultaneously:

456 ? ? 1122 63 212 23 ? 67
tap X Y channel all volume to Z set

where X is the tap number, Y specifies the channel ('left', 'right' or to adjust both channels at once use 'all') and Z is a value between 0 and 1.

Cross Channel Feedback:

Each channel has both left and right feedback gain settings, by default each channel only feeds back to itself, by adjusting a channel's left and right feedback gain you can affect the cross channel feedback.

To set the gain from a tap's left channel feedback to the input of the tap's right channel:

456 ? 118 1122 121 775 23 ? 67
tap X left channel right gain to Y set

where X is the tap number and Y is a value between 0 and 1.

To set the gain from a tap's right channel feedback to the input of the tap's left channel:

456 ? 121 1122 118 775 23 ? 67
tap X right channel left gain to Y set

where X is the tap number and Y is a value between 0 and 1.