Professional Documents
Culture Documents
This manual describes how to use the editing facilities in WorldView for Windows.
The software described in this document is furnished under license, and may only be used or
copied in accordance with the terms of such license.
The content of this manual has been carefully checked for accuracy. However, if you find any errors,
please notify Survalent Technology Corporation.
Revisions
Date Description
October 1, 2001 Library selector, pmacro properties, and views and layers dialogs now resizable.
Improved dialog for setting declutter levels. Added point browser, pop-up and
background photos, and report and external data pushbuttons. Added menus for
task activation pushbuttons and for analog points. Symbols and pmacros now
accessible from library selector for editing. Added new map, new alarm view and
new oprsum view functions to File menu. Sort folder function added to layers
dialog. Save DXF defaults added to DXF import dialog. Clarification of null
entries in symbol table editor. Added button to delete segment. Added display of
grid. Changed color of selection handles for groups to magenta.
December 9, 2002 Double-clicking an object in the map editor performs Modify. Enhanced pmacro
rotation options. Added dialog code –1 for view-only points. New Analog History
pmacro. Added Change Station feature. Added View Name to all status
pmacros. Improved handling of DXF import option files and import errors. Added
text-to-symbol replacement for DXF import from Microstation.
April 5, 2003 Updated to add description of how to add Publish and Update functions.
September 18, 2007 Added Undo/Redo. Added library Delete. Added alignment editing tool. Added
nudge functions. Added control panels in the Library Selector window. Added
analog gauge pmacro. Added pushbutton, station and status bitmap pmacros.
Added time value pmacro. Added analog history. Added dialog code -2. Added
Disallow Manual Set pmacro resource. Added Erase Before Draw pmacro
resource. Added Tooltip Text pmacro resource. Added View and Report menus.
Added missing resource check. Added Reservations. Added DWG import.
October 23, 2009 Screen shots updated. Added templates and template pmacro. Added the
following pmacro resources: Arrow Head Size, Data Item, some new dialog
codes (10, 11, 12 and 13) for status points, Draw from base (for analog bars),
Thousands Separator (for analog values), Warn on Execute (for control points).
Added Resource Sharing (Export / Import objects).
1 Introduction 1-1
2 Overview 2-1
6 Symbols 6-1
7 Pmacros 7-1
This document describes the editing facilities that are contained in Worldview for Windows.
WorldView for Windows is a world map user interface for the SCADA system. WorldView runs on Windows
200x/XP/Vista, and operates as a client to the SCADA host computer. The WorldView program uses its own
local copy of the map (stored on the PC’s hard drive), on which it overlays dynamic analog and status data that
is retrieved from currently active the host computer. Operator actions, such as control and alarm
acknowledgement, are forwarded to the host computer for execution.
Chapter 3, Getting Started, gets you started right away and takes you through the steps of creating, from
scratch, a simple station diagram.
Chapter 4, Drawing Styles, describes how to create and modify drawing styles and drawing style tables.
Chapter 5, Text Styles, describes how to create and modify text styles.
Chapter 6, Symbols, describes how to create and modify symbols and symbol tables.
Chapter 8, Map Editing, describes how to edit maps, add symbols, pmacros and text to the map, and how to
create views and poke points to take you to those views.
Chapter 9, World Map Import, describes how to import a map from either a DXF file or a VMS host.
Chapter 10, Change Control, describes how to get your new maps and libraries to your colleagues’ PCs.
For further background reading, you will also find the following SCADA documents useful (particularly the ones
related to the point database):
This document describes how to create a WorldView map and the libraries of components that go into the map.
A world map file consists of graphic objects stored in layers. In WorldView, each layer can be assigned upper
and lower magnification levels outside of which the entire layer declutters (i.e. disappears from view). This
powerful feature allows you to create extremely complex maps that can be easily navigated.
2.1 Libraries
The graphics objects contained in a WorldView map consist of:
• drawing primitives
• text strings
• symbols
• pmacros
Examples of drawing primitives are Lines, Rectangles, Filled Rectangles, Ellipses, Filled Ellipses, Arcs, Filled
Arcs, Closed Polygons, Filled Polygons and Open Polygons. The colors and lines style of the drawing primitives
in a WorldView map are defined by drawing styles. The WorldView editor allows you to create a library of as
many drawing styles as you want.
The appearance of text strings in a map is governed by both drawing styles and text styles. A text style defines
a font and font size, as well as orientation and alignment. You can create a library of as many text styles as you
want.
A symbol is a group of drawing primitives and text strings. Each symbol can be used any number of times in the
map to represent static objects such as distribution transformers and poles, and you can create a library of as
many symbols as you want.
Note that you don’t create a separate pmacro for each point. For each point that you want in the map, you place
an instance of the desired pmacro onto the map and then attach it by name to the database point. So you can
have a thousand points in your map represented by a thousand instances of just a handful of different pmacros.
Each library element can be used as often as desired. The same drawing style can be used with graphics
primitives, text strings, symbols and pmacros (pmacros use tables of drawing styles to color-code things). If you
change that drawing style, you will change the appearance of all objects that use that drawing style. This gives
you tremendous power to make a global change by means of one little edit. On the other hand, it can cause
great pain if you decide you want to change the color of a few thousand lines but they use the same drawing
style as a few other thousand lines that you don’t wish to change.
So what do you do? Plan ahead. Take feeders, for example. Even if you just want them all to be yellow today,
consider using different drawing styles for overhead vs. underground and for different voltage levels. If you want
them all yellow, that’s fine. Make them all yellow. But the fact that they are separate drawing styles means that,
in the future, you will be able to change the colors of all your 4 KV overheads without disturbing anything else, in
seconds.
The same thing goes for layers. Lots of layers are good. Having many layers gives you lots of control in the
decluttering of the map, both automatic and manual. This is particularly important for very large maps, where
good decluttering is essential to good performance.
Access to edit mode is denied to you unless you are logged into a privileged SCADA account. If you are not
logged into a privileged account, the Edit button is insensitive. The login procedure is described in the
WorldView for Windows Operator’s Guide.
Many of the edit tools are contained in the pull-down menus and tool bars that are described in WorldView for
Windows Operator’s Guide. We’ll just very quickly review all of the relevant pull-down menus and tool bars here.
• Undo Undo
• Redo Redo
• Cut Cut object and copy to clipboard
• Copy Copy object to clipboard
• Paste Paste items from clipboard
• Clear Delete selected object(s)
• Paste Link
• Find Find point note, line section or text in map
• Modify Open Properties dialog for selected object
• Group Group objects together
• Ungroup Ungroup objects
• Alignment Open Alignment popup menu
• Change
Change points to another station
Station…
• Front Bring object to front
• Back Move object to back
• Recolor Change color of selected object
• Restyle Change text of selected object
• Relayer Change layer of selected object
• Background
Change background color
Color
• Nudge up
• Nudge Down
• Nudge Down
• Nudge left
• Nudge right
• Links…
Cut Cut object(s) from the map and copy to the clipboard
Paste Copy items from the clipboard onto the map or symbol
Print Print
Views and layers List Open the Views and Layers pop-up window
The Edit bar appears whenever you are in Edit mode. The Edit bar is described in detail in section 8.7, Edit Bar.
The libraries of drawing styles and symbols, etc are available through the Library Selector window. This
is a multi-paned window that can be invoked by clicking on the Library Selector button in the edit bar.
The Library Selector window, shown in Figure 2-1, has eight tabs corresponding to eight libraries. When you
click on a tab, the pane containing the corresponding library is brought to the front.
Use of the Library Selector to access the various libraries is described throughout this document.
This chapter gets you started right away by teaching you, step by step, how to create a simple world map from
the bottom up. The world map that will be created consists of a basic substation with two feeders. A picture of
the completed map is shown in (Figure 3-1).
In order to edit, you will need to log into a privileged SCADA account. The login procedure is described in the
WorldView for Windows Operator’s Guide.
1. Start WorldView by clicking on the WorldView shortcut. This will open an empty WorldView window, as
shown in (Figure 3-2)
2. From the File pull-down menu, select New Map.
3. In the previously empty WorldView window, a new window for your new map will open, named Untitled1.
See (Figure 3-3)
5. After logging in, click on the Edit mode button to open the Edit toolbar that consist the Library Selector
button.
1. You’re now going to create all of the drawing styles that you’ll need in order to build your sample map. The
Library Selector window should already be open from the previous paragraph. If not, open it by clicking on
2. In the pop-up menu, click on Add. The Drawing Style Editor window will appear as shown in (Figure 3-6)
3. In the Drawing Style Editor, type _Yellow into the Name field. The underscore in the name will sort your
colors to the top of the list for the purpose of this exercise.
4. In the Drawing Style Editor, type _Yellow into the Name field. The underscore in the name will sort your
colors to the top of the list for the purpose of this exercise.
5. In the Drawing Style Editor, type _Yellow into the Name field. The underscore in the name will sort your
colors to the top of the list for the purpose of this exercise.
6. Click on the Color Add… button. This will bring up the Color window, shown in (Figure 3-7). From this
window, select the first yellow color box on the left by clicking on it once and then click on the OK button to
close the Color window. This will add a yellow colored box to the Cyclic Colors list in the Drawing Style
Editor window, as shown in (Figure 3-6).
7. Click on the Save button to close the Drawing Style Editor window and to save the new drawing style.
8. We need to add a few more drawing styles to our list.
• Repeat steps 2 to 7 with the name _Green and using a dark green color.
• Repeat steps 2 to 7 with the name _Red and using a red color.
• Repeat steps 2 to 7 with the name _Orange and using an orange color.
• Repeat steps 2 to 7 with the name _Gray and using a gray color.
• Repeat steps 2 to 7 with the name _Black and using black.
8. Click on the Save button in the Text Style Editor to save the new text style.
9. Repeat steps 2 to 9 for Text Styles _Arial 300 and _Arial 100 using the corresponding sizes. Select a Font
Style of Bold for the _Arial 300 text style.
You have now added the text styles that you’ll need for sample map. For a more detailed description of the Text
Style Editor, see Chapter 5, Text Styles.
When you first get the system, the symbol library already contains a set of ready-to-use symbols that are
provided by Survalent Technology, but you can create your own symbols. How to do this is the subject of this
section.
We’ll begin by drawing some breaker symbols. A breaker has two states: on and off. That doesn’t mean we
need two breaker symbols though. Although we can use two symbols for each breaker point, we can also make
do with just one, and arrange to have it colored differently depending on the state of the point. In our sample
map, we’re going to make use of both ways of representing status points.
2. A blank symbol drawing window, labeled Untitled, will appear with the Tool bar, Navigation bar and the Edit
bar located in it.
3. In the Library Selector window, click on the Drawing Styles tab. Scroll down and select the _Red drawing
style by clicking on it once with the left mouse button. Either drag the Library Selector out of the way, or
close it. (The selected drawing style will remain selected.)
7. To draw a rectangle on the screen, move your mouse to a point on the screen where the coordinates at the
bottom of the screen read X:0 Y:0. Press down on the left mouse button and drag up and to the right until
the coordinates read X:10000 Y:10000. Let go of the mouse button and you should have a red square as
shown below.
8. Click on the Save button that is located on the Tool bar. Because this is a brand new symbol, this will
bring up the Save As window.
10. We are now going to make a green-colored copy of the red symbol we just created. Retrieve the Library
Selector and click on the Drawing Styles tab. Find the _Green drawing style and select it by clicking on it
once.
11. Click on the Select (Arrow) tool and then select the symbol by clicking on it. It will be highlighted by a
selection rectangle (an outline). Right-click, and from the pop-up menu that appears, choose Recolor. The
symbol will turn green.
12. From the File pull-down menu, select Save As. In the File name field of the Save As window, enter _Breaker
Open.
13. Close the symbol drawing window by selecting Close from the File pull-down menu.
14. Close the Library Selector window. This completes the breaker symbols.
Now we are going to make a symbol to represent a pushbutton. The symbol for a pushbutton will consist of a
gray rectangle, as shown in (Figure 3-16).
1. Open the Library Selector, and in the Symbols list, right-click and select the Add function. A symbol drawing
window will appear.
3. From the Map pull-down menu, select Set Grid. In the Grid window that appears, change the spacing to
1000 x 1000, check both the Grid Enabled and Grid Visible check boxes, and click on OK.
5. Position the cursor at X:0 Y:0, press and hold the mouse button down, and drag the cursor up and to the
right until the coordinates read X:12000 Y:8000, and let go of the mouse button. A gray rectangle will
appear in the drawing area.
6. Click on the Save button, and in the Save As window that appears, enter the name _Pushbutton and press
Enter. Close the open windows.
In this paragraph, we’re going to make a symbol that we will use to represent a substation. This symbol will
consist of a circle, as shown below.
1. In the Symbols list of the Library Selector, right-click and select the Add function. A symbol drawing window
will appear.
2. Go into edit mode and access the Drawing Styles tab of the Library Selector. Select the {dynamic} drawing
style. Close the Library Selector.
3. From the Map pull-down menu, select Set Grid. Ensure that the spacing is 10000 x 10000, check the Grid
Enabled check box and click on OK.
5. Position the cursor at X:0 Y:10000, hold the left mouse button down, and drag the cursor down until the
coordinates read X:10000 Y:0. Then release the mouse button. Your symbol should resemble (Figure
3-17).
6. Click on the Save button, and in the Save As window that appears, enter the name _Substation and press
Enter. Close the open windows.
Now we’ll construct a symbol to represent a load. The symbol for a load will be represented by a yellow triangle,
shown in (Figure 3-18).
1. In the Symbols list of the Library Selector, right-click and select the Add function. A blank symbol drawing
window will appear.
2. Go into edit mode and access the Drawing Styles pane of the Library Selector. Select the _Yellow drawing
style that we created earlier and close the Library Selector.
3. From the Map pull-down menu, select Set Grid. In the Grid window that appears, change the spacing to
1000 x 1000, check the Grid Enabled check box, and click OK.
6. Click on the Save button, and in the Save As window that appears, enter the name _Load and press Enter.
Close the open windows.
We will now draw some symbols for switches. We will need two symbols, one to represent each switch state as
shown in (Figure 3-19).
1. In the Symbols list of the Library Selector, right-click and select the Add function. A new blank symbol
drawing window titled Untitled will appear.
2. Click on the Edit mode button, and access the Drawing Styles pane of the Library Selector window.
3. Select the {dynamic} drawing style and dismiss the Library Selector.
4. From the Map pull-down menu, select Set Grid. In the Grid window that appears, change the spacing to
1000 x 1000, check the Grid Enabled check box and click OK.
5. The closed switch will consist simply of two small circles connected by a line. In the Edit toolbar,
select the Filled Ellipse Tool. Place your mouse pointer at the co-ordinates X:0 Y:0 (approximately) and drag
the mouse pointer until the co-ordinates read X:1000 Y:1000.
8. Select the Line Tool from the Edit toolbar and draw a line between the center of the first circle and the
center of the second circle. You should now have a drawing that resembles the symbol at the bottom of
(Figure 3-19).
Note: Holding down the Shift key ensures that a line will be perfectly horizontal or vertical. Not using the
shift key allows you to draw a line in any direction.
9. Click on the Save button, and in the Save As window that appears, enter the name _Switch Closed and
press Enter. Don’t close the window yet.
We will now create the symbol for the open switch (the symbol at the top of (Figure 3-19)).
2. Select the horizontal line by clicking on it once with the left mouse button.
3. With the line selected, delete it by clicking on the Cut (scissors) tool in the Tool bar.
4. Select the Line Draw tool in the Edit bar, and drag out a line from the center of the left circle to about one-
inch above and just left of the right circle as shown in (Figure 3-19).
5. To save this new symbol under a different name, select Save As from the File pull-down menu. In the Save
As window that appears, enter _Switch Open in the File Name field and press Enter to save your new
symbol.
1. In the Symbols list of the Library Selector, right-click and select the Add function.
2. Click on the Edit mode button and access the Drawing Styles pane of the Library Selector. Find and select
the _Yellow Bus Bar style that we created in section 3.2, Creating Drawing Styles. Close the Library
Selector.
3. From the Map pull-down menu, select Set Grid. In the Grid window, change the spacing to 1000 x 1000,
check Grid Enabled and click OK.
4. Select the Open Polygon tool from the Edit bar. The mouse pointer turns into a cross-hair cursor.
6. Move the cursor up and to the right at a 45 degree angle until it snaps to the point X:1000 Y:3000, and click
once.
7. Move the cursor down and to the right until it snaps to the point X:2000 Y:2000 and click once.
8. Repeat the previous two steps four more times, ending at X:6000 Y:2000, and clicking twice at the end.
Your diagram should look as shown below.
9. Click once on the center point of your Symbol and drag a line straight down to the bottom of the window (to
coordinates X:3000 Y:0), and double-click.
10. Move the mouse pointer to X:0 Y:5000, click once, and drag a line down to the left to X:1000 Y:4000 and
click once.
11. Drag the cursor back up until your coordinates read X:2000 Y:5000 and click once.
12. Continue doing this until you have drawn a mirror image of the original zig-zag line. Double-click at the end.
13. Draw the final line from coordinates X:3000 Y:4000 straight up to X:3000 Y:7000 and double-click. You
should now have the diagram as shown in (Figure 3-20).
14. Click on the Save button, and in the Save As window that appears, enter the name _Transformer and press
Enter. Close the open windows.
Next, we’re going to create two different symbols for a fuse, one for each state of the fuse.
1. In the Symbols list of the Library Selector, right-click and select the Add function.
2. Click on the Edit mode button and access the Drawing Styles pane of the Library Selector. Select the
{dynamic} drawing style and close the Library Selector.
3. From the Map pull-down menu, select Set Grid. In the Grid window, change the spacing to 1000 x 1000,
check Grid Enabled, and click OK.
4. Using the Line Drawing tool, draw a line from the coordinates X:0 Y:2000 to X:2000 Y:2000.
5. Select the Unfilled Ellipse tool. From a starting point of X:2000 Y:4000, drag a circle down and to the
right to the point X:6000 Y:0. Your diagram should look like (Figure 3-22).
6. Draw another circle immediately to the right of the first one by dragging an ellipse from X:6000 Y:4000 to
X:10000 Y:0. Select the line tool and draw a line from X:10000 Y:2000 to X:12000 Y:2000 as shown in
(Figure 3-23).
7. With the Select tool, select the first circle, right-click on it, and from the pop-up menu that appears,
select modify.
9. For the second circle, just change the Angle from 360 to 180.
10. Turn off the grid by selecting Set Grid from the Map pull-down menu and unchecking the Grid Enabled
check box.
11. Select the Filled Ellipse tool and draw a circle about ¼ inch in diameter. Select this circle and center it
over the intersection of the first straight line and the semi circle. Your diagram should now look like the one
in (Figure 3-25).
13. Click on the Save button, and in the Save As window that appears, enter the name _Fuse Closed. Don’t
close the symbol drawing window. We’re now going to turn the _Fuse Closed symbol into a _Fuse Open
symbol.
14. Let’s first save the existing open fuse symbol under a new name (so we don’t accidentally use Save instead
of Save As later). From the File pull-down menu, select Save As, and in the Save As window that appears,
enter the name _Fuse Open, and press Enter.
15. Select the first semi-circle, right-click, and from the pop-up menu that appears, choose Modify. The Arc
Properties window that we saw earlier reappears.
16. In the Arc Properties window, change the Angle from 180 to 90. You can click on the Apply button to see the
results before clicking on OK, if you wish.
17. Repeat the previous two steps for the second semi-circle. Your symbol should now look like the one in
(Figure 3-26).
18. If you had already changed the symbol’s name to _Fuse Open as suggested in step 13, you may now click
on the Save button to save the updated image under the filename _Fuse Open. If you haven’t already
changed the symbol’s name, make sure you click on Save As rather than Save. Then close any open
windows other than the main WorldView window at this time.
You have now created all of the symbols that you need to build the sample map. For more details on editing
symbols, see Chapter 6, Symbols.
• the current value of an analog point according to what operating limit it may be violating, if any
• the {dynamic} portions of a status point’s symbol according to the current state of the status point
• a point’s tag indicator according to the highest level tag currently on the point
Although the database already contains perfectly good drawing style tables, we’re going to create brand new
ones for our sample map.
1. First, we’ll create a table of colors to use for points that have one or more unacknowledged alarms. Access
the Drawing Style Tables pane of the Library Selector.
2. With the mouse in the Drawing Style Table window, right-click and select Add from the pop-up menu that
appears. The Drawing Style Table Editor will appear as shown in (Figure 3-28).
In the Drawing Style Table Editor, the left side is a list of all of the available drawing styles. The list on the right,
which right now is empty, is the list of drawing styles that make up the drawing style table that is currently being
edited.
_Acknowledged Alarms
1. Now we’ll create a table to use with points that do not have any unacknowledged alarms. As we did above,
access the Drawing Style Tables Editor to add a new table.
2. In the Name field, enter _Acknowledged Alarms.
3. In the list on the left, click once on _Red and then once on _Yellow.
4. Click on the Save button to save the new table and to close the Drawing Style Table Editor.
_Pushbutton
1. Now we’ll create a table to be used by pushbuttons. Access the Drawing Style Table Editor as above, and
enter the name _Pushbutton
2. Add the color _Black to the table, and then click on the Save button to save the table and close the editor.
That’s it for drawing style tables for now. For a more detailed description of drawing style tables,
See Chapter 4, Drawing Styles.
Point-related pmacros display point values via either symbols or text strings. When you click on a pmacro that’s
linked to a database point, a dialog box is displayed with pushbuttons that you can use to perform operations
such as:
• control
• manual set
• acknowledge or block alarms
• add or remove tags
• modify limits (analog points only)
These dialogs are described in detail in the WorldView for Windows Operator’s Guide.
Survalent Technology provides a number of ready-to-use pmacros in the pmacro library, but you can create
your own. Like symbols, pmacros are created and modified via the New and Open functions in the File pull-
down menu.
Each pmacro may be used many times in the map. Each instance can be associated with a different point, view,
graph etc. But when you change the definition of a pmacro in the pmacro library, the change applies to every
instance of that pmacro in the map.
The Resource column shows the names of the pmacro’s resources (attributes). The default column shows the
default values of the resources. Note that not all of the resources have default values. The override column
shows the actual values, if any, that you have specified for the resources.
To enter a value for a resource, double-click on the name of the resource. A resource edit window will open to
let you enter a value. When an instance of the pmacro is added to the map, any resource values in the Override
column will be used instead of those in the Default column.
7. Next, double-click on the Button Label Drawing Style Table resource. Select _Pushbutton from the list of
tables that appears (see (Figure 3-34)) and click OK. This will give our pushbutton label text the black-
colored drawing style we created in section 3.2, Creating Drawing Styles, and assigned to a drawing style
table in section 3.5, Drawing Style Tables.
Note: If you can't reposition the Pmacro Properties window so you can see what’s happening in the background
adequately, feel free to click the OK box at the bottom to close the window. Select the Edit mode button to
reopen it at any time.
10. Double-click on the Button Label X Offset resource, enter a value of 3000 and click on OK.
11. Double-click on the Button Label Y Offset resource, enter a value of 1500 and click on OK.
12. The text is now nicely centered on the button. Since our button labels are going to be 2 digits wide, this
setting should work well for all of them. If you place longer labels on some of these pushbuttons, you can
stretch the pushbutton by changing the Scale Factor On X Axis resource without affecting the size of the
text.
An even better thing to do is to create some text styles with “center” alignment for use as pushbutton labels.
With these, you won’t need to touch the Button Label X Offset resource.
13. In the Pmacro Properties window, select the Button Label resource and then click on the Remove Override
button at the bottom of the window. This removes the F1 label from the library Pmacro that you are creating.
Real labels will be added as overrides on a per instance basis when we add the pmacros to the map.
14. Click on the OK button in the Pmacro Properties window. This dismisses the Pmacro Properties window.
You could get it back, if you wanted, by clicking on the Edit button. But we don’t want it back right now.
15. Click on the Save button located in the Tool Bar. Because this is a brand new pmacro, a Save As window
will appear. In the File Name field, enter the name Pushbutton and then click on Save.
16. Click on the Close button under the File menu. This will close the Pushbutton pmacro
Here, we’ll create an Analog value pmacro that displays analog data in numeric form.
1. In the Pmacros list of the Library Selector, right-click and select the Add function.
4. Double-click on the NAK Drawing Style Table resource to open the NAK Drawing Style Table dialog. Click
on the _Unacknowledged Alarms table name once to select it and then click on OK.
Figure 3-40 NAK Drawing Style Table Figure 3-41 Normal Drawing Style Table
Resource Dialog Resource Dialog
5. Double-click on the Normal Drawing Style Table resource and in the resource dialog that appears, click on
the _Acknowledged table once to select it. Then click on OK.
6. Double-click on the Text Style resource and select _Arial 100. Then click on OK.
7. Click on the OK button in the analog_value Pmacro Properties window to close the window.
8. Click on the Save button in the toolbar, and in the Save As dialog that appears, enter the name _Analog,
and press Save.
There are two types of station pmacro: Station Symbol and Station Color. Both use symbols and colors to
display the overall status of a station in terms of:
Here we’re going to build a simple Substation pmacro for the sample map. The pmacro will appear as a large
round pushbutton visible from the overview of the map. If there are unacknowledged alarms on any of the points
on the station, the pushbutton will flash to alert the operator. Clicking on the pushbutton will open a view linked
to the station pmacro.
6. Double-click on the NAK Drawing Style Table resource and in the NAK Drawing Style Table dialog of
(Figure 3-40) that appears, click on the _Unacknowledged Station Alarms drawing style table once to select
it and then click on OK.
7. Double-click on the Normal Drawing Style Table resource and in the Normal Style Resource dialog of
(Figure 3-41) that appears, select the _Acknowledged Station Alarms drawing style table and then click on
OK.
9. Notice the View Name resource in the Pmacro Properties window. We’re not going to specify it now. The
value of this resource will be filled in when we place instances of the substation pmacro on the map.
10. Click on the OK button at the bottom of the Pmacro Properties window and save the pmacro with the name
_Substation. Then click on the Close button under the File menu.
Now we’ll create a pmacro to represent a breaker. We’ll use the status_symbol pmacro class which, as the
name implies, uses different symbols to show the various states of the breaker.
2. Scroll through the resources and turn off all the flags (Alarm Blocked Flag, Condition Flag, Owner Tag Flag
and Tag Flag) by double-clicking each flag’s enable resource and unchecking the check box in the dialog
that appears.
3. Scroll through the resources and turn off all the flags (Alarm Blocked Flag, Condition Flag, Owner Tag Flag
and Tag Flag) by double-clicking each flag’s enable resource and unchecking the check box in the dialog
that appears.
4. Double-click on the NAK Drawing Style Table resource. The dialog of (Figure 3-40) will appear showing you
all of the available drawing style tables. Select _Unacknowledged Alarms and click on OK to close the
dialog. You should now see _Unacknowledged Alarms in the column next to the NAK Drawing Style Table
Resource.
6. Double-click on the NAK Symbol 1 resource, and in the dialog that appears, select the _Breaker Closed
symbol and click on OK.
7. Double-click on the Normal Drawing Style Table resource and in the resource dialog that appears (see
(Figure 3-41)), select the _Acknowledged Alarms drawing style table and then click on the OK button.
9. Click the OK button at the bottom of the Pmacro Properties window. Save the pmacro under the name
_Breaker. Then click on the Close button under the File menu.
Now we’ll create a pmacro to represent a switch. This will be a Status Symbol pmacro too.
1. Start a new pmacro edit as we did above. From the Create Pmacro window, select status_symbol and click
OK.
2. As we did for the breaker, turn off all four flags resource (Alarm Blocked, Condition, Owner Tag and Tag) by
unchecking each flag’s enable resource.
4. Double-click on the NAK Drawing Style Table resource and in the resource dialog of (Figure 3-40) that
appears, select the _Unacknowledged Alarms table and click on OK. Similarly, for the Normal Drawing Style
Table resource, specify the _Acknowledged Alarms drawing style table.
6. Double-click on the Symbol 0 resource. In the resource dialog of (Figure 3-35) that appears, select the
_Switch Open symbol and click on OK. Similarly, for the Symbol 1 resource, specify the _Switch Closed
symbol.
7. Click OK at the bottom of the Pmacro Properties window. Then save the pmacro with the name _Switch and
close any open windows.
1. Start a new pmacro edit as we did above. From the Create Pmacro window, select status_symbol and click
on OK.
3. Double-click on the NAK Drawing Style Table resource and from the resource dialog that appears, select
the _Unacknowledged Alarms table and click on OK. Similarly, assign the _Acknowledged Alarms drawing
style table to the Normal Drawing Style Table resource.
4. Double-click on the NAK Symbol 0 resource and assign the _Fuse Open symbol to it. Assign the _Fuse
Closed symbol to the NAK Symbol 1 resource.
6. Click OK at the bottom of the Pmacro Properties window. Then save the pmacro as _Fuse and close any
open windows.
1. Dismiss all of the windows inside your main WorldView window. From the File pull-down menu, select New
Map.
2. This creates an empty map window. Maximize the window by clicking on the Maximize button.
3. Click on the Save button in the toolbar. In the Save As window that appears, enter the name Test Map and
click on Save. From now, we can just click on the Save button to update the map. The map editor does
prompt you to save the map if you close it after having made some changes.
10. Another way to select a layer for drawing into by using the Layers button in the Navigation toolbar as shown
in (Figure 3-56). Highlight the Substation layer and click on Select, as shown, and the dialog boxes will
close on their own. The Selected Layer may now be edited.
12. If you are not already in edit mode, click on the Edit button to bring up the Edit bar.
13. Click on the Library Selector button to open the Library Selector window. Click on the Text Styles tab to
bring the Text Styles pane to the front and then move the Library Selector window off to one side of the
screen so that it’s not in the way. Note that once you have selected something from the Library Selector,
you can actually dismiss it until you need to select something else.
14. Select the text style named _Arial 300 by clicking on it once.
Tip: you can scroll down a long list of Text Styles by pressing a letter on the keyboard that corresponds to the
first letter of the named font. E.g. press ‘T’ for Times New Roman. The window will scroll down to the first text
style that begins with T.
15. In the Library Selector, select the Drawing Styles tab and select the _Green drawing style.
Figure 3-58
21. Using the scroll bar move the screen upwards so that Substation is located right at the top of the window, as
shown ion (Figure 3-59).
Figure 3-59
22. Click on the Pmacros tab in the Library Selector window. From the list of pmacros, select the _Breaker
pmacro.
24. Click on the position at which you want the breaker to appear. Place five breakers on the map so that the
breakers appear on your screen as they do in (Figure 3-60) by clicking once in each of the desired
locations. The pmacros will snap to the nearest grid point.
25. In the Library Selector window, click on the Symbols tab, and from the list of symbols, select the
Transformer symbol.
27. Now, wherever you click, a transformer symbol will appear. Place a transformer symbol between each set of
breakers as shown in (Figure 3-61). You can disable the grid if you want to place transformers between grid
points.
Figure 3-61
29. Click on the Line Draw button found in the Edit bar.
30. Draw two horizontal lines (the bus bar) originating from the middle breaker as shown in
(Figure 3-62). To draw a horizontal line, start with the cursor at one of the desired end-points. Press and
hold down the Shift key and the left mouse button. Now drag the mouse in the direction you want the line to
be formed. Release both the Shift key and the mouse button to complete the line.
Figure 3-62
31. Click on the Pmacros tab in the Library Selector, and from the list of pmacros, select the Breaker pmacro.
32. Select the Pmacro button in the Edit toolbar and add four more breakers to the map so that your map
resembles the map shown in (Figure 3-63).
33. Click on the Drawing Styles tab in the Library Selector, and from the list of drawing styles, select the
_Yellow drawing style.
34. Click on the Line Draw button and draw four lines, one from each of the four lower breakers to the Bus Bar
as pictured in (Figure 3-64).
Figure 3-65
Figure 3-66
Figure 3-67
42. Click on the Drawing Styles tab of the Library Selector and select the _Green drawing style.
44. Click on the Text button in the Edit toolbar, move the cursor just to the right and a bit above of the Bus Bar
(the yellow horizontal bar) and click on the left mouse button. This will open the String Properties dialog box.
45. Type Volts A into the text box and click OK. Your screen should now resemble (Figure 3-68).
Figure 3-68
46. Left click the mouse just under the V in the string Volts A, enter Volts B in the String text box that appears
and click on OK.
48. Click on the Pmacros tab of the Library Selector and select the _Analog pmacro.
50. Move the mouse directly to the right of the Volts A label and click on the left mouse button. This will place an
Analog pmacro there.
51. Repeat the previous step to place Analog pmacros beside both the Volts B and Volts C titles. Your map
should now resemble (Figure 3-69).
52. Repeat steps 42 to 49 except this time use the title Amps instead of Volts and place the titles so that in the
end, the substation resembles (Figure 3-70).
Figure 3-70
53. Click on the Pmacros tab in the Library Selector and select the Pushbutton pmacro.
54. Select the Pmacro button in the Edit toolbar. Place the cursor just under the left-most vertical yellow line and
click on the left mouse button to put down a pushbutton.
55. Move the cursor under the next yellow line on the left and click. This will put down another pushbutton and
your map should resemble (Figure 3-71).
57. In the Pmacro Properties window of (Figure 3-73) that appears, double-click on the Button Data resource.
In the Button Data resource dialog, enter the view name Feeder, and click on OK.
Note that the view name appears in the Override column of the Pmacro Properties window.
60. Repeat steps 54 to 57 for the second pushbutton, specifying F2 in the Button Label resource.
In the View Name field of the view dialog that appears type in the name Substation and click on OK. (We’ll
discuss background images in a later chapter. Don’t worry about this for now.)
The substation layer is now complete. We will now create the Feeder layer.
1. Leave the Views and Layers window open and select the Layers tab.
2. With the cursor over the Layers folder, right-click and select Create Layer from the pop-up menu that
appears. See (Figure 3-53).
3. In the Layer Name field of the Edit Layers dialog, type in the name Feeder and click on OK. See (Figure
3-54)
4. Select the new Feeder layer for drawing by clicking on it once and closing the Layers and Views window.
Alternatively, you can use the Layers button in the Navigation toolbar, in which case you highlight the
Feeder layer and click on Select.
5. Use the zoom and scroll buttons until your diagram resembles (Figure 3-77).
6. Select the Pmacros tab of the Library Selector and select the Pushbutton pmacro.
7. Click on the Pmacro button in the Edit bar, move the cursor directly under the two existing pushbuttons and
click to put down a third pushbutton as shown in (Figure 3-78).
Figure 3-78
8. Choose the Select tool in the Edit bar and right-click on the new pushbutton. From the pop-up menu, select
Modify.
9. In the Pmacro Properties window that appears, set the value of the Button Data resource to the name
Substation using steps followed below.
11. Set the value of the Button Label resource to S/S (short for SubStation).
12. Set the Button Label Text Style resource to _Arial 300. Click on OK in the Pmacro Properties window to
save your overrides.
Figure 3-79
14. From the Drawing Styles pane of the Library Selector, select the _Yellow Feeder drawing style.
15. Click on the Line Draw button in the Edit bar, and draw four lines as shown in
(Figure 3-80). The numbers in (Figure 3-80) are shown only to identify the four individual lines. Don’t draw
the numbers. Use the grid to keep your lines straight. Use the Open Polygon tool to draw lines 1, 2 and 3, if
you wish.
Figure 3-80
16. Click on the Pmacros tab of the Library Selector and select the _Switch pmacro.
17. Click on the Pmacro button in the Edit bar. Position the cursor beneath the line labeled 3 in
(Figure 3-80) and click to put down a switch pmacro.
The exact location of the pmacro doesn’t matter. You will be moving it in the upcoming steps.
18. Choose the Select tool in the Edit bar. Right-click on the switch you just placed, and choose Modify
from the pop-up menu.
19. From the switch’s Pmacro Properties window, double-click on the Rotation (degrees) resource and set the
value to –90. This will rotate the symbol 90 degrees to the right. Click on OK in the Pmacro Properties
window. Your switch should now be positioned vertically.
20. Turn off the grid. Move the cursor directly over the switch and click and hold the left mouse button. Drag the
switch over so that it lines up with the yellow line labeled 3 in (Figure 3-80).
22. Using the steps followed above for the first switch, access the second switch’s Pmacro Properties window
and set its Rotation resource value to 90. This will rotate the symbol 90 degrees to the left. Close the
Pmacro Properties window. The second switch should now be positioned vertically.
Figure 3-81
24. Click on the Line Draw button in the Edit toolbar, and in the _Yellow Feeder drawing style, draw three lines
as shown in (Error! Reference source not found.).
Figure 3-82
Figure 3-83
Figure 3-84
28. From the Pmacros pane of the Library Selector select the _Fuse pmacro. Click on the Pmacro tool in the
Edit bar and place a fuse at the end of the line drawn in the previous step as shown in
(Figure 3-85).
Figure 3-85
29. Draw a short horizontal line originating from the right side of fuse as shown in (Figure 3-86).
30. Select the _Switch pmacro from the Library Selector, and place a switch directly beside the line you have
just drawn. This will place a switch next to the line as shown in (Figure 3-87).
Figure 3-87
31. Draw a short horizontal line originating from the right side of switch as shown in (Figure 3-88).
Figure 3-88
33. In the Library Selector select the _Alarm Red drawing style from the Drawing Styles pane, and select the
Arial 100 text style from the Text Styles pane.
34. Click on the Text tool in the Edit bar. Place the cursor directly below the switch at the bottom of the screen
and click the left mouse button.
35. In the Text Properties dialog that appears, enter “Note: This switch should be kept in the Open state.” in the
String dialog box. Change the Horizontal Justification Center and click on OK.
Figure 3-90
37. Click on the Tree List button to open the Views and Layers dialog.
38. Select the Views tab to bring it to the front. Using steps followed previously to create the Substation view,
create a view named Feeder. See steps 59 and 60 in paragraph 3.7.1, Substation Layer.
The Feeder layer is now complete. We will now create the Main layer.
1. Create a layer named Main following the same procedures that you used to create the Substation and
Feeder layers. Dismiss the Layers and Views window.
2. Select the new Main layer by clicking on the Layers tool, highlighting the Main layer and clicking on
Select, as shown in (Figure 3-91). This is an alternative to selecting a layer via the Views and Layers
window.
3. Using the scroll bars, move the map so that it resembles (Figure 3-92).
Figure 3-92
Figure 3-93
10. Do the same for the Main layer but click on the lower Set Current button instead of the upper one.
This will be smallest scale at which the Main layer will be visible when its declutter mode is set to Auto. When
you zoom in beyond this magnification level, all objects contained in this layer will disappear.
12. In the Views pane of the Views and Layers window, using steps followed in paragraphs 3.7.1, Substation
Layer, and 3.7.2, Feeder Layer, create a new view and name it Main.
13. Right-click on the Main view that you just created. In the pop-up menu that appears, click on Set As Default
View. This is the view that will appear whenever you click on the Home button. In the Views list, the
default view name is highlighted in red.
Figure 3-97 Setting the Default View Figure 3-98 Default View
14. Save the map by clicking on the Save button in the tool bar, and exit from edit mode by clicking on the Edit
button in the navigation bar. The Edit tool bar will disappear.
You have now completed your sample map. Your map consists of three layers and three views which contain a
substation and a feeder. Your default view, the Main view, displays a small orange circle that is used to
represent a substation.
Clicking on the substation will take you to the Substation view so that you can see the internal structure of the
substation. From this substation, clicking on the feeder button will take you to the Feeder view so that you can
see the entire feeder in one window. From this view, you can also click on a button to take you back to the
Substation view
The point-related pmacros in the sample map will not operate because we did not attach them to SCADA
database points. Attaching a pmacro to a database point is just a matter of modifying the pmacro’s Point Name
resource to contain the desired point name. This is done via the Pmacro Properties window that we saw
throughout this chapter. Details on entering point names are provided in chapter 8, Map Editing.
This chapter describes how to use the Drawing Style and Drawing Style Table editors. Both editors are
accessible via the Library Selector window.
Each drawing style in the list defines a combination of the following graphics attributes:
For example, if the pmacro’s drawing style table contains the colors green and red, then while the point is in
state 0, any {dynamic} stuff in the symbol for state 0 is drawn in green. Similarly, while the point is in state 1, any
{dynamic} stuff in the symbol for state 1 is drawn in red. The symbols for states 0 and 1 can be identical.
If you click on Add, the Drawing Style Editor window opens with a blank name and default graphics attributes, as
shown in (Figure 4-4). If you click on Modify, the Drawing Style editor shows the data for the selected drawing
style, as illustrated in (Figure 4-5).
Note that if you modify an existing drawing style, you will change the appearance of all existing graphic
elements that use that drawing style.
4.1.1 Name
This is the name of the drawing style. It must be a legal Windows file name (because the drawing style definition
is stored as a .gcl file of this name). Make the names descriptive to make it easier for you and your colleagues
to remember. Examples of useful names are names that describe what the drawing styles are used for (e.g.
“Streets” and “Underground Feeder”) or names that describe the color and line size and/or type (e.g. “Yellow
Wide Dashed”).
This pushbutton opens the Color window of (Figure 4-6) to allow you to add a color to the Cyclic Colors box. In
the Color window, you can create your own colors using the Add To Custom Colors function, or you can just
stick to the Basic colors.
To use a basic color, click on the desired color in the Basic colors matrix. This causes the selected color to be
highlighted, and also moves the cursor in the custom colors section to the correct color location, puts the color in
the Color/Solid box and populates the Hue, Sat, Lum, Red, Green and Blue boxes with appropriate values.
When you click on OK, the Color window is closed and the selected color is added to the Cyclic Colors box of
the Drawing Style Editor window.
• Select the entry in the Custom colors matrix that you wish to update. The selected entry will be highlighted.
• Select the desired luminance value by moving the slide box beside the rainbow up or down. This updates
the color in the Color/Solid box and updates the Lum, Red, Green and Blue boxes with appropriate numeric
values. The Hue and Sat boxes are not updated.
• Select the hue and saturation by clicking in the rainbow. This updates the color in the Color/Solid box and
populates the Hue, Sat, Red, Green and Blue boxes with appropriate values. The Lum box is not updated.
• If you wish, you can type numeric values directly into the Hue, Sat, and Lum, or the Red, Green and Blue
boxes.
• When the desired color appears in the Color/Solid box, click on the Add to Custom Colors pushbutton. The
selected color will be added to the previously selected Custom Colors box.
Clicking on Cancel closes the Color window without applying any changes to the Cyclic Colors box of the
Drawing Styles Editor window.
To modify any of the colors in a drawing style, click on the desired color in the Cyclic Colors box, and then click
on the Color Modify... pushbutton. The Color window of (Figure 4-6) will open and allow you to select a color as
described in paragraph 4.1.2, Color Add. When you click on OK in the Color window, the color that you had
selected in the Cyclic Colors box is replaced by the color selected in the Color window.
To insert a color into the list of Cyclic Colors, click on the color in front of which you wish to make an insertion,
and then click on the Color Insert... pushbutton. The Color window of (Figure 4-6) will open and allow you to
select a color as described in paragraph 4.1.2, Color Add. When you click on OK in the Color window, the color
that you selected in the Color window will be inserted into the list of Cyclic Colors at the point that you had
specified.
To delete a color from the list of Cyclic Colors, click on the color you wish to delete and then click on the Color
Delete... pushbutton. The selected color will be removed from the list.
The Cyclic Colors box shows the colors that presently contained in the drawing style. As mentioned above,
adding multiple colors to a drawing style causes any objects drawn in that style to cycle between the selected
colors at the rate of one color per second. Up to eight colors are supported for each drawing style.
There is no cycling of colors while you are in WorldView edit mode.
4.1.9 Pixmap
4.1.10 Apply
Clicking on Apply causes the new or modified drawing style to be saved. If the drawing style already existed,
any objects in the map that use that drawing style are updated. The Drawing Style Editor window is left open.
4.1.11 Undo
Clicking on Undo undoes any changes that you may have made using Apply while the Drawing Style Editor
window was open. Once you dismiss the Drawing Style Editor window, you cannot undo what you did (except
by using the Drawing Style Editor again).
Clicking on Save causes the new or modified drawing style to be saved. If the drawing style already existed, any
objects in the map that use that drawing style are updated. The Drawing Style Editor window is closed, and you
cannot undo your changes (except by using the Drawing Style Editor again).
4.1.13 Cancel
Clicking on Cancel dismisses the Drawing Style Editor without saving any changes made since the last use of
Save.
If you click on Add, the Drawing Style Table Editor window opens with a blank name and default graphics
attributes, as shown in (Figure 4-12).
The options of the Drawing Style Table Editor are described below.
4.2.1 Name
The list on the left-hand side of the Drawing Style Table Editor is a list of all of the available drawing styles.
When you click on one, the selected drawing style is added to the end of the list contained in the right-hand side
of the Drawing Style Table Editor.
The list on the right-hand side of the Drawing Style Table Editor is the list of drawing styles contained in the
drawing style table being edited. Since the drawing styles in a drawing style table are accessed by indexing,
drawing style tables are very order-dependent. The meaning of the elements of a drawing style table depends
on how the drawing style table is used. The various ways in which drawing style tables are used are described
in section 4.3, Using Drawing Style Tables.
To add an entry to the drawing style table, click on the desired entry in the drawing style selection list on the left-
hand side of the Drawing Style Table Editor. The selected entry will be added to the end of the drawing style
table element list on the right-hand side of the Drawing Style Editor.
The order of the elements (drawing styles) in the drawing style table can be manipulated by using the up and
down arrows. The up arrow causes the selected drawing style in the table to move up one position in the list.
The down arrow causes the selected drawing style to move down one position in the list.
Clicking on the left arrow causes the selected drawing style to be removed from the drawing style table.
4.2.4 Apply
Clicking on Apply causes the new or modified drawing style table to be saved. If the drawing style table already
exists, any objects in the map that use that drawing style table are updated. The Drawing Style Table Editor
window is left open.
4.2.5 Undo
Clicking on Undo undoes any changes that you may have made using Apply while the Drawing Style Table
Editor window was open. Once you dismiss the Drawing Style Table Editor window, you cannot undo what you
did (except by using the Drawing Style Table Editor again).
4.2.6 Save
Clicking on Save causes the new or modified drawing style table to be saved. If the drawing style table already
existed, any objects in the map that use that drawing style table are updated. The Drawing Style Table Editor
window is closed, and you cannot undo your changes (except by using the Drawing Style Table Editor again).
4.2.7 Cancel
Clicking on Cancel dismisses the Drawing Style Table Editor without saving any changes made since the last
Save.
An analog pmacro (both value and bar) uses a drawing style table to color the analog point value to reflect the
current limit state of the point (e.g. color the point green if it’s in its normal range, red if it violates its emergency
alarm limit, etc.).
(Figure 4-14) shows the contents of such a drawing style table that is provided in the standard WorldView
database. The drawing style table is named ANALOG_DEFAULT. Table 4-1 explains the usage of each
element of this drawing style table.
A status pmacro uses a drawing style table to re-color its symbols according to the current state of a status point
(e.g. color the symbol green if the point is open, color the symbol red if the point is closed). Only the portions of
the symbols that are drawn in the {dynamic} drawing style are re-colored in this manner. The portions of the
symbols that are not drawn in {dynamic} retain the colors in which they were drawn.
(Figure 4-15) shows the contents of such a drawing style table that is provided in the standard WorldView
database. The drawing style table name is STATUS_DEFAULT. Table 4-2 explains the usage of each element
of this drawing style table.
4.3.3 Station
A station pmacro uses a drawing style table to re-color its symbols according to the priority of the highest-priority
unacknowledged or outstanding alarm on any point on the station. As in the case of the status points, only the
portions of the symbols that are drawn in the {dynamic} drawing style are re-colored in this manner.
(Figure 4-16) shows the contents of such a drawing style table that is provided in the standard WorldView
database. The name of the drawing style table is STATION_DEFAULT. Table 4-3 explains the usage of each
element of this drawing style table.
In all three cases above (analog, status and station), you can specify two different drawing style tables for each
pmacro: one to be used when there are no unacknowledged alarms on the point or station, and another to be
used when there are unacknowledged alarms on the point or station. Typically, the colors in the
unacknowledged table would differ from those of the acknowledged table only by the addition of black in the
cyclic colors list to cause the point to blink whenever it has unacknowledged alarms.
The standard WorldView database contains three corresponding drawing style tables for use with
unacknowledged alarms. These drawing style tables are named:
• NAK_ANALOG_DEFAULT
• NAK_STATUS_DEFAULT
• NAK_STATION_DEFAULT
and have the same usages as listed in Table 4-1, Table 4-2 and Table 4-3.
The condition, tag and alarm blocked indicators that are included in pmacros also have drawing style tables.
This allows you to customize the coloring of these indicators.
(Figure 4-17) shows the contents of a drawing style table for condition codes that is provided in the standard
WorldView database. The name of the drawing style table is FLAG_STATUS.
Table 4-4 explains the usage of each element of this drawing style table.
Similar drawing style tables are provided in the standard WorldView database for the tag and alarm blocked
indicators. The names of these drawing style tables are FLAG_TAG and FLAG_BLOCK respectively. Table 4-5
and Table 4-6 explain the usage of each element of these drawing style tables.
Owner tags are tag types that you can customize. Each owner tag type maps to one of the following:
Suppose that you have defined the following set of owner tag types:
• Station Guarantee
• Work Permit
• Self Protection
• Hold Off
• Caution
• Work and Test
• Information
where Station Guarantee is the highest level and Information is the lowest level. Then a corresponding drawing
style table for these owner tags could look like the one in Table 4-7.
4.3.7 Pushbutton
A pushbutton pmacro uses a drawing style table to color its label text. One color is used to color the text when
the mouse is not clicked on it. Another color is used to color the text while you’re holding the mouse button down
with the mouse pointer on the pushbutton.
The standard WorldView database contains a pushbutton drawing style table named PUSHBUTTON_LABEL.
Its elements are listed in Table 4-8.
4.3.8 Segment
Segments use drawing style tables to color groups of graphics elements according to the current values of
status points. In this case, the graphics elements contained in the group are re-colored regardless of whether
they are drawn in {dynamic} or not.
The standard WorldView database contains two segments drawing style tables named SEGMENT_DEFAULT
(used when the point has no unacknowledged alarms) and NAK_SEGMENT_DEFAULT (used when the point
has one or more unacknowledged alarms). The elements of SEGMENT_DEFAULT are listed in Table 4-9. The
usage of the elements of NAK_SEGMENT_DEFAULT is the same as that of the elements of
SEGMENT_DEFAULT.
Line sections use drawing style tables to color groups of graphics elements according to the states of the line
sections as calculated by the topology processor in the System Configuration Status (SCS) subsystem. As in
the case of segments, the graphics elements contained in the line section are re-colored regardless of whether
they are drawn in {dynamic} or not.
The required elements of a drawing style table for display of topology data is shown in Table 4-10. This is
described in more detail in the System Configuration Status User’s Guide (document number SCS-300).
As you can see, the drawing style tables define a very large part of the dynamic coloring scheme of your
system. The examples of drawing style tables presented in paragraphs 4.3.1 to 4.3.9 are those that come with
the SCADA system when you first get it. You are free to customize them as you wish. Just make sure that all
drawing style tables have at least as many elements (drawing styles) as shown in Table 4-1 to Table 4-10.
One way to customize a drawing style table is to leave the table itself alone and instead customize the drawing
styles that they contain. For example, you can customize the coloring scheme of your analog points by
customizing drawing styles ANALOG_NORMAL, ANALOG_REASON, etc.
Another way to customize a drawing style table is to remove the drawing styles that are in them and replace
them with other drawing styles. If you wanted, for example, to have different colors for upper and lower limit
violations, you could modify the ANALOG_DEFAULT and NAK_ANALOG_DEFAULT tables as shown in Table
4-11.
Another thing you can do is to create new drawing style tables of your own and reference these in your
pmacros. This allows you to retain intact the original drawing style tables for reference purposes, but more
importantly, allows you to have multiple coloring schemes. You can, for example, create two sets of analog
drawing style tables and use one for electric (with green for normal) and the other one for water (with cyan for
normal). You may also wish to use different colors for different types of status points. If you have the System
Configuration Status program, you can use multiple drawing style tables to create multiple line section coloring
schemes for high voltage vs. low voltage, for example, or for electric vs. water vs. gas.
Clicking on the Text Styles tab of the Library Selector causes a list of the existing text styles to be displayed, as
shown in (Figure 5-1).
5.1 Name
This is the name of the text style. It must be a legal Windows file name (because the text style definition is
stored as a .fnl file of this name). Make the names descriptive to make it easier for you and your colleagues to
remember. Examples of useful names are names that describe what the text styles are used for (e.g. “Street
Names” and “Note Label”) or names that describe the font and point size (e.g. “Arial Center Bold 16”).
If the text style is an existing text style, the font, font style and size of the text style are shown in the box at the
top of the window.
To edit, select a font from the scrollable font list, select a font style, and either select or enter font size (point
size). You can manually enter font sizes that are larger or smaller than the sizes listed in the scrolling window.
Note that different fonts at the same point size can be somewhat different in size. A sample of the current
selection is shown in the Sample box. Clicking on OK saves the current font selection and closes the Font
window. This does not save the text style. That’s done via the Save pushbutton in the main Text Style editor
window. Clicking on Cancel dismisses the Font window without applying any font changes.
5.3 Orientation
There are two choices: Horizontal and Vertical. The Horizontal option produces text that is read from left to
right. The Vertical option places each character of the text string letter directly below the previous character in a
column. The default is Horizontal.
This defines the horizontal alignment of the text with respect to the cursor. (The cursor is a crosshair that is used
to position text.) You have four choices:
• Left The left edge of the text string is placed at the cursor.
• Right The right edge of the text string is placed at the cursor.
• Center The center of the text string is placed at the cursor.
• Decimal This is for alignment of numbers by the decimal point. The decimal point is placed at the cursor.
This defines the vertical alignment of the text relative to the cursor. There are four choices:
• Baseline The baseline of the text is placed directly above the cursor.
• Top The top of the text box is placed directly below the cursor.
• Bottom The bottom of the text box is placed directly above the cursor.
• Center The center of the text box is placed on the cursor.
5.6 Apply
Clicking on Apply saves the new or modified text style but keeps the text style editor window open. If the text
style is an existing text style, any text strings that are currently in view and that use that text style are updated.
5.7 Undo
This function undoes any changes made using Apply while the window is open.
5.9 Cancel
This dismisses the Text Style Editor without saving any changes made since the last Save.
This chapter describes how to use the Symbol and Symbol Table editors.
• Symbols can be used on a map to represent static objects for which there are no database items in the
SCADA system.
• Symbols can be used in pmacros to represent dynamic points in the map. A status point pmacro, for
example, can display a different symbol for a point depending on the current state of the point. Alternatively,
you can define a pmacro to use just one symbol and color the symbol differently to represent the state of the
point. Pmacros also use symbols to represent the quality codes and tags of their associated points.
• Symbols can be used to represent various types of poke points on the map. You can use poke points to
jump to different views in the map, to bring up trend graphs, notes or images, or to initiate command
sequences.
In WorldView, each symbol is essentially a mini-world map and is edited via a Symbol editor that operates very
much like the map editor. There are differences, of course: symbols do not have layers, and you cannot place
pmacros in symbols. You can place drawing elements such as lines and shapes into a symbol, as well as text
and even other symbols, but not pmacros.
This symbol library includes a set of ready-to-use symbols provided by Survalent Technology, but you can add
your own custom symbols using the Symbol editor, as described in the next section.
If you have imported your base map from a DXF file, then your symbol library will also include all of the symbols
that were contained in the DXF file.
A Symbol Editor window, labeled Untitled, will be displayed, as shown in (Figure 6-2), that is very similar to the
Map Editor window.
pushbutton desensitized.
The edit bar allows you to add lines and shapes into the new symbol. The Library Selector allows you to choose
drawing styles and text styles to draw with.
Alternatively, you can select “Open” from the File pull-down menu.
Use the scroll bar to find the desired symbol, and either double-click on it or click on it once and then click on
Open. The Symbol Editor window will then appear with the selected symbol.
To save a symbol, you can use the Save pushbutton, or use the Save or Save As functions in the File pull-down
menu.
It is important to understand that when you place a symbol on a map, it is positioned so that the origin (X:0, Y:0)
of the symbol appears at the point in the map at which you clicked. For a new symbol, the Symbol Editor
initializes the scale of the view so that the height of the drawing area corresponds to 10,000 world units, and
Y=0 is at the bottom of the drawing area. The width of the drawing area, in world units, will depend on the
aspect ratio of the Symbol Editor window, and the X=0 will be on the left-hand side of the drawing area. (If the
window was perfectly square, the origin would be at the lower left corner of the window.) The center of the
drawing area is X=5000, Y=5000.
If you create your symbol to fill this initial drawing area, the origin of your symbol will be at the lower left corner
of the symbol. When you apply this symbol to the map, it will appear on the map with its lower left corner at the
point in the map where you clicked.
Sometimes, it will be more convenient to have the origin of your symbol at the center of the symbol. In such
cases, you can bring up the symbol in the Symbol Editor, zoom out by a factor of two (approximately) and drag
the entire symbol such that the coordinates of the center of the symbol are 0,0. This is a very easy task with grid
mode enabled, especially if you had drawn the symbol with grid mode on in the first place.
You can check the coordinates of any point in the symbol (or map, if you are in the map editor) simply by
moving the mouse pointer to that point and reading the coordinates that are displayed in the status bar at the
bottom of the edit window.
The displayed coordinates are updated continuously as you move the mouse pointer. There is no need to click
the mouse.
Note that if you modify an existing symbol table, you will change the appearance of all existing pmacros that use
that symbol table.
Clicking on Delete presently does not do anything. To delete a symbol table, you have to open the stl folder
through Windows Explorer and delete the appropriate .stl file.
6.4.1 Name
The list on the left-hand side of the Symbol Table Editor is a list of all of the available symbols. When you click
on one, the selected symbol is added to the end of the list contained in the right-hand side of the Symbol Table
Editor.
Some of the symbol tables that WorldView uses require null placeholder entries. You can create a null
placeholder entry in a symbol table by using the {Null} entry in the symbol selection list. When you click on {Null}
on the left, a {Null} entry is added to the list on the right. The editor shows you where the null entries are and
allows you to manipulate them in the same way as non-null entries. section 6.5, Using Symbol Tables,
describes where null entries are required.
The list on the right-hand side of the Symbol Table Editor is the list of symbols contained in the symbol table
being edited. Since the symbols in a symbol table are accessed by indexing, symbol tables are very order-
dependent. The meaning of the elements of a symbol table depends on how the symbol table is used. The
various ways in which symbol tables are used are described in section 6.5, Using Symbol Tables.
To add an entry to the symbol table, click on the desired entry in the symbol selection list on the left-hand side of
the Symbol Table Editor. The selected entry will be added to the end of the symbol table element list on the
right-hand side of the Symbol Table Editor.
The order of the elements (symbols) in the symbol table can be manipulated by using the up and down arrows.
The up arrow causes the selected symbol in the table to move up one position in the list. The down arrow
causes the selected symbol to move down one position in the list.
Clicking on the left arrow causes the selected symbol to be removed from the symbol table.
6.4.4 Apply
Clicking on Apply causes the new or modified symbol table to be saved. If the symbol table already exists, any
objects in the map that use that symbol table are updated. The Symbol Table Editor window is left open.
6.4.5 Undo
Clicking on Undo undoes any changes that you may have made using Apply while the Symbol Table Editor
window was open. Once you dismiss the Symbol Table Editor window, you cannot undo what you did (except by
using the Symbol Table Editor again).
6.4.6 Save
Clicking on Save causes the new or modified symbol table to be saved. If the symbol table already existed, any
objects in the map that use that symbol table are updated. The Symbol Table Editor window is closed, and you
cannot undo your changes (except by using the Symbol Table Editor again).
6.4.7 Cancel
Clicking on Cancel dismisses the Symbol Table Editor without saving any changes.
Section 4.3, Using Drawing Style Tables, describes the use of drawing style tables in the condition, tag and
alarm blocked indicators of pmacros. Symbol tables are used in much the same way.
(Figure 6-11) shows the contents of a symbol table for condition codes that is provided in the standard
WorldView database. The name of the symbol table is “condition_flags”.
In a condition flags table, a null entry is required in the second position. This corresponds to the Normal
condition code, for which no symbol is displayed. Table 6-1 explains the usage of each element of this symbol
table.
Similar symbol tables are provided in the standard WorldView database for the tag and alarm blocked
indicators. The names of these symbol tables are “tag_flags” and “alarm_blocked” respectively.
(Figure 6-12) and (Figure 6-13) and Table 6-2 and Table 6-3 illustrate the usage of each element of these
symbol tables.
Note that in a regular tag flags table, a null entry is required in the first position. This corresponds to the
"untagged" state, for which no symbol is displayed. In a blocked alarm flags table, a null entry is also required in
the first position. This corresponds to the "no alarms blocked" status, for which no symbol is displayed.
Paragraph 4.3.6, Owner Tags, describes how drawing style tables are used to display owner tags. When you
enable the owner tag indicator in a pmacro, you have to specify a symbol table in addition to a drawing style
table. Each element of the symbol table is associated with an owner tag type. The WorldView program selects
the symbol for an owner tag indicator by indexing into the symbol table using the point’s highest-level owner tag
as the index.
Suppose that you have defined the following set of owner tag types:
• Station Guarantee
• Work Permit
• Self Protection
• Hold Off
• Caution
• Work and Test
• Information
where Station Guarantee is the highest level and Information is the lowest level. Then a corresponding symbol
table for these owner tags could look like the one in Table 6-4. In a symbol table used for owner tags, no null
entries are required. Position zero corresponds to the highest-level owner tag, position one corresponds to the
next lower level owner tag, etc.
Symbol tables define a large part of the dynamic flags used to display the status of the points in your system.
The examples of symbol tables presented in paragraphs 6.5.1 and 6.5.2 are those that come with the SCADA
system when you first get it. You are free to customize them as you wish. Just make sure that all symbol tables
have at least as many elements (symbols) as shown in Table 6-1to Table 6-4.
One way to customize a symbol table is to leave the table itself alone and instead customize the symbols that
they contain.
Another way to customize a symbol table is to remove the symbols that are in them and replace them with other
symbols.
Pmacros are objects that serve as points of interaction with the user. The available classes of pmacro are listed
in Table 7-1. Most of the pmacro classes are associated with database points. These pmacros display point
values, and when you click on them, they display dialog boxes that allow you to perform operations on the
points. Other classes of pmacro act as poke points only. When you click on them, they take you to a different
view in the map, or bring up a trend graph, image or note, or allow you to operate a command sequence.
Each class of pmacro has a set of attributes called resources. Some of these resources are items contained in
libraries that we have talked about earlier, such as drawing styles, text styles and symbols. Other resources
consist of just numeric values or text strings. Pmacros that are associated with database points have one or
more resources that consist of SCADA point names. The resources used by each class of pmacro are identified
in section 7.2, Pmacro Classes. The resources themselves are described in section 7.3, Pmacro Resources.
You can create as many pmacros of each class as you wish. It’s the values of the resources that make each
pmacro different. For example, you can create a Status Symbol pmacro called “4KV Breaker” with appropriate
symbol resources for use with 4KV breaker points. And you can create another Status Symbol pmacro called
“Recloser” with other symbols for use with recloser points. Each of these pmacros can be used as many times
as you wish in your map by simply putting them down on the map and attaching them to database points.
How to add a pmacro to a map and attach it to a database point is described in Chapter 8, Map Editing. The
subject of the present chapter is how to create the pmacros.
When you add a pmacro to the map, you can override and change any of the resources for just that particular
instance of the pmacro. For example, if you want to apply a scale factor to the display of an analog point and
you don’t want to create a new pmacro with that scale factor, you can override the scale factor when you add
the pmacro to the map. This does not affect the definition of the pmacro in the library, and does not affect any of
the other instances of that pmacro in the map.
On the other hand, when you edit the pmacro definition itself using the Pmacro editor, you do affect all of the
pmacros in the map except in the instances where you have overridden the resource values. The point we’re
trying to make here is that while overrides are very convenient, overusing them destroys your ability to make
wholesale changes to all instances of a certain pmacro by simply editing the library definition of that pmacro. A
bit of planning before you start can save a lot of work in the future.
The list of pmacros that are currently in your pmacro library can be viewed by clicking on the Pmacros tab of the
Library Selector window. This is where you select the desired pmacro when you add a pmacro to the map.
Some of the pmacros in your library were there when you first got your system. They were provided by
Survalent Technology Corporation.
A Create Pmacro window will appear, as shown in (Figure 7-3). This window shows a list of the available
pmacro classes.
When you double-click on one of the pmacro classes, a Pmacro Properties window is displayed, as illustrated in
(Figure 7-4). (The example in Figure 7-4 is for a pmacro of class Status Symbol.) This window shows a
scrollable list of the resources associated with the selected class. The Pmacro Properties window is resizable,
so you can see all of the resources at once, if you wish.
In the background, a blank pmacro display window opens as well. This window is used to show you what the
pmacro will look like as you’re defining the resources.
Resource
The Resource column is a list of the resources available for the selected pmacro class. You may need to
double click or drag the vertical bar between the titles in order to have the complete names of some of the
resources displayed. Detailed descriptions of all resources used by all classes of pmacro are provided in
section 7.3, Pmacro Resources.
Default
The Default column is a list of default values for the resources. These are the values that will be used by
instances of the pmacro on the map if you do not supply values for the library definition of the pmacro. Note
that not all resources have default values.
Override
The Override column contains the resource values for the library definition of the pmacro. Any resource
values that you enter here override the defaults and are the values that are used for each instance on the
map (unless you further override them when you add a pmacro to the map).
As mentioned before, use of overrides on a per instance basis should be minimized. An exception is the
Point Name resource, which will generally be different for every instance. The Point Name resource should
be left blank in the Pmacro Editor, and entered as an override when you add each instance of the pmacro to
the map.
Remove Override
This pushbutton removes the override value of a selected resource. The resource reverts to its default value
(if it has one).
Apply
Clicking on the Apply pushbutton applies the changes and keeps the Pmacro Properties window open.
Undo
Clicking on the Undo pushbutton undoes any changes made using Apply while the window is open.
OK
Clicking on Cancel closes the Pmacro Properties window without applying any changes. To get the Pmacro
Properties window back, click on the Edit button or select Modify from the Edit pull-down menu.
To create your pmacro, edit the resources as required. If there is a Point Name resource, leave it blank. The
point name is filled in as an instance override when you add the pmacro to the map. Other resources, such as
labels and associated filenames, are also typically specified at the time of instantiation, so leave these blank too.
How to edit resources is described in paragraph 7.1.1, Editing Resources. The meaning of the resources is
described in Section 7.3, Pmacro Resources.
When you’re ready to save the pmacro, click on the Save pushbutton in the WorldView toolbar. This will open
the Save As window. Type in the desired file name for the new Pmacro and click on Save. This will save the
new Pmacro file and close the Save As window.
The Pmacro Properties window and the pmacro display window will remain, and you can continue editing the
pmacro if you wish. Or you can dismiss the Pmacro editor by closing the pmacro display window.
If you wish to edit the pmacro at a later time, you can access it by right-clicking on its entry in the Library
Selector window.
Alternatively, you can select Open from the File pull-down menu, and in the Open window that appears, select
“Pmacro (*.pml)” from the “Files of type:” menu. Then, navigate to the pml folder, and select the desired pmacro.
The Pmacro Properties window will appear, showing the pmacro’s current resource values, as well as the
pmacro display window showing what the pmacro presently looks like. See (Figure 7-8).
To edit a resource in the Pmacro Properties window, double-click on the resource name (in the Resource
column). A dialog box will appear that allows you to select or type in a resource value. The various dialog boxes
that are used to specify resource values are described below.
A library resource specifies an element of a library, such as a drawing style, drawing style table, text style or
symbol library. The dialog used to select the desired library element is illustrated in (Figure 7-9) (where the
example is one of specifying a drawing style table).
You can type the name of the desired library reference into the data entry field or select one from the scrollable
list by clicking on it. When you click on an item in the list, it appears in the data entry field. If you type in a name
that is not in the list, nothing will happen when you click on OK or Apply. Once the desired entry is in the data
entry field, clicking on Apply will cause the selected item to appear in the Override column of the resource.
Clicking on Undo removes the item from the Override column or returns to the original override that existed
before. Clicking on Cancel closes the dialog without saving any changes made since the last Apply. Clicking on
OK saves any changes made, stores the entered value in the Override column and closes the dialog.
Enable/Disable Resource
You can toggle the check mark by simply clicking on the check box. When you click on OK or Apply, the
resource value in the Override column updates to Yes if the check box is checked and No if the check box is
unchecked.
Type Resource
A type resource specifies an entry from a limited list of types. The dialogs used for these resources are similar to
those for library reference resources. An example is shown in (Figure 7-12).
As in the case of a library resource, you can either enter the desired type into the data entry field or select it
from the list.
Filename Resource
You can either enter the desired point name into the data entry field or browse for it. The point browser is
described in Chapter 8, Map Editing.
Note that point names are added to the pmacro when you instantiate them on the map, not when you define
them in the Pmacro editor.
The right-click Delete function in the Library Selector deletes the object from the library and moves it to the
Recycle Bin. Before doing so, WorldView asks you for confirmation that you really want to delete the library
resource. There is no Undo for this. If you want to undo, you have to retrieve the object yourself from the
Recycle Bin.
Before deleting a resource, WorldView checks the libraries and all currently open maps and control panels to
make sure that the resource is not in use. If it is in use, the resource will not be deleted. Any maps and control
panels that are not open will not be checked.
Most of these pmacro classes are associated with database points. When you are in viewer mode, and you click
on a pmacro that is associated with a database point, the system displays a dialog box containing functions that
you can perform on the point. These dialog boxes are described in the WorldView for Windows Operator’s
Guide.
The Analog Value pmacro displays the value of an analog point in a numerical fashion. By specifying
appropriate drawing style tables for the pmacro, you can control how the displayed value is to be color-coded to
reflect the point’s limit state as well as its unacknowledged alarm status.
The resources used by the analog value pmacro are listed in (Figure 7-15).
Analog Bar pmacros display analog point values in the form of real time bar graphs. Each pmacro displays one
bar. You can set up a row of these to provide a visual representation of data that can be interpreted with just a
glance. The length of each bar updates to reflect the value of the associated point. The color of the bar can be
made to reflect the limit state of the analog point (i.e. what alarm limits are violated, if any, by the point’s current
value).
The resources used by the Analog Bar pmacro are listed in (Figure 7-16).
The Analog Gauge pmacro allows you to create various types of gauges, dials and meters in your map or
control panel, driven by the values of analog points. When you click on a gauge pmacro, the same analog
dialog appears as for Analog Value pmacros with dialog code 0. You can define the Analog Gauge pmacro to
not be selectable by setting the dialog code to -1.
The resources used by the Analog Gauge pmacro are listed in the two halves of (Figure 7-17).
An Analog History pmacro displays analog point historical values in a pop-up window. The table within this
window can be configured to show any one or more of the analog history values for each of up to 18 point
names. The table may be organized to show one data item per line, or to show multiple points on each line.
The resources used by the Analog History pmacro are listed in (Figure 7-18).
The Mobile Icon pmacro can display the value of two status points (one determines the symbol and the other
determines the color). But the mobile icon is further controlled by the value of several other points. In particular,
the location of the mobile icon within the map is determined by the values of two analog points. This makes the
mobile icon useful for displaying the location and status of company vehicles in your service area. The location
of your vehicles, whether they are trains, buses or maintenance trucks, can be telemetered to the master station
via radio-based RTUs or GPS transponders.
A magnification analog point can be used to enlarge the mobile icon under certain conditions to alert the
operators.
The resources used by the mobile icon are shown in (Figure 7-19).
Although the mobile icon is associated with database points, it is presently a display-only pmacro. You cannot
click on it when you are in viewer mode (if you do, nothing happens).
A Mobile Icon Bitmap is a pmacro very similar to the regular Mobile Icon except that it uses bitmaps (e.g. *.jpg,
*.bmp, etc) instead of symbols.
Pseudo points are special status points that can only be used on WorldView maps (and only when connected to
a VMS-based SCADA system). They are created by means of a special pseudo point editor, but have no
telemetry or control addresses. They can be manually set on WorldView maps to reflect the status of devices
that are manually operated by field personnel but that are not monitored by SCADA.
A Pseudo Color pmacro is associated with one pseudo point. It uses one symbol that is partly or completely
drawn in the {dynamic} drawing style. The pmacro colors the {dynamic} portions of the symbol to reflect the
current value of the pseudo point. The colors used are specified in a drawing style table resource. Since a
pseudo point can have four possible states, there should be four drawing styles in this table.
The complete set of resources used by the Pseudo Color pmacro is shown in (Figure 7-20). Since tagging of
pseudo points is allowed, the list includes resources for tags and owner tags.
A Pseudo Symbol pmacro is similar to the Pseudo Color pmacro described above, except that a separate
symbol is displayed for each possible state of the pseudo point. See paragraph 7.2.4, Pseudo Color Pmacro.
A Pseudo Text pmacro is similar to the Pseudo Symbol pmacro described above, except that text strings are
displayed instead of symbols. A different text string is displayed for each possible state of the pseudo point.
The resources used by the Pseudo Text pmacro are shown in (Figure 7-22). The “String 0” resource specifies
the text string to be displayed when the pseudo point is in state 0, etc.
A Pushbutton Symbol pmacro acts as a poke point that can be used to go to other views, bring up trend graphs
notes, images or reports, or to activate command sequences. Which of these things the poke point does is
specified by the “Button Type” resource. Additional information, such as the name of a view or the number of a
trend graph or command sequence, is defined in the Button Data and Button Argument resources. For some
pushbutton types, associated files such as those containing images or ODBC queries are specified by the
Filename resource. The use of these resources for each button type is described in Section 7.3, Pmacro
Resources, and Section 7.4, Pushbuttons.
The complete set of resources used by the Pushbutton pmacro is shown in (Figure 7-23).
The “Symbol 0” resource specifies the name of the symbol to display on the map to represent the poke point.
The symbol can be anything you like. It does not have to be a picture of a pushbutton. The “Symbol 1” resource
specifies the name of an alternate symbol to be displayed while the mouse pointer is on the pushbutton pmacro
and the mouse button is pressed. If you don’t feel creative, you can enter the same symbol name for both
“Symbol 0” and “Symbol 1” or just leave “Symbol 1” blank.
The “Button Label Text Style” and “Button Label Drawing Style Table” resources allow you to specify the text
style and color of a label to be drawn on the pushbutton. The label text itself is specified in the “Button Label”
resource, which can be left blank in the library definition of the pmacro since you will most likely want to override
a different label string for each instance of the pushbutton on the map. The reason the color resource is a
drawing style table rather than just one drawing style is that the second drawing style in the table is used while
the mouse button is down on the pmacro (similar to displaying the alternate symbol). Only two drawing styles
are needed in this drawing style table.
A Station Color pmacro is similar to the Pseudo Color pmacro in that one symbol is colored to reflect the status
of a station. Only the {dynamic} portion of the symbol is re-colored.
The color is chosen by indexing into a drawing style table using the priority of the highest priority outstanding or
unacknowledged alarm on any point on that station. The drawing style table is chosen based on whether there
are any unacknowledged alarms on the station. When there are unacknowledged alarms on the station, the
drawing style table specified by the “NAK Drawing Style Table” resource is the one that is used. If you want
blinking effects for unacknowledged alarms, you would put cycling drawing styles into this table. Since there are
five alarm priorities (0 to 4), both drawing style tables must have five drawing styles in them.
The complete set of resources used by the Station Color pmacro is shown in (Figure 7-24).
The Button Label resources allow you to specify a label (e.g. station name) for each station pmacro, in a manner
similar to that for Pushbutton pmacros (see Paragraph 7.2.10, Pushbutton Pmacro).
The “View Name” resource specifies the name of a view in the map. If the value of this resource is non-blank,
then clicking on the station pmacro causes the viewer to jump to the specified view. The view name thus adds a
view pushbutton functionality to the station pmacro. This is great for system overviews:
• the color of the station symbol indicates the highest priority outstanding or unacknowledged alarm
• the symbol flashes if there are any unacknowledged alarms on the station
• clicking on the station symbol takes you to the view of that station
The Station Symbol pmacro is similar to the Station Color pmacro except that a separate symbol is displayed for
each alarm priority. The symbols specified by “Symbol 0” etc are displayed when there are no unacknowledged
alarms on the station. The symbols specified by “NAK Symbol 0” etc are displayed when there are
unacknowledged alarms on the station.
The resources used by the Station Symbol pmacro are shown in (Figure 7-25). The “View Name” resource can
be used to turn the station symbol pmacro into a view poke point in a manner similar to that of the station color
pmacro. See Paragraph 7.2.11, Station Color Pmacro.
The Status Color pmacro is similar to the Pseudo Color pmacro except that it’s associated with a status point
rather than a pseudo point. Like the pseudo color pmacro, the status color pmacro uses one symbol that is
partly or completely drawn in the {dynamic} drawing style. The pmacro colors the {dynamic} portions of the
symbol to reflect the current value of the status point. The colors used are specified in two drawing style table
resources. The “Normal Drawing Style Table” is used when the point has no unacknowledged alarms. The “NAK
Drawing Style Table” is used when the point has unacknowledged alarms. Since a status point can have four
possible states, both tables should contain four drawing styles each.
A number of Flag resources allow you to enable or disable indications of point quality, alarm blocked status and
tag status. The complete set of resources used by the Status Color pmacro is shown in (Figure 7-26).
The Status Symbol pmacro is similar to the Status Color pmacro except that a separate symbol is displayed for
each state of the point. The symbols identified by “Symbol 0” etc are displayed when the point has no
unacknowledged alarms. The symbols identified by “NAK Symbol 0” etc are displayed when the point has
unacknowledged alarms.
Despite its name, this pmacro can be used with analog points as well as status points. If you specify the name
of an analog point for the Point Name resource, the pmacro will display Symbol 0 if the analog point’s value is
positive, Symbol 1 if the point’s value is zero, and Symbol 2 if the point’s value is negative.
The complete set of resources used by the Status Symbol pmacro is shown in (Figure 7-27).
The Status Text pmacro is similar to the Status Symbol pmacro except that it displays text strings instead of
symbols to indicate the current value of the point. A different text string is displayed for each possible state of
the point.
The resources used by the Status Text pmacro are shown in (Figure 7-28).
The “String 0” resource specifies the text string to be displayed when the point is in state 0, etc. The color of the
text is taken from drawing style tables identified by “Normal Drawing Style Table” and “NAK Drawing Style
Table” resources. As usual, a color is obtained from the table by using the point’s current value as an index. The
selection of which drawing style table to be used is based on whether the point has any unacknowledged
alarms. Because a status point can have four possible states, both of these drawing style tables should have
four drawing styles in them.
A Text Value pmacro displays the value of a text point. The value of the text point consists of a text string (of up
to 30 characters) and a color code (0 – 7). When the string is displayed, trailing spaces are left off, which points
with short strings to be placed close together on the map.The resources used by the Text Value pmacro are
shown in (Figure 7-29).
A “Text Style” resource specifies the font to use for the text string. The color for the text string is obtained by
using the text point’s color code to index into a drawing style table (which should have eight drawing styles in it).
If you click on a text point pmacro that does not have a "Normal Drawing Style Table " resource defined, an
error message is displayed. The standard coloring scheme for text points is shown in Table 7-2, but in
WorldView, you can use any color scheme you like for text points.
The Pushbutton bitmap pmacro use bitmaps (image files) rather than symbols and can be used in both maps
and control panels. You can produce a "transparent" pushbutton (i.e. one that shows a pushbutton or target
contained in the background photo of a control panel) by not specifying any bitmap and just appropriately setting
the Bitmap Height and Bitmap Width resources.
The resources used by the Pushbutton Bitmap pmacro are listed in (Figure 7-30).
The Station Bitmap pmacro is similar to the Station Symbol pmacro except that instead of symbol the bitmap
(image files) is displayed. The bitmaps specified by “Bitmap 0” etc are displayed when there are no
unacknowledged alarms on the station. The symbols specified by “NAK Bitmap 0” etc are displayed when there
are unacknowledged alarms on the station.
Any bitmap files that you wish to use in bitmap pmacros should be placed in the "bmp" folder of the WorldView
"standard" directory. Bitmap file types supported include GIF, JPG and BMP.
The resources used by the Station Bitmap pmacro are listed in (Figure 7-31). The “View Name” resource can
be used to turn the station bitmap pmacro into a view poke point.
The Status Bitmap pmacro is similar to the Status Symbol pmacro except that it displays bitmaps instead of
symbols to indicate the current value of the point. A different bitmaps is displayed for each possible state of the
point.
The “Bitmap 0” resource specifies the bitmap to be displayed when the point is in state 0, etc. The selection of
which bitmap to be used is based on whether the point has any unacknowledged alarms. Because a status point
can have four possible states, you should define two sets of four bitmap files instead of symbols. The Bitmap
Height and Bitmap Width resources allow you to specify the desired size in world units.
The resources used by the Status Bitmap pmacro are listed in (Figure 7-32).
The Time Value pmacro displays the current date and time, and can be used in both maps and control panels. If
you are using the Time pmacro, you must check the "Guarantee Drawing Order" checkbox in the Options dialog
(else the displayed time will not update).
The resources used by the Time Value pmacro are listed in (Figure 7-33).
The Time Format resource is a string that contains time formatting codes. The formatting codes are preceded
by a percent sign (%). Characters that do not begin with % are output as is.
WorldView supports a type of object called “Template” which can be used with both Windows and VMS SCADA
systems.
A WorldView template is a complex object that contains pmacros, symbols, graphics and text strings. It’s an
entity that is similar to a single-page control panel, but when instantiated, is displayed right in the map (not via a
separate pop-up window).
The template makes it easy to create standard navigation bars and other complex objects for repeated use in
the map. And like control panels, when you modify a template, instances of the template are automatically
updated.
When you place an instance of a template pmacro on the map, an instance of the corresponding template is
added to the map. As mentioned above, if you edit and make changes to the template, all instances of the
template are automatically updated (regardless of which pmacros were used to instantiate them).
In edit mode, when you click on anything in the template, you select the template and you can move it, delete it
or edit its resources (edit the template pmacro’s resources, that is).
When you exit from edit mode and you select anything in the template, you operate on that object within the
template. If the object is a view pushbutton, you go to that view.
An example of a simple template in the template editor is shown below. The template contains four station
pmacros with views.
Note that if you enable grid mode, the lines going through 0,0 are highlighted in red. (This feature applies to the
map and symbol editors too.)
Although you can include analog and status pmacros in a template, the points have to be fully specified (i.e. with
the station name).
Note:
• Templates don’t have the station part of the points defined in the template instance pmacro as control panels
do.
The following is a description of all of the pmacro resources that are available.
This resource specifies the name of a drawing style table to be used to color the alarm blocked indicator for a
point. Double-clicking on this resource brings up a library resource dialog similar to that shown in Figure 7-9 to
allow you to select a drawing style table.
The alarm blocked indicator is the letter “B”. See paragraph 4.3.5, Flags, for a description of what needs to be
in the drawing style table used for the display of the alarm blocked indicator.
The value of this resource is meaningless if the Alarm Blocked Flag Enable resource is set to “No”. See
paragraph 7.3.2, Alarm Blocked Flag Enable.
This resource is used with a variety of point-related pmacros. It specifies whether the point’s alarm blocked
indicator is to be displayed or not. Double-clicking on this resource brings up a check box dialog similar to that of
(Figure 7-10) to allow you to toggle yes or no.
This resource is used to horizontally position the alarm blocked indicator relative to the origin of the pmacro.
Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to
enter a horizontal offset value (in world units).
The value of this resource is meaningless if the Alarm Blocked Flag Enable resource is set to “No”. See
paragraph 7.3.2, Alarm Blocked Flag Enable.
This resource is used to vertically position the alarm blocked indicator relative to the origin of the pmacro.
Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to
enter a vertical offset value (in world units).
The value of this resource is meaningless if the Alarm Blocked Flag Enable resource is set to “No”. See
paragraph 7.3.2, Alarm Blocked Flag Enable.
This resource is used with the Analog Bar and Analog Value pmacros only. It is used to scale the value of the
associated analog point to be displayed. The point’s value is divided by the scale factor. For example, if you
have a point whose value is in kilowatts, and you wish to display it in megawatts, you can enter a scale factor of
1000. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you
to enter a scale factor value.
This resource is used with the Analog Gauge pmacro only. It represents the angle length of the meter in
degrees, positive being in the counter-clockwise direction. Double-clicking on this resource brings up a data
entry dialog similar to that of (Figure 7-11) to allow you to enter a length value.
This resource is used with the Analog Gauge pmacro only. It represents the start angle of the meter in degrees,
0 degrees being the X axis. Double-clicking on this resource brings up a data entry dialog similar to that of
(Figure 7-11) to allow you to enter a start value.
This resource is used in a Gauge pmacro. It specifies the arrow head size as a fraction (0.0 to 1.0) of the arrow
size.
This resource is used with Analog Bar pmacros only. It represents the maximum deflection (in world units) of a
bar that varies in length depending on the value of the analog point. Double-clicking on this resource brings up a
data entry dialog similar to that of (Figure 7-11) to allow you to enter a length value. The value of this resource
is automatically overridden if you resize the pmacro by stretching it.
This resource is used with Analog Bar pmacros only. It specifies the width (in world units) of the bar. Double-
clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a
width value. The value of this resource is automatically overridden if you resize the pmacro by stretching it.
The width of the bar is not affected by the value of the analog point. Only the length is. See paragraph 7.3.9,
Bar Length.
7.3.11 Bitmap 0, 1, 2, 3, 4
These resources are used with Pushbutton, Station and Status Bitmap pmacros. They specify bitmaps to be
used to display the status of these types of pmacros.
These bitmaps are used when there are no unacknowledged alarms on the station or point. For a station, they
specify the bitmaps to be displayed for each value of highest priority outstanding alarm. In this case, there are
five bitmaps to be specified (corresponding to five alarm priorities).
For a status point, they specify the bitmaps to be displayed for each possible state of the point. In this case,
there are four bitmaps, which are called "Bitmap 0" through "Bitmap 3" to select (corresponding to four possible
states of a status point).
For a pushbutton, the "Bitmap 0" specifies the name of the bitmap to display on the map to represent the poke
point. The "Bitmap 1" resource specifies the name of an alternate bitmap to be displayed while the mouse
button is down on the pushbutton pmacro.
Double-clicking on each of these resources brings up a dialog similar to that of (Figure 7-13) to allow you to
select the desired bitmap from the "bmp" folder.
This resource is used with Pushbutton, Station and Status Bitmap pmacros. It specifies the height (in world
units) of the bitmap. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure
7-11) to allow you to enter a height value. It is not allowed to resize the pmacro by stretching it.
This resource is used with Pushbutton, Station and Status Bitmap pmacros. It specifies the width (in world units)
of the bitmap. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to
allow you to enter a width value. It is not allowed to resize the pmacro by stretching it.
This resource is used only with pushbutton pmacros of type “Task”, with dialog code 0. It represents the value of
the first of two arguments that are sent to the task when you click on the pushbutton. Double-clicking on this
resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an argument value.
See paragraph 7.4, Pushbuttons, for details on how button arguments are used.
The dialog code is defined by the value of the “Dialog Code” resource of the pushbutton pmacro. If a “Task”
pushbutton is assigned a dialog code of 1, the pushbutton displays a user-defined menu of functions when you
click on the pushbutton. The menu item that is selected then determines the value of the first argument that is
sent to the task. In this case, it doesn’t matter what the value of the “Button Argument 1 Data” resource is. See
paragraph 7.5.1, Task Menu, for a description of how to create and use task menus.
This resource is used only with Pushbutton and Pushbutton Bitmap pmacros of type “Task”. It represents the
type of the first of two arguments that are sent to the task when you click on the pushbutton. Double-clicking on
this resource brings up a type selection dialog similar to that of (Figure 7-12) to allow you to select an argument
type. The allowed argument types are:
• Integer
• Float
• String
This resource is used only with Pushbutton and Pushbutton Bitmap pmacros of type “Task”. It represents the
value of the second of two arguments that are sent to the task when you click on the pushbutton. Double-
clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an
argument value.
See section 7.4, Pushbuttons, for details on how button arguments are used.
As described in paragraph 7.3.14, Button Argument 1 Data, a dialog code of 1 causes the pushbutton to get the
first argument from a menu instead of from the “Button Argument 1 Data” resource. Note that this is not the case
for “Button Argument 2 Data”. The value of the “Button Argument 2 Data” resource is passed to the task as the
second argument regardless of the pushbutton’s dialog code.
This resource is used only with Pushbutton and Pushbutton Bitmap pmacros of type “Task”. It represents the
type of the second of two arguments that are sent to the task when you click on the pushbutton. Double-clicking
on this resource brings up a type selection dialog similar to that of (Figure 7-12) to allow you to select an
argument type. The allowed argument types are:
• Integer
• Float
• String
This resource is used with Pushbutton and Pushbutton Bitmap pmacros only. Its meaning depends on the
pushbutton type as specified by the Button Type resource (see paragraph 7.3.24, Button Type). Double-clicking
on the Button Data resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a
button data value. The meaning of the Button Data resource for each button type that uses it is summarized in
Table 7-3
This resource allows you to define a text string to be used to display a descriptive label in the pmacro. For
example, you can specify the name of a view in a view pushbutton or a description of a trend graph in a graph
pushbutton.
Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to
enter a label string. Normally, you should leave this resource undefined in the library definition of the pmacro,
and specify it when you add an instance of the pmacro to the map. But it’s ok to put something in as a default,
so you can see what the label looks like immediately when you put down the pmacro onto the map. Then you
can edit the label.
This resource specifies the name of a drawing style table to be used to color the label in pmacros that have the
Button Label resource. See Paragraph 7.3.19, Button Label. Double-clicking on the Button Label Drawing Style
Table resource brings up a library resource dialog similar to that of (Figure 7-9) to allow you to select the
desired drawing style table.
The specified drawing style table should have two drawing styles in it. Normally, the first drawing style is used to
color the label. The second drawing style is used to color the label when the mouse button is depressed while
the mouse pointer is over the pmacro.
This resource specifies the name of a text style to be used to display the label in pmacros that have the Button
Label resource. See Paragraph 7.3.19, Button Label. Double-clicking on this resource brings up a library
resource dialog similar to that of (Figure 7-9) to allow you to select the desired text style.
This resource specifies a horizontal offset to apply to the position of the label in pmacros that have the Button
Label resource. See Paragraph 7.3.19, Button Label. Double-clicking on this resource brings up a data entry
dialog similar to that of (Figure 7-11) to allow you to enter an offset value (in world units)
The offset positions the text relative to the origin of the pmacro. A positive value moves the label text to the
right, a negative value moves it to the left.
This resource specifies a vertical offset to apply to the position of the label in pmacros that have the Button
Label resource. See Paragraph 7.3.19, Button Label. Double-clicking on this resource brings up a data entry
dialog similar to that of (Figure 7-11) to allow you to enter an offset value (in world units).
The offset positions the text relative to the origin of the pmacro. A positive value moves the label up, a negative
value moves it down.
This resource is used with Pushbutton and Pushbutton Bitmap pmacros only. It specifies the type of pushbutton
pmacro. Double-clicking on this resource brings up a type selection dialog to allow you to select a pushbutton
type.
The purposes of the various pushbutton types are listed in Table 7-4.
This resource is used with Mobile Icon pmacros only. It specifies the name of a status point whose current state
determines the drawing style used to re-color the {dynamic} portions of the icon’s symbol. Double-clicking on
this resource brings up a data entry dialog of the type shown in (Figure 7-14) to allow you to enter or browse for
a status point name.
This resource specifies the name of a drawing style table to be used to color the condition code indicator for a
point. Double-clicking on this resource brings up a library resource dialog similar to that shown in (Figure 7-9) to
allow you to select a drawing style table.
If the point is normal, the condition code indicator is blank. Otherwise, it’s a character from Table 7-5.See
Paragraph 4.3.5, Flags, for a description of what needs to be in the drawing style table used for the display of
the condition code indicator.
The value of this resource is meaningless if the Condition Flag Enable resource is set to “No”. See Paragraph
7.3.27, Condition Flag Enable.
This resource is used with a variety of point-related pmacros. It specifies whether the point’s condition indicator
is to be displayed or not. Double-clicking on this resource brings up a check box dialog similar to that of (Figure
7-10) to allow you to toggle yes or no.
This resource is used to horizontally position the condition indicator relative to the origin of the pmacro. Double-
clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a
horizontal offset value (in world units).
The value of this resource is meaningless if the Condition Flag Enable resource is set to “No”. See Paragraph
7.3.27, Condition Flag Enable.
This resource is used to vertically position the condition indicator relative to the origin of the pmacro. Double-
clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a
vertical offset value (in world units).
The value of this resource is meaningless if the Condition Flag Enable resource is set to “No”. See Paragraph
7.3.27, Condition Flag Enable.
This resource specifies how long to keep displaying a point’s control panel after you have executed a control in
which there was a checkback failure. Double-clicking on this resource brings up a data entry dialog similar to
that of (Figure 7-11) to allow you to enter a timeout value (in seconds).
The purpose of the timer is to allow you retry the control that just failed without having to re-select the point.
This resource is used with the Station Symbol, Color and Bitmap pmacros. This is the name of an associated
Control panel file. Double-clicking on this resource brings up a dialog similar to that of (Figure 7-13) to allow you
to select the desired control panel from the "cpl" folder.
See the IED Control Panel User’s Guide for more details on creating control panels.
This resource is used with the Station Symbol, Color and Bitmap pmacros. It specifies an optional point name
prefix associated with a specific instantiation of an IED that was created using the IED Wizard.
See the IED Control Panel User’s Guide for more details on creating control panels.
The Control Panel String 1, Control Panel String 2 and Control Panel String 3 resources are used with the
Station Symbol, Color and Bitmap pmacros. These resources specify text strings that are to be displayed in the
control panel. Each string may be up to 50 characters in length. You can distinguish a displayed control panel
from another of the same type through these substituted strings.
To place these strings in the control panel, insert into the control panel text string objects with string values
“#string1#, “#string2#” and “#string3#” (without the quotes). WorldView will substitute these special string
values by the corresponding strings specified in the station pmacro. You can use any combination of these
three strings, in any text style and drawing style, and you can place them anywhere you want in the control
panel.
See the IED Control Panel User’s Guide for more details on creating control panels.
This resource is used with the Station Symbol, Color and Bitmap pmacros. It allows you to specify (in pixels) the
desired initial horizontal position of the control panel when it is launched. Double-clicking on this resource brings
up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an initial horizontal position for the
control panel.
See the IED Control Panel User’s Guide for more details on creating control panels.
This resource is used with the Station Symbol, Color and Bitmap pmacros. It allows you to specify (in pixels)
the desired initial vertical position of the control panel when it is launched. Double-clicking on this resource
brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter an initial vertical position for
the control panel.
See the IED Control Panel User’s Guide for more details on creating control panels.
This resource specifies how long to keep displaying a point’s control dialog after you have executed a control in
which there was a check back success. Double-clicking on this resource brings up a data entry dialog similar to
that of (Figure 7-11) to allow you to enter a timeout value (in seconds).
The purpose of the timer is to allow you to repeat the control that you just executed (after confirming that the
device behaved as expected) without having to re-select the point. This is particularly useful with tap changers
and other jog-type control points.
Both Analog and Status point pmacros allow you to show other data items besides current value. The other data
items are selectable by means of a me nu in the “Data Item” resource. See (Figure 7-39) for an analog point
below.
Via the Data Item resource you can select: last update time, point description, engineering units and any of the
analog history data items. This feature can be used with analog bars and gauges as well as with regular numeric
pmacros, but in the case of the gauges and bars, only the numeric data items can be used. For status points, you
can select: last update time, point description, state string and transition count.
This resource is used with the Analog Gauge pmacro only. It specifies the color of the Dial. Double-clicking on
this resource brings up a data entry dialog similar to that of (Figure 7-9) to allow you to choose from the list of
already defined Drawing Styles.
This resource is used with the Analog Gauge pmacro only. It specifies the direction of the Label, Left to Right or
Right to Left. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-9) to
allow you to choose the direction.
This resource specifies the type of control dialog that is to be displayed when you click on the pmacro in viewer
mode. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you
to enter a numeric dialog code.
Status Pmacro
There are presently 14 different control dialogs available for status pmacros. They are numbered 0 – 13, and
are selected from a menu, as shown in (Figure 7-40).
There is a special dialog code of “(–1) Disabled (no dialog)” that you can use in order to have no dialog
displayed at all when you click on a point. You can use this for points that you wish to be display only, i.e. to
make the pmacro not be selectable (except in edit mode). For such pmacros, the right-click pop-up menu still
allows you to access Tag/Untag, Notes, Alarm and Oprsum Viewer dialogs (for read only). For such pmacros,
although you are allowed to view tags and notes, you are not allowed to add, modify or delete them, nor use the
point in Group Tag operations.
The control dialogs that can be selected via the dialog code are all described in detail in the WorldView for
Windows Operator’s Guide. For your convenience, they are shown in this editing guide below.
Note that for dialog code 0, 1 and 2, the control dialogs that appear include a Properties button that allows you
to access the point editor. If you have the point editing right, you are allowed to make changes to the point.
Figure 7-45 Direct Set Manual Panel – Figure 7-46 Direct Set Manual With Tag –
Dialog Code 4 Dialog Code 5
The dialogs for dialog codes 7 and 8 contain just one control pushbutton. For dialog code 7, when you press
and hold the control pushbutton, a 0-control is issued to the point, and the pushbutton label updates to show the
state 1 command string. When you release the pushbutton, a 1-control is issued and the pushbutton label
reverts to the 0 command string. For dialog code 8, it’s the other way around: when you press on the control
pushbutton, a 1-control is issued, and when you release the pushbutton, a 0-control, is issued. You can keep
the dialog up for repeated control actions by specifying a non-zero value for the Control Fail Timeout resource.
The dialog for dialog code 9 is the same as for dialog code 3 except that an execute button is included.
Dialog code 10 causes a control panel to be launched when you select the point.
Dialog code 11 causes just the Tag/Untag dialog to be displayed when you select the point (with no other
functions allowed).
Figure 7-53 Direct Open - Dialog Code 12 Figure 7-54 Direct Close - Dialog Code 13
The dialogs for dialog codes 12 and 13 contain just one pushbutton. Pressing on the pushbutton causes a
control to be issued (open control for dialog 12, close control for dialog 13). These dialogs are particularly
useful for mimicking controls in control panels.
The Dialog Code resource is also used with task, view and report pushbuttons. In this case, there is no menu.
Just type in either a 0 or a 1. Dialog code 0 produces a regular pushbutton. Dialog code 1 causes the viewer to
display a menu when you click on the pmacro. The definition and usage of menus is the subject of section 7.5,
Menu Files.
If you want multiple points on each line (e.g. for 3-phase electrical points), you can enter the desired number of
points per line into the Dialog Code resource of the pmacro. The display that results from setting the dialog code
to 3 is shown in the example of (Figure 7-56).
There are presently 3 different control dialogs available for analog point pmacros. They are numbered 0 to 2,
and are selected from a menu, as shown in (Figure 7-57).
There is a special dialog code of “(–1) Disabled (no dialog)” that you can use in order to have no dialog
displayed at all when you click on a point. You can use this for points that you wish to be display only, i.e. to
make the pmacro not be selectable (except in edit mode). For such pmacros, the right-click pop-up menu still
allows you to access Tag/Untag, Notes, Limits, Analog History, Alarm and Oprsum Viewer dialogs (for read
only). For such pmacros, although you are allowed to view tags, notes and limits, you are not allowed to edit
them.
Symbol Pmacros
A dialog code of –2 assigned to symbol pmacros causes the extent of the pmacro to depend on the currently
displayed symbol instead of on the aggregate of all the symbols that are associated with the pmacro. Other than
this, the behavior is as for dialog code –1. What is this good for? It allows you to create a pmacro that, while its
point is in one state, occludes and renders unselectable another pmacro, but when the point is in another state,
the second pmacro is both visible and selectable.
This resource is used with Analog Bar/Value/Gauge, Status Symbol/Color/Text/Bitmap and Text Value pmacros.
If this resource is set to Yes, WorldView will not allow manual set or deactivate operations on the point. In the
case of an analog menu pmacro, WorldView will not even bring up the analog menu dialog.
This resource is used with the Time Value pmacro only. The color of the displayed date and time is determined
by the drawing style specified by this resource. Double-clicking on this resource brings up a library reference
dialog similar to that of (Figure 7-9) to allow you to select the desired drawing style.
This is an option that allows you to be able to display analog bars in a bipolar fashion. It’s enabled by setting
the “Draw from base” resource to Yes, and by entering the desired baseline value into the “Base value” resource.
This resource is used with the Analog Value/Gauge, Mobile Icon, Status Symbol/Color/Text/Bitmap, Station
Symbol/Color/Bitmap and Text/Time Value pmacros.
The default value of this resource is Yes, which causes the entire extent of the pmacro to be erased before re-
drawing it on an update.
Setting this resource to No allows you to have stuff that's behind the pmacro show through the empty parts of
the pmacro (e.g. text or other graphics poking through an open box or circle), creating sort of a transparent
effect.
If you wish to make use of this feature, you have to enable the "Guaranteed Drawing Order" option in the
Options dialog.
7.3.45 Filename
This is the name of an associated file. The use of an associated file depends on the type of pmacro and is
summarized in Table 7-6. Details can be found in section 7.4, Pushbuttons, and section 7.5, Menu Files.
This resource specifies a horizontal scale factor to be applied to all of the flag indicators in the pmacro (so that
you can independently control the aspect ratio of the flags). This includes the alarm blocked flag, condition code
flag and the tag flag. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure
7-11) to allow you to enter a scale factor value. You can use this resource to adjust the size of the flags relative
to the rest of the pmacro.
This resource specifies a vertical scale factor to be applied to all of the flag indicators in the pmacro (so that you
can independently control the aspect ratio of the flags). This includes the alarm blocked flag, condition code flag
and the tag flag. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to
allow you to enter a scale factor value. You can use this resource to adjust the size of the flags relative to the
rest of the pmacro.
This resource is used only with the Analog Gauge pmacro when the Gauge Type is Corner. It specifies the
subtype of the Gauge i.e. visible quadrant for the Corner gauge. Double-clicking on this resource brings up a
type selection dialog similar to that of (Figure 7-12) to allow you to select a gauge subtype. The allowed gauge
subtypes are:
• Top-Left
• Top-Right
• Bottom-Left
• Bottom-Right
This resource is used with the Analog Gauge pmacro only. It specifies the type of the Gauge. Double-clicking
on this resource brings up a type selection dialog similar to that of (Figure 7-12) to allow you to select a gauge
type. The allowed gauge types are:
• Dial
• Meter
• Corner
This resource specifies the horizontal justification of text-based pmacros such as Analog Value, Pseudo Text,
Status Text and Text Value, and allows you to override the horizontal justification of the selected text style (and
avoid having to create a new text style).
Double-clicking on this resource brings up a type selector dialog similar to that of (Figure 7-12) to allow you to
select the desired justification. Your choices are:
See section 5.4, Horizontal Justification, for a description of what these choices mean.
This resource is used with pushbuttons of type “Image”. It specifies a horizontal scale factor to be applied to the
image when the image is invoked (the image is invoked by clicking on the pushbutton). Double-clicking on this
resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a scale factor value.
If you want to maintain the image’s original aspect ratio, which would be the normal case, set the image scale
factors in both the X and Y directions the same. See paragraph 7.3.52, Image Scale factor, Y Axis.
This resource is used with pushbuttons of type “Image”. It specifies a vertical scale factor to be applied to the
image when the image is invoked (the image is invoked by clicking on the pushbutton). Double-clicking on this
resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a scale factor value.
If you want to maintain the image’s original aspect ratio, which would be the normal case, set the image scale
factors in both the X and Y directions the same. See paragraph 7.3.51, Image Scale factor, X Axis.
This resource is used with the Analog Gauge pmacro only. It specifies the color of the Gauge title. Double-
clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select
the desired drawing style.
This resource is used with the Analog Gauge pmacro only. It allows you to specify the desired horizontal
position of the gauge title. Double-clicking on this resource brings up a data entry dialog similar to that of
(Figure 7-11) to allow you to enter a horizontal position for the gauge title.
This resource is used with the Analog Gauge pmacro only. It allows you to specify the desired vertical position
of the gauge title. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11)
to allow you to enter a vertical position for the gauge title.
This resource allows you to define the title of an analog gauge. Double-clicking on this resource brings up a
data entry dialog similar to that of (Figure 7-11) to allow you to enter the text of the title.
Normally, you should leave this resource undefined in the library definition of the pmacro, and specify it when
you add an instance of the pmacro to the map. But it’s ok to put something in as a default, so you can see what
the label looks like immediately when you put down the pmacro onto the map. Then you can edit the label.
This resource is used with the Analog Gauge pmacro. It specifies the text style to use to display the title of the
gauge. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to
allow you to select the desired text style.
This resource is used with the Analog Gauge pmacro only. It specifies the color of the selected Limit. Double-
clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select
the desired drawing style.
This resource is used with Analog Gauge pmacros only. It specifies the maximum value at which the color in the
selected Limit will apply. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure
7-11) to allow you to enter a maximum limit value.
This resource is used with Analog Gauge pmacros only. It specifies the minimum value at which the color in the
selected Limit will apply. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure
7-11) to allow you to enter a minimum limit value.
This resource is used with the Analog Gauge pmacro only. It specifies the color for the inner area, below the
value in "Limit Min Visible %" resource. Double-clicking on this resource brings up a library reference dialog
similar to that of (Figure 7-9) to allow you to select the desired drawing style.
This resource is used with Analog Gauge pmacros only. It specifies the maximum visible percent of radius for
the Limits Area. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to
allow you to enter a maximum value in percent.
This resource is used with Analog Gauge pmacros only. It specifies the minimum visible percent of radius for the
Limits Area. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to
allow you to enter a minimum value in percent.
This resource is used with Analog Gauge pmacros only. It specifies the number of limits that will be displayed.
According to this number of limits, the same number of Limit Color, Limit Max and Limit Min values will be
displayed. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow
you to enter a number of limits.
This resource is used with Analog Bar and Analog Gauge pmacros only. It specifies the value of the associated
analog point below which the bar is to be displayed with zero length or the needle of the gauge is to be
displayed at its minimum position. Double-clicking on this resource brings up a data entry dialog similar to that of
(Figure 7-11) to allow you to enter a lower limit value. See paragraph 7.3.110, Upper Limit.
7.3.66 Magnification
This is a resource that allows you to scale the symbolic content of the entire pmacro. Double-clicking on this
resource brings up a data entry dialog of the type shown in (Figure 7-11) to allow you to enter a magnification
factor.
The magnification applies to symbols and flags, but not to text. The bar in an analog bar and gauge in an analog
gauge pmacro can also be magnified using this resource. Magnification factors greater than unity expand the
size of the pmacro. Positive values less than unity act to reduce the size of the pmacro. Negative values invert
the symbolic contents, both vertically and horizontally, in addition to scaling the symbolic content (but leave the
text content untouched).
This resource is used with Mobile Icons only. It specifies the name of an analog point whose value is used as a
magnification factor when displaying the icon’s symbol. Double-clicking this resource brings up a data entry
dialog of the type shown in (Figure 7-14) to allow you to enter or browse for a magnification point name.
If you have also specified a Magnification resource (see paragraph 7.3.66, Magnification), the value retrieved
from the point specified by the Magnification Point Name resource is multiplied by the value of the Magnification
These resources are used with Analog Gauge pmacros only. They specify the number of major divisions, and
number of minor divisions in each major division, that will be displayed. Double-clicking on these resources
brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a number of major / minor
divisions.
These resources are used with Analog Gauge pmacros only. They specify the color of the major and minor
divisions. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to
allow you to select the desired drawing style.
The Major Division Color resource only applies to major divisions that are not in any Limits range. Divisions that
are within a limit range are colored using the color of the Limit. The same coloring rule applies to the Minor
Divisions.
This resource is used with Analog Gauge pmacros only. Positive values of this resource specify the number of
decimal digits for the major division labels of the analog gauge. Double-clicking on this resource brings up a
data entry dialog similar to that of (Figure 7-11) to allow you to enter a major divisions precision value.
A value of zero for this resource means no decimal places and no decimal point.
This resource is used with Analog Gauge pmacros only. It specifies the color of the major divisions labels.
Double-clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to
select the desired drawing style.
This resource is used with Analog Gauge pmacros. It specifies the text style to use to display the labels of the
major divisions. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure
7-9) to allow you to select the desired text style.
This resource is used with Analog Bar/Gauge/Value/History and Status Symbol/Color/Text/Bitmap pmacros. It
allows you to specify an optional minimum size before a point can be selected for operation.
If both the displayed height and width of the point are less than this minimum size, WorldView does not allow
you to select the point.
These resources are used with Station Bitmap and Status Bitmap pmacros when there are unacknowledged
alarms on the station or status point, respectively. For a station, they specify the bitmaps to be displayed for
each value of highest priority outstanding or unacknowledged alarm. For a status point, they specify the bitmaps
to be displayed for each possible state of the point. In the case of a station point, there are five bitmaps to
select (to correspond to five alarm priorities). In the case of a status point, there are four bitmaps to select
(corresponding to four possible states of a status point).
Double-clicking on these resources brings up a library reference dialog similar to that of (Figure 7-9) to allow
you to select the desired bitmap.
NAK stands for uNAcKnowledged. This resource specifies a drawing style table that is to be used to color a
symbol or text string to reflect the value of a station or status point, or the limit state of an analog point, when
there are unacknowledged alarms on the point. If the pmacro uses symbols, only the portion of the symbol that
is drawn in {dynamic} are colored according to the contents of this drawing style table.
Double-clicking on this resource brings up a library reference dialog similar to that shown in (Figure 7-9) to
allow you to select the desired drawing style table.
For a station point, the color is chosen from the selected table by means of an index consisting of the priority of
the highest outstanding or unacknowledged alarm on the station. For a status point, the color is chosen
according to the current state of the status point. For an analog point, whether the pmacro is an Analog Value or
an Analog Bar pmacro, the color is chosen by indexing according to the point’s current limit state.
These resources are used with Station Symbol and Status Symbol pmacros when there are unacknowledged
alarms on the station or status point, respectively. For a station, they specify the symbols to be displayed for
each value of highest priority outstanding or unacknowledged alarm. For a status point, they specify the symbols
to be displayed for each possible state of the point. In the case of a station point, there are five symbols to select
(to correspond to five alarm priorities).
In the case of a status point, there are four symbols to select (corresponding to four possible states of a status
point).
Double-clicking on these resources brings up a library reference dialog similar to that of (Figure 7-9) to allow
you to select the desired symbol.
This resource is used with Analog Gauge pmacros only. It specifies the color of the needle. Double-clicking on
this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select the desired
drawing style.
This resource is used with Analog Gauge pmacros. It specifies the type of the needle. Double-clicking on this
resource brings up a type selector dialog similar to that of (Figure 7-12) to allow you to select the desired
needle type. Your choices are:
• Line
• Arrow
• Diamond
This resource is used with Analog Gauge pmacros only. It specifies the visible percent of the needle for the
meter type of gauge. Double-clicking on this resource brings up a data entry dialog similar to that of (Figure
7-11) to allow you to enter a value in percent.
This resource is similar to the NAK Drawing Style Table resource except that it is used when there are no
unacknowledged alarms on the point. See paragraph 7.3.75, NAK Drawing Style Table.
Double-clicking on this resource brings up a library resource dialog similar to that of (Figure 7-9) to allow you to
select the desired drawing style table.
7.3.81 Orientation
This resource specifies the orientation of text-based pmacros such as Analog Value, Pseudo Text, Status Text
and Text Value, and allows you to override the orientation of the selected text style (and avoid having to create
a new text style).
Double-clicking on this resource brings up a type
selector dialog similar to that of (Figure 7-12) to
allow you to select the desired orientation. Your
choices are:
• Default (i.e. use the orientation of the
text style)
• Horizontal
• Vertical
See section 5.3, Orientation, for a description of what these choices mean.
This resource specifies the name of a drawing style table that contains the drawing styles to be used to display
the symbols representing the highest-level tag on the point. Each element of this drawing style table has a
counterpart in a corresponding symbol table. See paragraph 7.3.86, Owner Tag Flag Symbols.
Double-clicking on this resource brings up a library resource dialog similar to that of (Figure 7-9) to allow you to
select the desired drawing style table.
This resource is used with a variety of point-related pmacros. It specifies whether the point’s owner tag indicator
is to be displayed or not. Double-clicking on this resource brings up a check box dialog similar to that of (Figure
7-10) to allow you to toggle yes or no.
This resource is used to horizontally position the owner tag indicator relative to the origin of the pmacro. Double-
clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a
horizontal offset value (in world units).
The value of this resource is meaningless if the Owner Tag Flag Enable resource is set to “No”. See paragraph
7.3.83, Owner Tag Flag Enable.
This resource is used to vertically position the owner tag indicator relative to the origin of the pmacro. Double-
clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a
vertical offset value (in world units).
The value of this resource is meaningless if the Owner Tag Flag Enable resource is set to “No”. See paragraph
7.3.83, Owner Tag Flag Enable.
This resource specifies the name of a symbol table that contains the symbols to be displayed to represent the
highest level tag on the point. Double-clicking on this resource brings up a library resource dialog similar to that
of (Figure 7-9) to allow you to select the desired symbol table.
See sections 6.4, Symbol Table, and sections 6.5, Using Symbol Tables, and in particular, paragraph 6.5.2,
Owner Tags, for details on creating symbol tables for owner tags.
For pmacros that are associated with one and only one point, this resource specifies that point’s name. Double-
clicking on this resource brings up opens a data entry dialog of the type shown in (Figure 7-14) to allow you to
enter or browse for a point name.
Note that the Analog History pmacro class supports 18 point names, which are called “Point Name 01” through
“Point Name 18”.
Note that the Status Symbol, Color, Text and Bitmap pmacro classes can be associated with two more point
names. The additional point name resources, which can be used if the dialog code is set to 6, are called “Point
Name 2” and “Point Name 3”.
These are three resources that are used with Status Symbol, Color, Text and Bitmap pmacros only. They
specify the titles of the three sections of the three-point dialog that is obtained when the dialog code is set to 6.
Double-clicking on each of these resources brings up a data entry dialog similar to that of (Figure 7-11) to allow
you to enter a point title.
7.3.89 Precision
This resource is used with Analog Value pmacros only. Positive values of this resource specify the number of
decimal digits to be used in the numerical display of the analog point’s value. Double-clicking on this resource
brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a precision value.
A value of zero for this resource means no decimal places and no decimal point. A value of –1 causes the
analog value to be displayed with a floating decimal point so as to display as many significant digits as possible.
A value of –2 causes the value to be displayed with leading zeros (as opposed to leading blanks).
7.3.90 Radius
This resource is used with Analog Gauge pmacros only. It specifies the radius of the gauge. Double-clicking on
this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a radius in world
units.
This resource is used with pmacros that display symbols. It allows you to specify an angle of rotation for the
symbols associated with the pmacro. Double-clicking on this resource brings up a data entry dialog similar to
that of (Figure 7-11) to allow you to enter a rotation angle.
The rotation angle is specified in units of degrees. Positive rotation is counterclockwise. Flags are rotated as
well as the symbols if the “Rotate MTB Flags” option is checked in the Map View tab of the Options window. See
Section 5.33, Map View Options, of the WorldView for Windows Operator’s Guide. Text contained in the symbol
is rotated. Label text is not.
This resource is used to specify a horizontal scale factor to apply only to the symbols contained in the pmacro
(so that you can change the symbol's aspect ratio). Double-clicking on this resource brings up a data entry
dialog similar to that of (Figure 7-11) to allow you to enter a scale factor value.
This resource is used to specify a vertical scale factor to apply only to the symbols contained in the pmacro (so
that you can change the symbol's aspect ratio). Double-clicking on this resource brings up a data entry dialog
similar to that of (Figure 7-11) to allow you to enter a scale factor value.
This resource is used with point-related pmacros. When you click on a point pmacro in view mode, the viewer
highlights your selection by drawing a selection rectangle around it. This resource specifies the drawing style
that is used to draw this selection rectangle. Double-clicking on this resource brings up a library reference dialog
similar to that of (Figure 7-9) to allow you to select the desired drawing style.
This resource is used with Analog Value pmacros only. It specifies whether the plus and minus (+, -) signs on
the numeric display of the point’s value are to be displayed or not. Double-clicking on this resource brings up the
check box dialog of (Figure 7-10) to allow you to toggle yes or no.
What’s this for? In cases where power or fluid flow can be in either direction, flow can be positive or negative.
Rather than make the operator have to think things like “positive means flowing left”, it’s preferable, in such
cases, to numerically display the absolute value of the flow, and display the direction of the flow using a symbol
like an arrow.
See paragraph 7.2.14, Status Symbol Pmacro, and paragraph 7.3.100, Symbol 0, 1, 2, 3, 4, for more on how
to display symbols based on the sign of analog values.
This resource is used with Station Symbol, Color and Bitmap pmacros. For pmacros that are associated with
one and only one station, this resource specifies that station’s name. Double-clicking on this resource opens a
data entry dialog of the type shown in (Figure 7-14) to allow you to enter or browse for a station name.
It makes sense to leave this resource blank in the library definition of the pmacro, in favor of filling it in as an
override when you add each instance of the pmacro to the map.
These resources are used to specify three additional stations for Station Symbol, Color and Bitmap pmacros
that are used to launch control panels. (A control panel can show points for up to four stations.) Double-clicking
See the IED Control Panel User’s Guide for more information on creating control panels.
7.3.98 String 0, 1, 2, 3
These are four resources that are used with Status Text and Pseudo Text pmacros only. The string that is
displayed depends on the point’s current value. Double-clicking on any of these resources brings up a data
entry dialog similar to that of (Figure 7-11) to allow you to enter a string.
7.3.99 Symbol
This resource is used with pmacros that are associated with just one symbol only. See paragraphs 7.2.7,
Pseudo Color Pmacro, paragraphs 7.2.11 Station Color Pmacro, and paragraphs 7.2.13, Status Color
Pmacro. Double-clicking on this resource brings up a library resource dialog similar to that of (Figure 7-9) to
allow you to select the desired symbol.
7.3.100 Symbol 0, 1, 2, 3, 4
These resources are used with station and point-related pmacros. They specify symbols to be used to display
the status of the point associated with the pmacro.
These symbols are used when there are no unacknowledged alarms on the station or point. For a station, they
specify the symbols to be displayed for each value of highest priority outstanding alarm. In this case, there are
five symbols to be specified (corresponding to five alarm priorities).
For a status point, they specify the symbols to be displayed for each possible state of the point. In this case,
there are four symbols to select (corresponding to four possible states of a status point).
For an analog point, these resources specify the symbols to display to show the sign of the point, as shown in
Table 7-7. In this case, there are three symbols to select.
Double-clicking on each of these resources brings up a library reference dialog similar to that of (Figure 7-9) to
allow you to select the desired symbol.
This resource is used with Mobile Icons only. It specifies the name of a status point whose current state is used
to select which symbol to display for the icon. Double-clicking on this resource brings up a data entry dialog
similar to that of (Figure 7-11) to allow you to enter a point name.
The tag flag consists of a single character that is displayed to indicate the point’s control state or highest level
tag. The characters used for this purpose are listed in Table 7-8.
The color of the displayed character is determined by a drawing style table specified by this resource. Double-
clicking on this resource brings up a library reference dialog similar to that of (Figure 7-9) to allow you to select
the desired drawing style table. See paragraph 4.3.5, Flags, for a description of what needs to be in a Tag Flag
drawing style table.
The value of this resource is meaningless if the Tag Flag Enable resource is set to “No”.
This resource is used with a variety of point-related pmacros. It specifies whether the point’s tag indicator is to
be displayed or not. Double-clicking on this resource brings up a check box dialog similar to that of (Figure
7-10) to allow you to toggle yes or no.
This resource is used to horizontally position the tag indicator relative to the origin of the pmacro. Double-
clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a
horizontal offset value (in world units).
The value of this resource is meaningless if the Tag Flag Enable resource is set to “No”.
This resource is used to vertically position the tag indicator relative to the origin of the pmacro. Double-clicking
on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to enter a vertical
offset value (in world units).
The value of this resource is meaningless if the Tag Flag Enable resource is set to “No”.
This resource is used with the display of numeric quantities by analog pmacros. If set to Yes, the thousands
separator is displayed in numeric values.
This resource is used with pmacros whose principal output is a text string. This includes the Analog Value,
Status Text, Pseudo Text, and Text Value pmacros. The Text Style resource specifies the text style to use to
display the string. Double-clicking on this resource brings up a library reference dialog similar to that of (Figure
7-9) to allow you to select the desired text style.
This resource is used with Time Value pmacros only. It specifies a string that contains time formatting codes.
Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to
enter the time format. The available formatting codes are listed in Table 7-9.
This resource is used with Analog History and Pushbutton Symbol/Bitmap pmacros. It allows you to define a text
string to be used to display a tool tip. Double-clicking on this resource brings up a data entry dialog similar to
that of (Figure 7-11) to allow you to enter a tool tip text.
By using the string \n as a separator, you can create multi-line tooltips. For example, Feeder\nLoads would be
displayed as:
Feeder
For pushbutton pmacros, a default tooltip is used if the Tool Tip Text resource is blank. For example, for a view
pushbutton, the tooltip shows the view name by default.
Normally, you should leave this resource undefined in the library definition of the pmacro, and specify it when
you add an instance of the pmacro to the map. But it’s ok to put something in as a default, so you can see what
the label looks like immediately when you put down the pmacro onto the map. Then you can edit the text.
This resource is used with Analog Bar and Analog Gauge pmacros only. It specifies the value of the associated
analog point above which the bar is to be displayed at its full length or the gauge is to be displayed at full angle.
Double-clicking on this resource brings up a data entry dialog similar to that of (Figure 7-11) to allow you to
enter an upper limit value.
The full length of the bar is defined by the Bar Length resource described in paragraph 7.3.9, Bar Length, while
the full angle value of the gauge is defined by the Angle Length resource described in paragraph 7.3.6, Angle
Length. There is also a Lower Limit resource that specifies the value below which the bar or gauge is to be
drawn with zero length. See paragraph 7.3.65, Lower Limit.
This resource is used with Station Color, Station Symbol and Station Bitmap pmacros to specify the name of a
view to go to when you click on the station symbol. Double-clicking on this resource brings up a data entry
dialog similar to that of (Figure 7-11) to allow you to enter the desired view name.
The “View Name” resource can also be used with Status Color, Status Symbol, Status Text and Status Bitmap
pmacros. If a view name is specified, the pmacro will operate like a station pmacro and jump to that view. This is
convenient if the status point is a calculated “summary point”, which represents the state of an arbitrary group of
points. See the Automation Database Editing Guide for more information.
This resource is used with Mobile Icons only. It specifies the name of an analog point whose value determines
the X coordinate of the mobile icon’s location within the map. The value of the X analog point is assumed to be
in world units. Double-clicking on this resource brings up a data entry dialog of the type shown in (Figure 7-14)
to allow you to enter or browse for the required point name.
This resource is used with Mobile Icons only. It specifies the name of an analog point whose value determines
the Y coordinate of the mobile icon’s location within the map. The value of the Y analog point is assumed to be
in world units. Double-clicking on this resource brings up a data entry dialog of the type shown in (Figure 7-14)
to allow you to enter or browse for the required point name.
This resource is used only by Analog History pmacros. If set to Yes, the analog history window will include an
entry for the present value of the point.
This resource is used only by Analog History pmacros. If enabled, the analog history window will include the
time of occurrence for each displayed value. This is used to identify the time at which a maximum or a minimum
value occurred.
These two resources are used only by Analog History pmacros. If enabled, the corresponding maximum or
minimum value will be included in the analog history display window. This will be the highest/lowest value seen
so far in this 15-minute interval. It is based on all values that have occurred, not just on periodic samples.
These resources are used only by Analog History pmacros. For each resource enabled, the corresponding
maximum or minimum value will be included in the analog history display window. This will be the
highest/lowest value seen so far in the current day, hour, or week. It is based on all values that have occurred,
not just on periodic samples.
7.3.118 Enable Previous 15M (Hour, Day or Week) Max (or Min)
These resources are used only by Analog History pmacros. For each resource that is set to Yes, the
corresponding maximum or minimum value will be included in the analog history display window. This will be the
highest/lowest value seen in the preceding 15-minute, day, hour, or week interval. It is based on all values that
occurred, not just on periodic samples.
This resource in the status colour/symbol pmacro allows you to specify that a warning message is to be
displayed between the Open/Close and Execute functions of a control sequence. The warning message
identifies the point name, description and the control about to be issued.
An example of an instantiated View pushbutton pmacro is shown in (Figure 7-64). In this example, only the
following were specified on instantiation:
The symbols used to display the pushbutton are specified by the Symbol 0 and Symbol 1 resources. The scale
factor on X- and Y-axis resources are used to magnify the pushbutton symbols independently in either direction.
The button label drawing style table, text style and x and y offset resources define how the label will look on the
pushbutton. The text of the pushbutton label is defined by the Button Label resource on instantiation.
When you click on the view pushbutton, the viewer takes you to the specified view. If the view named in the
Button Data resource does not exist, nothing happens when you click on the pushbutton.
Note: Sometimes it’s convenient to use a bitmap view pushbutton to act as a zoomable photographic
background for an area of the map. In order to facilitate the use of such “silent” pushbuttons, WorldView
doesn’t display a tooltip for view pushbuttons that have no defined views, nor does it display an error
message if such pushbuttons are clicked on when not in edit mode.
An example of an instantiated Graph pushbutton pmacro is shown in (Figure 7-65). In this example, only the
following were specified on instantiation:
It is allowed to assign a graph number zero to a pushbutton. Pushbuttons containing graph number zero can
also originate from SLDs that have been converted from Qwindows to WorldView
The appearance of the pushbutton in terms of symbols and label characteristics is defined in the same manner
as for a View pushbutton. See paragraph 7.4.1, View Pushbutton.
How to define graphs is described in Chapter 8, Trend Graphs, of the WorldView for Windows Operator’s Guide.
An example of an instantiated Task pushbutton pmacro is shown in (Figure 7-66). In this example, only the
following were specified on instantiation:
The Task pushbutton does not activate application programs directly. What it does is send “run” and “stop”
messages to a mailbox whose name is identified by the Button Data resource.
In the viewer, when you click on a task pushbutton that has dialog code 0, a Task Activation dialog appears.
When you click on Run and then Execute in the Task Activation dialog, a “run” request is sent to the mailbox.
When you click on Stop and then Execute, a “stop” request is sent. The application must already be activated
and must be written to service the mailbox.
The “run” and “stop” messages that are sent to the task mailbox can contain up to two arguments. If required by
the application, the values of these arguments can be specified by the Button Argument resources that are
described in paragraph 7.3.14 to paragraph 7.3.17.
Load Shed LSEXEC load control not used Sheds the Restores the
(VMS only) set # specified load. specified load.
WorldView does not allow you to run or stop command sequences unless you're logged into an account that has
the "Run Command Sequence" right. This applies to both VMS and Windows servers.
When you click on a task pushbutton that has a dialog code of 1, a menu is displayed (instead of the Task
Activation dialog). The items in this menu correspond to various values of the Button Argument 1 resource.
When you click on a menu item, a “run” command containing the appropriate Button Argument 1 value is sent to
the application.
In the case of the Command Sequencing application, such menus can be used to allow the operators to initiate
any command sequence that is listed in the menu. Or in AGC, such a menu can contain a list of AGC functions
that you wish the operators to be able to execute. Details on how to create task menus are given in section 7.5,
Menu Files, and more specifically in paragraph 7.5.1, Task Menu.
An example of an instantiated Note pushbutton pmacro is shown in (Figure 7-67). This pmacro uses a symbol
called Light Bulb as the displayed icon. Only the topic needs to be specified on instantiation:
When you click on a note pushbutton, a Note dialog appears even if you do not have the Edit Notes right and
allows you to view and print the note. The Note dialog displays the current contents of the note, and only if you
have appropriate privileges, allows you to modify the contents of the note.
An example of an instantiated Image pushbutton pmacro is shown in (Figure 7-69). When you click on an image
pushbutton, the image is displayed in a separate window that can be both relocated and re-sized. When re-
sizing, the image's aspect ratio, including any modification made by the X-Y scale factors, is preserved. The
image files can be in JPG, GIF or BMP format.
You specify the image file by double clicking on the Filename resource and browsing for the desired file. See
(Figure 7-70).
The following resources specify optional X and Y scale factors to be applied to the image when the image is
displayed:
All of the image files referenced by WorldView must be located in a single directory that is specified in the Image
Directory portion of the Options dialog. The reason for this is to make it easier for you to maintain your
WorldView databases on different computers. If the map contained the complete path to each image file, it
would be difficult for you to transfer a map from an operator workstation whose database is on a shared disk
drive to a dial-up laptop where the database is on drive C.
The image directory is stored in the registry, not in the map. This means that each computer can have its
images in a different directory.
You can have multiple image windows up at the same time. Each image window can be iconized and dismissed
via the usual buttons at the top right corner of the window.
An example of an instantiated External Data pushbutton pmacro is shown in (Figure 7-73). This type of
pushbutton allows you to retrieve a record from any OLE DB accessible database on the network and have its
contents displayed in a pop-up window.
You do not need the Survalent Technology ODBC driver or Excel SCADA Add-in to make use of this feature.
The target database is defined by a Microsoft Data Link file that is specified by the pmacro's Filename resource.
The Data Link file, which has a UDL extension, specifies a DSN (Data Source Name), which in turn specifies the
location of the database. How to create Data Source Names and Data Link files is described in section 7.6,
Creating DSNs and UDL Files.
The Filename resource stores only the filename, not the path to the UDL file. The UDL file must be located in
the qry folder of the standard directory. If your standard directory doesn’t have a qry folder, create one.
a record whose "NAME" column contains 005A will be retrieved from a table named "XFRMRS", and all
columns of that record will be displayed in a Dataview pop-up window. In the pop-up window, each column
value is displayed on a separate line, immediately preceded by the column name.
If your select statement is not specific enough, and multiple records are retrieved, only the first record is
displayed.
A separate instance of this External Data pushbutton is required for each piece of equipment for which you wish
to retrieve external data.
In order to use the External Data pushbutton, your PC must have a version of MDAC (Microsoft Data Access
Components) that is version MDAC 2.6 RTM (2.60.6526.3) or higher. If your version of MDAC is not high
enough, you may encounter an error message, but the data retrieval may still succeed. If you do not have
MDAC at all, WorldView will crash when you click on the External Data pushbutton.
You can obtain the latest version of MDAC from Microsoft’s web site. Make sure you download MDAC 2.6 RTM
and not MDAC 2.6 SDK (SDK is the developer's kit). During installation of the MDAC update, you may be asked
if it's ok to upgrade such things as Internet Explorer. We don't know what you get if you say no. Note that if you
have some Microsoft products such as SQL Server on your PC, you may already have MDAC 2.6 RTM.
An example of an instantiated Report pushbutton pmacro is shown in (Figure 7-75). This type of pushbutton
allows you to invoke a Microsoft Excel or Query report.
The reports and queries that can be brought up in this manner are the same ones that can be accessed from
the Reports and Queries tabs of the WorldView Graphs and Reports dialog. Your workstation must have
installed on it the Survalent Technology ODBC driver (if connected to a VMS host) or the Excel SCADA Add-in
(if connected to a Windows host) in order for you to be able to use this feature.
Although the report pushbutton was intended primarily to invoke files containing queries to the SCADA
database, it can be used for other purposes.
By selecting the All Files option, you can select any file that is contained in the qry folder, including a Word or
PDF document, or a database file such as an Access .mdb file. When you click on the pushbutton, the
application that is associated with the file will be invoked.
If the target file does not contain a query to the SCADA database, you don't need the Survalent ODBC driver or
Excel SCADA Add-in installed on your PC.
A task menu is a menu of parameters that can be sent to an application. In the case where the "task" is "seqpro"
(command sequencing), the menu is a menu of command sequences to activate.
In order to have a task pushbutton bring up a menu, you must set the value of the Dialog Code resource to 1.
The menu itself is defined in a text file whose filename is specified by the Filename resource. You can create
the menu files using Notepad.
When you double-click on the Filename resource, a Filename dialog appears that allows you to browse for the
desired menu text file. Although the browser allows you to go anywhere, your menu text files must be located in
the "wmp" folder of the "standard" directory within your WorldView database.
(Figure 7-79) contains an example of the menu that would appear for a menu text file defined as shown below:
$title="Reconfigure"
$pb_columns=2
26," Normal "
30," T1 and T2 parallel "
28," Shift all load to T1 "
29," Shift all load to T2 "
In the menu text file, the $title keyword specifies the title of the menu dialog. Each subsequent line defines one
menu item in terms of a numeric parameter and the text to be displayed for the menu item. In the case where
the task is the command sequence processor (Button Data = "seqpro"), the numeric parameters represent
command sequence numbers. In this example, when you click on "Shift all load to T1", command sequence
number 28 is activated.
By specifying a dialog code of 1 (Menu) in an analog pmacro, you can assign a menu file to an analog point. In
a manner similar to that of the task menu file described above, each line of the menu file specifies a numeric
value and a text string. On the map, the "value" that is displayed for the analog point is the text string from the
menu file that corresponds to the point's actual numeric value. When you click on the point, the menu appears in
a dialog. If you then select one of the menu items, the point's value is set to the menu item's corresponding
numeric parameter.
As an example, when you click on an analog point to which is assigned the menu file shown below, the dialog in
(Figure 7-81) would appear:
$title="AGC Mode"
$pb_columns=3
$ColorByValue
1,"Tie Line Bias"
2,"Constant Net Interchange"
3,"Constant Frequency"
If you select "Constant Net Interchange" from the menu in this dialog, the analog point's value would be set to 2.
This feature is useful for handling an analog point whose value is an integer that represents the state or mode of
a process. You could use it to control the operation of a command sequence. In the example above, the analog
point is used to specify the mode of calculating ACE to an AGC program.
ColorByValue, which is not assigned a value, is an optional keyword. If this keyword is present, WorldView
colors the analog value (which is a string from the menu file) according to its position in the menu instead of
using the point’s limit state. The colors used for this alternate coloring scheme are taken from a drawing style
table that is specified by the same resource used to specify the drawing style table for limit-based coloring.
As in the case for task menus, the menu files for analog points must be in the "wmp" folder of the "standard"
directory, and can be selected using the same Filename dialog as shown in paragraph 7.5.1, Task Menu. In
fact, you can see the AGC mode menu file in the Filename dialog of (Figure 7-78) above (it's called
agcmod.txt).
A view menu is a menu of any views you like, in any order that could be selected to be displayed.
In order to have a view pushbutton bring up a menu, you must set the value of the Dialog Code resource to 1.
The menu itself is defined in a text file (.txt), located in the wmp folder, whose filename is specified by the
Filename resource of the view pushbutton pmacro. You can create the menu file using Notepad.
As an example, when you click on a view pushbutton to which is assigned the menu file shown below, the dialog
in (Figure 7-83) would appear:
In the view menu file, each statement contains up to three comma-separated fields and defines a view. The
number at the beginning of the statement is not presently used, but should be set to 1 because a future
implementation of WorldView will use these numbers to produce a hierarchical menu. The next field is the actual
name of the view. The third field is the name that you want to appear in the pop-up menu. If this third field is
absent, the pop-up menu will simply show the actual view name.
With a Report pushbutton it is also possible to open a pop-up menu with desired SCADA reports. The menu file
format is the same as for a view menu:
nn,report_file{,menu_name}
As an example, when you click on a report pushbutton to which is assigned the menu file shown below, the
dialog in (Figure 7-84) would appear:
1,Scada_MinMax.lnk,MinMax Report
1,Scada_Tags.lnk,Tag Report
1,Scada_opLog.lnk,Operations Log Report
1,Module_History.lnk,Module History
1,Publish_History.lnk,Publish History
The menu file extension must be ".txt" and the file must be located in the wmp folder. A dialog code of 1 must
be assigned to the report pushbutton. The menu file must contain a list of shortcuts to ScadaReports.exe (if
Windows SCADA) or ReportView.exe (if VMS SCADA). The shortcuts themselves must reside in the qry folder.
(The shortcuts contain references to the SCADA reports in the command lines.)
A DSN is a thing that defines the location of a database. To create a DSN, invoke the ODBC Data Source
Administrator window from the Control Panel.
In the Create New Data Source window that appears, select the driver that is appropriate for the desired
database.
In the ODBC Microsoft Access Setup window that appears, type in the desired name and description of the
DSN. In our example, the name is KongSCADA05.
You can create a new UDL file by using the shortcut menu. Right-click in the folder where you want to create the
UDL file, and after selecting New, select Microsoft Data Link as the file type.
If you don't see Microsoft Data Link in the shortcut menu, just create a new Text Document and give the file a
UDL extension. Ignore the warning about the change in filename extension possibly making the file unusable
When done, click on OK to close the Data Link Properties dialog. Now all you have to do is put the UDL file into
your WorldView "qry" directory.
The "Missing Resource" report shows, for each missing resource, the name of the first object in the map that
references the missing resource (e.g. the name of the pmacro if a pmacro resource is missing). If a missing
resource is referenced by a text string object, the report displays the string value (which you can find using the
Find function).
The log file is overwritten each time Worldview starts (in order to avoid having it grow indefinitely). It therefore
only contains information about the most recently detected missing items. A sample of the log file is shown
below:
If the map contains missing objects (e.g. pmacros that do not exist), it’s important to not save the map until the
missing objects have been recovered. If you do save the map, the map will be saved without the missing
objects, and then it will be too late to fix.
If the map contains objects that themselves have references to missing resources (e.g. a pmacro or symbol that
references a missing drawing style), the missing resources will be either not be displayed or will be replaced by
defaults. But the objects themselves will remain in the map even if the map is saved.
For example, when the symbol editor displays a symbol that contains components in non-existent drawing
styles, the editor displays those components in the “dynamic” drawing style (which is displayed in white). If the
symbol contains a text string in a non-existent text style, the text string is not displayed. But when you click on
the text string, a selection rectangle is displayed showing the original extent (when the text style did exist), and
you can edit the text object and choose a new text style.
In order to export a symbol, pmacro or control panel, go into Edit mode in WorldView, and in the Library Selector
dialog, right-click on the desired object. You will see the Export function in the right-click menu.
Selecting the Export function causes WorldView to export the object, and all the resources it uses, into a zip file,
where the zip filename consists of a prefix, underscore, object name, underscore, and the object type (SYMBOL,
PMACRO or CPANEL). The output zip file is placed in the WorldView root directory (i.e. the directory that contains
the standard folder). Both the object itself and all of its resources will also have the prefix at the front of their names.
In the case of a control panel, the Export function follows all the pushbuttons to other pages of the control panel
and includes all pages of the control panel in the output zip file. So it’s not necessary to export every page. Just
export the first page.
The main purpose of the prefix in the object and resource names is to avoid conflicts with resources of the same
name that already exist in someone else’s database. In Windows SCADA, before you are allowed to export, you
must first enter an identifying prefix into the Share Resource Prefix field at the bottom of the WorldView page of the
System Parameters editor (SCADA Explorer). WorldView attaches this prefix to all objects and resources that it
In VMS SCADA, the prefix is defined by a logical name. Call Survalent customer service to have this set up for you.
All WorldView objects provided on the Survalent web site contain the prefix STC in the object names.
To import an object, go into Edit mode, and go to any of the three libraries mentioned above (symbol, pmacro or
control panel), right-click anywhere and select the Import function. An Import Shared Resources dialog appears to
allow you to browse for the desired zip file to import. After importing all the zip files you want, restart WorldView. No
need to do a Save.
Note:
• The resources in the zip file are organized by their appropriate folders (syl, pml etc), but they’re stored in text
format. So it’s not possible to unpack the zip files manually. You must use the Import function (which converts
the text files back into binary).
This chapter describes how to use the pull-down menus and button bars in a map window to edit a map. Only
the menus that contain editing functions, and only the editing functions in these menus, are described. Similarly,
in the button bars, only the buttons used for editing are described. Non-editing menus and functions are
described in the WorldView for Windows Operator’s Guide.
When you select this function, an empty map window appears within the main WorldView window, in which you
can draw stuff from scratch, as we did in Chapter 3, Getting Started. Or you can import a map from a DXF file
as described in Chapter 9, Importing Maps.
This function brings up an Open dialog that allows you to select a file to open. Select the map you wish to open
and then click on Open. A map window containing the desired map will appear.
The Open dialog defaults to files of type “Map (*.wmp)” and sub-folder Wmp. If you wish to open something
else, then choose a different file type (e.g. “Alarm View (*.alv)” or “Symbol (*.syl)”), and if necessary, a different
sub-folder, before clicking on Open.
This function is used to import maps from either DXF files or WorldView text files. This is described in Chapter
9, World Map Import.
8.1.4 Export
This function is used to export maps (or libraries) to WorldView text files. This is described in Chapter 9, World
Map Import.
This function is used to export complete maps as a text file. This is described in Chapter 9, World Map Import.
8.1.6 Save
This function saves the map you’re currently working on. If the map is a brand new map that has never been
saved before, then a Save As window appears to allow you to name the new map.
See paragraph 8.1.7, Save As.
8.1.7 Save As
This function is used to exclusively reserve the WorldView database (i.e. the map and all of the resource files)
so that only you can edit it. This is described in section 10.1, Change Control With Reservations.
This function is used to publish line sections to the online directories of both host computers. It need only be
used after you have edited line sections.
Line sections define the topology of a network (electric, gas and/or water) that is represented in the map. The
line section data is used by a topology processor to calculate the network connectivity. The calculated
connectivity data allows WorldView to dynamically color the line sections to show you what parts of the network
are energized/pressurized. Line section editing is an extension of the map editing function of WorldView, and is
described in the following document:
The functions contained in this menu are mostly duplications of the tools you can access either through the tool
bar or through a pop-up menu that appears when you right-click on an object in the map.
The Undo function, accessible from the Edit menu and via the standard Ctrl-Z keyboard equivalent, checkpoints
the “before” state of each object that is modified during an edit session. The list of checkpoints allows Undo to
step back through the modifications, and allows Redo to step forward again to re-create the modifications. The
size of the Undo list is 99. A separate Undo list is maintained for each document (map, control panel or
symbol). When the edited document is saved, its entire Undo history is discarded.
The checkpoints that are recorded (and therefore the actions that can be undone) include: insert (draw), delete,
move, resize, recolor, restyle and relayer. Cut and Paste is also undoable, although the content of the clipboard
before the Cut is not restored. Operations performed using the Alignment tools can be undone and redone, as
well as certain edits of groups (with the exception of delete).
8.2.2 Cut
Selecting Cut while one or more objects in the map are selected causes the selected objects to be deleted from
the map and copied to the Windows clipboard. Each new Cut or Copy overwrites the previous contents of the
clipboard.
There is a tool bar equivalent to the Cut function. The Ctrl-X keyboard equivalent also works.
8.2.3 Copy
Selecting Copy while one or more map objects are selected causes the selected objects to be copied to
the Windows clipboard. The objects in the map are not disturbed.
Each new Cut or Copy overwrites the previous contents of the clipboard.
There is a tool bar equivalent to the Copy function. The Ctrl-C keyboard equivalent also works.
When you select Paste, the mouse pointer becomes accompanied by an outline of the last thing that you cut or
copied to the clipboard. The outline follows the mouse pointer wherever you move it until you click. Where you
click is where the contents of the clipboard will be pasted.
There is a tool bar equivalent to the Paste function. The Ctrl-V keyboard equivalent also works.
Because you can select many objects at once (by drawing a selection rectangle around the desired objects),
and you can copy all of the selected objects to the clipboard at once, replication of complex entities in your map
is quite an easy task. Even complete substations can be replicated. (Figure 8-9) shows the substation of
(Figure 8-4), zoomed out somewhat, and having been selected and copied in its entirety to the clipboard, being
pasted in its entirely to the left of it.
The contents of the clipboard can be pasted as often as you wish. Note that you cannot paste objects into your
WorldView map from other Windows applications. You can, however, copy and paste between multiple map
windows within WorldView.
8.2.5 Clear
Selecting Clear while one or more objects are selected causes the objects to be deleted from the map but not
copied to the clipboard. The existing contents of the clipboard are not disturbed. Unlike Cut, you can’t undo this
function via a Paste.
While you are in Edit mode, the Find function can locate objects in the map for you, just as it does in operating
mode. Points, notes, and line sections can all be located by name, as well as background text. Refer to WV-
200, WorldView for Windows Operators Guide for more information.
In the Find Text function, there’s an option that allows you to replace all matching text strings by another string.
You must be in Edit mode to use this. In the Find dialog for Text, you will see:
8.2.7 Modify
The Modify function brings up dialogs that allow you to modify the properties of the selected object. Because
there are different dialogs for different types of objects, the Modify function cannot be used when several objects
are selected at the same time.
If the object you want to modify is part of a group, you can to use the Select Member function to access only the
desired object. See paragraph 8.2.8, Group, and the discussion of object selection in section 8.7, Edit Bar.
8.2.8 Group
The Group function allows you to group selected objects together to make them more convenient to manipulate.
To group objects together, use the Select tool in the Edit bar and enclose the objects in a selection rectangle, or
alternatively, click on each desired object while holding down the control (Ctrl) key.
Another purpose for grouping objects together is to associate multiple objects to a segment or line section.
Segments are described in paragraph 8.8.2, Segment. Line sections are described in the System Configuration
Status User’s Guide.
8.2.9 Ungroup
This function ungroups the objects that had previously been grouped together. To ungroup a group, select the
group by selecting any object in the group, and then select the ungroup function.
8.2.10 Alignment
There is also an equivalent alignment toolbar that can be obtained via the alignment pushbutton in the Edit
toolbar.
8.2.10.1 Left
8.2.10.2 Right
8.2.10.3 Top
8.2.10.4 Bottom
This function allows you to distribute the selected objects in a matrix of rows and columns. When choosing this
option, a dialog shown in (Figure 8-13) appears giving you two spacing options.
This function evenly spaces the selected objects within the rectangle that contains all of the objects.
You have to specify the number of elements desired in each row or column. WorldView then aligns the
objects accordingly.
In order to be able to preserve the order of the objects, WorldView assumes that the objects are already
approximately correctly arranged, just not perfectly aligned. If an object is so far out that WorldView
cannot decide where to put it, it leaves the object where it is.
This function evenly spaces the selected objects according to a grid that you specify in world units. As
above, you have to specify the number of elements desired in each row or column.
The origin of the grid can chosen to be either the Top-Left corner or the Bottom-Left corner of the
selection rectangle. If you select Top-Left, the grid extends rightwards and downwards. If you select
Bottom-Left, the grid extends rightwards and upwards.
This function allows you to make the selected objects the same height as the:
maximum height object, or
minimum height object
This function allows you to make the selected objects the same width as the:
maximum width object, or
minimum width object
This function allows you to make the selected objects the same size as the:
biggest object, or
smallest object
This function allows you to change the station name of all the points in a group of pmacros. Select a group of
objects (drag a rectangle around them, or hold Ctrl and click on each one), right-click and choose Change
Station from the menu.
In the Change Station dialog that appears, use the browse buttons to select the station that you wish to change
from and the station that you wish to change to.
8.2.12 Front
This function causes the selected object(s) to be placed in front of all other objects that are in the same layer.
The selected objects that move to the front will block out objects that are behind them. Unfilled objects are
transparent: only the lines of these objects will block out other objects.
Use this tool to place the selected object(s) behind all other objects. Select an object(s) and then select Edit,
Back. The selected objects will move to the back and be blocked out by objects in front of them. Unfilled picture
objects are transparent. Only the lines of these will block out the objects moved to the back.
8.2.14 Recolor
Recolor applies the current drawing style to the selected objects. To use this function, select a drawing style
from the Drawing Styles tab in the Library Selector. Then select the object(s) to be recolored and then, from the
Edit menu, select Recolor. Alternatively, you can right click on any of the selected objects, and select Recolor
from the pop-up menu.
You can recolor all graphics primitives (basic shapes). You can also recolor the parts of symbols that are drawn
in the {dynamic} drawing style. You cannot recolor the other parts of symbols from the map editor. Recoloring
the non-{dynamic} parts of an existing symbol may only be done from the symbol editor. Note that this will affect
all instances of the symbol in the map. If a symbol being edited contains other symbols, only the {dynamic} parts
of those other symbols can be recolored.
8.2.15 Restyle
This function applies the current text style to the selected text string objects. To use this function, select one or
more text objects, select a text style from the Library Selector, and then select Restyle from the Edit menu. The
selected text will be given the font, type and size of the selected text style.
8.2.16 Relayer
This tool can be used to move the selected object(s) to the currently selected layer. First, select a layer using
the Layers button. See section 8.10, Layers, for further details. Select one or more objects, and then select
Relayer from the Edit menu (or right-click and select Relayer from the pop-up menu). This will move the
selected object(s) to the selected layer.
The Nudge functions can be used to nudge the positions of one or more selected objects Up, Down, Left or
Right, After selecting one or more objects, select the desired direction from the Edit menu or by operating the
arrow keys. There is no Undo for nudge operations.
If the object you want to modify is part of a group, you can use the Select Member function to access only the
desired object. This function is accessible through a pop-up menu that appears when you right-click on an
object in the map. This function is described in paragraph 8.8.3, Select Member.
Only the items relevant to editing are described below. The other functions are described in the WorldView for
Windows Operator’s Guide.
Selecting this function toggles WorldView between view mode and edit mode. You must be logged into a
privileged SCADA account in order to be able to go into edit mode, and you must be in edit mode in order to do
any editing. When you go into edit mode, an Edit bar of edit buttons appears. The Edit bar is described in
section 8.7, Edit Bar. The Edit bar is removed when you return to view mode.
There is a navigation bar equivalent for this menu function. It’s called the Edit button.
The Edit Tools function is a toggle button that either displays or hides the edit toolbar. The Edit button in the
navigation bar does the same thing. The Edit bar is described in section 8.7, Edit Bar.
The Alignment function is a toggle button that either displays or hides the alignment toolbar when you are in Edit
mode. There is an Edit toolbar equivalent for this menu function.
It is called Toggle Alignment pushbutton.
This toggle function allows you to turn on or off background images in a map.
This function brings up the Views and Layers window shown in (Figure 8-16).
The pane labeled Layers shows a list of all of the layers that are in your map. From this pane, you can create,
modify and delete layers. From here, you can also set each layer into either automatic or manual declutter
mode. For each layer, you can specify the auto-declutter zoom limits to be used for when that layer is in auto-
declutter mode.
Like views, layers can be organized hierarchically in folders and sub-folders. Although each layer must have its
own declutter limits, it is possible to toggle entire folders of layers between automatic and manual declutter
mode in a single operation.
The pane labeled Layer Drawing Order shows the order in which the layers are drawn. Within each layer, the
elements contained in that layer are drawn in the order in which you put them into the map. You can override
this order by using the Front and Back functions described in paragraphs 8.2.12, Front, and 8.2.13, Back. You
can also specify the order in which the layers themselves are to be drawn by editing the list contained in the
Layer Drawing Order pane. This gives you lots of control over the display of overlapping objects in your map.
The Feeders pane shows all your feeders, organized first by station transformer and then by substation
transformer, and allows you to enable or disable display of feeders. This is described in the WorldView for
Windows Operator’s Guide.
A detailed description of how to create and manage layers is provided in section 8.10, Layers.
This function brings up the Library Selector window shown in (Figure 8-17). The Library Selector is a multi-
paned window that shows all of the WorldView components that can be used in your map. This includes drawing
styles, text styles, symbols and pmacros. The creation and use of all of these components have been described
throughout this document.
A button bar equivalent for the Library Selector function is available in the Edit toolbar. This function is only
available when you are in edit mode. The function in the menu is dimmed if you are in view mode.
The extent of the map is the smallest rectangle that completely encompasses everything that’s in the map.
The Current pushbutton allows you to adjust the extent of the map by panning and zooming to the desired view
and then just clicking on the Current button.
This function brings up a Grid dialog that allows you to define a grid and turn it on and off. The grid allows
graphics and library components to be accurately placed and sized on the map.
The grid is defined in world units in terms of both spacing and offset, both of which can be specified
independently for the horizontal (X) and vertical (Y) directions. (Figure 8-21) illustrates a visible grid.
If the grid spacing corresponds to less than a few pixels, it is not displayed even if the Grid Visible check box is
checked.
WorldView contains a function that reorganizes the storage of the map so as to optimize the speed at which that
map can be redrawn when you navigate.
The storage reorganization is based on variable-sized tiling. The optimization threshold is the number of
elements to be placed in each tile. Very large values of the optimization threshold produces very large tiles and
hence little optimization. Very small values of the optimization threshold, on the other hand, cause so many tiles
to be produced that the speed improvement is outweighed by the overhead of tile management.
In the present implementation of WorldView, repeated use of the Optimize Map function produces diminished
results. For now, it’s best to use it just once immediately after DXF import.
This function allows you to obtain a report on the contents of the map. The report is produced in a text file that
you name. Included in the report file are: the map extent, a list of all the layers, and for each layer, the number
and extent of the graphics contained in that layer. At the end, the report indicates the total number of graphics
primitives and layers that are contained in the map.
When you click on Save, the report file is produced. The report file for the small station map shown in (Figure
8-4) is shown in (Figure 8-24).
This function makes toggling the grid on or off more convenient during editing. A Ctrl+G keyboard equivalent is
provided, and a button bar equivalent for the Grid Enabled function is available in the Edit toolbar. This function
is only available when you are in edit mode. The function in the menu is dimmed if you are in view mode.
Cut Cut object(s) from the map and copy to the clipboard
Paste Copy items from the clipboard onto the map or symbol
Print Print
Views and layers List Open the Views and Layers pop-up window
8.6.1 Layers
This function brings up a drop-down menu containing the directory structure of the layers. To select a
layer to draw in, locate the desired layer by navigating through the structure and then click on the Select item.
The two other options, Visible and Auto Declutter, are used to control the declutter mode. Clicking on Visible
takes the layer out of automatic declutter mode, places it in manual mode and if the layer was previously
invisible by virtue of being auto-decluttered off, makes the layer visible. The next time you look at this layer, the
check mark beside Auto Declutter will no longer be there (indicating that the layer no longer auto decluttered)
and a check mark appears beside Visible. If you subsequently toggle the Visible option off, the layer is not
placed back into auto declutter mode. To place the layer back into auto declutter mode, you can click on the
Auto Declutter option.
Clicking on Select sets that layer active for editing, each layer has its own Auto Declutter settings. Only one
layer can be selected at a time. The selected layer will have a checkmark beside Select for that layer. This is the
only way to determine after the fact which layer is selected for editing. Therefore if you are editing a world map
with a large number of layers, it is recommend that you make a record of each layer as you select it. See
section 8.10, Layers, for more details on layers.
This performs the same function as the Tree Lists item in the View menu. See paragraph 8.3.5, Tree Lists.
This toggles between edit mode and view mode, and is equivalent to the Edit Bar item in the View menu. See
paragraph 8.3.1, Edit Bar.
8.7.1 Select
The Select tool allows you to select objects that are already in the map. After selecting this tool, place the
tip of the mouse pointer over the object you want to select and then click.
You can:
• resize the object in the horizontal direction by clicking on either the left-middle or right-middle handle and
dragging the handle to the left or the right
• resize the object in the vertical direction by clicking on either the top-middle or bottom-middle handle and
dragging the handle upwards or downwards
• resize the object in both directions at once by clicking on any corner handle and moving diagonally
The Select Member function allows you to select an individual object that is part of a group. This is described in
section 8.8, Groups, and in particular, paragraph 8.8.3, Select Member.
You can select multiple objects simultaneously by using the mouse to drag a box around the objects you want to
select. The objects will be highlighted individually by dimmed selection rectangles and in their entirety by one
active selection rectangle that encompasses all of the selected objects. See (Figure 8-9) for an example of this.
The objects must be fully inside your selection box to become selected. Furthermore, only objects that are
visible (not decluttered off) will be selected.
When multiple objects are selected, the individual selection rectangles are not active (i.e. you can’t click on any
of their handles to manipulate individual objects). The main selection rectangle that surrounds all of the selected
objects is partially active:
• The entire set of selected objects can be moved by dragging the mouse in the same way as for a single
object.
• The corner handles can be used to resize the entire set of objects together but only so constrained as to not
change the aspect ratio of the object set.
• The Modify function in the pop-up menu that appears when you right-click is not active (because the
required Properties dialog is not unique). The other functions in the pop-up menu, such as Recolor, Restyle,
Relayer, Cut etc can be used, however.
The constrained re-size action described above for selections of multiple objects also applies to symbols and
pmacros. If you wish to change the aspect ratio of symbols or pmacros, you can do so by editing their X and Y
Scale Factor attributes using the appropriate Properties dialogs (which you can access via the Modify pop-up
function).
Note: The "escape" key can be used to cancel a current selection of an object in the map.
This performs the same function as the Library Selector item in the View Menu. See paragraph 8.3.6, Library
Selector.
This performs the same function as the Library Selector item in the View Menu. See paragraph 8.3.6, Library
Selector.
8.7.5 Line
This tool allows you to draw lines. After selecting this tool, move the mouse pointer to where you wish to
start a line, hold the mouse button down and drag the mouse to create the line. Holding down the shift key as
you do so will make your line either perfectly horizontal or vertical.
The Point Properties dialog also shows the coordinates of the start and end points of the line, as well as an
empty check box named Filled. You can modify any of the coordinates by double-clicking on them in the Point
Properties Dialog. An X-Y Coordinates dialog appears to allow you to modify the selected coordinates.
Note that you cannot add coordinates to a line. You can only modify them. By clicking on Apply, you can see the
changes you have made before you dismiss the Point Properties dialog. You can use Undo to revert back to
what you have in the Point Properties dialog. There is no undo after you dismiss the Point Properties dialog.
Checking the Filled box has no effect on a straight line. We’ll see its uses later with other objects. (The Point
Properties dialog is used with rectangles and polylines as well as with individual lines. A rectangle or polyline
contains a list of coordinate pairs that correspond to each vertex of the object plus one more: the very last
coordinate pair is a repeat of the first coordinate pair.)
This tool allows you to draw unfilled rectangles. After selecting this tool, move the mouse pointer to one
corner of where you wish to create the rectangle, hold the mouse button down and drag the mouse to the
opposite corner. Holding down the shift key as you drag will make your rectangle a perfect square.
This tool allows you to draw filled rectangles in the same manner as described above for unfilled
rectangles.
The Filled check box, which shows whether the rectangle is presently filled or not, can be toggled to turn an
unfilled rectangle into a filled rectangle and vice versa.
8.7.10 Ellipse
This tool allows you to create ellipses. After selecting this tool, you create the ellipse by defining a
bounding box (rectangle) that would contain the ellipse.
Click on one corner of this bounding box, hold the mouse button down and drag the mouse to the opposite
corner of the bounding box, and then release the mouse button. Your ellipse will be created inside the invisible
box that you just defined. Holding down the shift key as you drag the mouse causes your ellipse to be a perfect
circle.
This tool allows you to draw filled ellipses in the same manner as described above for unfilled ellipses.
8.7.12 Arc
This tool allows you to draw an arc. Move the mouse pointer to one corner of where you wish to create
your arc, hold the mouse button down and drag the mouse to the opposite end of the arc. Your arc will default to
being ¼ of an ellipse, or ± 90° of a circle.
This tool allows you to draw a filled arc in the same manner as described above for an unfilled arc.
Select your Filled Arc and open the Arc Properties Dialog box, shown below in paragraph 8.7.14. You will see
the Layer and Drawing Style you selected, the co-ordinates of the Ellipse points that the Arc is part of, the Start
angle and Angle total, the mode and the style. You can convert your Arc to an ellipse or longer or shorter arc by
changing the Angle values, e.g. change 90 to 180 degrees and get half an ellipse. You can change to a non-
filled are.
The X-Y coordinates shown in the Arc Properties dialog are the coordinates of the arc’s bounding box. The first
set of coordinates is that of the top left corner of a box that would surround the ellipse. The second set of
coordinates is that of the bottom right corner of the bounding box. The coordinate values can be edited.
Arcs, ellipses, and circles are all handled the same way in the Arc Properties dialog.
If you draw an arc and check its XY coordinates, you will find that the corners of the bounding box that you used
to draw the arc are not at the coordinates shown in the Arc Properties dialog. This is because an arc is
The Start Angle and Angle Length fields in the Arc Properties dialog allow you to convert an ellipse to an arc
and vice versa, and to modify the orientation of an arc.
The value of Start Angle for all ellipses defaults to zero. Arcs created from left to right have a starting point of 0°,
and arcs created from right to left have starting points of 180°.
The value of Angle Length for all ellipses is 360°. The angle of arcs defaults to 90° ± as shown in the diagram.
You only need to modify the Start Angle and Angle Length of Arcs. If you change the Start Angle of an Arc to
180 and the Angle Length to 180 and click apply, you will get the bottom half of an ellipse. Changing the Angle
Length to 270 will change its appearance to ¾ of a pie. All Ellipses and Circles are 360 but changing the Angle
will change them to part ellipses or Arcs.
In the Arc Properties dialog, there is also a Mode and Style selection. There are three Modes and two Styles
which control how your ellipse will appear. Filled is self-explanatory. Closed causes the ends of the arc to be
joined, but Open does not join the ends of the arc.
Style affects the appearance of the open part of your arc. Pie indicates that your arc will be joined by two lines
from the ends of the arc joined at the center of the arc. Chord indicates that one line will be drawn between the
ends of the arc.
Table 8-1 illustrates how an ellipse would change as the Start, Angle, Mode and Style fields are modified.
This tool allows you to draw a closed polygon. After selecting this tool, click where you want your polygon
to start. It’s not necessary to hold the mouse button down for this. Click on each vertex that you want in your
polygon, and then double-click on the last vertex. You don’t have to draw a line back to the first point. The last
line that links to the starting point will be created automatically.
This tool allows you to create a closed polygon. The procedure is the same as that described above for a
closed polygon.
This tool allows you to draw an open polygon. The procedure is the same as that described above for a
closed polygon.
Select this tool and click where you want your polygon to start. You do not need to hold down the mouse button
for this operation. Click on each co-ordinate that you want in your polygon, and double click on the last point.
This tool allows you to add text to the map. After selecting this tool, click where you want the text string to
start. A String Properties dialog will appear. Enter the desired text string into the String data entry field and then
click on OK.
Any text string that you add will be in the text style, layer and drawing style that you last selected using other
tools. If you wish to change any of these, you can use the Restyle, Relayer and Recolor functions described in
earlier sections of this chapter.
If you wish to adjust the X-Y position of the text string, or the justification, orientation or rotation of the text string,
you can do so via the String Properties dialog of (Figure 8-33). You can access the String Properties dialog by
right-clicking on the text string and selecting the Modify function from the pop-up menu that appears.
If the text string is horizontally oriented, the entire line of text is rotated by the angle that you specify. If the text
string is vertically oriented, then each character will be rotated by the angle that you specified, but the text string
will still be vertically oriented.
8.7.21 Symbol
This tool allows you to add a symbol to the map. After selecting this tool, just click where you want the
symbol to be added. The symbol will appear at the selected location. To move or re-size the symbol, you can
select the symbol (using the Select tool) and then move by dragging or re-size using the handles on the
selection rectangle that highlights the symbol.
If you right-click on a symbol and select the Modify function from the pop-up menu, a Symbol Properties dialog
appears for the selected symbol. The Symbol Properties dialog identifies the layer of the symbol. You can
modify the layer that the symbol is in by using the Relayer function.
This tool allows you to add a pmacro to the map. After selecting this tool, just click where you want the
pmacro to be added. The pmacro will appear at the selected location. If the pmacro is a status point pmacro, the
symbol and color used to display the pmacro will be those that correspond to State 0, with no unacknowledged
alarms. If the pmacro is an analog pmacro, a string of question marks is displayed in the color that corresponds
to the point’s normal range (no limit violations). The number of question marks after the decimal point
corresponds to the value of the Precision resource of the pmacro. In both cases, all of the indicators (condition
code, tag flag and alarm blocked flag) that are enabled are displayed with the pmacro.
To move or re-size the pmacro, you can select the pmacro (using the Select tool) and then move by dragging or
re-size using the handles on the selection rectangle that highlights the pmacro.
If you right-click on a pmacro and select the Modify function from the pop-up menu, a Pmacro Properties dialog
appears for the selected pmacro. The Pmacro Properties dialog identifies the layer of the pmacro. You can
modify the layer that the pmacro is in by using the Relayer function.
The XY coordinate fields in the Pmacro Properties dialog show the exact location of the pmacro in the map, and
can be modified if desired.
Any overrides (resource values) that you defined for the pmacro when you created the pmacro in the Pmacro
library are now shown as default values in the Pmacro Properties dialog for the instance you just put down on
the map. You can override the values of any of these resources for just this particular instance of the pmacro by
double-clicking on the resource name and entering the override value into the resource dialog that appears. See
Chapter 7, Pmacros, for a detailed description of all of the available pmacro resources for each class of
pmacro, and how to modify them.
If an instance of a pmacro has a resource with an override value, the override value is displayed in the Override
column of the Pmacro Properties dialog. Any override value can be removed by selecting the corresponding
resource name and clicking on the Remove Override button. Any override value that is added or removed is
immediately applied to the displayed pmacro without requiring the use of Apply.
It has previously been mentioned that per-instance overrides should be used with care (because it can render
making global changes quite difficult). There is one resource, however, that should be left blank in the library
pmacro definition and should be overridden on a per instance basis. This is the Point Name resource, which
normally would have a different value (point name) for each instance in the map.
Note that if you do wish to display the same point more than once in the map (using multiple pmacros), the
editor lets you do so. You can, for example, display a voltage or current for a feeder coming out of a substation
at the substation’s zoom level, and then display the point again at a higher (zoomed out) feeder level. Use of
separate layers with appropriate declutter levels would prevent the two pmacros from be displayed
simultaneously.
To assign a point name to an instance of a pmacro, double-click on the Point Name resource name in the
Resource column of the Pmacro Properties dialog. A Point Name resource dialog will appear containing a data
entry field for a point name, Type in the desired point name and click on OK.
If the point name that you enter does not exist on the host computer, or if it is not of the correct type for the
pmacro, then an error message is displayed. In this case, you can correct the mistake and click on OK again.
Alternatively, you can browse for the point. If you click on the Browse button in the Point Name resource dialog,
a Point Browser window will be displayed, containing a scrollable list of stations as shown in (Figure 8-38). The
list contains the names and descriptions of all of the stations that are in the host system, in alphabetic order of
station name.
When you click on the desired point name, the Point Browser window is dismissed and the selected point name
is displayed in the Point Name field of the resource dialog.
When you click on OK in the resource dialog, the resource dialog will be dismissed and the point name will
appear in the Override column of the Pmacro Properties dialog.
When you click on OK in the Pmacro Properties dialog, the pmacro is now attached to the point. If you get out of
edit mode (by toggling the Edit button in the navigation bar), and click on the pmacro, you’ll get a control dialog
that allows you to operate the point (see (Figure 8-42)). You can get right back into edit mode by again toggling
the Edit button.
Another reason for grouping objects together, however, is to be able to associate multiple objects to one
element in the SCADA database. There are presently two types of database assignments that can be made for
groups:
Segment
If you define a group to be a Segment, it becomes assigned to a status point. Everything in the group will be
colored according to the current value of the status point. This is described in paragraph 8.8.2, Segment.
Line Section
If you define a group to be a line section, it becomes assigned to a record in the line section database.
Everything in the group will be colored according to the current connectivity status of the line section (energized,
de-energized, paralleled, looped, etc). This is described in the System Configuration Status User’s Guide.
To create a group, select the objects that you wish to group by using the procedure described in paragraph
8.7.1, Select. Alternatively, you can control-click on each object. You may have to use the latter if objects you
don’t want in your groups are mixed in with the ones you want. Either way, each object select will have its own
selection rectangle plus one that surrounds all of the selected objects.
This creates the group. Next time you click on any element of the group, the entire group will become selected
and highlighted by one selection rectangle that surrounds the group. Individual selection rectangles for each
element will no longer appear.
8.8.2 Segment
The purpose of segments is to color-code parts of your map according to the value of status points, which may
be telemetered or calculated. If you don’t have the System Configuration Status program on your system, and if
your network is not too complex, you can use calculated status points assigned to segments to show the
energized/de-energized or pressurized/un-pressurized status of your network.
As you may guess, segments are implemented in WorldView by special pmacros that have no counterpart in the
pmacro library. That is, you cannot create segment pmacros in the pmacro library. You can only create them by
creating groups and then turning groups into segments using the Group sub-menu described immediately
above.
In the Pmacro Properties dialog for a segment, there are three resources that you can specify. The two drawing
style table resources specify drawing style tables that are used to color the segment (i.e. the group) according to
the current value of the status point. The NAK Drawing Style table is used when the status point has one or
more unacknowledged alarms. The Normal Drawing Style Table is used when the status point has no
unacknowledged alarms. Each table should have four drawing styles in it. To specify the desired drawing style
table, double-click on it, and in the Library resource dialog that appears, find and select the desired drawing
style table.
Figure 8-47 NAK Drawing Style Table Resource Dialog for Segment
The Point Name resource specifies the name of the status point that is to drive the coloring of the segment. To
enter the point name, double-click on the resource name in the Resource column, and in the Point Name dialog
that appears, enter the point name directly or use the point name browser as described in paragraph 8.7.25,
Attaching a Point Name to a Pmacro.
When you right-click or double-click on a group that is not associated with a segment or a line section, and
select Modify, a pop-up window appears to show the internal identifier of the group. There are no modifications
that you can make to the group via this window. (The move and re-size functions that you can perform can only
be done by dragging and re-sizing the group’s selection rectangle.)
When you right-click on a group that is assigned to a segment, and select Modify, the segment Pmacro
Properties dialog of (Figure 8-46) appears. This dialog allows you to modify the definition of the segment (i.e.
the resource values of the segment pmacro) but it does not allow you to modify the group itself.
When you right-click on a group that is assigned to a line section, and select Modify, the SCS Line Section
Editor window appears. This window allows you to modify the definition of the line section record but does not
allow you to modify the group itself.
So how do you modify any of the elements in a group without ungrouping (especially since you can ungroup a
segment or line section)? To access an individual element in a group, you use the Select Member function in
the right-click pop-up menu.
First click on any element in the group. The entire group will be highlighted, and the handles will be colored
magenta. Then right-click on the element that you want to access, and in the pop-up menu that appears, choose
Select Member. When you do so, the group highlight disappears and the selected element becomes highlighted
alone (and the handles become colored yellow). Now you can move it or re-size it via its handles, or you can
right-click on it and use the editing functions that are in the pop-up menu. You can even cut the element from
the group (but you can’t undo it and presently, you can’t add new objects to an existing group).
8.9 Views
A view is like a bookmark to a particular place in the world map. Each view has a name. You can create any
number of views and organize them in a hierarchical fashion in a tree list. You can also assign views to
pushbuttons. When you click on a view pushbutton, you’re taken immediately to the view that is assigned to that
pushbutton.
When you save a view, you also save the current auto/manual declutter settings for all of the layers that are in
the map. This means that it is possible to create a view with some layers showing that would not normally show
when in auto declutter mode.
To create a named view, first use any navigation tools you like to bring the desired view into the map window.
Then invoke the Views and Layers window by Views and Layers Lists button in the navigation bar or by
selecting the Tree Lists function in the View pull-down menu.
If in your view, you want to override the automatic declutter of any layers (i.e. manually turn on layers are
normally off at this zoom level, or manually turn on layers that are normally off), then do this now using steps
described in section 8.10, Layers.
In the Views pane of the Views and Layers window, right-click on the Views folder as shown in (Figure 8-50).
If you find later that the view is too large or too small, you can adjust it by navigating and then right-clicking on
the view name. Select Modify View from the pop-up menu. The same View dialog of (Figure 8-51) will appear.
In the Edit Views dialog, click on the Current button. This set the X-Y coordinate values in the View dialog to the
corners of the map window. When you click on OK, the view definition is updated.
There is no mechanism to change the view name of an existing view. If you modify an existing view and change
the view name in the View dialog, a confirmation dialog appears asking if you wish to create a new view with
that name.
You can specify a background image for your view by clicking on the Background Image button in the Edit
Views dialog. This brings up an image file browser dialog that allows you to select the desired image.
You can specify whether you want the background image stretched to fit the screen or not. If you don’t specify
stretch to fit, the image is displayed at the top left of the screen. This is a useful option that allows you to
incorporate your company logo in the default view.
The image files that can be used for background images must be located in the image directory that is specified
on the Directories page of the Options dialog. This is the same directory that contains the pop-up photos. See
paragraph 7.4.5, Image Pushbutton.
A background image is not considered to be an object that shifts or scales when you pan or zoom. The
background image that is associated with a view is displayed only while you’re looking at that view. As soon as
you begin to navigate away from the view, whether it’s by panning or zooming, the background image
disappears.
If you add your company logo to your default view, you may find that it shows up fine when you click on the
Home button but it doesn’t appear when WorldView starts up and automatically opens the map and displays the
initial view. This is because when you save the startup configuration (via the Save Configuration function), it’s
not the name of the current view that’s memorized. It’s the coordinates of the current view. (This initial view at
startup doesn’t have to be the default view, and in fact, doesn’t even have to be a named view at all.) WorldView
does memorize the fact that a background image was displayed at the time the configuration was saved,
however. So all you have to do after you add the logo is re-save the desired configuration.
To delete a view, right-click on the view name and select Delete from the pop-up menu. A confirmation dialog
will appear to which you must answer yes if you really want to delete the view.
When you click on OK, the folder will be added to the list of views and folders, as shown in (Figure 8-61). Note
that the list is not sorted for you. Anything new is added to the bottom, and you re-arrange the list and move
things into folders as described in paragraph 8.9.7, Organizing Views.
To rename a folder, right-click on the folder and then select Rename Folder from the pop-menu. Type in the new
folder name into the Enter Name Of Folder dialog that appears, and click on OK.
A folder cannot be deleted unless it is empty. To delete an empty folder, right-click on the folder and select
Delete Folder from the pop-up menu. A confirmation dialog appears, to which you must answer Yes if you really
want to delete the folder.
Folders can be moved in the same way. To move a view into a folder:
Note that you must release the mouse button over the target folder’s icon, not its name. If you release the
mouse button while the mouse pointer is over the folder’s name, you will move the view to the position after the
folder at the level of the folder (instead of inside the folder).
The Views list behaves like a Windows Explorer directory structure. If a folder contains views or other folders, it
has a plus sign “+” beside it. When you click on the plus sign or double-click on the folder icon or name, you
open the folder. The folder’s contents are now displayed, and the folder has a minus sign “-“beside it. Clicking
on the minus sign or double-clicking on the folder will close the folder and hide its contents.
Note that folders can be placed inside other folders to create a multi-level hierarchy of views.
8.10 Layers
Layers in a world map are like a stack of transparencies. Every object in the map is in one and only one layer.
The set of objects in a layer can be turned on or off (i.e. appear or disappear from the screen). This is called
decluttering. The decluttering for each layer can be set to either automatic or manual mode. A layer that is in
auto-declutter mode automatically turns off all of its objects when you navigate outside the layer’s assigned
inner and outer zoom limits. A layer that is in manual declutter mode can be turned on or off manually.
Worldview does not limit the number of layers that you can create. The more layers you have, the more
declutter control you have on your map.
When you import maps from DXF files, the layers that are in the DXF file are preserved in the WorldView map
file. After the import, you can set the auto declutter levels for each layer.
If you re-import an updated version of a DXF file that you previously imported, then you can specify that the
contents of the layers in the new DXF file should replace the contents of the corresponding layers in the working
map. Because of this, it’s very important to create new layers for objects that you add to the map using the
WorldView editors. If you do this, then you can re-import the layers of an updated DXF file without disturbing the
layers containing your own artwork.
To set the minimum zoom level for automatic decluttering, zoom out to the desired level (where the objects are
at the smallest size that you wish to see) and right-click on the desired layer name in the layers list. In the pop-
up menu that appears, select Modify.
Note that a scale value of –1 may be used to indicate that the zoom limit is “infinite”. For example, if the Zoom
Out Declutter Point is set to a positive value and the Zoom In Declutter Point is –1, then the layer will be off until
you zoom in to the zoom out declutter point, and will then stay on indefinitely as you zoom in deeper (i.e. there is
no second zoom level at which the layer will declutter off again).
The Edit Layers dialog contains a Layer Mode radio button. The choices are:
• AUTO
The layer is automatically decluttered if not manually set in the view (to either ON or OFF).
• MANUAL OFF
The layer is manually set to OFF, unless explicitly manually set to ON in the view.
The name of an existing layer cannot be changed. If you attempt to modify the name of an existing layer via the
Edit Layers dialog, a confirmation dialog appears asking if you wish to create a new layer.
To delete a layer, right-click on the desired layer name and select Delete from the pop-up menu. A confirmation
dialog will appear. If you really want to delete the layer, select yes.
You can control the order in which layers are drawn by modifying the order of this list. A layer name can be
moved within the list by clicking on the layer name and dragging it to a new position in the list. The layer will be
moved to immediately after the position where you release the mouse button.
Note that you don’t have to be in edit mode to modify the layer drawing order, but you do have to be logged into
a SCADA account and you do have to remember to save the map.
As in the case of views, you can hierarchically organize your layers in folders.
The new folder will be added at the bottom of the “root directory” list. You can re-arrange the list of layers and
folders, and put layers (and even folders) into folders. The procedure for doing this is identical to that described
for views in section 8.9, Views.
Folders can be renamed or deleted by using the Rename Folder or Delete Folder items in the right-click pop-up
menu. The Sort Folder function can be used to sort the contents of a folder in alphabetical order. This is
particularly useful after your first DXF import before you’ve created any folders.
You can open a folder by clicking on the folder’s plus “+” sign or double-clicking on its icon or folder name. You
can close a folder by clicking on its minus sign “-“or again double-clicking on the folder’s icon or folder name.
(Figure 8-75) shows an example of a map in which the layers have been organized into a multi-level system of
folders. In (Figure 8-75), layers AB-1 and AB-2 are manually set to on, while the remaining layers in the
“aberdeen s/s” folder are in auto-declutter mode and are turned off.
Setting the declutter modes of layers is described in the WorldView for Windows Operator’s Guide.
• Folder Auto
• Folder Manual
and when in manual mode, to turn all of the layers contained in the folder on or off:
• Folder On
• Folder Off
Note:
• Modifying or rearranging the views and layers of the map is not allowed unless you have map editing
privilege.
• A tooltip on the layer list pushbutton shows the currently selected layer.
This chapter describes how to import maps from other sources into WorldView for Windows.
Section 9.1, DXF File Import, describes how to import DXF files from other drawing packages (such as
AutoCAD) or AM/FM/GIS systems. The DXF import function has two important features:
• You can specify that the contents of the DXF file are to be added to the present contents of the target map
window. This allows you to put together a large map from multiple DXF files.
• You can specify that the contents of all of the layers contained in the DXF file are to completely replace the
contents of the same layers in the target map window. This allows you to update the previously imported
layers in your map without disturbing the layers that contain graphics that you entered using the WorldView
editing facility.
Section 9.2, Import From WorldView for VMS, describes how to import maps and libraries from WorldView for
VMS. This is a two-step process:
• The first step is to export the WorldView for VMS maps and libraries into text files on the VMS host
computer and transfer them to your PC (via FTP). This is described in the Guide to World Map Conversion
(document number WV-107).
• The next step is to import the text files exported above into WorldView for Windows. This is what’s
described in section 9.2.
When you select the desired DXF file, a DXF Import Settings window is displayed.
• The DXF Map Extent area shows the declared extent of the map in the DXF file’s own coordinates.
• The Recommended Scale Factor is calculated for you (from the declared extent in the DXF file) so as to
make the imported map occupy approximately 100 million by 100 million world units. (The total WorldView
coordinate space is 1 billion by 1 billion world units.) You can use the recommended scale factor as is, or
you can modify it by editing it. For reference, the Minimum Scale Factor is calculated to show you the scale
factor value that would make the imported map occupy 1 million by 1 million world units. And the Maximum
scale factor is calculated to show you the scale factor value that would make the imported map occupy 1
billion by 1 billion world units.
Survalent recommends that you not exceed a coordinate space of +-500,000,000, for two reasons:
• to support monitors with different aspect ratios (e.g. 3x4, 16x9 etc) from that where the import is being
performed.
• The rotation is initialized to zero. You can enter a non-zero angle of rotation if you wish.
• Leaving “Make Map larger if required” unchecked causes the import function to only import stuff that’s inside
the declared map extent. It is not uncommon to find graphics in a DXF file that are outside the DXF file’s
declared extent. This is usually garbage caused by export errors, and if imported, can stretch the imported
map’s extent to such a degree that the imported map can be difficult to handle. The best default therefore is
to leave the box unchecked.
If you suspect that there are things missing in your imported map, you can try re-importing with the “Make
Map larger if required” option checked.
• Leaving “Overwrite Existing Text Styles” unchecked causes the import function to not update the WorldView
text style library. This is handy in cases where you have modified previously imported text styles and you
don’t want your changes to be lost on this import. If you do want the text styles updated, the “Overwrite
Existing Text Styles” box must be checked.
• Leaving “Replace Existing Layers” unchecked causes the import functions to import and add the new map
to the existing map (if you had one open). This is what you would do if you wanted to merge several maps
together (i.e. import multiple sub-maps to produce one large map). If, on the other hand, what you want to
do is to update your map from an updated DXF file, you would check the “Replace Existing Layers” check
box. In this case, each layer in the DXF file completely replaces the corresponding layer of your existing
map.
Note that any layers in your existing map that are not present in the DXF file are left intact. Which is why it’s
very important to put your own stuff that you add(e.g. stations, pmacros, pushbuttons, etc) into layers
separate from those imported from DXF files.
• The “Use Default File…” button allows you to use a previously saved set of scale factor, X-Y offsets and
rotation angle. The “Save Defaults As…” pushbutton allows you to define and save these import parameters
for use on subsequent imports. See paragraph 9.1.1, Saved DXF Import Parameters.
• The Font Factor is a scale factor for text only. It allows you to adjust for text size differentials that can result
if the source text is vector-based (WorldView text is based on TrueType fonts).
• The Keep Line sections check box controls whether line sections are to be preserved on re-import. If
checked, WorldView determines whether any of the layers about to be imported already exist in the map
being updated, and if so, whether any of those layers contain line sections. If yes, then WorldView performs
an X-Y match of all of the graphics in those layers that are presently attached to line sections against the
graphics that are being imported. For each matching graphic, WorldView preserves the attachment to the
line section
After clicking on OK, the import function proceeds to import the DXF file. During the import, a progress bar is
displayed. How long the import takes depends on the size of the DXF file, but most files will take well under a
minute. On completion, if you like what you see, you can save the map.
The DXF Import function will display an error message if it encounters an error in the DXF file. If the problem is
not fatal, the import will continue after you acknowledge the error.
After saving the map, you can use the Optimize Map function to reorganize storage of the map so as to optimize
the speed of navigation. See paragraph 8.4.3, Optimize Map. After optimizing the map, Save it again.
The Save Defaults As… pushbutton allows you to save the current set of import parameters as the default, to be
used on subsequent DXF imports. When you click on the pushbutton, a Save File dialog appears and you can
give the options file any name you choose. It will be given the extension .opt by default.
If you are importing several separate maps, you may wish to keep their parameters separately. But if you are
merging several DXF files into a single WorldView map, it may be more convenient to use the same option file
for all the imports.
To use the saved parameters on a subsequent import, just press the Use Default File button in the DXF Import
Settings dialog. A File Open dialog box will appear, and you will be able to select the option file you wish to use.
The scale factor, offset and rotation angle information fields will update to show the saved values.
Using saved DXF import parameters is a must for cases where maps are imported (and subsequently updated)
from multiple DXF files that represent different areas of your network but are all based on the same coordinate
space. If you’re importing a matrix of section maps, for example, we suggest that you import the middle one first
and save its import parameters as the default. Then use those defaults to import the remaining DXF files.
Saved DXF import parameters are also useful for single DXF file imports and updates. When you import a DXF
file that represents an update to one that was previously imported, the extent of the new file may be different
from that of the original. In order to be compatible with the other layers of your map, it's important that all DXF
updates be done at exactly the same scale and offset. By saving the DXF import parameters on the initial
import, you don't need to record on a piece of paper the scale and offset that was used for the first DXF file
import. It's in the map's option file.
Even if you do not save the options in a file, WorldView logs all imports, complete with import parameters. The
log file is named Worldview.log and is located in the WorldView directory. An example of the log file is shown
below. In addition to DXF imports, the log file is also used to record saves of maps and publishes of line
sections.
Some MicroStation systems do not use the INSERT command to specify symbols in an exported DXF file.
Instead, they just insert special text strings, which the importing program must convert to a symbol.
To accommodate this, WorldView supports a text-to-symbol cross-reference file. If you’re using this capability,
the name of the cross-reference file must be the same as the name of the DXF file being imported but with a
.DXF_OPT file extension. If the cross-reference file exists, WorldView uses it to replace text strings by symbols.
If the file does not exist, no text to symbol replacement is performed.
Below is an example of a text-to-symbol cross-reference file. A double-slash “//” in the first position of a line
denotes a comment.
// 44KV_LAYER_12.DXF_OPT
// Option File for MicroStation Text-to-Symbol Conversion
MICROSTATION 1
// EOF
MICROSTATION
This keyword enables or disables text-to-symbol replacement. Setting the keyword value to 1 enables text-to-
symbol replacement. Setting the keyword value to 0 disables it.
MS_CONVERSION
Each instance of this keyword defines the following items in order to map a certain text string in a certain layer
and with certain font style to a WorldView symbol:
• Layer Name
This is the name of a layer that contains text strings that need to be replaced by symbols.
• Text String
Any instance of this text string in the previously specified layer is to be replaced by a symbol. The symbol
that replaces the text string is specified by the next item.
• Symbol
This is the name of the symbol that is to replace each instance of the text string identified above.
Note: Since the symbol definitions are not included in the DXF file, the symbols that replace text strings
must be prepared ahead of time and be present in the WorldView symbol library at the time of the DXF
import.
This is the name of a font for the text string that needs to be replaced. If the text string is not in this font, it is
not replaced by a symbol.
If the text string’s font is a default font that is defined in the DXF file for the entire layer, then just set this to
STANDARD.
• X Scale
This is the X scale factor to be applied to the symbol that replaces the text string.
• Y Scale
This is the Y scale factor to be applied to the symbol that replaces the text string.
In the example above, each instance of text string M5-51 in layer SW_LABEL in font style STANDARD will be
replaced by a symbol named 60POLE. The X and Y scale factors used on the symbol are both 1.0.
Another example is the special string %%C that represents the Greek letter PHI (used in electrical diagrams to
represent the word "phase"). Other special symbols that are also properly imported are the combined +- sign
and the degree sign.
The DWG / DXF import function is a more advanced function that presently supports all versions of AutoCAD
DWG and DXF up to AutoCAD 2008.
The same Import Settings dialog is used as for DXF R12 import. If the DWG file is password-protected,
WorldView prompts you for the password.
The price for this capability is that imports are noticeably slower. A 10-20 second import using the original DXF
R12 import function can take a few minutes using this function. For this reason, the DXF R12 import function
has been retained.
In DWG files, some of the attributes of Blocks (symbol definitions) are not used by WorldView. In this case,
WorldView simply ignores the unused attributes.
1. Open a new map (using the New Map function in the File pull-down menu).
• Drawing Styles
• Pixmaps
• Text Styles
• Symbols
• Pmacros
For each library, select Import from the File pull-down menu and from the sub-menu that appears, click on the
library name. For each library that you select, an Import library dialog will appear to let you find and select the
desired library text file.
When you click on Open, the selected file is imported into the appropriate sub-folder of your WorldView
standard directory. Any existing elements of each library will be over-written.
Note that there will be two library files of the symbol type (extension .sms). Import them both in two consecutive
import commands, but import the file named “symbol table.sms” second.
3. Import the map. An Import Maps dialog will appear to let you find and select the map file. The map you
select will be imported and then drawn in the current map window.
4. Unlike the imports of the libraries, the results of a map import are not automatically written to disk. You must
save the map using either the Save command in the File menu or the Save button in the Tool bar.
Each library or map import is a separate command. You can exit or do other things between each import
command. You can choose to re-import any library or map at any time without repeating the import of the other
If you import a map into a window that already has a map open, the result will be a merge of the two maps. If
you do this by accident, you can close the map window without saving the map, and import the map again in a
new empty window. You don’t have to re-import the libraries.
Since this export process must look up each point ID on the Master, and convert it to a name, it may take a long
time. The warning box shown below is displayed before proceeding with the export.
The output file may be named anything you wish, and can be placed anywhere you like, but you should retain
the .wms extension.
• The Reservation system allows you to exclusively reserve the WorldView database (i.e. the map and all of
the resource files) so that only you can edit it.
• By including Publish and Update functions, the system allows other users to be automatically notified that
new versions of the maps and resources are available, and to then conveniently update their workstations.
10.1.1 Setup
The WorldView reservation system is enabled via the WorldView page of the System Parameters editor in the
SCADA Explorer.
And, of course, place your official copy of the WorldView database in the specified repository directory.
The repository directory contains the Standard folder.
If the reservation system is enabled, you cannot edit the WorldView database without a reservation. If you
attempt to do so, an error message is displayed:
To reserve the WorldView database, use the Reservations sub-menu in the File menu.
If someone else has the database reserved, WorldView identifies the reservation holder’s account name and
workstation to you.
After you have finished editing, you can publish your files. When you publish, all the files that you have modified
will be copied to the central repository, and from there made available to other users to download and use on
their own workstations. If you have deleted any files in your WorldView database, those files will be deleted from
the central repository as well.
When you publish, a dialog is displayed that allows you to enter a comment (of up to 500 characters) to describe
your changes. This dialog also displays how many modules are being published (both updated and deleted).
You can request to see a list of the modules by clicking on the Updated Files… and Deleted Files…
pushbuttons.
A checkbox at the bottom of the Publish dialog allows you to specify that you do not wish the module history to
be updated. This is useful in cases where you have just done a DXF or other type of import.
When you click on Ok to initiate the Publish, a progress dialog displays the name of every file that is being
updated or deleted. As a precaution, before a file is overwritten or deleted in the central repository by a publish
command, it is automatically copied to a Save folder in the repository.
After publishing, you may Release your reservation, or hold on to the reservation to continue editing.
10.1.4 Update
When files are published to the central repository, WorldView informs all users at startup of WorldView, and on a
user-selectable time interval, that changes have been made and that the user may update his WorldView files.
The user can then ask WorldView to update the WorldView files on his workstation.
If Reservations is enabled, the Publish Check Time parameter in the Options dialog specifies the interval (in
minutes) at which WorldView is to check for a new version of the database.
A value of “-1” means don’t check, ever. This is a useful value to use on workstations that belong to people
outside your company and whose version of the map is to be strictly controlled by your own people.
A user right for “Update Map” is included in the User Rights editor. If your account doesn’t have this user right,
you cannot update any workstation.
As a precaution, before deleting any file in your copy of the WorldView database, the Update function first
places a copy of the file into a Save folder of your WorldView directory.
In order for the changes to take effect, you must restart WorldView after performing the Update function.
If you attempt to reserve the database but your workstation is not up-to-date, a warning message is displayed.
The dialog asks if you wish to have your workstation updated. If you indicate No, then your reservation request
will be denied. If you indicate Yes, then your workstation will be updated and you will be invited to restart
WorldView. You will not be able to make your reservation until you do so.
C:/Program Files/Quindar/WorldView/standard
In our sample map of Chapter 3, Getting Started, we didn’t modify any pre-existing files, but we did create new
files of the following types:
• Each new drawing style that we created is contained in a new file whose name is the name of the drawing
style and whose file extension is .gcl. These files are contained in the gcl sub-folder.
• Each new drawing style table that we created is contained in a new file whose name is the name of the
drawing style table and whose file extension is .gtl. These files are contained in the gtl sub-folder.
• Each new text style that we created is contained in a new file whose name is the name of the text style and
whose file extension is .fnl. These files are contained in the fnl sub-folder.
• Each new symbol that we created is contained in a new file whose name is the name of the symbol and
whose file extension is .syl. These files are contained in the syl sub-folder.
• Each new pmacro that we created is contained in a new file whose name is the name of the pmacro and
whose file extension is .pml. These files are contained in the pml sub-folder.
• We didn’t create any new symbol tables, but if we did they would be contained in new files whose names
are the names of the symbol tables and whose file extensions are .stl. These files are contained in the stl
sub-folder.
• The map itself is contained in a new file called sample.wmp and is contained in the wmp sub-folder.
If you copy all of these files to the appropriate directories on your colleagues’ PCs, your colleagues will be able
to use your map.
If you don’t use the Reservation system to preclude two people editing the same file on separate PCs, it is very
important that your company implement a procedure for controlling WorldView database maintenance.
• Overall control of the updating and distribution of maps is assigned to one person. Even if you use an
electronic bulletin board to post notices of maps being updated, one person is in charge of monitoring the
activity described in such a bulletin board.
• People who edit the map files are aware of company drawing standards, and fully understand the
implications of making changes to existing libraries (drawing styles, symbols etc).
• If you have an IT department, you can consider automating the update procedure. See section 10.2.2,
Publish and Update.
• Ensure that a mechanism exists for identifying the version of a map so that users can confirm whether they
have the most recent version or not. For example, you can reserve a small area of the map to record the
date that the map was last edited together with the name or initials of the person who last edited it (so that
people know who to ask if they have questions). Consider sometimes including a brief description of a
significant change (e.g. addition of a new feeder).
One way to share a WorldView database is to have everyone's copy of WorldView point to one common
directory on a shared drive somewhere on the network. Although this is convenient, it does have some
drawbacks. First, it causes all WorldView map opens and saves to be over the network. For large maps, this
may cause noticeably slower performance. In addition, remote users may not be able to map to the shared
drive for security reasons or may find the download time unacceptable (especially if access is via a dial-up
connection).
So we suggest that you think about going a little further and implementing a simple Publish and Update scheme
that keeps the main advantages of a centralized WorldView database but avoids the drawbacks.
The idea is to use the shared location just as a central storage place for the “official” WorldView database. No
one’s (or almost no one’s) copy of WorldView would access this directly. Instead, people would have copies of
this WorldView database on their own PCs, and:
• use an Update batch file to update their copy of the WorldView database from the shared location whenever
it changes
• use a Publish batch file to publish edits from their own PC to the shared location
Because each user’s copy of the map is on the user’s local hard drive, access times and network load are
reduced.
Anyone intending to edit the map should get an up-to-date local copy of the map via the Update function and
then edit locally. This will make “save” operations very fast. In addition, other users will not see interim copies of
the map or libraries. When you’re ready to make the new map and libraries available to other users, a simple
"Publish" command will copy the map and libraries to the server.
Update
In the examples of this section, let’s assume that the shared WorldView database is stored in a share called
“ScadaCommon” on a server called “Tycho". And let’s assume that the WorldView database on each user’s PC
is stored in:
"c:\program files\quindar\worldview"
The quotes in the statement are required because the destination path has a space in it. The "/S" means copy
subdirectories. The "/Q" forces a quiet copy.
You can place a shortcut to the batch file in your start menu, or on your desktop.
Publish
To publish your computer's WorldView database to the shared location, you can create a batch file called
"Publish.bat". It would contain just one statement that looks like this:
As in the case of Update, you can place a shortcut to the batch file in your start menu, or on your desktop.
Note that only people who edit WorldView would have a need for the "Publish" batch file. People who just use
WorldView would only need the "Update" function.