Back to Node List

Image To Automation

image_to_automation

Turns pixel art into sound: scans an image and reads its brightness (or a channel) as a curve. Feed a sprite in and wire the curve to an oscillator's pitch for an image-driven warble

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
画像
image
Image
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

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

axis
Enum
Horizontal

画像のどちら方向を時間として読むかです。横方向=左端が音の始まりで、縦1列ずつ平均して1つの値に。縦方向=上から下へ読みます

  • 横方向Horizontal
  • 縦方向Vertical
チャンネル
channel
Enum
Brightness

各ピクセルから何を読むかです。明るさ=見た目の明るさ(透明部分は0扱い。通常はこれ) / アルファ=不透明度だけ / R/G/B=各色チャンネル(透明ピクセルに隠れた色も読みます)

  • 明るさBrightness
  • アルファAlpha
  • redRed
  • greenGreen
  • blueBlue
出力最小
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 image brightness into a time curve (AutomationCurve). It treats the horizontal image axis as time and repurposes the brightness pattern as changes in volume or pitch. This makes gradients and noise useful as curve material.

Usage tips

  • Reading a noise image quickly creates a randomly fluctuating curve; reading a gradient creates a monotonic rising or falling curve. This is faster than writing automation_curve JSON.
  • A common destination is the pitch or gain curve of audio_oscillator.
  • To draw an exact curve shape, path_to_automation provides a more direct path-based method.

Related nodes

  • path_to_automation — the path-drawn counterpart
  • automation_curve — preset and JSON version
  • audio_oscillator — a common curve destination
  • noise_generate / coordinates — generate the image to read

Converts image brightness or channel values into a time-based AutomationCurve.

Ports

Direction Port Type Description
Input image Image Image to read
Output curve AutomationCurve Generated control curve

Parameters

  • duration: duration of the curve
  • samples: number of curve samples
  • axis: Horizontal / Vertical
  • channel: Brightness / Alpha / Red / Green / Blue
  • output_min: output value for curve value 0
  • output_max: output value for curve value 1

Notes

Horizontal scans left to right and Vertical scans top to bottom. Each sample averages every pixel on the perpendicular row or column. Brightness reads luminance × alpha; Alpha reads alpha directly. Red, Green, and Blue also read hidden RGB from fully transparent pixels. A missing or mistyped required image is an evaluation error rather than a valid zero curve. Known legacy lowercase enum values remain accepted, while any other unknown value is an error.

Back to Node List
Image To Automation — PixPipeline Node Reference