オートメーションカーブ

名前	型	説明
カーブ curve	AutomationCurve	時間方向の制御カーブ

名前

型

説明

カーブ

curve

AutomationCurve

時間方向の制御カーブ

パラメータ

名前	型	既定値	範囲	説明・選択肢
長さ duration	Float	0.35	0.01–5 / step 0.01	時間の長さ(秒)です。効果音は0.1〜1秒程度が目安。オシレータと、そこへ繋ぐカーブはこの値を揃えてください。カーブの方が短いと、カーブが終わった時点で効果が切れます(音量カーブなら最大音量に戻ってしまいます)
サンプル数 samples	Int	256	2–4096	カーブの解像度(形を何個の点で記録するか)です。点と点の間は滑らかに繋がれるため、通常は既定値のままで大丈夫です。増やすと細かい形まで正確になり、減らすと細部が失われます。音の長さや高さは変わりません
プリセット preset	Enum	Rise	—	カーブの形です。一定=変化なし / 上昇・下降=だんだん上がる・下がる / アタック減衰=一瞬で立ち上がりすぐ減衰(打撃系の音量の定番) / 揺れ=周期的な波(ビブラート向き) / JSON=キャンバスに自分で描く一定`Flat` 上昇`Rise` 下降`Fall` アタック減衰`AttackDecay` 揺れ`Wobble` JSON`Json`
JSONサンプル json_samples	CustomData	{"version":1,"samples":[0,1]}	—	描いたカーブの中身(0〜1の値の列)です。上のキャンバスをドラッグすると自動で更新されるので、通常このJSONを直接編集する必要はありません。同じ値を並べると平らな段になり、アルペジオ作りに使えます
出力最小 output_min	Float	0	-96–96 / step 0.1	カーブの下端(一番低い所)が実際に意味する値です。例: 音程カーブとして使うとき、最小0/最大12なら「0〜+12半音の上昇」、最小-30/最大0なら「落下する音程」になります。音量カーブとして使うなら0〜1のままにします
出力最大 output_max	Float	1	-96–96 / step 0.1	カーブの上端(一番高い所)が実際に意味する値です。「出力最小」とペアで、カーブが実際に動く範囲を決めます。例: 音程用に0〜12なら最大+1オクターブ、音量用なら0〜1のままが基本です

概要

「時間→値」の自由な変化カーブ(AutomationCurve)を作るノードです。波形ノード(sine等)の定型では表現できない、任意の形の動き (ため→急発進→ゆっくり停止、など)をプリセットやJSONサンプル列から定義します。

使い方のポイント

まずはプリセットから選ぶのが手軽。凝った動きが必要になったらJSONでサンプル列を与える
ease_in_out の9種で足りるならそちらの方が簡単。このノードは「カーブの形そのものを設計したい」場合の道具
対応ノード(カーブ入力を持つもの)につないで、パラメータの時間変化を駆動する

プリセットまたは JSON サンプルから AutomationCurve を生成します。

Ports

Direction	Port	Type	説明
Output	`curve`	`AutomationCurve`	生成された制御カーブ

Parameters

duration: カーブの時間長
samples: 出力サンプル数
preset: Flat / Rise / Fall / AttackDecay / Wobble / Json
json_samples: preset=Json のときだけ表示される 0..1 のJSONサンプル配列
output_min: カーブ値 0 の出力値
output_max: カーブ値 1 の出力値

Notes

v2 はプリセットとJSON入力に対応します。既知の旧小文字値は互換入力として受け付けますが、それ以外の未知値は既定プリセットへ黙って置き換えずエラーにします。不正なJSONも評価エラーとして表示し、入力文字列は保持します。専用Curve Editorは今後の拡張対象です。

出力ポート