Quantize Pitch

A path-local pitch constraint that snaps an incoming note value to this node’s authored root and scale. Unlike a global setting it applies only along the routing it sits on, so different branches of a patch can enforce different tonalities. Use it to keep a specific voice or line in key without affecting the rest of the graph.

Inputs

Note In

• ID: note
• Kind: control
• Rate: control
• Unit: midiNote
• Range: 0 to 127 midiNote
• Coercion: Implicit
• Default: 60

Root In

• ID: root
• Kind: control
• Rate: control
• Unit: midiNote
• Range: 0 to 127 midiNote
• Coercion: Implicit
• Description: Optional graph-authored root override as a MIDI note.

Scale In

• ID: scale
• Kind: control
• Rate: control
• Unit: count
• Range: 0 to 7 count
• Coercion: Implicit
• Description: Optional graph-authored scale override: 0 chromatic, 1 major, 2 minor, 3 pentatonic, 4 blues, 5 dorian, 6 mixolydian.

Scale

• ID: scaleContext
• Kind: scale
• Rate: event
• Coercion: Forbidden
• Description: Optional connected Scale value that overrides the authored Root and Scale parameters.

Outputs

Note Out

• ID: note
• Kind: control
• Rate: control
• Unit: midiNote
• Range: 0 to 127 midiNote
• Coercion: Implicit

Changed

• ID: changed
• Kind: trigger
• Rate: event
• Coercion: Implicit
• Description: Trigger emitted when quantized note changes

Parameters

Scale

• ID: scale
• Type: enum
• Control: select
• Range or Options: Chromatic (chromatic), Major (major), Minor (minor), Pentatonic (pentatonic), Blues (blues), Dorian (dorian), Mixolydian (mixolydian), Custom (custom)
• Default: Chromatic (chromatic)

Root

• ID: root
• Type: enum
• Control: select
• Range or Options: C (C), C♯ (C#), D (D), D♯ (D#), E (E), F (F), F♯ (F#), G (G), G♯ (G#), A (A), A♯ (A#), B (B)
• Default: C (C)

Notes

• Canonical ID: pitch.quantize
• Category: utilities
• Runtime Surface: control
• Runtime Targets: control-main-thread
• JUCE Early Access: Supported
• Early Access Note: Native-supported in the plugin for the current catalog/runtime support contract.
• Scale and root are authored on this node, so two Quantize Pitch nodes can impose different harmonic constraints in one patch.
• A connected Scale value overrides the authored Root and Scale parameters and is lowered into those params for runtime.
• When connected, Root In and Scale In override the stored root and scale parameters for explicit host or graph-driven harmony.
• Does not read patch-wide key context; connect or configure a Quantize Pitch node wherever a pitch path needs harmonic constraints.