<qt bgcolor="#f4f4c8" title="MusE - The Linux (Midi) Music Editor">
<center><h1>MusE - The Linux (Midi) Music Editor</h1></center>

<h2>4. Window Reference Guide</h2>
<p>
<h2>4.1 The Main Window</h2>
Here's a screenshot of the main window, with a standard MIDI file already
loaded:
<p>
<img src="main_window.jpg"</img>

<p>
The main window is basically divided up into two panes separated by a
veritcal bar that is movable horizontally.  These two panes together
are called the Arranger.

<h2>4.2 The Arranger</h2>
<p>
The left pane of the Arranger describes each track in detail,
while the right pane describes each track graphically.

<h3>4.2.1 The Left Pane</h3>
<img src="left_pane.jpg"</img>
<p>
The left pane details the following information for each track:
<ul>
  <li>A -??
  <li>M - Mute the track
  <li>C - Defines whether the track is one of MIDI, Drum or Wave.
  <li>Track - A freely-editable track name.
  <li>Ch - Defines which MIDI Channel this track plays on.
  <li>Port - Defines which MIDI port this track plays on.
  <li>T -??
</ul>

You can select which track is currently "active" by simply clicking
on the track.
<p>
When a track's M column is clicked, that track is marked as Muted with
a red circle and upon playback that track will not be heard.  To hear
the track, click on the M column for that track again.
<p>
Right click on the C column for a track to declare the track to be of
type MIDI, Drum or Wave.
<p>
The Track column is free-form, meaning that a double-click on a track's
Track column will allow you to enter a descriptive name for the track,
for example "Hot Lead Guitar".
<p>
The Ch column for a track is changed by right-clicking to increment the
number or middle-clicking to decrement the number.  It's generally a
good idea to keep differing instruments on different MIDI channels and it's
considered common to have the drum kit on channel 10.
<p>
<h4>4.2.1.1 Track Info</h4>
<p>
At the bottom of the left pane, you'll see a little button labelled
"TrackInfo".  When clicked, the standard information plus more about
the currently selected track is presented:
<p>
<img src="track_info.jpg"</img>
<ul>
  <li>Track Name
  <li>Channel
  <li>Transpose
  <li>Delay
  <li>Length
  <li>Velocity
  <li>Compr
</ul>
The bottom half of the TrackInfo display describes MIDI channel information:
<ul>
  <li>MIDI Instrument
  <li>H-Bank
  <li>L-Bank
  <li>Progr
  <li>Volume
  <li>Pan
</ul>

<p>
Operations that can be performed on the left pane:
<table border=1>
<th> <strong>Track Functions </th> <th>&nbsp;</th>
<tr><td>Select Track<td>
  <ul>
    <li>Left Mouse Button
  </ul>
<tr><td>Select multiple Tracks<td>
  <ul>
    <li>Shift + Left Mouse Button
  </ul>
<tr><td>Change Selected Track<td>
  <ul>
    <li>Key Up: previous Track
    <li>Key Down: next Track
    <li>click with left mouse button in name field
  </ul>
<tr><td>Move Track<td>
  <ul>
    <li>Drag with left Mouse Button
  </ul>
<tr><td>Create New Track<td>
  <ul>
    <li>Pulldown Edit<br>
    <li>Ctrl T
    <li>double click in empty track
  </ul>
<tr><td>Delete selected Track(s)<td>
  <ul>
    <li>Pulldown Edit
    <li>Del
  </ul>
<tr><td>Rename Track<td>
  <ul>
    <li>doubleClick with left mouse button
        on track name
  </ul>
<tr><td>Change Midi Channel<td>
  <ul>
    <li> left mouse button increments midi channel
    <li> middle mouse button decrements midi channel
  </ul>
<tr><td>Select Midi Port<td>
  <ul>
    <li> click with right mouse button on portname;
         select from pulldown menu
  </ul>
<tr><td>Mute Track<td>
  <ul>
    <li> click with left mouse button on M field in
         Tracklist
  </ul>
<tr><td>Solo Track<td>
  <ul>
    <li> click Solo button
  </ul>
</table>


