Contents

Previous

Next

Subchapters

Current Chapters-> cmdline commandio graphicio debugio menubar omtoolbar editorio

Parent Chapters-> Omatrix6 starting omgui omtoolbar

Search Tools-> contents reference index search

The O-Matrix Toolbar

Description
The toolbar at the top of the screen (just below the menu bar) provides access to the some of the frequently used menu items. If a tool bar icon is not available, it is grayed out. For example, the hand icon is grayed in the second version of the toolbar above. It is possible, using the hide command, to gray out the entire toolbar. This should only be done by an O-Matrix program that does not wish to get input from the toolbar or command line.


The first icon displays a blank sheet of paper. Selecting this icon is equivalent to the File | Edit New Program menu item. This creates a new editor window with nothing in it.


The second icon in the toolbar displays an open file folder. Selecting this icon is equivalent to the File | Open Program menu item. This starts a browser dialog in which you can select an existing file. Once you select a file, a new editor window containing the contents of the file is created.


The third icon displays a floppy disk. Selecting this icon is equivalent to the File | Save menu item. If the currently active window is an editor window, it is saved to disk. If an editor window is not active, you can also use this icon to save the contents of the Command or Debugger window windows.


The fourth icon displays a lightning bolt. If the O> prompt is currently displayed, selecting this icon is equivalent to the File | Run Program menu item. If in addition, an editor window is currently active, the contents of the editor window will be run as an O-Matrix program. Otherwise, a browser dialog is displayed in which you can select an existing file. Once you select a file, it is run as an O-Matrix program.

If the DEBUG> prompt is currently displayed, selecting the icon is equivalent to the Debug | Next menu item which executes one source code line in the current function.


The fifth icon displays a hand in red (when it is active). If the O-Matrix is currently running a program, selecting this icon is equivalent to the File | Halt Execution menu item. (If O-Matrix is currently running a program the word "Processing" is displayed in the status line at the bottom right of the main O-Matrix window.) In this case, selecting the icons halt program execution and returns control to the Command line .

If the DEBUG> prompt is currently displayed, O-Matrix execution has been suspended. In this case, if an editor window is active, selecting this icon sets a debugger break point at the current line in the current editor window and displays the current set of break points. The line number corresponding to the break point is displayed in the status bar at the bottom right of the main O-Matrix window. If an editor is active, this line number changes whenever the cursor moves over a new editor window. For this reason, the cursor must not move over another editor window between selecting the line in the active editor and selecting the halt icon. If no editor window is active, selecting the halt icon will just display the current set of break points.




The sixth icon is either the 0> prompt or the DEBUG> prompt.

If the O> prompt is displayed, selecting its icon is equivalent to the Debug | Enter Debugger menu item. When the O> prompt is displayed and the hand icon is grayed out, O-Matrix is waiting for command input . When the O> prompt is displayed and the hand icon is red, O-Matrix is currently running a program. In this case, selecting its icon will suspend program execution and enter the debugger where execution can later be resumed using the Debug | Continue menu item.

If the DEBUG> prompt is displayed, selecting its icon is equivalent to the Debug | Exit Debugger menu item. When the DEBUG> prompt is displayed, O-Matrix is in waiting for a debugger command.