SYS 500 Picture Editing

Transcription

1 1MRS MEN Issue date: Program revision: Documentation version: A SYS 500 Copyright 2000 ABB Substation Automation Oy All rights reserved. Notice 1 The information in this document is subject to change without notice and should not be construed as a commitment by ABB. ABB assumes no responsibility for any error that may occur in this document. Notice 2 This document version complies with the program revision Notice 3 Additional information such as Release Notes and Last Minute Remarks can be found on the program distribution media. Trademarks Microsoft is a trademark of Microsoft Corporation. Windows NT is a trademark of Microsoft Corporation. LONWORKS is a registered trademark of Echelon Corporation. Other brand or product names are trademarks or registered trademarks of their respective holders All Microsoft products referenced in this document are either trademarks or registered trademarks of Microsoft.

2 SYS 500 1MRS MEN Related SYS 500 and MicroSCADA Technology Manuals The following SYS 500 manuals are published with this software release. Installation Visual SCIL User Interface Design Visual SCIL Objects System Management 1MRS MEN 1MRS MEN 1MRS MEN 1MRS MEN 1MRS MUM The following MicroSCADA technology manuals are published with this software release. Connecting LONWORKS Devices to MicroSCADA System Configuration System Objects Application Objects Programming Language SCIL Status Codes 1MRS MEN 1MRS MEN 1MRS MEN 1MRS MEN 1MRS MEN 1MRS MEN

3 1MRS MEN SYS 500 Contents Page 1 Introduction Using the Picture Editor General Handling Picture Files General Functions Editing Elements Background Selecting Graphic Features for Elements Drawing Graphic Elements Editing Existing Graphic Elements Windows Overview Defining Windows Defining Internal Representations Defining Library Representations Defining Picture Representations Function Keys Overview Creating Function Keys Defining Function Keys Picture Programs Overview Using the SCIL Editor Compilation of Picture Programs Some SCIL Commands... 75

4 SYS 500 1MRS MEN 7 Picture Functions Overview...77

5 1MRS MEN SYS Introduction 1 Introduction About this Chapter This chapter gives a brief presentation of picture handling in MicroSCADA. It introduces the picture editing facilities, picture elements and the editing procedure. It also describes how the pictures are stored. Presentation MicroSCADA is a microcomputer-based programmable system for remote and local supervision and control of energy distribution, water purification, etc. The main functions of MicroSCADA are man-machine communication - interaction between operator and control system - supervision and control, alarm and event handling, data acquisition, calculation and reporting. Pictures in MicroSCADA The operator can use pictures to monitor and to control the process. A variety of pictures and picture functions are available: Pictures visualize the controlled process with symbols and colors. The operator controls the process from screen with function keys placed in pictures. The operator enters data in the pictures. Pictures inform the operator about alarms and events. Pictures illustrate process data and historical data as tables and graphs. By using pictures the operator supervises and controls components of the Micro- SCADA system, for example printers and communication lines. Menu pictures help the operator to select reports, process control pictures, trends, alarm and event lists or tools to the screen. Facilities The physical picture editing facilities are the same as the operating facilities, which are a color display, a keyboard and a mouse. You can use any operator console for picture editing. You create and edit pictures with picture editors. There are two different picture editors in MicroSCADA. The full graphic picture editor is used with Visual SCIL (VS) monitors and the other, the semigraphic picture editor, is used mainly with other monitors or to edit semigraphic elements of old pictures. This document describes the full graphic picture editor. To learn about the semi-graphic picture editor, please refer to 8.2 manual. 1

6 SYS Introduction 1MRS MEN Picture Components A picture contains the following components: Picture background. The picture background is the static, unchanging part of the picture. In revision the picture background is usually made with the full graphic editor. You can also use the semigraphic picture editor, for example to edit semigraphic elements. Windows. Windows are the dynamic parts of the picture that can be shown, erased and replaced without any impact on the other picture components. Windows may show complete pictures, text or data, figures or graphs. You can place them anywhere in the picture, even so that they overlap one another. Function keys. The function keys are regtangular programmed areas. When you click a function key, a program or a data entry is executed. Picture programs Programs define the behaviour of the picture. A picture can contain seven types of programs: A start program. An update program. A draw program. A background program. An exit program. Key programs. Named programs. An error handling program. Programs are written with a system-specific high-level language SCIL. Picture functions A picture function is a set of picture components that may include all components mentioned above in this list. When a standard function is installed from a library, a copy of it is added to a picture as a picture function. 2

7 1MRS MEN SYS Introduction Picture background Picture function Windows Function keys Figure 1. An example of the picture components, except picture programs, are shown in this figure. A picture may contain windows containing pictures. It may also contain a number of picture functions, which are, likewise, constructed as pictures. The picture functions and the pictures shown in windows can be regarded as sub-pictures or part pictures of the whole picture, which is called main picture. The sub-pictures in turn may have their own sub-pictures, which means that a hierarchical picture structure is obtained. Do not mix the MicroSCADA internal windows and application windows. Internal windows are parts of a picture and the application windows are parts of the screen. Procedure All picture components are created and edited in the picture editor. You can add the components in any order. You do not have to use all the picture components. For example, a picture can include only a background, window or start program. If you want to display a picture as a main picture, it should at least have an exit key. MicroSCADA pictures can be edited almost without restriction. However, you cannot edit the picture while it is being used. Likewise you cannot open the same picture in two different editors at the same time. Picture Handling and Storage Pictures are stored in files under the picture names with the extension.pic. The files are situated in various standardized file directories, where they can be accessed according to the four letter rule. Therefore, if the path is not given in the name definition, the first four letters in the name are compared to the logical path definitions. If a match is found, then the file is searched for according to the path definition. If a match is not found the file is searched for according to PICT logical path definition. For example a picture named SYS_TEST is searched for in the SYS_ folder. Pictures can be changed using!new PIC command. For more information, see Programming Language SCIL manual. 3

8 SYS Introduction 1MRS MEN The most frequently used pictures are also stored in main memory, in the picture cache memory, which makes the picture handling faster. When the memory is full, the least requested picture is removed. 4

9 1MRS MEN SYS Using the Picture Editor 2 Using the Picture Editor About this Chapter This chapter describes the general principles of how to use the Picture Editor. 2.1 This first section gives an overview of the full graphic picture editor. It describes entering and exiting from the full graphic picture editor. 2.2 The second section is about handling picture files. An explanation of how to create a new picture, open an existing one or how to save a picture is given. Commenting a picture and creating a revision history is also described. 2.3 The third section tells you about the general functions in the full graphic picture editor. The various modes that you can select, removing semigraphs, refreshing screen and the graphic layers of a picture are discussed. There is also an overview of picture size and quadrants. 2.4 The fourth section describes editing elements. This includes a discussion of selecting, moving, using snap and grid, aligning, copying, deleting and zooming. 2.1 General Overview Picture Editor is used like Windows programs, for example with the help of menus. In the Picture Editor you can either create a new picture or edit one that already exists. You can edit picture parts in any order. Those functions that have no effect are grayed out to show that they are disabled. When you enter the editor, an empty drawing area is shown. You can then begin to create a new picture, which you usually start with the background. Picture programs are written in the SCIL Editor, which is a tool in the Picture Editor. Entering and Exiting the Picture Editor To enter the full graphic picture editor, enter the Tool Manager and choose Picture Editor with blue icon. To use the semigraphic picture editor, choose Picture Editor with black icon and refer to 8.2 manual. To exit from the full graphic picture editor, choose Exit from the File menu. If you have not saved the picture, you are asked to do it now. 5

10 SYS Using the Picture Editor 1MRS MEN Menu and Toolbars The menu bar and toolbar of the Picture Editor are shown in the Figure 2. Select the functions either by clicking the correct button in the toolbar or their names in the menu bar at the top of screen. There is a drawing toolbox at the left side of screen. The buttons for snap, grid, color, font and zoom are at the bottom of screen. There are also two fields and a drop-down list box in the upper right corner of screen, also shown in the Figure 2. The first field shows the size and position of the selected element and the second shows the position of the mouse pointer. All the coordinates and sizes are always presented as SCIL coordinates. If one of the values is ambiguous or not valid, then 0 x 0 or (0, 0) is used. The drop-down list box indicates the name of the currently selected picture function or window, and the selected picture function or window can also be changed from this list. Figure 2. The menu and toolbar The first button in the Toolbar is the Open button and the second one the Save button. The next three buttons are Cut, Copy and Paste buttons. The sixth button is Bring To Front button and the seventh button is Send To Back button. The next two buttons are Ungroup and Group buttons. The tenth button is Rotate -90 button and the eleventh button is the Rotate +90 button. The Next four buttons are Background mode, Picture Functions mode, Function Keys mode and Windows mode buttons. 2.2 Handling Picture Files General From the File menu you can choose options to create a new picture, open an old one, or save the one you have on screen. You can also exit from the Picture Editor. These functions, among others are discussed in this section. Figure 3. The File menu 6

11 1MRS MEN SYS Using the Picture Editor Creating a New Picture An empty drawing area appears when you enter the Picture Editor. You can then start to create a new picture. If you already have another picture on the screen, click New in the File menu. Note that you can only edit one picture at the time. Save the changes to the previous picture before starting to create a new one. If you click New, but you have not saved changes to the picture, you are asked to do it now. Opening an Existing Picture Pictures that have been saved normally can be found in the PICT directory. There are three ways to open an existing picture for editing: Choose the name of the picture from the File menu, where the most recently edited pictures are listed, if the file history is not disabled. See Figure 3. The number of the recently edited pictures shown in the File menu can be altered between 0 and 20 from File History Length in the Options menu. If 0 is selected, the file history is disabled. or: 1 Choose Open by File Chooser from the File menu. In the File Chooser the existing files are listed and you choose pictures according to their location in the file system, see Figure 4. 2 Select the name of the picture you want to open and then click Open. Figure 4. The File Chooser in the Picture Editor or: 1 Choose Open by Name from the File menu. You can then type the name of the picture in the dialog box that appears. See Figure 5. The picture name can be typed 7

12 SYS Using the Picture Editor 1MRS MEN with or without a logical path. If the name is typed without the logical path, the picture is searched with four letter rule. 2 Click OK. Figure 5. The dialog box for opening a picture by its name In the File Chooser the paths can be selected in four different modes: Application Relative Paths MicroSCADA Relative Paths Logical Paths Operating System Paths Path representation in the MicroSCADA path format relative to the current MicroSCADA application home directory. The application home directory itself can't be referenced. Path representation in the MicroSCADA path format relative to the MicroSCADA root directory. The MicroSCADA root directory itself can't be referenced. Path representation in the MicroSCADA logical path format. Path representation in the format used by the operating system. The default path mode is Logical Paths and the default folder is PICT, but the last used path mode and folder are saved and restored between editing sessions. The size of a file and the time of the last save operation are shown in the File Chooser, as shown in Figure 4. In the Picture Editor one picture can be edited at a time. Loading a picture replaces the one, which was previously shown on screen. If unsaved changes had been made to the picture previously on screen, a question is asked before opening the next picture whether to save the changes or not. Saving a Picture To save a picture that has not been saved before: 1 Choose Save As from the File menu. The File Chooser appears as Save As dialog box. 2 Select the wanted path and folder. 3 Enter the filename you want to use by clicking the Save as text box and type the filename there. Use at maximum 10 characters in the filename. The extension (.pic) is added to the given filename automatically. You can use letters A-Z, numbers 0-9, and the underscore character ( _ ). Begin the filename with a letter. 8

