Skip to content

module node liveosc Return.API

Tom edited this page Jul 17, 2014 · 6 revisions

Class: Return

node-liveosc~ Return

new Return(liveosc, id)

Return object, represents a return track in the Ableton Live set.

Parameters:
Name Type Description
liveosc Object

LiveOSC instance

id Number

id of the return

Source:

Members

devices :Array

Devices in this return

Type:
  • Array
Source:

eventEmitter :EventEmitter

EventEmitter for return events

Type:
  • EventEmitter
Source:

id :Number

The id of this return

Type:
  • Number
Source:

liveosc :Object

Instance of LiveOSC

Type:
  • Object
Source:

mute :Number

Return muted

Type:
  • Number
Source:

name :String

Name of the return

Type:
  • String
Source:

pan :Number

Return panning

Type:
  • Number
Source:

sends :Array

Return send levels ex [{id: 0, value: 1.0}]

Type:
  • Array
Source:

solo :Number

Return soloed

Type:
  • Number
Source:

volume :Number

Return volume

Type:
  • Number
Source:

Methods

destroy()

Called when a return is refreshed or destroyed

Source:

emitEvent(ev, params)

Emit a return event

Parameters:
Name Type Description
ev String

event name

params Object

event parameters

Source:

on(ev, cb)

Listen for a return event, current events are:

send solo mute volume pan name destroy

Parameters:
Name Type Description
ev String

event name

cb function

callback

Source:

setMute(mute)

Set the return mute state

Parameters:
Name Type Description
mute Number

0 or 1

Source:

setName(name)

Set the name of the return

Parameters:
Name Type Description
name String

the new track name

Source:

setPan(pan)

Set the return panning

Parameters:
Name Type Description
pan Number

1.0 - 1.0

Source:

setSend(send, val)

Set return send level

Parameters:
Name Type Description
send Number

send id

val Number

new send level (0.0 - 1.0)

Source:

setSolo(solo)

Set the return solo state

Parameters:
Name Type Description
solo Number

0 or 1

Source:

setVolume(volume)

Set the return volume

Parameters:
Name Type Description
volume Number

0.0 - 1.0

Source:

view()

Focus the return

Source:

<inner> devicelistListener()

Listen for /live/return/devicelist

Source:

<inner> infoListener(trackId, solo, mute, volume, pan)

Listen for /live/return/info

Parameters:
Name Type Description
trackId Number

the id of the return

solo Number

0 or 1

mute Number

0 or 1

volume Number

current return volume

pan Number

current return panning

Source:

<inner> muteListener(trackId, mute)

Listen for /live/return/mute

Parameters:
Name Type Description
trackId Number

the id of the return

mute Number

0 or 1

Source:

<inner> nameListener(trackId, name)

Listen for /live/name/return This is called when devices are added or removed

Parameters:
Name Type Description
trackId Number

the id of the return

name String

the name of the return

Source:

<inner> panListener(trackId, pan)

Listen for /live/return/pan

Parameters:
Name Type Description
trackId Number

the id of the return

pan Number

new return panning

Source:

<inner> sendListener()

Listen for /live/return/send

Source:

<inner> soloListener(trackId, solo)

Listen for /live/return/solo

Parameters:
Name Type Description
trackId Number

the id of the return

solo Number

0 or 1

Source:

<inner> volumeListener(trackId, volume)

Listen for /live/return/volume

Parameters:
Name Type Description
trackId Number

the id of the return

volume Number

new return volume

Source:

Generated with wicked.

Clone this wiki locally