Yotsuba Games
Back to Node List

Path To Automation

path_to_automation

Draw sound movement with the mouse: converts a drawn path (horizontal = time, vertical = value) into a curve for pitch or gain. Great for free-form pitch slides you would struggle to type in

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

Input Ports

NameTypeDescription
パス
path
Path
Required
読み取るパスです。左端=音の始まり、右端=終わり、高さ=値として読みます。複数描いた場合は最初のサブパスだけが使われます

Output Ports

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

Parameters

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

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

サンプル数
samples
Int
2562–4096

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

Y反転
invert_y
Bool
true—

ON(既定)だと、キャンバスの上に描いた線ほど高い値=高い音・大きい音になります(直感的)。OFFにすると画面座標そのまま(下ほど大きい値)で読みます

出力最小
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

Converts a curve drawn in the path editor into a time curve (AutomationCurve). Design pitch or gain changes freely as if drawing a Bezier graph where horizontal means time and vertical means value.

Usage tips

  • A practical SFX workflow is to draw a shape that rises sharply and falls → path_to_automation (set output_min/max in semitones) → audio_oscillator.pitch_curve. The line shape becomes the character of the sound.
  • For gain, an output range of 0–1 is standard.
  • If the curve shape changes often, this is faster to edit than the preset-based automation_curve.

Related nodes

  • audio_oscillator — a common curve destination
  • automation_curve / image_to_automation — alternate ways to create curves
  • bezier_path / multi_path_editor — draw the source path

Converts a Path into a time-based AutomationCurve, reading the horizontal axis as time and the vertical axis as value.

Ports

Direction Port Type Description
Input path Path Source path; only the first subpath is read
Output curve AutomationCurve Generated control curve

Parameters

  • duration: duration of the curve
  • samples: number of curve samples
  • invert_y: treats upward lines as higher values
  • output_min: output value for curve value 0
  • output_max: output value for curve value 1

Notes

For pitch control, set output_min / output_max in semitones. For gain control, 0..1 is the standard range.

When a Path contains multiple subpaths, only the first is read and a non-fatal warning is shown. Reduce the source to the intended single subpath when all other shapes should be ignored deliberately. A connected empty Path returns a zero curve with a warning; a missing or mistyped required path is an evaluation error.

Related Nodes

Audio Oscillatoraudio_oscillatorAutomation Curveautomation_curveBezier Pathbezier_path
Back to Node List