13 1MRS MEN SYS Using the Picture Editor 4 Click Save. Filenames that coincide with a name reserved by the operating system cannot be used e.g. LPT1, COM1, etc. To save a picture, which has already been saved, choose Save from the File menu, click the button with diskette in the toolbar or press CTRL+S at the same time. To save a picture under another name, do it in the same way as you save a picture that has not been saved before. New folders can also be created in the File Chooser by selecting the right path and clicking on the create directory ( ) button. Type the name of the new folder in the appearing Create Directory dialog box, or define the logical path in the opening Path & Rep_Lib Viewer tool (opens only when Logical Paths is selected in the File Chooser). The four modes for selecting paths in the File Chooser are listed on page 8. Viewing Picture Format The format of the picture is important information when working with several different formats at the same time. The picture format can be viewed as follows: 1 Select Show Picture Format from the Help menu of the Picture Editor, see Figure 6. 2 The dialog box shown in Figure 7 appears. The pictures can be either of the old pre or of the new format. Figure 6. The help menu Figure 7. The dialog box for viewing the picture format Comments A picture comment can include the name of the originator, the date of creating or editing the picture, its connection with other pictures and other relevant facts. You can read or write them in the Comment dialog box. In the comment line you can have at maximum of 68 characters. 1 To type, edit or read a comment, choose Comment from the Edit menu. The dialog box shown in Figure 8 appears. 9

14 SYS Using the Picture Editor 1MRS MEN 2 Type the text you want to add in the text box and click OK. Editing and reading the comment is also done in the same dialog box. Figure 8. In this dialog box you can type, edit or read a comment that gives information about the picture. You can include the picture comment in the picture document. It is another way to document pictures. Automatic documentation functions in MicroSCADA make it easier to document the application. They allow you to choose objects, which will be included in the document. You should note that a description of full graphic elements can not be included in the document. The result is a printed document covering the details of the application. Revision History 2.3 General Functions You can write a revision history of the picture of up to lines long. To type, edit or read it: 1 Choose Revision History from the Edit menu. 2 Type, read or edit the text in the editor that appears. Fill in the template form with the help of the titles and empty rows that are inserted in it. Selection of Modes The editor has four modes: Background. Function Keys. Picture Functions. Windows. In background mode you can add, delete or edit graphic elements. In windows mode you can add, delete or edit windows. You can edit function keys in the function keys mode. Picture functions are installed and configured in the picture functions mode. Only the valid menu items and buttons are always enabled in every mode. When you open the Picture Editor, it is in background mode. To change the mode, choose the name of the mode you want to use from the Edit menu. Note that windows and function keys modes for the main picture cannot be chosen when the picture editor is in the picture function mode. Choose the background mode first. Then all the other modes can be chosen for the main picture. If you have a picture function se- 10

15 1MRS MEN SYS Using the Picture Editor lected in the picture function mode, you can choose the windows and function keys modes for that picture function. You can also change the mode in the toolbar by clicking the mode buttons. For more information, see the page 6. Removing Semigraphics The full graphic picture editor does not support editing semigraphic figures. You can edit them in the semigraphic picture editor, which is also a part of the revision 8.4 of MicroSCADA. There is only one function you can do to a semigraphic element in the full graphic picture editor; you can remove the whole semigraphic background of the main picture. To remove the semigraphic background: 1 Choose Remove Semigraphics from the Edit menu. 2 A dialog box, which is shown in Figure 9, appears. Click Yes. Figure 9. This dialog box expects you to confirm that you want to remove semigraphics before it removes them permanently. Graphic Layers Different graphics layers are drawn in the picture editors. The main graphic layers of pictures that are created using the full graphic picture editor are listed below, starting with the uppermost layer. The main graphic layers that contain picture functions are further divided into separate layers for all installed picture functions and in some cases a layer for the main picture graphics. The main graphic layers are: The uppermost layer is the start program of the picture functions. The second layer is the start program of the main picture. The third layer is the full graphic drawing programs of the main picture and picture functions. The fourth layer is the full graphic background programs of the main picture and picture functions. The fifth layer is the semigraphic background of the picture functions. The sixth layer is the semigraphic background of main picture. 11

16 SYS Using the Picture Editor 1MRS MEN The currently applied order of graphic layers is shown in the Drawing Order dialog box. The default execution order of picture function layers inside main graphic layers one, three, four and five is the order in which those picture functions were installed. In the Picture Editor you can freely choose the execution order of picture functions and main picture graphics. Therefore you cannot change places of main graphic layers. The order of main picture and picture functions inside layers one, three, four and five may be changed. It is done using the options from the Arrange menu. To see the current drawing order, choose Drawing Order from the View menu. The dialog box shown in Figure 10 is shown on screen. Figure 10. The current drawing order of the graphic layers is shown in this dialog box. Change the order of graphic layers by using the options from the Arrange menu. When a new element is added to the picture background, it is placed on top of the previous ones. When elements have the same location or they overlap, the new element will cover the previously drawn one. By using the options from the Arrange menu in several different ways you can put elements into correct order. You can send backward or bring forward background elements and picture functions, but not windows or keys. 12

17 1MRS MEN SYS Using the Picture Editor Figure 11. The Arrange menu in which the raising, lowering and aligning functions are chosen Bring to Front Send to Back Bring Forward Send Backward Places the selected element in front of other elements. See Figure 12. Places the selected element behind the others. Raises the selected element one level, in other words it moves the element in front of the element that is currently placed directly on top of it. Lowers the selected element one level, in other words, it moves the element behind the element that is currently placed directly beneath it. 13

18 SYS Using the Picture Editor 1MRS MEN Raise 1 (a) 3 1 Raise one level (b) Figure 12. (a) Bringing element 1 to the front. (b) Bringing element 1 forward one level. There are several ways to change the order of elements and one possible way is described here: 1 Select the element you want to place behind the others. 2 Choose Send to Back from the Arrange menu. See Figure Select the element you want to place as the second lowest element. 4 Choose Send Backward from the Arrange menu. Choose it again, if you have Several layers of elements and the selected element is not yet in the right place. 5 If the order is still not correct one, select the element you want to move and choose Send Backward repeatedly until the element is in the correct position. Refreshing Screen In some situations screen does not show the graphics as they will appear In the final drawing. This might happen, for example, when an element which lies behind other elements is edited. In this case it will be brought to the foreground. To get a real view of the picture, choose Refresh from the View menu. The picture will be drawn again. 14

19 1MRS MEN SYS Using the Picture Editor Picture Size Normally the size of the picture is equal to the size of the drawing area that is shown on screen. The size can be changed and there are three methods for doing so: By Pointing. By Inputting. Automatically. All three methods always include automatically all picture functions and function keys in the picture. Those objects can not be excluded, whereas graphical elements and windows can be excluded from the picture. The minimum size in SCIL units, if no picture functions or function keys appear outside this area, is 16x20 and the maximum is 1280x960. By Pointing method for resizing a picture in the Picture Editor is used as follows: 1 Choose By Pointing from the Picture Size submenu of the Format menu. A dash lined rectangle for defining the new size appears in the upper left corner of the Picture Editor. 2 Move the mouse pointer to determine the new size for the picture. The dash lined rectangle follows the mouse pointer indicating the new size. 3 When the rectangle indicates the desired new size, click on the position of the mouse pointer to resize the picture. The second method for resizing a picture is By Inputting, as follows: 1 Choose By Inputting from the Picture Size submenu of the Format menu. A New Picture Size dialog box appears. 2 Define the new size for the picture in the Width and the Height boxes of the dialog box. The size must be in SCIL units. 3 Click on OK to accept the new picture size, or on Cancel to cancel the operation. A picture can be resized also automatically. This method can be used as follows: 1 Choose Automatically from the Picture Size submenu of the Format menu. 2 The picture is resized to include all the background graphics, graphics from the DRAW program of the main picture, picture functions and function keys in the picture without any user interaction. The picture size is automatically rounded up to the next semigraphical unit. To have the new size when the picture is opened the next time, the picture must be saved before closing it in the Picture Editor. If you also want to keep the old version of the picture, you will have to save the new one using another filename. Quadrants The Control Board is divided into four quadrants. To use quadrants: 1 The picture you have on screen has to be the one you want to use in the first quadrant, that is the upper left quadrant of the control board. Choose Quadrants from the Edit menu. 15

20 SYS Using the Picture Editor 1MRS MEN 2.4 Editing Elements 2 In the first text box of the dialog box type the name and the logical path of the picture you want to show in the second quadrant. 3 In the second text box type the name and the logical path of the picture you want to show in the third quadrant and in the third text box type the name and the path of the picture you want to show in the fourth quadrant. General The editing of existing elements (background elements, function keys, windows, picture functions) starts by selecting an element. All types of selected elements can be moved, deleted, aligned and zoomed. The size, shape, text and the graphic features can be changed for background elements. The size of a function key can also be changed. The background elements, windows and function keys can be copied. Background elements and picture functions can be brought to the front or sent to the back. Elements that are created by SCIL commands in the draw program are shown in the Picture Editor, but they cannot be edited. Figure 13. The Edit menu Choose the basic editing functions from the Edit menu. There are also several other editing functions which can be chosen from other menus. The functions available from the Edit menu are shown in Figure 13. You can also choose some functions by clicking the relevant buttons in the toolbar. The toolbar is located at the top of the Picture Editor. 16

21 1MRS MEN SYS Using the Picture Editor Selecting an Element To edit an element, first select it. Selection is done in the mode in which the element is edited (for example background elements in the background mode). To select an element: 1 Click the button with the black arrow in the drawing toolbox. 2 Click the border of the element. Handles will appear in the border. If you have one element selected but you want to select another one, choose the Select Next from the Edit menu. This function selects the closest element to the previous one. If you choose Select Next again, the closest element that has not been selected before is selected. By repeating this action you can select the one you want. This is an important feature, if you have small elements, which are drawn close to each other. In this case selecting the right one with the mouse pointer might be difficult. You can select several elements by holding the Shift key down while moving the pointer from one element to another one and clicking the mouse button above the elements to be selected. If you press the mouse button above an element and the Shift key is not pressed, all previously selected elements are unselected and only the current one is selected. If you click the mouse button above an already selected element and shift is pressed at the same time, only that element is unselected. Select all elements by choosing Select All from the Edit menu. Unselect all the selected elements by choosing Unselect All from the same menu. All elements in a specified area are selected by pressing down the mouse button in one corner of the area. Then the pointer is dragged to the opposite corner, holding the mouse button down. This only works when no elements have already been selected. Moving an Element To move an element: 1 Select the element. 2 Show the new location by pressing the mouse button down in the middle of the element and keeping it down while dragging the pointer to the new position. A selected element can also be moved by using the arrow keys (on the keyboard). If the Shift key is pressed down, the elements move one grid point with the arrow key. In the background mode the elements move one SCIL unit when the arrow key is pressed (without the Shift key). In window, picture function and function key modes the elements always move one grid point, which is equal to 16 horizontal and 20 vertical SCIL units. This particular grid unit size belongs to a system of 48 lines with 80 character positions each. Note that a SCIL unit is usually not equal to a pixel. To move an element (except a picture function) from one picture to another: 1 Select the element. 2 Choose Cut from the Edit menu. 17

