MacroModulator

interface MacroModulator extends Modulator {
uuid: string
label: string
enabled: boolean
index: number
bipolar: boolean
amount: number
modulations: readonly Modulation[]
valueTracks: readonly ValueTrack[]
kind: 'Macro'
value: number
addValueTrack<T extends AnyModulator | Modulation>(target: T, parameter: ParameterPath<T>, props?: Partial<Pick<Track, 'enabled'>>): ValueTrack
assign<T extends Automatable>(target: T, parameter: ParameterPath<T>, depth?: number): Modulation
remove(): void
}

Manual macro control

See:
- Modulators.Macro

Hierarchy

Modulator
MacroModulator

Properties

`uuid: string`

readonly

Inherited from uuid

Unique id

`label: string`

Inherited from label

Custom label

`enabled: boolean`

Inherited from enabled

Enable the modulator

`index: number`

readonly

Inherited from index

Order in the modulator list

`bipolar: boolean`

Inherited from bipolar

Bipolar output (-1 to 1) instead of unipolar (0 to 1) (default true)

`amount: number`

Inherited from amount

Output amount (0.0 to 1.0, default 1.0)

`modulations: readonly Modulation[]`

readonly

Inherited from modulations

All assignments

`valueTracks: readonly ValueTrack[]`

readonly

Inherited from valueTracks

Automation lanes of this modulator's own parameters and assignment depths

`kind: 'Macro'`

readonly

Overrides kind

Always "Macro"

`value: number`

Value (0.0 to 1.0, default 0.5)

Methods

`addValueTrack< T extends AnyModulator | Modulation, >( target: T, parameter: ParameterPath<T>, props?: Partial<Pick<Track, 'enabled'>>, ): ValueTrack`

Inherited from addValueTrack

Add an automation lane for one of this modulator's parameters or an assignment depth

Type Parameters

T extends AnyModulator | Modulation

Parameters

target (T) — This modulator or one of its modulations
parameter (ParameterPath<T>) — Parameter path, e.g. "rateAbsolute" or "depth"
props (Partial<Pick<Track, "enabled">>, optional)

Returns

ValueTrack

`assign< T extends Automatable, >( target: T, parameter: ParameterPath<T>, depth?: number, ): Modulation`

Inherited from assign

Assign this modulator to a parameter

Type Parameters

T extends Automatable

Parameters

target (T) — Any modulatable object (a device, a unit, ...)
parameter (ParameterPath<T>) — Parameter path, e.g. "cutoff"
depth (number, optional) — Modulation depth (-1.0 to 1.0, default 0.25)

Returns

Modulation

Example

CODE

const lfo = project.addModulator("LFO", {rateSync: 6})
lfo.assign(synth.instrument, "cutoff", 0.5)

`remove(): void`

Inherited from remove

Remove this modulator including its assignments

Returns

void