PitchControlCurve

PitchControlCurve

NoteGroup 内の指定した時間範囲で生成されたピッチをオーバーライドするピッチコントロールカーブです。

ピッチコントロールカーブは、複数の時間-ピッチのペアで定義される連続的なピッチの変更を表します。 このオブジェクトはアンカー位置(ノートグループに相対的)、アンカーピッチ値(ノートグループに対して相対的な半音単位の値)、およびアンカー位置とアンカーピッチ値によってオフセットされた複数の時間-ピッチのペアを保持しています。

アンカー位置とアンカーピッチの値は GUI には表示されませんが、実装の便宜のために保持されています。通常、これらは内部のすべてのポイントを囲むバウンディングボックスの中心位置に設定されます。

(2.1.0 以降でサポート)

継承

メソッド

clone() → {PitchControlCurve}

現在のオブジェクトのディープコピー。

戻り値:
PitchControlCurve

getIndexInParent() → {number}

継承元:

現在のオブジェクトの、親の中での添え字を取得します。Lua では、添え字は 1 から始まります。JavaScript では、添え字は 0 から始まります。

戻り値:
number

getParent() → {NestedObject|undefined}

継承元:

NestedObject を取得します。現在のオブジェクトが親に付いていない場合、undefined を返します。

戻り値:
NestedObject | undefined

getPitch() → {number}

ピッチコントロールカーブのアンカーピッチ値を、ノートグループのピッチオフセットに対して相対的な半音単位で取得します。

戻り値:

pitch in semitones

number

getPoints() → {Array.<Array.<number>>}

このピッチコントロールカーブのすべてのコントロールポイントを取得します。

この関数は、[ time , value ] ペアの配列を返します。ここで、time はカーブのアンカー位置を基準としたブリック単位、value はアンカー位置からの半音単位のピッチオフセットを示します。

戻り値:

array of [time, value] pairs

Array.<Array.<number>>

getPosition() → {number}

ピッチコントロールカーブのアンカー位置を、ノートグループの時間オフセットに対して相対的なブリック単位で取得します。

戻り値:

position in blicks

number

getValueAt(time) → {number}

特定の時間における補間されたピッチ値を取得します。

この関数は、カーブのコントロールポイントにより補間された、指定された時間における半音単位のピッチオフセットを返します。

パラメータ:
名前 細細
time number

time in blicks relative to the curve's position

戻り値:

pitch offset in semitones

number

isMemoryManaged() → {boolean}

継承元:

現在のオブジェクトがメモリ管理されているかどうか(スクリプト環境によってガベージコレクションされるか)を確認します。

戻り値:
boolean

setPitch(pitch)

このピッチコントロールカーブのアンカーピッチ値を設定します。

パラメータ:
名前 細細
pitch number

pitch in semitones

setPoints(points)

このピッチコントロールカーブのすべてのコントロールポイントを設定します。

各コントロールポイントは、[ time , value ] の配列である必要があります。ここで、time はカーブのアンカー位置を基準としたブリック単位、value はアンカー位置からの半音単位のピッチオフセットを示します。

パラメータ:
名前 細細
points Array.<Array.<number>>

array of [time, value] pairs

setPosition(position)

このピッチコントロールカーブのアンカー位置を設定します。

パラメータ:
名前 細細
position number

position in blicks