22 SYS Using the Picture Editor 1MRS MEN 3 Open the picture into which you want to place the element. If you have not saved changes to the old picture, you can also do it at this point. Choose Paste from the Edit menu. 4 The new element, which was moved from another picture, appears in the upper left corner of the drawing area. 5 Hold the mouse button down on it and move it with the pointer to the correct position. While pasting windows or function keys, when the temporary positioning box is still visible, the Paste operation can be cancelled by pressing ESC key on the keyboard. This removes the positioning box and cancels the paste operation. Snap and Grid Snap and Grid are facilities which help you to move and align elements. The grid facility includes horizontally and vertically aligned points with a selected space. The grid system can be shown or hidden. Using the Snap option means that all end points of the elements are fastened to certain points in the drawing area, the snap points (Figure 14). The pointer jumps to snap points when you are drawing. The spaces between snap points are equal to the grid space. Grid space (and therefore also snap space) is changed by choosing Grid from the Format menu. The dialog box that appears is shown in Figure 15. Figure 14. The Grid and Snap features are chosen from the Options menu Figure 15. The grid space can be changed in this dialog box To use snap option, choose Snap On from the Options menu. To use grids, choose Grid On. You can also choose them by clicking the Snap and Grid check boxes at 18

23 1MRS MEN SYS Using the Picture Editor the bottom of the picture editor. Both snap and grid functions can be on at the same time. When they are both on, the pointer moves to the grid points. You can also see the grid points so that you are able to align elements precisely. Aligning Elements Several elements can be aligned according to their top, bottom, center, left or right side. You can align background elements, function keys or picture functions. Alignment functions place the elements so that one point of each element is on the same line. Top alignment arranges all of the selected elements according to the uppermost selected element and its uppermost point. Bottom alignment places the elements according the lowest selected element, and its lowest point. Center alignment is done either horizontally or vertically. Horizontal center alignment moves the elements to the line that is located in the middle of the center points of the uppermost and lowest element. Vertical center alignment moves the elements to the line that is located in the middle of the center points of the elements that are first in the left and last in the right side of the drawing area. Left alignment aligns according to the element that is selected and begins first in the left side of the drawing area. Right alignment places the elements according the element that is selected and reaches the farthest point to the right side of the drawing area. To align elements: 1 Select the elements you want to align. 2 Choose the alignment function you want to use from the Arrange menu. Update Coordinates The place of the pointer is updated all the time at right side of the tool bar. If you do not want to update the coordinates all the time, you can cancel the selection Update Coordinates in the Options menu. This might be usefull to fasten the operating speed of the Picture Editor. Copying an Element To copy an element within a picture: 1 Select the element. 2 Choose Copy from the Edit menu. 3 Then choose Paste. The new element, which was copied, appears next to the original location, unless the visible drawing area has been changed from the original, then the pasting will appear in the upper left corner of the new visible area. 4 Move the element to its correct position. This is done by pressing down the mouse button in the middle of the element and keeping it down while dragging the pointer 19

24 SYS Using the Picture Editor 1MRS MEN to its new position. If a second element is pasted before the first one is moved, it will be placed right and down of the last pasted element. Selected elements can also be copied to a buffer by clicking the button in the toolbar with two text papers or pressing CTRL+C at the same time. The elements in the copy buffer can be pasted by pressing CTRL+V at the same time or by clicking on the tool with one white paper and one text paper symbol. While pasting windows or function keys, when the temporary positioning box is still visible, the Paste operation can be cancelled by pressing ESC key on the keyboard. This removes the positioning box and cancels the paste operation. To copy an element to another picture: 1 Select the element. 2 Choose Copy from the Edit menu. 3 Open the picture to which you want to place the copied element. If you have not saved changes to the old picture, you can also do it at this point. 4 Choose Paste from the Edit menu. The copied element appears next to the original element location. 5 Move the element to the correct position. Deleting an Element To delete an element: 1 Select the element. 2 Choose Delete from the Edit menu and the element disappears. This can also be done by pressing Delete (on the keyboard). 3 Click OK in the dialog box that appears to confirm that you want to delete the element. If you do not want to confirm the delete function all the time, you can cancel the Confirm Delete selection in the Tools menu. When deleting picture functions that have connections to process objects, a question to delete also the process objects is asked. This question is made for each picture function containing connections. It includes the name of the picture function and the process object group as well as the group s indices. The fullgraphic picture editor does not support editing semigraphic figures. The only function that you can do to a semigraphic element is to remove it. For more information on this, please refer to page 11. Semigraphic elements can be edited in the semigraphic picture editor, which is also part of MicroSCADA revision 8.4. Zooming To facilitate the drawing and editing of small elements you can zoom the whole picture or just a part of it. 20

25 1MRS MEN SYS Using the Picture Editor To zoom the whole picture background, choose the percentage to zoom with in the View menu. This can also be done in the box in the lower right corner of the picture editor. The percentage in the box is changed by using the spinner or by typing the correct number in it. Zooming can also be done in the View menu by selecting Zoom In or Zoom Out. These functions zoom the picture by ten percent. To zoom a part of a picture, so that this part will cover the whole drawing area, do the following: 1 Click the button with a magnifying glass in the lower right corner of the Picture Editor. 2 Then select the area you want to zoom. To select the area, press the mouse button in a corner of the area and hold it down while dragging the pointer to the opposite corner of the area you want to select. Then release the button and the correct zoom ratio is selected automatically. 21

26

27 1MRS MEN SYS Background 3 Background General You can use the following functions in the Picture Editor: 3.1 Selecting graphic features for the elements: color, line style and width, font. Also the procedure of grouping elements is also described. 3.2 Selecting types of graphic elements and drawing them. You can select for example line, rectangle, circle, ellipse or arc. 3.3 Editing existing elements, for example changing size and shape, rotating elements, changing color or editing text. 3.1 Selecting Graphic Features for Elements General You can choose or modify the graphic features any time during the picture background editing. The graphic features that can be changed are color, font, line style and width. Each of the graphic features has a default setting (for example color is white, line width is the first narrow line and style is solid). To use default or previously changed settings, you do not need to change anything. The procedure of selecting features is described in this section. You can group elements that should have common features. This function allows you to change graphic features for several elements at the same time, instead of changing them separately for each element. When a group feature is changed, all elements belonging to the group in question are changed accordingly. The graphic features can also be copied from an existing element. Each element belonging to a certain Graphics Contents (GC) group gets all its graphic features. If an element is selected, the selection of graphic features affects that element. If there are no elements selected and you change graphic features, all elements created after this are affected. Selecting a Color for Drawing You can choose a color freely among a number of predefined standard colors with recommended purposes and a number of application colors, which you can specify. You can obtain any color with the RGB Color Mixer. To select a color for drawing, click the color you want to use from the color bar. See Figure 16. The chosen color is shown separately beneath. The name of the color is also written beside it. If the color you want to use is not in the color bar, replace a color with the new one. This procedure is described in the next section, on page

28 SYS Background 1MRS MEN Figure 16. The color bar on the bottom row of the Picture Editor, stating that the color blue is chosen. Replacing a Color in the Color Bar If the color you want to use is not shown in the color bar, replace a color with the one you want to use. To get a new color to stay on the color bar one of the standard colors has to be replaced with the new one, this is done as follows: 1 Select a color to be replaced by clicking the respective button of the color on the color bar, when no elements are selected. See the Figure Click the button with colored circles, located on the bottom row of the color bar as shown in the Figure 16. The Color chooser appears. See the Figure Choose one from four alternative color types by selecting the appropriate page. Then choose the color you want to use. 4 When the color is chosen, click on Apply to get the color to the color bar or on OK to get the color to the color bar and to close the Color chooser. Cancel command button cancels the operation and closes the Color chooser. To get all the standard colors back to the color bar, the Picture Editor has to be restarted. Figure 18. The User Colors page of the Color Chooser where colors can be changed 24

29 1MRS MEN SYS Background System Colors The System Color group includes predefined colors that all have a specific purpose. You are supposed to use each color for the same purpose every time. To select and/or modify the System Colors: 1 In the System Colors tab, in the list box, click the color element that you want to select or modify. See Figure Select the Color Mixer tab. 3 Select a ready made colour or make your own colour mix. The selected colour is shown in the lower left corner under the text Selected Color. 4 Click Apply, if you want to select or modify another color element, otherwise click OK, which closes the color selector. Figure 19. User Color The system colors are chosen from the list box that is shown in the System Colors page in the Color Chooser. The User Color group contains predefined colors that do not have to be used for any specific purpose. Click the Color Selector dropdown list box. Then select the name of the color you want to use. The color is shown in the upper left corner of the dialog box under the text Selected Color. The RGB Color The RGB Color stands for Red Green Blue Color Mixer. With this tool you can freely mix your own color with shades of red, green and blue. The selection is done in the dialog box shown in Figure 20. Choose a shade of red by scrolling the pen with the black arrows. You can also move the red pen with the mouse. This is done by holding the mouse button down while dragging the pointer to 25

30 SYS Background 1MRS MEN the desired location. The current color with its selected shades is shown in the upper left corner of the dialog box. Then select shades of green and blue in the next rows in the same way as selecting the shade of red. After the correct shades for red, green and blue are chosen, the color is ready. Click OK. Figure 20. A color can be mixed using shades of red, green and blue Semigraphic color Semigraphic color is a color that can be chosen from the group of eight semigraphic colors. Click the Color Selector drop-down list box. Then select the name of the color you want to use. The color is shown in the upper left corner of the dialog box under the text Selected Color. Filling Elements with a Color Some drawn elements can be filled with the same color that is used in its border. The elements that can be colored are arc, circle, polyline and rectangle. To fill an element with the same color that is used in its border: 1 Click the black arrow in the drawing toolbox. Then click on the border of the element you want to color. 2 Click the second button in the drawing toolbox, the button with a can pouring blue color. 26

31 1MRS MEN SYS Background To remove the fill, select the element and click the same button. This will unfill the color. Line Style and Width Lines can be solid, dashed, dotted, or a mixture of them. There are six options, which are shown in the Figure 21. There are different line widths available. To change line style: 1 Choose Line Style from the Format menu. 2 Various styles are shown. Select the style option you want to use. Figure 21. The dialog box where line style is chosen 3 Click OK. To change the line width: 1 Choose Line Width from the Format menu. 2 Various widths are shown, see Figure 22. Select the width you want to use. Figure 22. The dialog box where line width is chosen 3 Click OK. 27

32 SYS Background 1MRS MEN Choosing a Font Choose the font you want to use before typing any text. To choose the font: 1 Click the button with the letter F at the bottom of the window. The Font Chooser shown in the Figure 23 appears. 2 In the Font dialog box you can choose Mixed, System or User fonts page. Choose the System fonts. 3 From the System font list box you have a choice of predefined fonts. Select the font you want to choose. After choosing a font, a sample of it will appear at the bottom of the dialog box. The number of the font is shown on the right side of the System font list, this is also shown as a sample of the font. To use a font that is not listed, add it yourself to your user fonts. 4 Click OK. Free fonts, on Mixed Fonts page, are only for special needs, because they are monitor dependent. The fonts defined with an exact font family, face and size are shown exactly as designed only on the same monitor type (VS Local, VS Remote or X monitor) and the same picture size. Figure 23. The font is selected in this dialog box In the Mixed Fonts page, shown in Figure 24, any family, face name and font size can be typed to the corresponding fields, but only existing fonts can be selected. The default families shown in the Mixed Fonts are the ones currently used by the System and User Fonts. 28

