The Piano Roll Editor allows you edit individual notes and tweak aspects of their playback.
To open the Piano Roll Editor (PRE), right-click on a measure in the score and choose the Piano Roll Editor option from the context menu. The Piano Roll Editor will open showing the staff and measure where you clicked. If the Piano Roll Editor is already open, it will be updated to show the new staff and measure you clicked on.
The Piano Roll Editor is divided into several sections. At the very top is a row of buttons and controls that affect playback and can modify notes. The name of the part being edited is at the top right.
The central portion contains the Note Display Area which allows you to view and edit notes. Each note is displayed as a block, with yellow blocks representing selected notes, and darker green blocks representing unselected notes (these colors can be changes in the Preferences). Given sufficient space, each block will display its pitch on the left and the voice it is assigned to on the right. Changing the size of the note blocks is covered in the navigation section.
To the left of the Note Display Area is the Keyboard. By clicking on a key in the Keyboard, you can hear a sample of that note playing. As you move the mouse in either the Node Display Area or the Keyboard, a key on the keyboard will light, corresponding to the pitch you are over. You can also hover your mouse over a particular key to get more information about that pitch. If you are using a Drumkit, the keys of the keyboard will show the name of the drum assigned to that particular pitch. For instruments that are not concert C, the keyboard will be adjusted so that the C of the keyboard matches the C of the instrument.
Along the top of the Note Display Area is the Measure Ruler which displays the current position of the playback head, as well as the current looping range if it set.
The bottom of the editor contains the Levels Display Area. It is a bar graph showing extra data values assigned to each note, such as its velocity or cutoff time. To the left of the Levels Display Area is a dropdown menu allowing you to select the type of data you wish to see displayed or edited.
There are several ways to move about in the Piano Roll Editor. First of all, you can click and drag on the scroll bars on the edges of the Note Display Area.
The mouse wheel can also be used to pan and zoom as follows:
To jump to a particular measure, switch back to score view and find the measure you wish to see. Then right-click on the measure and select Piano Roll Editor. The Piano Roll Editor will scroll to center on the measure you clicked.
In the Note Display Area, you can click on single notes or click and drag to select a group of notes. Holding down the modifier keys will affect how your selection changes:
To change the pitch of a selection of notes: Drag a selected note up or down to a new pitch; or press the ↑ or ↓ arrows. Note: Dragging the note horizontally to change the start time is not supported at the moment.
To delete a selection of notes: Press the Del key.
To move a note selection to another voice: Click the desired voice number button at the top of the editor.
To add notes:
Notes can be inserted by clicking in the Piano Note Area with the modifier keys held. These edit operations will use the beat or subbeat line to the left of the spot where you click as the point where a note is altered:
Ctrl: A note of the current insert note duration will be added at the subbeat and pitch where you clicked. The note insert length is the same as the one you use to add notes in note entry mode in the score. If you wish to change the duration, you will need to select this in the Score View as the Piano Roll Editor does not currently have these buttons. If notes already exist in this location, a chunk will be cut out of them to make room for the note you are inserting, unless they happen to have the same start time and duration of the note you're adding, in which case the new note will simply be appended to the existing chord. Tuplets are currently not supported, and so will be ignored.
Shift: Looks for a chord that already spans this subbeat line. If it finds one, appends a new pitch to the existing chord. Otherwise, this is a rest and the rest will be replaced with a note of equal start time and duration to the existing rest.
Ctrl+Shift: Looks for a chord or rest that spans this subbeat. This chord will be cut in two at this subbeat line. Tuplets are currently not supported, and so will be ignored.
To edit note event data:
Note event data can be changed in the Levels Display Area. To edit event data such as velocity or cutoff time, first select the notes you wish to edit in the note area. Then click in the Levels Display Area on the corresponding bar; the value of the level will changed to correspond to the point where you clicked. You can also click and drag in this area to change the levels of several notes with a single gesture. If you want the levels to all be set to the same value, hold Shift while dragging. Only selected notes will have their value changed - this is to prevent you from accidentally changing the values of other notes.
The Levels area can display the same data in multiple ways. For example, velocity data can be displayed both as absolute (i.e., relative to the output midi volume) and relative (i.e., as an offset to the dynamics value). You can switch between these display modes as you see fit.
From left to right the controls have these functions;
Subdivides the beat by adding extra divisions to the Note Display Area. The value indicated the number of time the beat will be subdivided. So for 4/4 time, a division of 2 will draw grid lines at every eighth note; a division of 3 at every sixteenth note, and so on. Setting the subdivision is necessary for some editing operations if you wish to place notes off the beat.
For larger numbers of subdivisions, you may need to be zoomed in to see the extra grid lines since grid lines are not drawn below a certain density. Combines with the tuplet control which also affects grid line placement.
Adds additional grid lines, subdividing the beat to show the rhythmic placement of tuplets. For example, setting tuplets to 3 will show the beat subdivided into three parts. Combines with the subdiv control to show subdivisions of the tuplet. For example, setting tuplets to 3 and subdiv to 2 will draw grid lines showing the tuplet beats subdivided into two parts - i.e., the beat will be subdivided into 6.
Selecting a tuplet mode other than 1 will disable some of the note insertion tools for the Piano Roll Editor. For larger numbers of subdivisions, you may need to be zoomed in to see the extra grid lines since grid lines are not drawn below a certain density.
Shows the velocity of the currently selected note (only one note may be selected). Indicates the loudness of the note. This can be expressed as 'Offset' or 'User':
When you switch from User to Offset or vice versa, the value will be recalculated to best match the value in the other system. This way you could, for example, switch to User mode to set the value as you would like it to sound in MIDI output and then switch to Offset so that this value respects the dynamic marking instead of overriding it. At the moment you switch back, the offset value will be recalculated to match the User value in loudness but will no longer act as an override so you may later change the dynamic.
Some keys are hooked up to perform special actions:
The Piano Roll Editor will display in both normal mode and dark mode. If you wish to change the colors the Piano Roll Editor uses to display in these modes, they can be adjusted in the Preferences under the Advanced tab. All the Piano Roll Editor related properties begin with ui/pianoroll/light for light mode and ui/pianoroll/dark for dark mode.