<h3>4.2.2 The Right Pane</h3>
<img src="right_pane.jpg"</img>
<p>
The right pane desribes each track graphically.  Time moves from left
to right and is measured in beats that are referenced at the top of
the right pane.  Tracks are displayed vertically in boxes, called
"Parts", that depict where MIDI and audio data are played.
<p>
The small sliders that are adjacent to the bottom right corner affect
the view of the right pane in terms of "zooming".  The vertical slider
affects the height of the tracks, while the horizontal slider affects
the width.
<p>
Operations that can be performed on the right pane:
<p>
<table border=1>
<tr><td><b>To do this...<td><b>...Do this
<tr><td>Select Part<td>Left Click
<tr><td>Select multiple parts<td>Shift + left click
<tr><td>Select all parts on track<td>Ctrl + left click
<tr><td>Change selected part<td>Key left: previous part, Key right: next part<p> Key up: nearest part on track above, Key down: nearest part on track below
<tr><td>Move locators to beginning and end of selected part<td>Alt+P
<tr><td>Move part<td>Drag with left mouse button
<tr><td>Create new part<td>select Pencil tool; draw with left mouse button pressed, OR set left and right mark; double click on track
<tr><td>Delete selected part(s)<td>select rubber tool; click part to delete
<tr><td>Rename part<td>double click with left mouse button on part
<tr><td>Copy part<td>drag with shift + left mouse button
<tr><td>Cut part<td>select Cut Tool; click on part to cut
<tr><td>Glue part<td>select Glue Tool; click on part to glue with next part
</table>
<p>

<h3>4.2.3 The Button Bar & Menus</h3>
<img src="button_bar.jpg"</img>
<p>
Across the top, above the Arranger, is a menu system, icons and other
widgets that you use to manipulate your project.  Most of these are
self-explanatory, while others are described later in this document.


<h2>4.3 The Pianoroll</h2>
<img src="pianoroll.jpg" border="1"></img>
<p>
The Pianoroll displays the contents of a midi track. 
Notes are entered with the pencil tool, and are moved around with the arrow tool.
The snap value is used to snap the notes to the grid (use no snap value to move the notes freely).
Quantize is used to move existing notes closer to a defined interval (f.ex. a quarter note). For example, If one records a piece
and want to adjust timing errors. Other alternatives in the menu are scale velocity, gate time modification and selection of specific events
<p>
Pressing the 'ctrl'-button in the lower left corner of the pianoroll opens the controller editor.
Keyboard shortcuts and other things that can be used in the pianoroll:
<table border=1>
<tr><td><b>To do this...<td><b>...Do this
<tr><td>Change current position<td>Key left, Key right
<tr><td>Undo last change<td>Ctrl+Z
<tr><td>Select all events in current part<td>Ctrl+A
<tr><td>Select all events with a certain pitch<td>Ctrl key + Left click on event
<tr><td>Insert silence<td>Insert key
<tr><td>Change quantization & stick to value btwn 1-1/64th<td>Key 1-Key 7
<tr><td>Toggle triplets on/off in quantization & stick to<td>T-key
<tr><td>Toggle period (long notes?) on/off in quantization & stick to<td>Period key
<tr><td>Change event color-mode<td>E-key
<tr><td>Move locators to beginning and end of selected events<td>Alt+P
</table>

<h2>4.4 The Control Editor</h2>
<img src="controleditor.png" border="1"></img>
<p>
The control editor is where you can edit controllers and velocity. Use the 'Sel' button to select the controller you wish to edit.
The above window is an example of the velocity values for a group of notes. To edit velocity, or already existing controller values, 
just select the pen tool and paint in the controller pane.

<h3>4.4.1 Managing controls</h3>
<img src="control_dialog.png" border="1"></img>
<p>
When pressing the 'Sel'-button, different controllers will be shown based on the controllers existing in the song. If you want to 
add a controller not previously in the track, select the option at the bottom of the popup-menu when pressing the 'Sel'-button. 
This opens the dialog for managing controllers. You can add new controllers to the list as well as save and load controller sets.
<br>

<img src="controleditor2.png" border="1"></img>
<p>
To create new controller events when there aren't any existing controller events already entered can be a little counter-intuitive if you're not used to it.
This is done by either selecting the pen tool and holding down the shift key while left-clicking in the controller pane, or using the line tool 
when left-clicking with the shift key pressed.
<p>
If you only want to edit already existing controller values, just left click using the pen or line tool. This only changes already existing controller values
without creating new controller events. The above example shows editing of pan controller events.