33 1MRS MEN SYS Background Figure 24. The Mixed Fonts page of the Font Chooser Defining Text Alignment Defining the text alignment means choosing the attachment point of the text. The attachment point is the place to which the cursor is attached while placing the text, and by which the placed text is anchored. The alignment possibilities are: Default Left Center Right Default means usually Left alignment, but this is font dependent. To change the default alignment for texts to be placed: 1 Check that no texts are selected. 2 Select one of the four alignments from the Text Alignment submenu of the Format menu. The new texts placed after this are now aligned according to the new selection. Grouping and Ungrouping Elements If you want to give the same graphic features to several elements or you want them to be handled together, for example moved together, it is convenient to define them as a group. If you only want to give the same graphic features for several elements you can 29

34 SYS Background 1MRS MEN form a GC (Graphical Contents) group. GC groups are discussed at the end of this section. You can change a feature of a group in the same way as you change a feature of one element. Handling elements as a group is especially useful if some of the features may have to be changed at a later stage. A group can also include elements that do not have the same features as the other elements. This is only possible if the features are chosen before grouping. You cannot resize a group. A group cannot be cut or copied. To define a group: 1 Select the first element of the group. 2 Press the Shift key and hold it down while selecting the other members of the group. 3 Choose Group from the Arrange menu. Now you can perform actions on the group or select features you want to give to the group. It is also easy to add new elements to the group later. To add a member: 1 Select any member of the group. 2 Press the Shift key down and select the new member (or members) of the group. You will then have to redefine the group features, if every member of the group does not have the same ones already. If you want to change a feature for a member of a group, but you do not want to change features for all members, ungroup the elements. To ungroup: 1 Select the group by selecting one element that is member of it. 2 Choose Ungroup from the View menu. Choosing Features for a Group Select one element of the group. Now the whole group is selected. After this select graphic features in the same way as you select them for a single element. Graphical Contents Group If you want to give the same graphic features for elements, but apart from that you do not want to handle them together, form a Graphical Contents group. To form a GC group: 1 Choose GC Groups... from the Format menu. The dialog box shown in the Figure 25 appears. 2 Click New. 3 In the dialog box that appears type the name of the graphical contents group. Click OK. 4 Choose the graphical features of the group. You can choose the color, font, line style and width that will be used. Defining graphical features is discussed in section 3.1. Click OK. 30

35 1MRS MEN SYS Background Figure 25. The graphical features for a GC group are chosen in this dialog box To edit the features shown in the Figure 25 choose GC Groups... from the Format menu and change the features. When no GC group is active in the Picture Editor, the GC Group combo box in the bottom of the Picture Editor shows the group name as (None). When an element is selected, at the same time the name of the GC group is selected from the combo box and the current GC group of the Picture Editor changes. When unselecting elements, the active GC group of the picture Editor does not change, but remains as the last selected. To use the Graphical Contents (GC) groups: 1 Select the element or elements whose graphical features you want to change. 2 Choose the GC group in the text box at the bottom of the Picture Editor. The graphical features of the GC group are applied to the element(s). If no elements were selected as instructed in the first step, only the active GC group of the Picture Editor changes. 3.2 Drawing Graphic Elements General You can select graphic features, for example color, line width and style and text font, before you start to draw. You can also do this after drawing by editing the elements. Begin drawing by selecting an element from the drawing toolbox. Select either basic elements (for example line, rectangle, circle) or compound elements. A graphic element is drawn by pointing out a location with the mouse, pressing the mouse button and holding it down while dragging the pointer to a second point. Drawing Tools The drawing toolbox includes buttons for basic drawing and editing tools. The uppermost button, the black arrow, is for selecting elements. SeeFigure 26. The second button is for filling elements. The next six buttons are for drawing the elements shown on the buttons. The button with the letter A is for typing text. 31

36 SYS Background 1MRS MEN Figure 26. The drawing toolbox To open the additional part of the drawing toolbox, which includes the compound elements, choose Extended Toolbox from the Options menu. The extended toolbox is described in more details on page 35. Straight Line There are two ways to draw a line. To draw a straight line: 1 Click the button with the line symbol or choose Line from the Draw menu. 2 Place the pointer at the starting point of the line in the drawing area, hold the mouse button down and drag the pointer to the end point. Release the button and a line is drawn. Polyline A polyline consists of several straight lines connected at sharp angles. If you choose the fill option for polyline, the polyline changes to polygon that is filled with the selected color. To draw a polyline: 1 Click the button with the polyline symbol or choose Polyline from the Draw menu. 2 Place the pointer at the starting point of the line in the drawing area, hold the mouse button down and drag the pointer to the angle point. 3 Release the mouse button and press it again to start drawing the next part of the line. 32

37 1MRS MEN SYS Background 4 Release the button again at the next angle point. Repeat the procedure until the end point is reached. 5 Double-click at the end point of the polyline and the element is complete. Circles To draw a circle: 1 Click the button with the circle symbol or choose Circle from the Draw menu. 2 Place the pointer in the center of the circle. 3 Hold the mouse button down and drag until the circle reaches the size you want. Ellipses To draw an ellipse: 1 Click the button with the ellipse symbol or choose Ellipse from the Draw menu. 2 Place the pointer in the center of the ellipse. 3 Hold the mouse button down and drag the pointer both sideways and lengthwise until the ellipse is the size and shape you want to. Arcs Arcs are drawn as parts of a circle. Therefore drawing an arc begins by drawing a circle. Then the part of the circle forming the arc is limited. To draw an arc: 1 Choose Arc Modes from the Format menu. The alternative modes, Pieslice and Chord, are shown after you have chosen Arc Mode. You can select one of them. The Pieslice mode is chosen by default. If you change the mode in one picture, the mode will also be applied to the other pictures made in the editor before closing it, unless you change it again. 2 Click the button with the arc symbol or choose Arc from the Draw menu. 3 Place the pointer in the center of the circle in the drawing area. 4 Hold the mouse button down and drag the pointer until the circle reaches the size you want. 33

38 SYS Background 1MRS MEN Figure 27. From the Format menu you can choose one of the Arc Modes. The available choices are Pieslice and Chord. 5 Place the pointer on the circle, on the point where the arc starts or ends. Press the mouse button down. 6 Move the pointer counterclockwise along the circle to draw the arc, or move it clockwise to remove parts of the circle. Hold the mouse button down during this procedure. Figure 28. The arc modes. The upper filled arc is pieslice and the other is chord. Rectangle To draw a rectangle: 1 Click the button with the rectangular symbol or choose Rectangle from the Draw menu. 2 Place the pointer in one corner of the rectangle in the drawing area. Hold the mouse button down and drag the pointer to the opposite corner. 3 Release the mouse button. 34

39 1MRS MEN SYS Background Compound Standard Elements The buttons for compound graphic elements are raised fields, window frames and separators, in standardized colors and shadings. To draw compound elements: 1 Choose Extended Toolbox from the Options menu and the buttons for compound elements are shown on screen. 2 Click the button with the correct figure. 3 Place the pointer in one corner of the rectangle in the drawing area. Hold the mouse button down and drag the pointer to the opposite corner. 4 Release the mouse button. With the help of buttons for compound graphical elements you can easily draw complex elements. You can draw for example window frames or raised fields. The compound graphical elements are made of boxes so that they can be drawn in the same way as boxes. They can also be edited individually. Figure 29. The Extended Toolbox, which can be chosen from the Options menu Text A font has to be chosen before typing any text. This procedure is described under title Choosing a Font in page 28. To insert text in a picture: 1 Click the button with the letter A in the drawing toolbox or choose Text from the Draw menu. If a font has not been chosen, an error message No font defined. appears. Click OK and define the font as described. 2 The dialog box shown in the Figure 30 appears. Type the text in the text box and then click OK. 35

40 SYS Background 1MRS MEN In the resizable dialog box, shown in the Figure 30, it is possible to select between One line (text) and Multiple lines (text vector) type. The default type is One line, but when adding a new text without exiting the Picture Editor in between, the previously used type is used as the default. If Multiple lines is selected, the text field has the vertical scroll bar enabled and the OK button is not the confirm item of the dialog box, as it is for the One line type. If One line type is selected for a text with multiple lines, the first line is preserved. 3 The input text attaches to the cursor by its font dependent attachment point. Position the text to the place where you want to add the text and click the mouse button. Figure 30. In this dialog box type the text, which you want to add When new text is placed into a picture, the alignment is Default by default, which in most cases means Left alignment. Other alignment possibilities are Left, Center and Right. To change the alignment of, for example a Left aligned text: 1 Select the text or texts to which the new alignment is to be applied. 2 Select either of the other two alignments, Center or Right from the Text Alignment submenu of the Format menu. The text changes alignment according to the new selection. Note that the alignment of an existing text can not be changed to Default. Image To insert an image as background of a picture: 1 Click the Image button in the toolbox or choose Image on the Draw menu. The Insert Image dialog box, shown in the Figure 31, appears. 2 Enter the name of a.vso file or click Browse to select a with the file chooser. 3 Click Fetch Images. 4 Click the arrow in the drop-down combo box to see a list of available images in the file. The tag size to use depends on the size of the monitor. The tag sizes correspond to monitors 840*640, 960*720, 1280*960 and 1600* To customize height and width uncheck the predefined options and enter values for height and width in pixel units. 6 Click OK to insert image and to close dialog. 36

41 1MRS MEN SYS Background Figure 31. The Insert Image dialog box To edit a background image: 1 Select the image. 2 Click the Image button in the toolbox or choose Image on the Draw menu. The Edit Image dialog box, shown in the Figure 32, appears. 3 Edit the width or/and the height by unchecking the predefined options and entering values for height and width in pixel units. Also the tag names can be altered. 4 Click Apply to make the changes take place or click OK to make the changes take place and to close the dialog box. Figure 32. The Edit Image dialog box The VSO file name fields in the Figure 31 and the Figure 32 accept MicroSCADA relative paths, logical paths and operating system paths. 3.3 Editing Existing Graphic Elements General A selected element can be moved or deleted, its size, shape and the graphic features can be changed and texts can be edited. You can also bring the elements to the front 37

42 SYS Background 1MRS MEN or send them to the back. Elements that are created by SCIL commands in the draw program are shown in the Picture Editor but they cannot be edited. Figure 33. The Edit menu Choose the basic editing functions from the Edit menu. The functions in the Edit menu are shown in the Figure 33. Some of them can also be chosen by clicking the buttons in the toolbar. Several other editing functions can be chosen from other menus. Changing Size or Shape To change the size or shape of an element: 1 Select the element. 2 Place the pointer on one of the handles, hold the mouse button down and drag the pointer to the new location of the handle. 3 Release the mouse button. Alternatively, use the arrow keys on the keyboard to move the handle one grid unit at a time. Rotating an Element A rectangle or hyperbola can be rotated by + 90, 180 or - 90 degrees. To rotate: 1 Select the element. 2 Choose Rotate from the Edit menu. 38

43 1MRS MEN SYS Background 3 The option - 90 degrees rotates the element to the right and + 90 degrees rotates it to the left. The option 180 degrees rotates the element upwards. These options are shown on screen. Select the one you want to use. The element is rotated. Changing the Color of an Element To change the color of an element: 1 Select one or more element(s). 2 Select the color that you want to use from the color bar. The color of the element is changed. Another way to change the color: 1 Select one or more element(s). 2 Click the button with colored circles, located on the bottom row of the color bar as shown in the Figure 16 or select Color from the Format menu. The Color chooser appears with the current element color selected, see the Figure Choose one from four alternative color types by selecting the appropriate page. Then choose the color you want to use. 4 When the color is chosen, click Apply to change the color of the element(s) or click OK to change the color of the element(s) and to close the Color chooser. Cancel button closes the Color chooser. Editing Text To edit text: 1 Select the element. 2 Click the button with letter A. 3 The Edit Text dialog box appears. Edit the text in the text box. Click OK. To change the font: 1 Select the element. 2 Click the button with the letter F at the bottom of the screen or choose Font from the Format menu. 3 The Font Chooser appears. Now change the font in the same way as it was selected before typing the text. For more information on this, see page

