1.16.2.2 The Screen Editor Window

The Screen Editor window is used to layout the M&C windows used in the M&C/NMS user interface. Windows like the VLC Main window, the M&C Main window and additional user created windows are customized by means of this program.

The Screen Editor works like a simple drawing program. Each M&C window contains a number of objects ( elements ) which may be placed, sized and edited using the Screen Editor.

Object Placement

Objects contained in the window are placed by dragging them to the desired position (left mouse button). Dragging an object with the right mouse button changes it's size, or, more precisely changes the size of it's bounding rectangle (most objects are not scaled if they are resized). A double click to an object opens the Element Properties window for this object.

Tool-bar Functions

• --- Clears the window surface and starts to edit a new window.
• --- Loads a window description to edit.
• --- Saves the window actually edited.
• --- Saves the window actually edited with a different name. If you have selected a group of elements, only the selected elements are saved. This deletes all unselected elements and shrinks the panel just to fit around the selected elements! The saved screen always ist stored in the "/screens" directory. This applies even if you edited a VLC screen from within the NMS client application.
• --- Adds a new device icon for each device which has not yet an icon. This function is only available, if the program knows about the device list of the application which is edited.
• --- Adds a new object to the window. It appears in the upper left corner. You also may point with the mouse to the (empty) destination point at the drawing area and the right button context menu.
• --- Duplicates the selected object. The new object appears on top of existing one.
• --- Removes the selected object. If you have selected a group of elements, all elements in the group are removed.
• --- Opens a Element Properties window for the selected object.
• --- Defines a background image for the window. A file selection box appears, you may select any picture in GIF or JPG format as the window background. The window size automatically gets aligned to the size of the image you selected.
• --- Objects are placed along a invisible 3 x 3 pixel grid if they are moved while this button is down.
• --- Moves the selected object to the back so it does not cover any other object.

Inserting screens

You may insert complete screens into the actually edited one. Point the mouse to where you want the upper left corner of the inserted screen to be placed. Press the right mouse button and select "Insert screen" from the context menu. A file selection box appears which lets you select the screen to insert.

You also may select one of the predefined screens used by the device windows of the software for insertion. To insert such a file, change the directory to "dscreens" in the file selection box. Be aware, that the message identifiers of all parameters in these screens don't contain a device ID. The tx-on parameter of a transceiver e.g. refers to a message ID "tx.on" in a device screen, not to something like "KSTAR-1.tx.on". You have to edit all message identifiers if you insert a screen from this directory.

Group selections

The screen editor lets you select multiple elements to a set on which you can perform some useful actions. Selecting an element group works like you would expect: Spanning a rectangle by dragging the mouse with the left button held down selects all elements which are covered by this rectangle. Selecting single elements with the mouse while pressing down the CTRL key at the keyboard also adds these element to the group. Any other mouse click clears the selection.

Elements selected in this way are marked with a blue rectangle drawn around. The first element you selected is called the "reference element". It's marked with four small boxes in it's corners. If you select a group by spanning a rectangle around the elements, the element which was selected before becomes the "reference element". Below there is a list of operations you may apply to a selected group of elements:

• Moving a group of elements: --- Select the elements you want to move, then keep the CTRL key pressed and drag one of the elements in the group (left mouse button). The other elements follow.
• Resizing a group of elements: --- You can change a group of elements to the same width, height or size the reference element has. Select the elements you want to resize and select the reference element. Then -- while pressing the CTRL key -- open the context menu with the right mouse button on one of the elements in the group. Select "Same width", "Same height" or "Same size" as you need.
• Aligning a group of elements: --- Aligning a group of elements, i.e. moving them to make either the left, right, top or bottom edge of all elements in one line, is done analogous to the resizing functions. The context menu selections are "Align left" ... "Align bottom". "Align column" is a special function which aligns the selected elements horizontally to the reference element like "Align left". Vertically this function aligns the elements to fit into a fixed 42 pixel raster, relative to the reference element.
• Re-addressing a group of elements. --- With this function (context menu selection "Same device") you can address a group of elements to the same device name the reference element contains in it's message ID. The device name in the message ID of each element in the group gets replaced by the device name in the reference element's message ID. This function recognizes if an element contains no device name defined and adds the reference element's device name in this case.
• Storing a group of elements: --- Select the elements you want to store and click to in the tool bar. This deletes all unselected elements and shrinks the panel just to fit around the selected elements, so be careful! In most cases it will be better to make a backup of the edited screen before.
• Deleting a group of elements: --- Select the elements you want to delete and click to in the tool bar.

Remarks

• Window descriptions, images and icons are stored on the NMS server computer. This means, any changes you make are stored at a central place and are automatically available to other users. If you wand to add your own icons or images, contact your system administrator to store these files on the server computer.
• A quick start for a new main screen is the tool bar button. It creates a new device icon for each device defined in the VLC/M&C system.