<h2>4.5 The Drum-editor</h2>
<h3>4.5.1 The left pane</h3>
<img src="drummap.png" border="1"></img>
<p>
The left pane of the drum editor displays the drum map, made up of drum instruments. When creating a drum track, a default drum map is loaded. It's also possible
to load and save your own drummaps.
<p>
The different parameters for the instruments are as follows:
<table border="1">
<tr><td>M<td>Toggle instrument mute
<tr><td>Sound<td>Name of the instrument
<tr><td>Quantize value<td>Self-explanatory. Quantize value is currently not used though
<tr><td>E-Note<td>The physical note that is actually stored
<tr><td>Len<td>Default len value. All events created will have this value
<tr><td>A-Note<td>The note actually played. (Whenever a E-note occurs, an A-note is played)
<tr><td>Ch<td>The channel the note is sent to. Makes it possible to f.ex. use different soundfonts in fluidsynth from the same drum map
<tr><td>Port<td>The port the note is sent to. Makes it possible to f.ex. use different soundfonts in fluidsynth from the same drum map
<tr><td>LV1<td>Level value 1. When creating a note with left-click+Ctrl+Shift, this is the velocity value the note is given
<tr><td>LV2<td>Level value 2. When creating a note with left-click+Shift, this is the velocity value the note is given
<tr><td>LV1<td>Level value 3. When creating a note with left-click+Ctrl, this is the velocity value the note is given
<tr><td>LV4<td>Level value 4. When creating a note with left-click, this is the velocity value the note is given
</table>

<p>
To edit the particular values, you can either double click the value you wish to change or increase or decrease the value by using right and middle mouse keys. Changing port is done by pressing the right mouse button and selecting a value from the popup-menu that appears.
<p>
It can be tedious to enter the same value for many instruments, f.ex. port and channel value. To change all the channel and port values, hold down the Ctrl-button before clicking right or middle mouse button.
<p>
You can also switch the order between the instruments by pressing down the left mouse key on the name of a specific instrument, and drag it up and down.
(Note that some things are not completely finished in the editor. Changing the E-note on an instrument and then switching place makes the result unpredictable!
Since the output not (A-note) is generally the interesting one, changing the E-note is not particularly useful and this option might be removed in the future)

<table border="1">
<tr><td><b>To do this...<td><b>...do that
<tr><td>Toggle mute<td>Left click in the mute-column for the selected instrument
<tr><td>Change instrument name<td>Double click in the sound column for the selected instrument
<tr><td>Change quantization<td>Right/middle mouse click in the QNT-column for the selected instrument
<tr><td>Change E-note<td>Right/middle mouse click in the E-note-column for the selected instrument
<tr><td>Change Len<td>Right/middle mouse click or doubleclick in the Len-column for the selected instrument
<tr><td>Change E-note<td>Right/middle mouse click in the A-note-column for the selected instrument
<tr><td>Change Channel<td>Right/middle mouse click in the Channel-column for the selected instrument
<tr><td>Change Channel for all instruments in drummap<td>Ctrl+Right/middle mouse click in the Channel-column for the selected instrument
<tr><td>Change Port<td>Right-click in the Port-column for the selected instrument and select port from popup-menu
<tr><td>Change Port for all instruments in drummap<td>Ctrl+Right-click in the Port-column for the selected instrument and select port from popup-menu
<tr><td>Change default level values<td>Right/middle mouse click, or doubleclick in the LV1-LV4 columns
</table>

<p>
<b>Note:</b>
It's possible to only view and edit the velocity of one particular drum-instruments (this can be quite useful when you f.ex. want to edit the hihat only).
To do this, open the controller pane (press 'Ctrl' in the bottom left of the editor) and then select a particular instrument by clicking left in its 
sound-column

<h3>4.5.2 The right pane</h3>
<img src="drumeditor.png" border="1"></img>
<p>
Notes are entered using the pen tool and holding down ctrl, shift or ctrl+shift (to give them the different default level values).
Currently, there are not a lot of functions in the drum editor. It's possible to copy, move and delete events, as in the arranger and pianoroll.
You can also select all notes of a particular instrument by ctrl+left-clicking on a note.
<p>
To set all select drum notes to a particular length (the default lenght in the Len-column in the left pane), press Alt+L. Can be useful with particular soundfonts where the sound dies as soon as the note ends.
<br>
<br>
<br>
<br>
<br>
<br>
<br>
<br>
</qt>