44

45 1MRS MEN SYS Windows 4 Windows About this Chapter This chapter discusses the following subjects: 4.1 Features, window and representation types are described in this section. 4.2 This section handles creating and defining windows. 4.3 The third section tells you how to define all types of Internal Representations. 4.4 The fourth section tells you how to define all types of Library Representations. 4.5 The fifth section tells you how to define all types of Picture Representations. 4.1 Overview Window Features Windows are the dynamic and changing, pop-up parts of the pictures. A window can be regarded as a rectangle in which you can show values, symbols, graphs and other picture components that are not needed continuously. The look of the window is defined by representation. The representation is the content of the window. The size of the window is automatically adjusted to the representation displayed in it, at the display moment. The size can be anything from one grid unit to the whole screen. Windows can be located anywhere on screen, even overlapping one another either partially or totally. When a picture is shown in a window, you can use all its elements. The elements are acting independently of the main picture. This way you can view several process parts in the same picture and produce or erase temporary function keys. While a window is shown on screen, the covered areas of the picture cannot be used. However, windows can be moved from one location to another with SCIL. Windows are edited in the windows mode. Windows can also be seen in the windows mode. Window Types There are three types of window: Library representation. A library representation is stored in a library under its name. You can use it in the entire base system. Internal representation. An internal representation belongs to a certain picture and is stored together with it. The internal representation can be used only in that picture. 41

46 SYS Windows 1MRS MEN Picture. A window type picture is an ordinary picture that is displayed in a window. Any picture can be used for this purpose. It can contain function keys and windows, which in turn can contain pictures. The use of picture representations extends the usability of pictures and enables a large variety of picture solutions. Representation Types There are six types of representation: Bar Curve Field Multifield Selector Figure FIELD: 09:26:53 FIGURE: SELECTOR: PICTURE: ON OFF BAR: CURVE: MULTIFIELD: NOTE! Figure 34. Examples of different representation types and a picture The representation types are shown in Figure 34. Bars and curves are used to show data in graphs. They can also be used to show trends, prognoses or level changes. You can use them for example to illustrate voltage measurements. The accuracy in which the curves are drawn depends on the resolution of the screen you are using. You can show several curves or bars in the same window. 42

47 1MRS MEN SYS Windows A field is a one-dimensional, horizontal field whose length can be up to 80 characters. It is used to display and enter information. A multifield can contain several fields, which can be either vertical or horizontal. It is used to enter and display data if you need more than 80 characters in it or to show information with several rows. A selector is used to show, in the same window, alternative representations that depend on some conditions. These representations can be of type field or figure. For instance, you can show a breaker differently at open and close positions or alternative texts depending on certain values. A figure is like a picture background. It is usually small but can also fill up to the whole screen. Unlike pictures the figures cannot contain function keys or windows. Function Showing and erasing windows does not affect other picture components. You can repeatedly display windows without erasing them. A time or event based updating is also possible. The covered areas of the picture cannot be used while a window is shown on screen. However you can move windows from one location to another and then use these areas. Windows are shown and erased using!show and!erase commands. For more information on window handling commands, see Chapter 6, or the Programming Language SCIL manual. 4.2 Defining Windows General In windows mode you can add, delete or edit windows. Editing functions that are common to several types of elements were discussed in Chapter 2. These functions are selecting, deleting, copying, aligning and zooming. Open the Picture Editor and then change the background mode to the windows mode. Choose Windows from the Edit menu to change the mode. You can also change it in the toolbar. The appearance of the Window Editor varies depending on the choices made concerning the representation type. Creating a Window To create a new window, define its place, name and then the representation. The location of a window is always defined by the position of its upper left corner. Identify a window by its name. The SCIL expression is optional. The representation determines the appearance of the window. To create a new window: 1 Choose Window from the Draw menu. A window, of the size of one character, appears in the picture. The window moves along with the mouse pointer. 2 Show the location of the new window by clicking the mouse button on the place, where you want to insert the upper left corner of the window. 43

48 SYS Windows 1MRS MEN 3 The dialog box shown in Figure 35 appears. Type the name of the window in the text box and then click OK. Figure 35. This dialog box appears after you have shown the place of the new window. Type the name of the window in the text box. 4 A window editor, part of which is shown in Figure 36, appears. The name you gave in the previous dialog box is shown in the Name text box. 5 In the Expression text box you can enter a SCIL expression, which is optional. The expression defines the data to be shown in the window. The representation specifies also how the expression will be shown in the window. If you do not want to continue creating a window, click Cancel, which removes the window and all the definitions you have entered. After one window has been created, there are default values in the Window Editor every time you enter it. You can use and edit them, or remove all the choices by clicking Clear. 6 A drop-down list box, where you choose the window type, appears. Choose the one you want to use. Window types were discussed earlier. Figure 36. Select the Window Type in the Window Editor. There are three possibilities: Internal Representation, Library Representation and Picture. 7 Define the window according to the explanation presented in sections Defining Internal Representations 4.3, Defining Library Representations 4.4 and Defining Picture Representations 4.5. Editing Window Definitions You can also edit the window definitions. To edit them, click the button with the tools symbol in the toolbox. The other way to edit the definitions is to choose Configure Window the Edit menu. To rename the window, click Rename button and type the new name in the dialog box that appears. Click OK and the new name appears in the name text box. 44

49 1MRS MEN SYS Windows 4.3 Defining Internal Representations To define Internal representation, choose the representation type you want to use from the Select Representation Type drop-down list box. The representation types were discussed earlier. Bar If you use bar representation type, the text shown in Figure 37 appears. 1 Define the general values of the diagram which are basic, minimum and maximum value. Click the General tab. In the Basic Value text box enter the basic value of the graph. It is the value where the x-axis, the horizontal axis, is drawn. Those values that are lower than the basic value will be shown as bars heading downwards. The default value is Enter the minimum value in the second text box. The minimum value is the lowest value to be shown in the diagram. Values lower than the minimum value are shown as the minimum value. The default value is In the third text box enter the maximum value, which is the greatest value that is shown in the diagram. Values greater than or equal to the maximum value are shown as bars of maximum height. The maximum value cannot be below the basic value. The default value is 0.0. Figure 37. Enter the basic, minimum and maximum values for the bar in the text boxes 4 Define the size of the diagram. It is defined using four attributes, which are width, height, bars and spaces. Use the spinners to select the correct numbers or type them. Click Size tab. Enter the Width, which is the width of one bar, the number of semigraphic character positions. The default value is 1. See Figure

50 SYS Windows 1MRS MEN 5 Enter the Height, which is the distance from the horizontal axis to the highest point of the graph. If all bars head downwards, the height is the distance between the horizontal axis and the minimum value. The default value is 1. 6 Enter the number of Bars you want to have in the window. The default value is 1. 7 Enter Spaces, which is the distance between the right side of the first bar and the left side of the second bar. The default value is 0. Figure 38. Enter the Width, Height, the number of Bars and Spaces 8 The last step to define the bar diagram is to enter limits to the figure. Select the Limits tab. Colors must be defined starting in the last row and proceeding upward. Click the first box in the beginning of the bottom row. See Figure

51 1MRS MEN SYS Windows Figure 39. Define limits of the bars. When the value exceeds the limit, the color of the bar will change. The Color Chooser appears. Choose one of the eight colors in the semigraphic color group in the Color Selector drop-down list box. The selected color is shown in the upper left corner of the dialog box. Click OK. The chosen color appears in the color box. The bottom row defines the color of the bar at the start point. The next row defines the look of the bar when its value exceeds the first limit. After selecting a color, you can choose to change the color of the whole bar or to make the diagram blink. To change the color of the whole bar when the limit value is exceeded, click the next check box. Otherwise the bar is filled with different colors, changing the color in the limit point. To make the diagram blink, click the third box in the row. The Limit Expression is a statement written with SCIL, which determines the limit. For more information on SCIL, see the Programming Language SCIL manual. Note that the limit must be given as a numerical data type, for example, integer, real or vector with numerical elements. If the limit is a vector, each element in the window expression is compared to the corresponding element in the limit. You cannot leave empty limit rows. Enter the second limit in the third row and continue like this. To add a row later, select its position by clicking the limit row below the place you want to add the new row. Click Insert. To remove a row, select it and then click Delete. After you have entered all the limits, click OK. 47

52 SYS Windows 1MRS MEN Curve If you use Curve representation, the notebook shown in Figure 40 appears in the Window Editor. 1 Select the General tab to define general values of the diagram, which are basic, minimum and maximum values. Select the numbers using the spinners or type them. In the first text box enter the basic value of the graph. The basic value is the value where the x-axis, the horizontal axis, is drawn. Those values that are lower than the basic value will be shown under the x-axis. The default value is Enter the minimum value in the second text box. The minimum value is the lowest value to be shown in the diagram. Values lower than the minimum value are shown as the minimum value. The default value is In the third text box enter the maximum value, which is the greatest value that is shown in the diagram. Values greater than or equal to the maximum value are shown as curves of maximum height. The maximum value cannot be below the basic value. The default value is 0.0. Figure 40. Enter the basic, minimum and maximum values in the text boxes 4 Select the Size tab to define the size of the diagram. It is defined using three attributes, which are Width, Height and Points. Enter the Width, which is the width of one curve element indicated in semigraphic character positions. The default value is 1. 5 Enter the Height, which is the distance from the horizontal axis to the highest point of the graph. It is also measured in semigraphic character positions. Enter the Points, which is the maximum number of points to be displayed in the curve. The default value is 0. 48

53 1MRS MEN SYS Windows 6 The last step to define the curve diagram is to enter limits to the figure. Select the Limits tab. Start to define the colors in the last row. Click the first gray box at the beginning of the last row. The Color Chooser appears. Choose one of the eight colors in the semigraphic color group in the Color Selector drop-down list box. The selected color is shown in the upper left corner of the dialog box. Click OK. The chosen color appears in the color box. The bottom row defines the color of the curve at the start point. The next row defines the look of the curve when its value exceeds the first limit. After selecting a color, you can choose to change the color of the whole curve or to make the diagram blink. To change the color of the whole curve when the limit value is exceeded, click the next check box. Otherwise the curve is filled with different colors, changing the color in the limit point. To make the diagram blink, click the third box in the row. The Limit Expression is a statement written with SCIL, which determines the limit. For more information on SCIL, see the Programming Language SCIL manual. Note that the limit must be given as a numerical data type, for example, integer, real or vector with numerical elements. If the limit is a vector, each element in the window expression is compared to the corresponding element in the limit. You cannot leave empty limit rows. Enter the second limit in the third row and continue like this. To add a row later, select its position by clicking the limit row below the place you want to add the new row. Click Insert. To remove a row, select it and then click Delete. After you have entered all the limits, click OK. You cannot print curves automatically, or you cannot make the curve to blink in other monitors than microworkstation. Field The field representation is a one-dimensional, horizontal field, whose length can be from 1 to 80 characters. It is used for displaying and entering data. If you use Field as the representation type, the notebook shown in Figure 41 appears. 1 Click the General tab. There are three choices of value type, which are Integer, Real and String. You can use string to enter text or time type expressions. Select the type you want to use from the Value Type drop-down list box. If the variable value is read from the field, the correct value type is selected automatically. The default value is integer. 2 There are three alignment choices, Left, Center and Right. Left means that the data shown in the field starts from the left side of the field. Center means that the characters are placed in the center of the field. If the input entered into the field is shorter than the character spaces available, the empty spaces will remain before the characters. Right alignment means that the characters are shown to the right of the field. In this case there may also be empty spaces before the characters. Alignment 49

