StepsModulator

interface StepsModulator extends Modulator {
uuid: string
label: string
enabled: boolean
index: number
bipolar: boolean
amount: number
modulations: readonly Modulation[]
valueTracks: readonly ValueTrack[]
kind: 'Steps'
count: number
rateSync: number
rateAbsolute: number
phase: number
smooth: number
direction: 0 | 1 | 2 | 3 | 4
steps: readonly 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
setSteps(values: readonly number[]): void
}

Step sequencer

See:
- Modulators.Steps

Hierarchy

Modulator
StepsModulator

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: 'Steps'`

readonly

Overrides kind

Always "Steps"

`count: number`

Number of steps (1 to 64, default 16)

`rateSync: number`

Synced step rate index (see LfoModulator.rateSync, default 10 = 1/16)

`rateAbsolute: number`

Free running rate in Hz (0 to 10, used when rateSync is 0)

`phase: number`

Phase offset (0.0 to 1.0)

`smooth: number`

Smoothing between steps (0.0 to 1.0)

`direction: 0 | 1 | 2 | 3 | 4`

Direction (0-4): Forward, Backward, Ping-Pong, Alternate, Random

`steps: readonly number[]`

readonly

64 step values (0.0 to 1.0)

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

`setSteps(values: readonly number[]): void`

Replace the steps from the beginning and set the count

Parameters

values (readonly number[])

Returns

void