class="CHAPTER" bgcolor="#FFFFFF" text="#000000" link="#0000FF" vlink="#840084" alink="#0000FF">

Menus

This section deals with all the title bar menus that can be used in Melys. Many of the features can also be driven by the keyboard and in most cases this is the best way to work. Keyboard short-cuts are shown to the right on each menu entry. The shortcuts can be changed in the standard gtk+ manner by highlighting a menu entry by placing the mouse over it and typing the required key combination. Such user defined shortcuts are not saved however (they should be, its just not implemented yet).

Title bar menus

File

This is the standard file menu that allows you to open and save files and exit the application. You can also open files by dragging them from a graphical file manager.

Open

This will bring up a dialog box that will allow you to select a file to read. You may select any file type that Melys knows how to read. At the current time this includes MIDI files ending in .mid or .smf and MDML files ending in .mdml. It will also read compressed MDML. Compressed files can have the same .mdml ending or a .mdml.gz ending which they would have if compressed with gzip.

You can have several files open at once. The limit is the number of queues that the sequencer is configured with (currently 8). Each file appears in its own top level window. If you click and drag the notebook tab below the main area you can place several files into the same notebook window.

Close

This will close the current file. If the file is playing it will stop.

Warning

There are currently no warnings if it has not been saved. I do not intend to add any warnings as they slow down work, instead all operations will be undo-able.

New

A new song is created. It will have a number of tracks pre-allocated setup with default channel and device numbers. However there are no limits to the number of tracks and you can add more, or delete all the unused ones.

Save

The current file is saved to the file it was read in from or last written to. If there is no remembered filename (for example if it is new) then you will be prompted, just as with the Save as... menu item.

Save as...

Save the current file with a specified filename. A dialog box is brought up to allow the name to be specified.

Exit

Exits Melys.

Warning

There is currently no warning if files are not saved and all unsaved changes will be lost.

Actions

Play

Starts the current file playing. Has no effect if the file is already playing. It is (currently) possible to start another file at the same time that another is playing. This will probably be disallowed or modified in future.

Pause

The playing file is stopped temporarily. If play is later selected the song will continue from the same point that it stopped at.

Stop

The playing file is stopped. If the file is re-started it will begin playing from the beginning.

Record

Recording starts. If the file is not already playing, then it will start to play. Incoming events are recorded on each track that has the record button pressed until Record stop or Stop is selected. Each track has an associated recording source and only events from that source are recorded to that track.

Events are merged into any existing track parts. New parts are created as necessary to hold events that occur outside of existing parts.

Note

In the future there will be other modes for storing new events such as replacing the events that currently exist.

Record stop

Recording is stopped. The song will continue playing if it has not already finished and recording can be restarted by selecting Record again.

Windows

This menu contains an entry for each open file. Any file can be selected from this menu and it will be brought to the front. This will work even if the file is in another window.

In addition there are the following entries.

Close all

This will close all open windows.

Debug

This menu item will only appear if Melys is built for debugging. It will show some information that may be useful in debugging Melys.

Help

This menu contains the usual useless information. The about item shows the version of Melys and who to complain to when something doesn't work.

The manual item brings up the manual that you are reading now.