54 SYS Windows 1MRS MEN has no meaning for data entries, which are always left aligned. Select the type of alignment you want to use from the Alignment drop-down list box. The default alignment is right. Figure 41. Define the value type and alignment for the field in the text boxes 3 Select the Size tab. Enter the number of spaces for semigraphic characters you want to have in the field. Type the number in the Field Length text box or change the number using the spinners. See Figure 42. The default value is 6. Figure 42. Define the field length and number of decimals for a field 4 If you selected real value type, in the next text box type the number of decimals or change the number using spinners. The default value is 0. 50

55 1MRS MEN SYS Windows 5 Select the Colors&Fonts tab. Define the colors for foreground and background. First click FG Color. Color Chooser appears. The default color is white. For more information on how to choose a color from the Color Chooser, see Chapter 3. Next click BG Color. The Color Chooser appears again. Define the color you want to use. The default color is black. 6 To choose the font you want to use, click Font. The Font Chooser appears. For more information on how to use the Font Chooser see Chapter 3. 7 To make the field blink while it is on screen, select the Blink option. The default is no blink. Click OK. Base system supports the blinking of the representation type of the field if its color and font are both semigraphic. Multifield If you use Multifield as a representation type, the notebook shown in Figure 43 appears. Figure 43. Define the direction, alignment and number of fields for the multifield 1 Select the General tab. Type the number of fields in the Field text box or change the number using spinners. The default value is 1. 2 There are three alignment choices, Left, Center or Right. Left means that the data shown in the field starts from the left side of the field. Center means that the characters are placed in the center of the field. If the input entered into the field is shorter than the character spaces available, the empty spaces will remain before the characters. Right alignment means that the characters are shown to the right of the field. In this case there may also be empty spaces before the characters. Alignment has no meaning for data entries, which are always left aligned. Select the type of alignment you want to use from the Alignment drop-down list box. The default alignment is right. 51

56 SYS Windows 1MRS MEN 3 There are two options for direction, Horizontal and Vertical. Select the direction you want to use from the Direction drop-down list box. The default direction is vertical. 4 Select the Size tab. Type the field length you want in the Field Length text box or change the number using the spinners. All fields at multifield must have the same length. See Figure 44. The default value is 6. 5 In the Decimals text box enter the number of decimal places you want to have in the field either by typing them or using the spinners. All numerical data is shown with the same number of decimals. The default value is 0. 6 In the Spaces text box enter the number of spaces you want to have between the fields in semigraphic coordinates. The default value is 1. Figure 44. Enter the field length, number of decimals and spaces for the multifield 7 Next define foreground and background colors. Select the Colors tab and then click FG Color. The Color Chooser appears. Choose one of the semigraphic colors. For more information on how to use the Color Chooser, see Chapter 3. 8 Next click BG Color. The Color Chooser appears again. Choose the color in the same way as you chose the foreground color. The default color is black. 9 To choose the font you want to use, click Font. The Font Chooser appears. For more information on how to use the Font Chooser see Chapter 3. To make the multifield to blink select Blink option. 10 Every element in a vector has a status code. When a multifield is displayed, the suspicious status codes 1 and 2, 10 (not sampled) and codes larger than 10 (logging error) can be expressed by text, color, blinking or other features. Select the tab (1,2). Then from the Action drop-down list box choose the action you want to use from the four available alternatives: Nothing, Text, Indication and Representation. See Figure 45. Nothing Nothing means that you do not want to show anything on screen. This is the default choice. 52

57 1MRS MEN SYS Windows Text Indication The representation Text represents a text that will be placed in the actual field or to the right of it. The position of the text can be selected from the Placement drop-down list box. In the Element text box type the element text. You can also choose the foreground and background colors and whether you want the text to blink or not. To choose the color, click FG Color at the bottom of the editor and the Color Chooser appears. To get more information on choosing a color, see Chapter 3. To make the text blink on screen, select the Blink option. Indication can be a color, which may also be blinking. The procedure of choosing a color is described in Chapter 3. To make the color to blink, select Blink option. Representation is the library representation that can be of type figure, field or selector. The representation is displayed in a window that is automatically generated and placed in the actual field. The rest of the fields in the multifield remain visible when the window is shown. The expression that will be shown in the window is determined by the actual vector element of the multifield. This means, that if the representation is a selector, the conditions are related to this status code. To choose the representation you want to show in the window, click Select and browse the files. Figure 45. Define the status codes for a multifield 11 Select the (10) tab and repeat the procedure described in the previous step. Select the (>10) tab and repeat the same procedure. 12 Different values or intervals can be marked in various ways using Programmable Exceptions. The programmable exceptions are specified by conditions related to the expression of the window. Refer to the window expression with empty brack- 53

58 SYS Windows 1MRS MEN ets (), which can be used as operands in the condition. You can also build a condition so that it starts with a relational operator. Then the window expression is the left operator. Any logical operator in the condition can be followed by a relational operator. Remember that text data cannot be compared with numerical values. Hence, if the expression of a multifield includes both text and numerical data, the conditions will produce error messages. You can define up to three exceptions. To define the first exception, select the PE1 tab, for the second exeption select PE2 tab and for the third one select PE3 tab. See Figure 46. Enter a condition and select how the exception should be displayed. The procedure is the same as for the other status codes. This was described in more detail in Step 10. Figure 46. You can define three exceptions to show different values or intervals Enter the condition in the Condition text box. From the Type drop-down list box you can choose one of the four alternatives, Nothing, Text, Indication and Representation. These alternatives and how to define them were already discussed in Step 10. To insert an exception between two exceptions that have already been defined, click Insert. Then enter the condition and proceed normally. To delete an exception, click Delete. Accept the choices you have made by clicking OK. Selector If you use selector as a representation type, the text shown in Figure 47 appears. A selector can contain several representation alternatives, which can be of type picture, field or figure. Each altenative is connected with a condition. When a window is requested for display, the alternatives are checked until the required condition is full- 54

59 1MRS MEN SYS Windows filled. Then that representation is shown in the window. The remaining alternatives will not be checked. Figure 47. Enter the condition for every alternative in a selector 1 Enter a condition in the Condition text box. See Figure 47. The representation is shown, if the condition is fulfilled and no other condition has been fullfilled before it. The condition must follow the rules for SCIL conditional expressions, with operands (object notations, variables, constants, function calls) and operators. Note that the object notation and variables are only evaluated the first time the window is shown. A new evaluation requires that the window is erased before it is shown again. An important special feature: window expressions are referred using empty brackets. They can be used as an operand or argument in function calls. For example, the condition GET_STATUS (())==2 is true when the status code for the window expression is 2. Another way to type a condition is to start it with a relational operator. The window expression is then the left operand in the relation. Likewise, possible logical operators in the condition can be followed by relational operators. 2 Click Add and the Selector Editor shown in Figure 48 appears. The alternative type can be Internal, Library or Picture. Select the type you want to use from the Select Alternative Type drop-down list box. To edit the definitions later, click Edit. 55

60 SYS Windows 1MRS MEN Figure 48. In the selector editor you can define the type of the alternative If you select Internal as the alternative type, choose between field and figure. For more information on how to define field and figure, see section Field on page 49 or section Figure on page 57. If you select Library as the alternative type, enter the name, type and representation of the library. Choose field, figure or selector depending on which type you want use. See Figure 49. You can choose the library and the representation you want to use from the Library and the Representation drop-down list boxes. Figure 49. Define the library file, type and representation for a alternative of library type If you select Picture as alternative type, choose the Logical Path you want to use from the Logical Path drop-down list box. See Figure 50. Then type the name of the picture without its extension (.pic). To see a preview of the picture, click Show. To make sure you gave the correct name and the path, click Select. The width and height of the picture are shown. If the correct name and path were not given an error message appears. Click OK and correct them. After you have defined the representation, click OK. To exit the Selector Editor without saving, click Close. 56

61 1MRS MEN SYS Windows 3 Enter the number of the next alternative and the condition related to it. Click Add and define the representation. Continue like this until all alternatives have been defined. 4 Click OK to save the definitions and exit the Window Editor. To exit without saving, click Close. Figure 50. Type the name of the picture and select its logical path in the dropdown list box. To see a preview of the picture, click Show. Figure A figure representation can contain all the elements included in the picture background. Figures cannot contain function keys or windows. If you use a figure as a representation type, you can create or edit the figure by clicking Edit. The drawing area appears. The figure is drawn in the same way as the background of the main picture. This was described in Chapter 3. Click OK. Figure 51. To edit an internal figure, click Edit 57

62 SYS Windows 1MRS MEN 4.4 Defining Library Representations If you use a library representation, new text boxes appear in the middle of the Window Editor (Figure 52). Select the representation type you want to use. Define the basic features of the library representations. You can also edit other features in the Representation Library Editor, where the library representations are added. This procedure is described with more details after the procedure of defining the normal features. The most important advantage of using library representations is that they can be used in any picture in the system. Handling library representations is almost as fast as handling internal representations. Figure 52. Select the representation type for a library representation 1 Choose the Representation type you want to use. 2 In the Library drop-down list box choose the logical name of the library you want to use. 3 In the Representation drop-down list box are shown the representations of the chosen representation type in that particular library. Choose the one you want to use. 4 Define a window as described in this section. In the Window Editor you can see the definitions related to the chosen representation. The definitons that can be changed or added are written in black. Bar If you select a bar representation, define the size of the diagram in the General page using two attributes, the number of bars and spaces. 1 Enter the number of bars you want to have in the window. Type the number or change it with spinners. 2 Enter the number of spaces, which is the distance between the right side of the first bar and the left side of the second bar. 3 Select the Limit tab to define the limit values. Begin to define the colors from the bottom row. Click the first box at the beginning of the bottom row. 58

63 1MRS MEN SYS Windows The Color Chooser appears. Choose one of the eight colors in the semigraphic color group in the text Color Selector drop-down list box. The selected color is shown in the upper left corner of the dialog box. Click OK. The chosen color appears in the color box. The bottom row defines the color of the bar at the start point. The next row defines the look of the bar when its value exceeds the first limit. After selecting a color, you can choose to change the color of the whole bar or to make the diagram blink. Note that you cannot make the bar to blink in other monitors than microworkstation. To change the color of the whole bar when the limit value is exceeded, click the next check box. Otherwise the bar is filled with different colors, changing the color in the limit point. To make the diagram blink, click the third box in the row. The Limit Expression is a statement written with SCIL, which determines the limit. For more information on SCIL, please refer to the Programming Language SCIL manual. Note that the limit must be given as a numerical data type, for example, integer, real or vector with numerical elements. If the limit is a vector, each element in the window expression is compared to the corresponding element in the limit. You cannot leave empty limit rows. Enter the second limit in the third row and continue like this. To add a row later, select its position by clicking the limit row below the place you want to add the new row. Click Insert. To remove a row, select it and then click Delete. After you have entered all the limits, click OK. Curve If you select a curve representation, define the size of the diagram in the General page using two attributes, number of points and width factor. 1 Enter the number of points you want to have in the window. The points is the maximum number of points to be displayed in the curve. 2 Enter the width factor, which is used to multiply the original width in the library to obtain the width to be used in the window. 3 Select the Limits tab to define the limit values. Begin to define the colors in the last row. For more information on this procedure see the previous section (page 58). Note that you cannot print curves automatically, or you cannot make the curve to blink in other monitors than microworkstation. Accept the choices by clicking OK. Field Select a field representations. For more information on field definitions, see section Field on page 49. There are no definitions for a field that can be changed. Accept your choices by clicking OK. Multifield 1 If you select a multifield representation you must define several attributes. Select the General tab to define the direction. In the Direction drop-down list box there 59

