RESPITE: The CASA Toolkit Page:Documentation:The CTK GUI Guide

The RESPITE CASA Toolkit Project

Using the CTK Graphical User Interface


Contents:

Editing a system in the layout window

The Pull Down Menus

The Toolbar

The Preferences Panel


Editing a system in the layout window


Adding a block

Moving a block

Deleting a block

Making a connection

Breaking a connection

Editing a parameter

Selecting/Unselecting a block

Selecting/Unselecting a group of blocks

Undoing a change


Adding a block

First, select the block type required using the pull-down menu in the top left of the window, below the tool bar.

Second, position the cursor in the desired position in the layout area and then click the left mouse button.

Moving a block

Select the block to be moved by positioning the cursor over it and clicking and holding down the left mouse button. Then while keeping the left mouse button pressed, drag the block to its new position.

Deleting a block

A block is deleted by clicking it with the right mouse button.

Making a connection

First click and hold down the left mouse button over one of the two sockets to be connected. The socket should change colour to indicate it has been selected. Now, while keeping the left mouse button depressed, drag the mouse to the second of the two sockets. When positioned over the second socket release the mouse button.

Note, a connection can be made either by dragging from the output socket to the input socket, or vice versa.

Breaking a connection

Click the right mouse button over either of the two connected sockets.

Editing a parameter

Double-clicking the left mouse button over a block will bring up a panel displaying the blocks parameters.

The parameter panel will display all the block's parameters. Individual parameters will be displayed using text windows, check boxes, or pull down menus. Parameters that can be set by the user can be edited using this panel.

A parameter value can be attached to one of the scripts command line arguments by clicking directly over the parameter name, and then selecting a command line parameter position in the panel that pops up (i.e. 1=first parameter, 2= second parameter etc).

Selecting/Unselecting a block

Hold down the shift key while clicking the left mouse button over the block to be selected/unselected.

Once blocks have been selected they will be marked with small black squares in their corners. If a selected block is moved then all other selected blocks will move with it.

Selecting/Unselecting a group of blocks

To select a group of blocks hold down the shift key and click and hold down the left mouse button. While keeping the mouse button held down drag the cursor over the group of blocks to be selected.

To unselect all currently selected blocks use the "Unselect All" in the pulldown "Edit" menu.

Undoing a change

Click on the undo button in the tool bar (a downward curving arrow), or select "undo" from the "Edit" menu.

Note! Multiple undos are allowed, but there is currently no redo.


The Pull Down Menus


The File Menu - Saving and Loading CTK scripts

The Edit Menu - Editing CTK systems

The Layout Menu - Tools for tidying the layout

The Run Menu - Running a CTK script within the GUI

The Profile Menu - Analysing a CTK system's performance

The Shell Menu - For entering the CTK shell from within GUI

The Help Menu - Online help


The File Menu

Print a hardcopy of the layout window

New Start a new layout
Open Open an existing .ctk file
Save Save the current layout
Save As... Save the current layout with a new name
Revert Revert the current layout to the last saved version
Print
Quit Quit the CTK GUI


The Edit Menu

Unselect All Unselect all currently selected blocks
Undo Undo the last edit (this feature is incomplete and currently will only undo move, make connection and break connection)
Preferences... Display the preferences panel


The Layout Menu

Toggle Grid Turns the background layout grid on and off
Toggle Snap Turns 'snap mode' on and off. In snap mode blocks can only be positioned at grid intersections


The Run Menu

Run run the system
Run with... run the system with command line parameters


The Profile Menu

Profile Toggle profiling mode on and off
Reset Reset the profile statistics
Show report... Write a profile report to the terminal


The Shell Menu

Note: The Shell Menu is not available on all systems.

Shell Transfer control to a CTK Shell


The Help Menu

Help... View the online documentation.
About... Show the CTK version number.
What's This Enter "What's This" Mode.

When in "What's This" mode a question mark will appear beside the cursor. Clicking on an item will display help information about the item if there is any available.


The Toolbar


filenew.png New Start a new layout
fileopen.png Open Open an existing .ctk file
filesave.png Save Save the current layout
fileprint.png Print Print a hardcopy of the layout window
toggleprofile.png Toggle Profile Toggle profiling mode on and off
undo.png Undo Undo last change
whatsthis.png What's This Enter "What's This" Mode


The Preferences Panel


The preferences panel is accessed by using the Edit pull-down menu and selecting Preferences... .

The preference panel has four tabs:

General - The customising appearance of the layout frame.

Profile - Preference related to the profile tool.

Save - Preferences related to file saving.

Colour - For altering the colour scheme.

Beneath the tabs are three additional buttons: Save - for saving the current preference settings for use in future sessions. Revert - for restoring preference settings to the previously saved values. Default - for restoring preference settings to their `standard' default values.

General Preferences

Profile Preferences

Save Preferences

Colour Preferences


Documentation for CTKv1.1.4 - Last modified: Thu Jun 28 17:55:39 BST 2001