PitchControlPoint

PitchControlPoint

A discrete anchor point that guides the pitch generation at a specific time and pitch position within a NoteGroup.

(supported since 2.1.0)

Extends

Methods

clearScriptData()

Inherited From:

Remove all script data from the object's storage. Note: use with caution as this could also remove data created by other scripts.

clone() → {PitchControlPoint}

A deep copy of the current object.

Returns:
Type
PitchControlPoint

getIndexInParent() → {number}

Inherited From:

Get index of the current object in its parent. In Lua, this index starts from 1. In JavaScript, this index starts from 0.

Returns:
Type
number

getParent() → {NestedObject|undefined}

Inherited From:

Get the parent NestedObject. Return undefined if the current object is not attached to a parent.

Returns:
Type
NestedObject | undefined

getPitch() → {number}

Get the pitch value of this pitch control point in semitones relative to the pitch offset of the note group.

Returns:

pitch in semitones

Type
number

getPosition() → {number}

Get the position of this pitch control point relative to the time offset of the note group (in blicks).

Returns:

position in blicks

Type
number

getScriptData(key) → {any}

Inherited From:

Retrieve a value from the object's script data storage by key. Returns undefined if the key does not exist.

Parameters:
Name Type Description
key string

The key to retrieve the value for

Returns:

The stored value, or undefined if key doesn't exist

Type
any

getScriptDataKeys() → {Array.<string>}

Inherited From:

Get all keys currently stored in the object's script data storage.

Returns:

Array of all stored keys

Type
Array.<string>

hasScriptData(key) → {boolean}

Inherited From:

Check whether a key exists in the object's script data storage.

Parameters:
Name Type Description
key string

The key to check for

Returns:

true if the key exists, false otherwise

Type
boolean

isMemoryManaged() → {boolean}

Inherited From:

Check whether or not the current object is memory managed (i.e. garbage collected by the script environment).

Returns:
Type
boolean

removeScriptData(key)

Inherited From:

Remove a key-value pair from the object's script data storage.

Parameters:
Name Type Description
key string

The key to remove

setPitch(pitch)

Set the pitch value of this pitch control point.

Parameters:
Name Type Description
pitch number

pitch in semitones

setPosition(position)

Set the time position of this pitch control point.

Parameters:
Name Type Description
position number

position in blicks

setScriptData(key, value)

Inherited From:

Store a value with the specified key in the object's script data storage. The value must be JSON-serializable.

Parameters:
Name Type Description
key string

The key to store the value under

value any

The value to store (must be JSON-serializable)