64 SYS Windows 1MRS MEN are two alternative options for direction, horizontal and vertical. Choose the direction you want to use. See Figure 53. Figure 53. The direction of a multifield can be edited 2 Select the Size tab and type the number of fields in the Field text box. See Figure In the Spaces text box type the number of spaces between the fields. Figure 54. Define the number of fields and spaces between the fields 60

65 1MRS MEN SYS Windows 4 There are no color definitions that can be changed. Status Codes and Programmable Exceptions are defined as for internal Multifield. For more information on this, see section Multifield, on page 51. Accept your choices by clicking OK. Selector Choose a Selector. For more information on selector definitions, see section Selector on page 54. There are no definitions for a selector that can be changed. Accept the choices by clicking OK. Figure 1 To use figure representation, select Figure from the Select Representation Type drop-down list box. Then choose the library you want to use from the Library drop-down list box. 2 The figure representations that are located in the given library are listed in the Representation text box. Choose the figure you want to use. The chosen figure is shown. See Figure 55. Accept it by clicking OK. Figure 55. For a figure choose the name and logical path of the library you want to use. Then select the figure you want to use. Defining Other Features of Library Representations To edit features other than the ones that can be edited in the Window Editor, use the Representation Library Editor. To edit: 1 Open the Representation Library Editor by clicking its icon in the page of MicroSCADA Tool Manager. 2 Choose the logical name of the representation library you want to use from the Logical Library drop-down list box. 61

66 SYS Windows 1MRS MEN 3 Choose the representation library file you want to use from the Representation Library File drop-down list box. Figure 56. The Library Representation is defined in the Representation Library Editor 4 The representation types that exist in the defined file are listed in the Representation Type drop-down list box. Choose the type of the representation you want to define. 5 The names of the representations that are of the given type in the file are shown in the large white box. Select the representation you want to edit. See Figure To change the representation, click Edit. To add a new representation, click Add. Now the features you can edit are shown on screen. See Figure 57. Edit the features and save the representation. To create a new representation that has some same features as the old one, click Copy. In the dialog box that appears type the name of the new representation. 62

67 1MRS MEN SYS Windows Figure 57. The Representation Editor appears when you click Add in the Representation Library Editor Copying Library Representations In the Representation Library Manager you can copy or move representations from one library file to another. To open it, click Repr Mgr in the Miscellaneous page of the Tool Manager. The Representation Library Manager contains two columns, where the library files and a representation are chosen. The files where you copy from and to can be in both columns. To copy a representation: 1 Choose a Logical Representation Library in the upper drop-down list box in the left column. The libraries that exist are shown in it. 2 Choose a Representation Library File in the second drop-down list box. The existing files in the chosen library are shown in it. 3 Choose a Representation Type in the third drop-down list box. The existing types in the chosen file are shown in it. 4 Repeat the steps 1-3 in the right column. 5 Select the representation you want to copy. The represenation can be either in the left or right column. 6 Click the arrow that points to the column where the file to which you want to copy the representation is chosen. 7 In the Representation Transfer dialog box that appears click Copy. The copied representation is shown in the file to which the arrow points. Moving Library Representations The Representation Library Manager contains two columns, where the library files and a representation are chosen. The files where you move from and to can be in both 63

68 SYS Windows 1MRS MEN columns. To open it, click Repr Mgr in the Miscellaneous page of the Tool Manager. To move a representation: 1 Choose a Logical Representation Library in the upper drop-down list box in the left column. The libraries that exist are shown in it. 2 Choose a Representation Library File in the second drop-down list box. The existing files in the chosen library are shown in it. 3 Choose a Representation Type in the third drop-down list box. The existing types in the chosen file are shown in it. 4 Repeat the steps 1-3 in the right column. 5 Select the representation you want to move. The representation can be either in the left or right column. 6 Click the arrow that points to the column where the file to which you want to move the representation is chosen. 7 In the Representation Transfer dialog box that appears click Move. The moved representation is shown in the file to which the arrow points. 4.5 Defining Picture Representations If you use picture representation, the content of the Window Editor changes. See Figure 58. Any picture can be displayed in a window. You should remember the following facts when creating a picture that will be displayed in a window. The picture is shown so that its upper left corner is in the place you have defined. The size of the window is adjusted to the size of the picture. The variables of a main picture can be used in the window picture and the variables of the window picture can be used in the main picture without further definitions. The start program is executed each time the window is loaded with the SCIL command!show, and the exit program is executed each time the window is erased. Updating the picture is done with the!update and #on commands of the window, not with the commands of the main picture. To define picture representation: 1 Select the logical path of the picture from the Logical Path drop-down list box. 2 Then type the name of the picture in the Picture Name text box. To see a preview of the picture, click Show. To make sure you have the correct name and path, click Select. The width and height of the picture are shown on screen. If the name and path were not correct an error message appears. Click OK and correct them. 64

69 1MRS MEN SYS Windows Figure 58. Enter the logical path and name of the picture for a picture representation. To see a preview of a picture, click Show. 65

70

71 1MRS MEN SYS Function Keys 5 Function Keys About this Chapter This chapter describes: 5.1 Overview. 5.2 Creating function keys. 5.3 Defining and programming function keys. 5.1 Overview General Function keys are programmed rectangular areas. When a function key is activated, a SCIL program or data entry is started. Using function keys you can affect the process as well as the control system. For example you can load and erase pictures and windows, operate the process, select, acknowledge alarms or initiate printouts. You can place function keys anywhere in a picture. The size of a function key can be anything from one character to the whole screen. Remember that the key is not automatically shown on screen in other modes. Before creating the other features of the function key, it is useful to make the function key visible by drawing its background. You can move, delete or reprogram a function key. Function Key Types There are three types of function keys: Command keys. Command keys can be used for all kinds of user operations. A command key contains a SCIL program, which is started every time the key is activated. Line command keys. Line command keys are used to build up a series of data entries. A line command key is a command key with a special feature. This special feature appears when the line command key contains an!input_var command. After this command has been executed, pressing Enter (on the keyboard) may cau automatic activation of another function key. If there is a function key in the position defined by the variable CURSOR_POS, it will be activated automatically. String keys. String keys are used for data entry. A string key contains a character string, which is entered to a SCIL program with!input_var command each time the key is activated. 67

72 SYS Function Keys 1MRS MEN Function Key Handling Choose Function Key mode from the Edit menu. Now you can begin to create or edit function keys. 5.2 Creating Function Keys To create a function key: 1 Choose Key from the Draw menu. The function key types, command, line command and string keys, are shown. Choose the one you want to use. The function key type can be changed later, in the Key Editor. 2 Then press the mouse button down in the place where you want to insert the upper left corner of the key in the drawing area and hold it down while dragging the pointer to the opposite corner. The selected area is now marked by frames to indicate that it is a function key. Function keys cannot be placed on top of each other. An error message Overlapping keys not allowed appears if you try to place one function key on top of another. If you want to move several keys and any of the keys are overlapping, no keys are moved. Otherwise the function keys can be placed freely on windows and picture functions. If a function key is placed on top of the function key in a picture function, the function key of the main picture lies behind the function key of the picture function. In this case it cannot be used. After creating a function key you can define the key, edit it or create another one. It is possible to move, delete, align or zoom a function key. You can also resize it. For more information on this, see Chapter Defining Function Keys The Key Editor To define a function key: 1 Select the function key. 2 Click the button with tools symbol. The Key Editor shown in the Figure 59 appears. 3 Choose the key type you want to use from the Type drop-down list box. 4 A function key can be blinking or non-blinking. Blinking means that the key will start blinking when it is activated and continues until the!restore command is executed. Non-blinking means that the function key will not blink in any situation. 68

73 1MRS MEN SYS Function Keys Figure 59. You can define the key in the Key Editor 5 Continue function key definition by programming the key and typing the help text. Programming Function Keys All three types of function keys, command keys, text keys and command line keys, are programmed in the Key Program Editor, which is entered via the Key Editor. To program the key: 1 First enter Key Editor. 2 Click Program and the Key Program Editor appears. If the key has not been programmed before, the program lines are empty. Otherwise the program that has been written before is shown. 3 To program command keys or line command keys, type the SCIL statements line by line. To program string keys, you can only use the first line. Do not use quotation marks ( ). The variable CURSOR_POS must be defined before the!input_var command in the program of line command keys. For example, the following line command key program activates the function key on the next line when Enter is pressed on the = %CURSOR_POS(2) + 1!INPUT_VAR 4 When you have finished programming, choose Exit from the File menu. 5 A dialog box with the question Do you want to update edited object? is shown. Click on Yes. 6 Choose Close in the Key Editor. Chapter 6 discusses programming and using SCIL Program Editor in more details. 69

74 SYS Function Keys 1MRS MEN Inserting Help and Header Tex You can insert Help or Header texts for keys. Help texts are read with the command!input_key HELP. These texts give information about the key to the user - they have no functional meaning. To insert help or header text: 1 Select the function key. 2 Click the button with the tools symbol in the toolbox. The Key Editor appears. 3 Click Help or Header depending on which one you want to insert. The Key Help or Key Header dialog box appears. 4 Start the typing in the first row. For more information on editing text see Chapter 6. 70

75 1MRS MEN SYS Picture Programs 6 Picture Programs About this Chapter This chapter contains the following sections: 6.1 The first section describes the different program types and gives some general rules and hints for programming with SCIL. 6.2 The second section describes how to use the SCIL Program Editor. 6.3 Description of the compilation feature in the Picture Editor. 6.4 The fourth section describes some common SCIL commands related to picture handling. 6.1 Overview Picture Program Types Programs are the active parts of a picture. The background, draw, start and update programs are executed each time the picture is requested to be shown on screen, no matter whether it is shown as a main picture or a part picture. A picture can contain the following types of programs: Background program. The background program is created automatically. It contains only graphical commands, which are usually made by Picture Editor. Other than graphical commands will be removed. The graphics drawn by the background program are shown in the Picture Editor. Note that the program should not be edited manually. Draw program. The draw program is executed immediately after the background program, before the start program. Though the draw program can contain any command, it is especially suitable for full graphic SCIL commands. The elements drawn with graphics commands in the draw program are not shown until the whole program has been executed. The graphics created in the draw program are shown in the Picture Editor, but cannot be edited without changing the program. Graphics commands added to the draw program during the picture editing can be shown by choosing Refresh from the View menu. Start program. Start programs are normally used for showing or reading initial picture values, defining the updating of the picture and other similar functions. Update program. The update program provides the possibility to update the picture cyclically with a selected time interval as long as the picture is shown on screen. Exit program. The exit program is executed each time the picture is closed. It does not matter if the picture is shown as a main picture or a part picture, or in what way it is exited. 71

