Controller

To start the Osiris system the following command should be issued:

     osiris

Then, the Controller window appears (see Fig 6.1). It consists of a menu-bar, two tool-bars and a status-bar. The menu-bar controls all features of Osiris. The tool-bars handle the most commonly used actions. The status-bar displays information about actions and theirs results.

Figure 6.1: Controller, the main window.

The structure of the menu-bar is given below:

File

Takes care of opening and saving projects, as well as defining the name of an output file to be generated using Generator. Consists of following sub-menus:

New

It creates a new project, all unsaved information will be lost.

Open

It opens a dialog which helps to choose a file to load (see Fig 6.2) A file have to be an Osiris datafile.

Save

It saves a project. The filename is the same as a filename of current project or it is noname.osiris.

Save As...

It allows to save a project using other filename. A dialog window is shown to choose a filename (similar to Open)

Properties

It invokes a dialog (Fig 6.3), which provides the way to set a name of a file which will be generated by the Generator. A filename could be typed explicitly or using a dialog window similar to Open by pressing $[\ldots]$ button.

Quit

It exits the Controller and the Osiris, as well. There is a keyboard shortcut defined: Ctrl + Q.

Modules

This menu consists of Osiris modules:

Edit

Opens Editor window.

Validate

Executes the Validator, if there are any errors, they will be reported by the status-bar and by an additional window with an appropriate message.

Generate

Executes the Generator, if there are any errors, the user will be noticed by the status-bar and an additional window with an appropriate message.

Launch

Executes the Launcher with the output file generated by the Generator. As default, the gKheops will be started with the output file loaded into the Kheops environment.

Configuration

Allows to change the configuration of Osiris:

Modules

Creates a new window (see Fig 6.4), which allows to change filenames of external modules to be used as the Validator, the Generator and the Launcher modules. The default values are: ovalid for the Validator, ogener for the Generator and gkheops for the Launcher.

Help

These are Help windows.

Manual

Osiris user's manual.

About

About Osiris.

License

The License.

Figure 6.2: Open file dialog window.

Figure 6.3: Output file properties window.

Figure 6.4: Configuration window.

The tool-bars implement shortcuts to certain, commonly used menu-items. There are two tool-bars: the project tool-bar and the modules tool-bar.

All buttons and actions associated with for the tool-bars are shown in Table 6.1.

Table 6.1: Controller tool-bar, tool-bar to menu associations.

button's name	menu-item
New	File/New
Open	File/Open
Save	File/Save
Edit	Modules/Editor
Validate	Modules/Validator
Generate	Modules/Generator
Launch	Modules/Launcher

Both the menu-bar and the tool-bars are detachable components. It means that they can be moved from the Controller window and placed anywhere on the desktop the user wants. It can be done using a special vertical bar, located on the left of the menu-bar or the tool-bars, called a handler. When the handler is dragged, the given widget is taken off the window. To put a widget back, the handler should be doubly clicked.