Skip to content

The Panel (Control Surface)

The Panel is a separate canvas where you build custom control surfaces using widgets. It's designed for live performance and hands-on interaction.

Overview

The Panel is independent from the Graph Canvas. While the graph defines your audio signal flow, the Panel provides a user-friendly interface for controlling parameters.

Edit vs Perform Mode

ModePurpose
Edit (Unlocked)Add, move, resize, and configure widgets
Perform (Locked)Interact with widgets only:no accidental edits

Toggle between modes using the lock button in the Panel toolbar.

Available Widgets

WidgetDescription
Slider (V/H)Vertical or horizontal slider for continuous values
KnobRotary control for parameters
ButtonTrigger an event
ToggleOn/off switch
ComboBoxDropdown selection
RadioGroupMutually exclusive choice buttons
XY PadTwo-dimensional control (e.g., filter freq + resonance)
TextDisplay or edit text values
ImageDisplay an image file
ShapesSquare, Rectangle, Circle, Triangle, Hexagon, Arc, Line, Polygon
Keyboard (Keymap)Piano keyboard for playing notes
Sample ViewWaveform display
Sample MapMulti-sample zone editor
MIDI Drag ExporterDrag MIDI clips out of MNodes

Adding Widgets to the Panel

  1. Widgets are node types:add them from the Node Palette in the graph
  2. They automatically appear in the Panel view
  3. Position and resize them in Edit mode

Widget Parameters

Each widget has configurable properties:

  • Min / Max / Default values
  • Step size for discrete steps
  • Prefix / Suffix labels (e.g., "Hz", "dB", "%")
  • Color customization
  • Expose to DAW toggle for automation

Connecting Widgets

Widgets have output pins in the graph that you connect to other nodes:

  • A Knob outputs its current value as Data
  • A Button outputs an event
  • A Keyboard outputs MIDI notes
  • An XY Pad outputs two values (X and Y)

Panel Layout

  • Grid snapping:Optional grid for alignment
  • Background color:Customizable per-panel
  • Zoom:Adjustable view scale
  • Toolbar:Toggle visibility

Panel State

Panel layout (widget positions, sizes, and view settings) is saved as part of the preset file, separate from the graph state.

MNodes Documentation