76 SYS Picture Programs 1MRS MEN Key program. A key program is executed each time the corresponding function key is activated. There can be several key programs in a picture. Named program. A named program is executed by a SCIL command or as a callback from a Motif widget or Visual SCIL object. There can be several named programs in a picture. ERROR_HANDLER. The standard error messages shown in the upper left corner of pictures can be avoided. Each picture may contain a named program with predefined name, ERROR_HANDLER, where the programmer can define the error handling to be used in the picture. The ERROR_HANDLER program receives information about the errors. See the manual Programming Language SCIL, Chapter 7. Programming Each program, except string key programs, can contain up to lines. All programming is written with SCIL. When you program with SCIL you can leave empty lines and spaces anywhere in the program. In picture programs, except in background programs, all types of SCIL statements are allowed. Programs are written in the SCIL Program Editor. It includes a number of useful features, for example it enables cutting, copying and pasting program lines as well as searching texts and replacing them with others. A program can be copied to and from an ASCII file. Hints and Notes The updating of a picture can be defined by programs. The update program is not started until the!update command has been executed. Automatic event based updating in a picture is done with #ON command and event objects. A window is updated at the time interval that is given in the same window picture. The event based updating of a window is also defined in the window picture. Named programs can be used when a program should be executed several times in the same picture. Note that the #EXEC commands are queued in a separate execution queue. This means that some commands that are meant to be executed after the #EXEC command may be executed before, if the program is not done carefully. When a window picture is shown with the!show command, its start program is executed. When the picture is erased, its exit program is executed. You can erase a window picture with!erase command that is located in the same hierarchical picture stucture. If the command is located inside the window picture, the program in which the command is located stops immediately when the command is executed. 6.2 Using the SCIL Editor Opening the SCIL Editor To open the SCIL Editor from the Picture Editor, choose the program type you want to create or edit from the Program menu. You can also open the SCIL Editor through 72

77 1MRS MEN SYS Picture Programs several dialogs while defining elements. For example, you can open the Key Program Editor from the Key Editor where you define other features of the key. Using the SCIL Editor The File menu of SCIL Editor contains options for file handling, updating and exiting the editor. The Edit menu contains options for copying, moving and deleting. The Undo option found here is useful when you regret an operation. The Search menu contains options which help the programmer search and replace text strings. There is also a Go To option for moving to a certain line. In the Settings menu, the font size can be changed. The Help menu provides information about the editor. The SCIL Editor is operated according to the same principles as other Windows based applications. The editor is specialized for SCIL program editing. For more information on using the SCIL Program Editor, see the Chapter 12 in Programming Language SCIL manual. Exiting the SCIL Editor To quit programming, choose Exit from the File menu. If you have made changes after the last time you have saved the program, a dialog box asking Do you want to update edited object? appears. Answer Yes if you want to save the changes you have made to the program. 6.3 Compilation of Picture Programs Programs of station pictures can be compiled in the picture editor to optimize performance. There are programs which can not be compiled and therefore it is possible to select which programs are compiled. There is no need to compile the programs while the picture is under construction and not ready tested. If an error occurs during execution of a compiled programs the error viewer can not show the line where the error occurred. If a program can not be compiled, the picture editor shows which program it is and the line that caused the error. The compilation status (compiled/uncompiled) of programs in the edited picture can be viewed. Picture Formats The picture format of MicroSCADA and later is different from previous revisions. Pictures of the old format is however fully supported by the and later revisions of MicroSCADA. Compilation of picture programs and installation of more than 220 picture functions is only supported in the picture format of MicroSCADA and later. If these features are used in a picture of the old format, the picture editor will ask if the picture format should be changed. Pictures of the MicroSCADA and later formats can not be used in previous revisions of MicroSCADA. 73

78 SYS Picture Programs 1MRS MEN Compilation Picture programs selected for compilation are compiled when the picture is saved. All syntax errors are reported when the picture is compiled. To compile picture programs: 1 In the Picture Editor, choose Compilation... on the Options menu. A dialog named Compile Options opens. 2 Check the program types that are to be compiled when the picture is saved. At this stage the picture format is checked. If the picture is of old format a dialog asking the user if the picture should be upgraded is shown. 3 Click Close to exit the dialog. Compilation is also performed when the Picture Editor is with the Exit command. If a program checked for compilation has been edited and the Picture Editor is exited, the syntax is checked as the program is compiled. If a syntax error is encountered a message There were errors found when compiling the picture is displayed in a dialog. The user can choose the Exit anyway button, which exits the Picture Editor despite failing compilation whereas the program will not work. The second button, Show Errors, displays the Show Syntax Error(s) dialog where the name of the erraneous program and SCIL line is shown. Compilation Status The compilation status of picture programs in a picture can be inspected. To inspect the compilation status of picture programs: 1 Choose Compilation Status... on the Programs menu. A dialog showing compiled and uncompiled programs is opened. 2 Click Close to exit. Syntax Check of Picture Programs Invoking the syntax check in the picture Editor checks all picture programs for errors. To check syntax: 1 Choose Check Syntax on the Programs menu. 2 If one or more erraneous SCIL lines are encounter a dialog named SCIL Syntax Error(s) is shown. Information of a successful syntax check is shown in a message box. 3 To exit the SCIL Syntax Error(s) dialog, click Exit. The message box is closed by clicking OK. For more information of compilation, see Chapter 13 of the Programming Language SCIL manual. 74

79 1MRS MEN SYS Picture Programs 6.4 Some SCIL Commands General A detailed description of SCIL can be found in the Programming Language SCIL manual. In this section, only some commands used for picture editing are introduced. The commands are given with the arguments needed to build a full statement. The arguments are written with lower case letters. Exchanging Picture!NEW_PIC picture_name Loads a specified picture to the screen. The background, start and draw programs of the picture are executed.!last_pic Reloads the picture that was last shown on screen. Window Handling!SHOW window expression Shows the named window. If the expression argument is given, it defines what is to be shown in the window. If it is used, the one given in the Window Editor is disregarded. The command can be repeated without erasing the window in between.!win_input window expression The expression argument has to be given. It defines what is to be shown in the window. The expression in the Window Editor is disregarded.!win_pic window picture_name Specifies the picture to be shown in the window. This picture name supersedes the one given in the Window Editor.!WIN_REP window representation Selects the library representation to be used in the named window. The representation supersedes the one given in the Window Editor.!WIN_POS window position Moves the window to a new position (e.g. given with!input_pos below).!win_name window_name Creates a new window during operation.!win_create window_name Creates a window during operation. See Programming Language SCIL manual. 75

80 SYS Picture Programs 1MRS MEN!ERASE window Erases the window from the screen. User Entries!INPUT_VAR window variable Assigns the variable value the user gives. The window should be of FIELD type.!input_pos variable Reads the mouse or cursor position the user gives.!enter Terminates the data input. The system waits for further data until this command is executed. Updating in Picture!UPDATE interval Starts the cyclic execution of the updating program according to the given updating time interval. #ON event statement Defines a statement or block of statements to be performed each time a certain event occurs. Concerns pictures currently displayed on screen. Printout #PRINT number picture_name (variable list) Sends the picture to be printed on a printer.!send_pic device_name number Copies the screen to a printer (hardcopy). Miscellaneous!RESTORE Removes the blinking of a function key caused by the execution of the key. 76

81 1MRS MEN SYS Picture Functions 7 Picture Functions About this Chapter This chapter describes briefly how to use the LIB 5XX standard functions for building application pictures. 7.1 Overview General LIB 500 is a product group. A library includes standard functions for different application fields. There are several libraries in the LIB 5XX product group, for example, LIB 500 Base, LIB 510, LIB 520 and LIB 530. The LIB 500 Base is the base library that you need to have to be able to use libraries. It includes the following functions: User Management. System Self Supervision. Event & Alarm Handling. Busbar coloring. Backbone functions. Installation tool. Configuration tool. Language converter. In addition to LIB 500 you can also have other libraries. The selection of libraries is done based on the need of different functions and tools. The LIB 500 is continuously developed and extended with new standard functions. The standard functions are, in principle, ordinary pictures. The following are the main types of standard functions: Substation displays. Reports (energy, current). Trends. Alarm and event lists. System Self Supervision. A picture function is a copy of library standard function that has been given a name and has been installed into a picture. The objects belonging to the function are created later when you configure the picture function. These objects can be process objects, scales or report objects. Installation and configuration phases are done separately. You can install a standard function into an application and configure it later. The configuration parameters can easily be changed without using the Installation Tool. A picture can contain picture functions, but this is more of a theoretical value. In 77

82 SYS Picture Functions 1MRS MEN practice, for example the amount of memory in the computer in use and the configurations of MicroSCADA can be limiting factors to the amount of picture functions in one picture. Prepare the application for LIB 500 before installing picture functions that are located in the library. For more information on the libraries, see LIB 500 documentation. Features Picture functions are picture components that work like complete pictures that are included in the main picture. Like ordinary pictures, picture functions can contain: A picture background. Draw, Start, Update, Background, Exit, Key and Named programs. Function keys. Windows. A picture function itself cannot contain picture functions. One picture can contain several picture functions, which can be installed in an arbitrary order. The installation order is important because of the execution order of the start programs. Before a picture containing picture functions is shown on screen, the start programs are executed. The start program of the main picture is executed first. Then the start programs of the picture functions are executed, by default in their installation order. This order can be changed using Send To Back and Bring To Front functions. You can also freely choose the execution order of picture function and the main picture graphics. Automatic event based updating is done according to #ON commands containing event objects, executed in the picture function. Update program of a picture function defines time based updating of the picture function. It is not started until the!update command has been executed. The time based updating is done using the time interval defined with the!update command. The command is usually located in the start program of the picture function. The name of a picture function must be unique within a picture. A picture function may not have the same name as a window in the same picture. You can use at maximum 10 characters in the name. The programs of a picture function can be edited freely. Picture function components can be moved or deleted. Note that new components cannot be added to a picture function. For more information on general editing functions, see Chapter 2. Installing Standard Functions Standard functions are installed using the Installation Tool. It installs the selected standard functions from the file tree structure shown below. The Installation Tool uses the file B_INST/MLIB_INDEX.TXT to view the file tree structure which con- 78

83 1MRS MEN SYS Picture Functions tains the standard functions that will be possible to install. A standard function is inserted into the main picture as a picture function. If there is no file tree structure shown in the Installation Tool, the application has not been prepared for LIB 500. Choose Picture Functions from the Edit menu. You can also change the mode in the toolbar. To insert a picture function: 1 Click the button with the breaker symbol in the toolbox. The dialog shown in Figure 60 appears. This can also be done by choosing Show Library from the Library menu or by pressing CTRL+L on the keyboard. Figure 60. In this dialog you can choose from the library the picture function you want to insert into the picture 2 Now the Installation Tool has been launched and the files become visible. The main menu contains several submenus. Click the plus mark before the files you want to open so you can see their contents. Click the name of the standard function you want to install. 3 In the Picture Function Name text box type the name you want to use to recall the function in the picture. After you have installed one picture function, the tool suggests names for the next ones. 4 The installed picture function appears. Click Install to install the picture function into the main picture and exit the tool. The installed picture functions are given the suggested names. You can also install standard functions that are not shown in the tree by typing their names and including the possible logical path. The name is typed in the Standard Function Name text box. Configuration of Picture Functions Picture functions have a set of configurable attributes, that can be changed afterwards. The configurations are stored in a list located in the DRAW-program of the picture function. When you select the function in the Picture Editor the Standard Configuration Tool reads the name of the datafile of the picture function. The datafile gives all the necessary data for doing configurations using the Standard Configuration Tool. 79