Piano Roll Node

Provides a simple and fast piano roll to create melodic patterns and sources by hand, as well as to record and edit recorded melodies.

The Piano Roll Node can be connected to an audio source Node to drive audio synthesis with the created melody, such as the Oscillator Node or the Sampler Node.

The Piano Roll Node appears on the Timeline when you place it.

Editing

This Node provides a simple and fast piano roll to edit melodic patterns. The piano roll can be opened either from the properties panel, or by double clicking on the node (both in Patcher and Timeline). Navigation is mostly identical to that of the Timeline (e.g. hold and drag to move the viewport, zoom with mouse-wheel or pinch-zoom), with the following additions:

Place noteLeft-click or tap on an empty cell. If a note is selected, the new note’s duration will be the same as that of the selected note; otherwise, the current grid-size setting is used to determine duration.
Select noteLeft-click or tap on a note. Hold the Ctrl key to add/remove from selection.
Note propertiesRight-click or tap-and-hold on a note, then select Properties.
Delete noteRight-click or tap-and-hold on a note, then select Delete.
If multiple notes are selected, the operation is performed on each selected note. The Del hotkey can also be used.
Clone noteRight-click or tap-and-hold on a note, then select Clone. If multiple notes are selected, the operation is performed on each selected note. The Ctrl-D hotkey can also be used. If holding Ctrl when notes are moved, they are also cloned before moving.
Move noteLeft-click-and-hold or touch-and-hold then drag a note. If holding Ctrl when notes are moved, they are also cloned before moving.

Recording

The Piano Roll Node can record live play through its Melody input. If a source with a live Melody is connected (such as a MIDI Keyboard Node), click or tap the Record button in the “dropdown” section of the header when the Piano Roll is open. This will start recording as soon as the connected input updates (e.g. by pressing a key on a connected MIDI keyboard). When finished, simply click or tap the Record button again.

Note: melody preprocessing can be applied to the input before it reaches the Piano Roll Node. For example, to automatically record each note from a keyboard as a chord, connect your Melody source through a Component Extension Node.

Snapshots

The Piano Roll Node can also take a snapshot of non-live Melody data, such as the output of another Piano Roll, or a Sequencer Node. To do this, simply connect a non-live Melody line to the Melody input, then click on the Snapshot button in the “dropdown” section of the header when the Piano Roll is open. This will copy the source Melody into the Piano Roll. This can also be used to inspect the effect of Melody preprocessor Nodes (such as the Component Extension Node).

Note: taking a snapshot will erase any previous contents in the Piano Roll editor. The previous contents can be restored by doing an Undo.

Inputs

This Node has no inputs.

Settings

Most of this Node’s settings are accessible by opening the Piano Roll editor.

Grid sizeSets the grid size to use in the editor.
Snap to gridWhen set, notes are snapped to the nearest grid cell.
Lock editingWhen set, editing is disabled. This is useful to prevent accidental modifications.
RepeatWhen set, shows a window that lets you define a region to repeat for the entire project duration.
Holding Ctrl and dragging on an empty editor area can also be used to set the repeat region quickly.
Track nameA visual name by which the Piano Roll’s track can be identified on the Timeline.
This is purely visual.

Outputs

MelodyThe Melody created in the Piano Roll.