Documentation Wiki rss-feed

Recorder


Name

Recorder:

image:recorder_expanded.png

768
recorder

Description

The Recorder is the EigenD agent which is used to record performance information (for example, key presses, strip and breath controller information etc).

Each EigenD instrument contains a Recorder. They allow all the performance information to pass through during normal operation, but when 'armed' (made ready for recording) they record it for the predefined number of bars. This then triggers the Scheduler to automatically loop that recorded take.

Ports

Key input

  • Name:

114 116
key input

  • Input
  • Type: Key

The key input is used in the main to receive activation signals from an upstream Agent (normally the Keygroup 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 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 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 and processes them accordingly.

Controller input

  • Name:

1775 116
controller input

  • Input
  • Type: Generic

The controller input is used to pass on information that changes infrequently and usually carries configuration data from an upstream Agent, for instance Keygroup octave, tonic, scale, mapping, ...

Auxilliary inputs 1 to 10

  • Name:

4452 116 ?
auxilliary input X

  • (X is the auxilliary input number - it can be from 1 to 10)
  • Input
  • Type: Generic

An auxilliary input is used to record auxilliary upstream performance information which does not have a dedicated input to the Recorder. An example of this would be strip or breath controller information.

Song Beat input

  • Name:

652 127 116
song beat input

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

The song beat input is used to indicate to the Recorder the current position of the song when the Metronome is running - as a consequence you have to connect the 'song beat output' of the Metronome to this input for recording to work correctly.

Bar Beat input

  • Name

126 127 116
bar beat input

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

The bar beat input is used to indicate to the Recorder the current beat of the bar when the Metronome is running - as a consequence you have to connect the 'bar beat output' of the Metronome to this input for recording to work correctly.

Running input

  • Name:

1488 116
running input

  • Input
  • Type: On/Off

The running input is used to indicate to the Recorder that the Metronome is running - as a consequence you have to connect the 'running output' of the Metronome to this input for recording to work correctly.

Scheduler identifier

  • Name:

243 8626
scheduler identifier

  • Input
  • Type: String

The scheduler identifier is used to indicate to the record which Scheduler agent to use in the setup for scheduling takes. The Scheduler's agent identifier output is typically connected to it.

Key output

  • Name:

114 125
key output

  • Output
  • Type: Key

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

Pressure output

  • Name:

128 125
pressure output

  • Output
  • Type: Number
  • 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: Number
  • Range: -1 to 1

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

Yaw output

  • Name:

132 125
yaw output

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

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

Controller output

  • Name:

1775 125
controller output

  • Input
  • Type: Generic

The controller output is used to pass on information that changes infrequently to downstream Agents.

Auxilliary outputs 1 to 10

  • Name:

4452 125 ?
auxilliary output X

  • (X is the auxilliary output number - it can be from 1 to 10)
  • Output
  • Type: Generic

An auxilliary output is used to route auxilliary upstream performance information to downstream Agents - an example of this would be strip and breath controller information.

Nouns

Take:

A 'take' is the term used to describe a recorded part within the Recorder. Once you have recorded a take, it is stored in the ~/Library/Eigenlabs/Recordings-tmp/ directory temporarily. If you 'un play' the recording, or shut down EigenD without saving, the recording within this directory will be deleted. If you save your EigenD setup, the recordings are copied from the temporary directory into the ~/Library/Eigenlabs/Recordings/ directory.

You refer to recorded takes on a per Recorder basis. E.g. if you record a take for the first time on a Recorder called

768 11
recorder 1

then the take will be referred to as

768 11 1243 11
recorder 1 take 1

There are a number of operations you can perform involving a recorded take - please see the 'Verbs' and 'Examples' sections below for more information.

The list of recorded takes can be viewed in the EigenBrowser (please see the EigenBrowser article for more information).

Verbs

Record:

758
record

The 'record' verb is used to initiate the recording of performance information for a predefine duration.

Play:

187
play

The 'play' verb has multiple uses within the Recorder - please see the examples below.

Toggle Play:

441 187
toggle play

'Toggle play' has multiple uses within the recorder - please see example below

Repeat:

1321
repeat

The 'repeat' verb is used to have a take loop whilst the Metronome is running.

Toggle Repeat:

441 1321
toggle repeat

'Toggle repeat' is used to to toggle the looping of a recorded take.

Copy:

1324
copy

The 'copy' verb is used to copy a take from one Recorder Agent to another.

Use:

75
use

The 'use' verb is used to indicate to the Recorder which Scheduler Agent should be used to control event scheduling and take playback.

Delete:

1424
delete

The 'delete' verb is used to delete a take from a Recorder.

Cancel:

1823
cancel

The 'cancel' verb is used to cancel recording.

Examples

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

768 ? 1131
recorder X listen

where X is the number of your desired recorder.

Recording

As well as using the controls given in the factory setups, you can use Belcanto to record your instruments. The general format for arming a recorder is as follows:

? 126 758
X bar record

where X is the desired number of bars.

Your recording will begin to loop as soon as the recording has finished.

Un playing all recordings

To halt the playback of all recordings within a Recorder use:

6 187
un play

Un playing individual takes

You can un play individual takes using:

1243 ? 6 187
take X un play

where X is the number of your desired take.

Playing a recorded take once

To play a take once using Belcanto:

1243 ? 187
take X play

where X is the take number.

Playing a recorded take at a specific time

You can schedule the playback of a recorded take at a specific time in song beats or bars, for a specific duration and also define the points within the song where restart of the take can begin. This is the general Belcanto format:

1243 ? 42 ? 43 ? 41 ? 187
take N at X until Y every Z play

where N is the desired take number, X is the song beat/bar number at which you want to start take playback, Y is the song beat/bar number at which you want to stop take playback, and Z is defining the interval between restarting playback of a recorded take (i.e. to create loop playback). Here is an example:

1243 11 42 652 127 14 22 43 652 127
take 1 at song beat 4 0 until song beat

11 22 22 41 18 652 127 187
1 0 0 every 8 song beat play

This would enable playback of take 1 at song beat 40 (40 beats since the start of the Metronome) and restart playback every 8 song beats until song beat 100.

Toggling the playback of a take

To toggle a single playback of a recorded take use:

1243 ? 441 187
take X toggle play

where X is the number of the desired take.

Repeating a take

To play a take and have it loop:

1243 ? 1321
take X repeat

where X is the number of the desired take.

Toggling the repetition of a take

To toggle the loop playback of a take use:

1243 ? 441 1321
take X toggle repeat

where X is the number of the desired take.

Deleting a take

To delete a take:

1243 ? 1424
take X delete

where X is the number of the desired take.

See also