Yotsuba Games
Back to Node List

Automation Curve

automation_curve

Makes the 'shape' that moves pitch or volume over time. Pick a preset, or choose Json and draw the curve directly on the canvas, then wire it into an oscillator's Pitch/Gain Curve input

Reviewed
Guide available
The node name and summary are available in English. Port, parameter, and article details are currently shown in Japanese.

Output Ports

NameTypeDescription
カーブ
curve
AutomationCurve
時間方向の制御カーブ

Parameters

NameTypeDefaultRangeDescription / Options
長さ
duration
Float
0.350.01–5 / step 0.01

時間の長さ(秒)です。効果音は0.1〜1秒程度が目安。オシレータと、そこへ繋ぐカーブはこの値を揃えてください。カーブの方が短いと、カーブが終わった時点で効果が切れます(音量カーブなら最大音量に戻ってしまいます)

サンプル数
samples
Int
2562–4096

カーブの解像度(形を何個の点で記録するか)です。点と点の間は滑らかに繋がれるため、通常は既定値のままで大丈夫です。増やすと細かい形まで正確になり、減らすと細部が失われます。音の長さや高さは変わりません

プリセット
preset
Enum
Rise—

カーブの形です。一定=変化なし / 上昇・下降=だんだん上がる・下がる / アタック減衰=一瞬で立ち上がりすぐ減衰(打撃系の音量の定番) / 揺れ=周期的な波(ビブラート向き) / JSON=キャンバスに自分で描く

  • 一定Flat
  • 上昇Rise
  • 下降Fall
  • アタック減衰AttackDecay
  • 揺れWobble
  • JSONJson
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のままが基本です

Overview

Creates a free-form "time → value" curve (AutomationCurve). Define arbitrary motion shapes that standard waveform nodes such as sine cannot express—for example, a hold followed by a sudden start and a gradual stop—using presets or a JSON sample sequence.

Usage tips

  • Start with a preset for the quickest setup. Supply a JSON sample sequence when you need more elaborate motion.
  • If the nine options in ease_in_out are enough, that node is simpler. Use this node when you want to design the shape of the curve itself.
  • Connect it to a compatible node with a curve input to drive a parameter over time.

Generates an AutomationCurve from a preset or JSON samples.

Ports

Direction Port Type Description
Output curve AutomationCurve Generated control curve

Parameters

  • duration: Duration of the curve
  • samples: Number of output samples
  • preset: Flat / Rise / Fall / AttackDecay / Wobble / Json
  • json_samples: A JSON array of values from 0 to 1, shown only for preset=Json
  • output_min: Output value when the curve value is 0
  • output_max: Output value when the curve value is 1

Notes

Version 2 supports presets and JSON input. Known legacy lowercase values remain accepted for compatibility, but any other unknown value is an error instead of silently selecting a default. Invalid JSON is also reported as an evaluation error without replacing the entered text. A dedicated CurveEditor UI remains a future extension.

Related nodes

  • ease_in_out — nine standard easing modes (check whether this is enough first)
  • keyframe_clip — keyframes for shapes and poses rather than values
  • image_to_automation / path_to_automation — create curves from images or paths

Related Nodes

Ease In/Outease_in_outKeyframe Clipkeyframe_clipImage To Automationimage_to_automation
Back to Node List