Knob Node

The Knob Node displays a customizable knob on the Patcher, and outputs a constant value controlled by it. It’s very useful for building custom Nodes with turnable knobs, or controlling multiple Nodes from a single place.


Inputs

The Knob Node itself does not expose any inputs. However, when placed inside a subpatch, the Knob Node creates an input on the subpatch container Node itself. That input can then be used to control its value from the outside, similarly to how many Nodes have controllable settings, such as the Gain Node’s Gain setting.


Settings

Value

The output value. Clamped between Min. value and Max. value.

Min. value

Minimum value of the control knob.

Max. value

Maximum value of the control knob.

Origin

The starting point of the knob’s visual fill. This setting is visual, and has no effect on the output.

Curve

Adjusts how the knob scales as you turn it. A value of 1 represents a linear value. A value greater than 1 causes values to change slowly at the start, and then speed up towards the end (useful for frequency-related settings). This setting is visual, and has no effect on the output.

Step

Rounding step. For example, if set to 1, the Value will be an integer.

Marks

Adds dashes into the knob’s visual fill. To use multiple values, separate numbers with a comma, e.g. “1, 1.5, 2” (without the surrounding quotes). This setting is visual, and has no effect on the output.

Order

Sets the Knob Node’s appearance order when used in a subpatch (e.g. a Subpatch Node). Affects both input order, and the Knob Node’s appearance order on the properties panel. Lower values appear first. Has no effect when used outside a subpatch.

Theme

Sets the knob’s color. This setting is visual, and has no effect on the output.

Dividers

Adds dividers when the Knob Node appears on the properties panel of a subpatch (e.g. Subpatch Node). This setting is visual, and has no effect on the output.

Size

Sets the knob’s size. This setting is visual, and has no effect on the output.


Outputs

Control Output

The value specified by the Value setting. This value is always constant, and thus enables constant folding in connected Nodes if they support it (unless the Knob Node is controlled through a subpatch input using a non-constant connection).