Back to Node List

Image To Automation

image_to_automation

Reads image brightness as a time-domain automation curve

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

音の長さ(秒)

サンプル数
samples
Int
2562–4096

オートメーションカーブのサンプル数

axis
Enum
Horizontal

左→右または上→下へ読み、直交方向は平均します

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

平均するチャンネル。Brightness はalpha加重、RGBは透明pixelの隠れた色も読みます

  • 明るさBrightness
  • アルファAlpha
  • redRed
  • greenGreen
  • blueBlue
出力最小
output_min
Float
0-96–96 / step 0.1

カーブ値 0 のときの出力値

出力最大
output_max
Float
1-96–96 / step 0.1

カーブ値 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