Sunteți pe pagina 1din 41

WVPC 2000-PG

Worldview PC-2000
Developers Guide

March 2008

Copyright 2008 by QEI Inc.


WorldView PC-2000 WVPC-2000
ALL RIGHTS RESERVED

.
NOTICE

The information in this document has been carefully checked and is believed to be
accurate. However, no responsibility is assumed or implied for inaccuracies. Further
more, QEI, INC., reserves the right to make changes to any products herein described to
improve reliability, function or design. QEI, Inc. does not assume liability arising our to the
application or use of any product or circuit described herein; neither does it convey any
license under its patent rights nor the rights of others.

This manual and all data contained constitutes proprietary information of QEI, Inc. and
shall not be reproduced, copied or disclosed to others, or used as the basis for
manufacture without written consent of QEI, Inc.

QEI Inc.
60 Fadem Road
Springfield, NJ 07081
Phone: (973) 379-7400
Fax: (973) 379-2138
Web Site: www.qeiinc.com
WVPC-2000-PG WorldView PC Developers Guide

Revisions
Revision Description Date

A Revised Manual March 2008

Copyright 2008 QEI, Inc. Revisions i


WVPC-2000-PG WorldView PC Developers Guide

Contents
1 Introduction ......................................................................... - 1 -
2 Map Making.......................................................................... - 1 -
2.1 Map Strategy .................................................................... - 1 -
2.2 Layer Strategy .................................................................. - 1 -
2.3 Symbols............................................................................ - 2 -
2.4 PMacros ........................................................................... - 2 -
2.5 Drawing the Map .............................................................. - 2 -
2.6 Map Distribution................................................................ - 2 -
3 Editing Tools ....................................................................... - 3 -
3.1 Edit Toolbar ...................................................................... - 4 -
3.2 Select Toolbar .................................................................. - 5 -
3.3 Adding or Modifying a Layer ............................................. - 6 -
3.4 Adding or Modifying a Drawing Style................................ - 7 -
3.5 Adding or Modifying a Text Style. ..................................... - 8 -
4 Symbols ............................................................................... - 9 -
4.1 Creating symbols .............................................................. - 9 -
4.2 Modifying Symbols ......................................................... - 10 -
5 PMacros ............................................................................. - 11 -
5.1 Creating PMacros........................................................... - 11 -
5.2 Drawing Style Table ....................................................... - 12 -
5.3 Analog Bar PMacro ........................................................ - 15 -
5.3.1 Analog Bar Resources..................................... - 15 -
5.4 Analog Value PMacro ..................................................... - 17 -
5.4.1 Analog Value Resources ................................. - 17 -
5.5 Mobile Icon PMacro ........................................................ - 18 -
5.5.1 Mobile Icon Resources .................................... - 19 -
5.6 Pushbutton PMacro ........................................................ - 20 -
5.6.1 Pushbutton Resources .................................... - 21 -
5.7 Station Color PMacro ..................................................... - 22 -
5.7.1 Station Color Resources.................................. - 22 -
5.8 Station Symbol PMacro .................................................. - 23 -
5.8.1 Station Symbol Resources .............................. - 23 -
5.9 Status Color PMacro ...................................................... - 24 -
5.9.1 Status Color Resources................................... - 25 -
5.10 Status Symbol PMacro ................................................... - 28 -
5.10.1 Status Symbol Resources ............................... - 28 -
5.11 Status Text PMacro ........................................................ - 31 -
5.11.1 Status Text Resources .................................... - 31 -
5.12 Text Value PMacro ......................................................... - 32 -
5.12.1 Text Value Resources ..................................... - 32 -
6 Drawing the Map ............................................................... - 33 -
6.1 Multiple Selections.......................................................... - 34 -
6.2 Drawing Tips................................................................... - 35 -

Copyright 2008 QEI, Inc. Contents i


WVPC-2000-PG WorldView PC Developers Guide

1 Introduction
This manual is intended for the developer of WorldView maps. It is assumed that the reader is fully familiar with the
contents of the operators manual, WVPC-2000-OP.

2 Map Making
There are several steps that need to be taken in order to create a Worldview Map. They are:

- Develop a map and layer strategy

- Create Symbols

- Create PMacros

- Either draw the Map or import the Map from an AutoCAD file

- Distribute the Map to the operator PCs.

2.1 Map Strategy


There are several ways of organizing a Map or Maps. One way is to create an all encompassing Map that is
divided into many different views. Each substation or well head would be drawn side-by-side on the Map and
separated into distinct views. Pushbuttons on the Map would allow the user to navigate to each view.
Alternately, many Maps can be created with only one or a limited number of views on each Map. An overview
Map can be created that contains pushbuttons that call up the other maps. A third possibility is a few large
Maps with several views on them. Each large Map would contain a major area of operator responsibility, for
instance, water, electric, and sewer.

There is no clear advantage to either method and the choice is up to the map maker. A large Map may be
difficult to edit since there is a large amount of information to manage. However, a large Map may be easier to
maintain since there is only one map file that has to be distributed to the operator PCs. The operators may find
it easier to navigate around a small Map, but difficult to find the Map file they need to open from a large list of
Maps. The decision may depend on the Maps supplied from the CAD department. It is possible to overlay small
AutoCAD Maps onto one large WorldView Map, however, it might be easier to have a one to one
correspondence between the AutoCAD maps and the WorldView Maps.

2.2 Layer Strategy


Layers are a way of grouping similar objects together. For instance, all objects configured with Scada data
points could be grouped into a layer; all text describing a certain type of equipment could be grouped into
another layer. The advantage of layers is that all the objects in that layer can be made visible or invisible (turned
on or turned off) at the same time. Further, layers can be turned on or off automatically based on the zoom
level.

Take as an example a roadmap from an online map service. When you first look at the map, you can only see
major highways. As you zoom in, major roads appear. Zooming in further reveals side roads, and, if you zoom
in far enough, you can see some side alleys and walkways. This is accomplished through layers. The major
highways are grouped into a layer, the major roads are grouped into another layer, etc. As you zoom in or out,
the layers are turned on or off revealing more or less detail.

This is similar to what happens in a Worldview Map. When you first look at the map, only major sections are
visible. As you zoom in, equipment symbols become visible. Zooming in further revels Scada data points and
informational text. Zooming out reverses the process.
Copyright 2008 QEI, Inc Introduction 1
WorldView PC Developerrs Guide WVPC-2000-PG

At a minimum, Scada data points should have their own separate layer. Beyond that, the separation of layers
will depend on the map maker, or, the way the layers are arranged in the AutoCAD maps that are used to create
the WorldView Maps.

2.3 Symbols
Symbols are used to represent various pieces of equipment, for instance a breaker, a pump, a valve, etc.
Symbols are also used to indicate the state of the equipment: an open breaker, a closed breaker, a running
pump, or, a pump out of service. Symbols can be placed on the Map as drawn. However, they are most often
used with PMacros to dynamically indicate equipment status.

Symbols can be drawn by hand using drawing tools such as lines, curves, blocks, etc. Symbols can also be
created when importing an AutoCAD drawing. An AutoCAD block becomes a WorldView symbol. It is easier to
create the symbols on the AutoCAD drawing rather than import the drawing and create and place the symbols
afterwards.

2.4 PMacros
PMacros are used to create dynamic objects on a Map. Any object that changes value, changes color, changes
shape, blinks, or executes an action is made possible by a PMacro. Examples include analog values, analog
bars, status values, status symbols, lines or text that change color, pushbuttons, etc.

Several PMacros use Symbols as display elements. For example, a Status Symbol may use four different
symbols, each one representing the four different values that a status point may have. Therefore, developing
PMacros and Symbols go hand-in-hand.

2.5 Drawing the Map


Once the Map and layer strategies have been developed, and several Symbols and PMacros have been
created, the Map can be drawn. A Map is a combination of static and dynamic objects. Static objects, such as
lines, circles and text, are created from the Edit toolbar. Dynamic objects are created from configured PMacros.

Maps can also be created from an AutoCAD drawing. This is achieved by importing the AutoCAD drawing onto
a new or existing MAP. From a privileged account and with a Map opened in the main window, select File ->
Import -> From DFX from the menu on the main window. The Open dialog box is displayed. Select the
AutoCAD file you wish to import.

AutoCAD DFX format 12 or 13 is the best to import. When exporting from AutoCAD, turn off and freeze layers
that you dont want. If you just turn off a layer, it still is imported but not turned on; you must freeze the layer to
remove it.

2.6 Map Distribution


There are two ways of distributing a Map to the operator PCs, using the WorldView export and import facility or
directly copying the files from the development PC to the operator PCs.

When you export a Map, it notifies the operator PCs that a new Map is available and that it should be
imported. The problem with this method, is that the export and import is done in pieces, that is, you can select
which libraries you want to export or import. Needless to say, this may lead to incomplete or mismatched Maps
on the operator PCs.

The other method is to copy the entire \Standard folder from the development PC to the operator PCs. The
\Standard folder is a sub-folder of the folder where WorldView is installed, typically C:\Program Files\WV2000.
The \Standard folder contains additional sub-folders which holds the maps and all supporting libraries (Symbols,

2 Map Making Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

PMacros, etc.). This method should be used when distributing files to a large number of operator PCs. It also
guarantees that all of the necessary files are copied, not just some of them.

To copy the files, do the following:

1. Use Windows Explorer to locate the folder where WorldView is installed, typically, C:\Program
Files\WV2000\. Locate the \Standard sub-folder and copy it and all of its sub-folders to a memory stick
or similar media.

2. On the operator PC, locate the folder where WorldView is installed; it does not have to be the same as
the development PC. Copy the Standard folder from the memory stick to the WorldView folder (not the
\Standard sub-folder). When the Confirm Folder Replace dialog box appears, click the Yes to All
button.

Another method which may be used, is to copy the \Standard folder from the development PC to a network drive
which is accessible to all of the operator PCs. The operator PCs would use the network drive when opening
the Maps instead of their own local drive. To do this, follow the two step above, but instead of copying the
\Standard folder to the operator PCs, copy the \Standard folder to the network drive. In this situation, it is not
necessary to install WorldView on the network drive. Instead, just create a top level folder, say for instance
WorldViewFiles, on the network drive and copy the \Standard folder to that location.

3 Editing Tools
There are two toolbars that are used when editing symbols and Maps. They are the Edit toolbar and the Select toolbar.

The Edit toolbar provides basic drawing capabilities: lines, circles, boxes, filled boxes, etc. The Select toolbar allows
fast selection of a Layer, PMacro, Symbol, Drawing Style, or Text Style.

The toolbars are displayed by selecting the Edit button. The Edit toolbar normally appears on the right hand side of
the display and the Select toolbar normally appears on the top of the display just below the other displayed toolbars.
However, since they are movable toolbars, they may be placed anywhere on the display.

A Drawing Style is a combination of color, line thickness and line style. It is used when drawing basic graphical shapes
on the symbol palette (where Symbols are created) or on a Map. A Text Style is a combination of text font, height, and
orientation (horizontal or vertical). It is used when placing text on the symbol palette or a Map.

Layers can be added or modified from the View and Layers window which can be displayed by selecting the Tree
Lists button. Details on how to add or modify a Layer is explained in section 10.3.

Drawing Styles and Text Styles can be added or modified from the Library Selector window which can be displayed by
selecting the Library Selector button. Details on how to add or modify a style is explained in section 10.4 and 10.5.

Copyright 2008 QEI, Inc Editing Tools 3


WorldView PC Developerrs Guide WVPC-2000-PG

3.1 Edit Toolbar


The Edit toolbar provides the following functionality:

Select Use the Select button to select one or more objects.

Line Click the Line button to draw a line. To draw a flat line (horizontal or vertical)
press and hold the shift key before drawing the line.

Box Click the Box button to draw a box.

Filled Click the Filled Box button to draw a filled box.

Ellipse Click the Ellipse button to draw an ellipse.

Filled Ellipse Click the Filled Ellipse button to draw a filled ellipse.

Arc Click the Arc button to draw an arc.

Filled Arc Click the Filled Arc button to draw a filled arc.

Closed Polygon Click the Closed Polygon button to draw a filled polygon.

Filled Polygon Click the Filled Polygon button to draw a filled polygon.

Open Polygon Click the Open Polygon button to draw an open polygon.

Text Click the Text button to position a text object.

PMacro Click the PMacro button to position a PMacro.

Symbol Click the Symbol button to position a Symbol.

Bezier Click the Bezier button and follow the instructions below to draw a Bezier
Curve:

Drawing:
1. Click the mouse at the starting point of the curve.
2. Click two intermediate points along the curve.
3. The final (fourth) click specifies the curves endpoint.

Editing:

1. Select the bezier curve: the curve will be surrounded


by a selection box. Two control points are represented by
two small crosses.
2. Drag the control points to change the shape of the curve.
3. Alternatively, modify the point properties directly by right-
clicking on a selected bezier curve and selecting Modify.

Note on importing Bezier curves:

4 Editing Tools Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

To import a spline from AutoCAD into WorldView, the curve should


be named SPLINE. Since WorldView Bezier curves only take four
(4) points, two end points and two control points are used. After the
spline is imported, the curve may not appear the same as in
AutoCAD. Use the edit function to modify the curve.

Picture Click the Picture button to add a picture. Select the picture from the Open
dialog box. The picture can be a .JPEG, .GIF, or .BMP type.

3.2 Select Toolbar


From the Select toolbar, the user can:

- Select a Layer. When drawing or placing an object on a Map, a Layer needs to be specified. The Layer can
be selected from the dropdown list. Section 10.3 describes how to add or modify a Layer.

- Select a PMacro. Select the PMacro from the dropdown list, then click on the Map to place it. When selecting
from the dropdown list, the PMacro button on the Edit toolbar is automatically selected. Subsequent clicks on
the Map will place additional copies of the selected PMacro on the Map. Section 12 describes how to create or
modify a PMacro.

- Select a Symbol. Select a Symbol from the dropdown list, then click on the Map to place it. When selecting
from the dropdown list, the Symbol button on the Edit toolbar is automatically selected. Subsequent clicks on
the Map will place additional copies of the selected Symbol on the Map. Symbols can also be placed on the
symbol palette (where Symbols are created). Thus, it is possible to create a large Symbol by combining
several smaller Symbols together. Section 11 describes how to create or modify a Symbol.

- Select a Drawing Style. There are two instances when Drawing Styles are used. (1) When drawing a basic
graphical shape on the symbol palette or a Map, the selected Drawing Style is used to set the color, line
thickness and line style. (2) Symbols can be drawn with a color called dynamic. This indicates that the
Drawing Style will be set when the Symbol is placed on the Map. By selecting a different Drawing Style before
placing this type of Symbol on a Map, the same symbol can be used in different places with a different color,
line thickness and style. Section 10.4 describes how to add or create a Drawing Style.

- Select a Text Style. Select a Text Style from the dropdown list, then click on the Map or symbol palette to
place the Text. When selecting from the dropdown list, the Text button on the Edit toolbar is automatically
selected. After clicking on the symbol palette or Map, the String Properties dialog box is displayed:

Copyright 2008 QEI, Inc Editing Tools 5


WorldView PC Developerrs Guide WVPC-2000-PG

The text is entered into the String text box. Notice that the currently selected Text Style, Layer, and Drawing
Styles are used to create the string. Other placement parameters can also be set from this dialog box.

Section 10.5 describes how to add or modify a Text Style.

3.3 Adding or Modifying a Layer


To add a Layer:

- Insure that the Edit button is selected (you must be logged into a privileged account).

- Select the Tree Lists button. The Views and Layers window is displayed.

- Select the Layers Tab.

- Right click on the Layers folder icon. Select the Create Layer menu item.

The Layer dialog box is displayed:

6 Editing Tools Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

Enter the Layer name in the Layer name text box. Leave -1 in the Maximum scale and 0 in the Minimum scale
text boxes. These values can be set at a later time when the Map is more developed and you have a better idea
at what zoom levels the Layer should be turned on or turned off.

To modify a Layer, right click on the Layer name and select the Modify menu item. The Layer dialog box is
displayed. Modify the desired fields.

3.4 Adding or Modifying a Drawing Style.


To add or modify a Drawing Style:

- Insure that the Edit button is selected.

- Select the Library Selector button.

- Select the Drawing Styles tab.

- Right click on a Drawing Style from the list.

- Select Add or Modify. The Drawing Style Editor dialog box appears:

Copyright 2008 QEI, Inc Editing Tools 7


WorldView PC Developerrs Guide WVPC-2000-PG

Name: The Name text box contains the name of the Drawing Style.
Color Modify, Color Add, and Color Insert: These three buttons all display the color palette window.
Color Delete: This button deletes a color from the Cyclic Colors list.
Line Size: The Line (size) dropdown list sets the line size, in pixels.
Line Style: The Line (style) dropdown list sets the line style (solid or dashed)
Cyclic Colors: The Cyclic Colors area displays up to eight colors. You can animate objects on the screen from
a simple blink to a rotating pump using cyclic colors. The colors are cycled thru, from left to right, at a fixed rate
which cannot be adjusted. If only one color is specified, the color is fixed.

3.5 Adding or Modifying a Text Style.


To add or modify a Text Style:

- Insure that the Edit button is selected.

- Select the Library Selector button.

- Select the Text Styles tab.

- Right click on a Text Style from the list.

- Select Add or Modify. The Text Style Editor dialog box appears:

8 Editing Tools Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

Name: The Name text box contains the name of the Text Style.

Select Font: This button displays the Font Editor. Any MS windows font can be used, however, a True Type
font is preferred.
Reset Current Map: This button applies any changes made to the text style under edit to all objects on the
current Map that use this Text Style. This is useful when the user wants to change the size of the text currently
being used by a Map. This option will change all text using this style, so caution is advised.
Orientation: Choose the orientation of the text (horizontal or vertical).
Horizontal: Choose the horizontal justification of the text (left, right, center or decimal). Most text will be left
justified but with analog values the user would use Decimal so that the analog value displayed would stay in
the same position on the screen as the analog values change.
Vertical: Choose the vertical justification of the text (left, right, center or decimal).

Note: It is possible that a font could exist on the development PC and not on the operator PCs. This will cause
missing or wrong sized text on the WorldView Map. Caution should be used when selecting a font, especially if
the font was installed on the development PC from a third party software program.

4 Symbols
Symbols are used to represent various pieces of equipment in various states, for instance an open breaker or a closed
breaker. Symbols can be placed statically on the Map as drawn, or, they can be used with PMacros to represent the
equipment dynamically. Symbol are created from a privileged account.

4.1 Creating symbols


From the menu on the main window, select File -> New -> Symbol. The symbol drawing palette appears.

Copyright 2008 QEI, Inc Symbols 9


WorldView PC Developerrs Guide WVPC-2000-PG

From here, the Edit toolbar can be used to draw graphical objects or text strings on the palette. Before drawing
a graphical object, a Drawing Style should be selected. Before placing text on the palette, a Drawing Style (for
the color) and a Text Style (for the font) should be selected. Note that if Select Drawing Style or Select Text
Style appears in selection window, the style is actually set to the first style in the dropdown list.

If the Drawing Style is {dynamic} or the Text Style is {textStyle}, then the color of the graphical object or the text
string will be determined when the symbol is placed on the Map or used in a PMacro. If the styles are not
{dynamic} or {textStyle}, then the currently selected Drawing Style or Text Style will be fixed for the Symbol.

The intersection of the crosshairs on the palette are X-Y coordinate 0,0. When placing the Symbol on a Map,
the position of the mouse cursor corresponds to coordinate 0,0. Therefore, for proper alignment on the Map,
you may want to draw the objects totally above or below the horizontal line. Likewise, you may want to draw
the objects totally to the left or to the right of the vertical line.

4.2 Modifying Symbols


Once a graphical object or text string is placed on the palette, you may want to change its color. To do so, click
the Select button from the Edit toolbar (the button on top) and select the item (left click on the item, or, left click
on the screen and hold the mouse button, drag the mouse over the item, then release the mouse button). Select
the new Drawing Style from the dropdown list. Right click on the selected object, then select Recolor from the
popup menu. The color will be modified to the currently selected Drawing Style.

To move a graphical object or text string, select the item, left click and drag the item to the new location, then
release the mouse button.

10 Symbols Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

To delete a graphical object or text string, select the item, then press the delete key on the keyboard.

To finish, select File -> Save or File -> Save As from the menu on the main window. The Save As dialog box is
displayed. Enter the name for the new Symbol and press the Save button.

WorldView is shipped with a large library of predefined Symbols, so it may not be necessary to create new ones.
If so, it might be easier to modify an existing Symbol. To do this:

- Select File -> Open from the menu on the main window.

- Change the file type to Symbol (*.syl).

- Change the folder location to Standard\Syl (the folder location is defaulted to Standard\Map).

- Select the Symbol to modify.

- Modify the Symbol as described above.

- To finish, select File -> Save As from the menu on the main window. Enter a new Symbol name then press
the Save button. Caution: do not select File -> Save. This will overwrite the original Symbol without any
verification.

5 PMacros
PMacros are used to create dynamic objects on a Map. The most commonly used PMacros are analog values, status
symbol, status text, and pushbuttons.

5.1 Creating PMacros


From the menu on the main window, select File -> New -> PMacro. The Create Pmacro dialog box appears:

The PMacros that are shown in the display are actually templates that are
used to create many different PMacros. After selecting a PMacro template,
the template is customized and saved. When the saved PMacro is placed on
a Map, further customization can occur.

The question is, how much customization should be completed when creating
the PMacro and how much should be completed when placing the PMacro on
a Map. Take for example, an analog value. There are two main items that
need to customized, the pointname and the number of decimal places the
value displays. These two items could easily be entered when placing the
PMacro on the Map. However, it is better to limit the amount of customization
when placing a PMacro; it speeds up drawing the map and leads to greater
visual consistency on the Map. So for this example, several analog value
PMacros would be created, each one with a different number of displayed
decimal places. The pointname is then entered when the PMacro is placed
on the Map.

After selecting a PMacro to customized and selecting the OK button, an untitled PMacro drawing window is
displayed. Select the Edit button and a Pmacro Properties dialog box appears:

Copyright 2008 QEI, Inc PMacros 11


WorldView PC Developerrs Guide WVPC-2000-PG

The Resource column contains the attributes that make up this particular PMacro. The Default column lists the
default values for the attributes. A value is set in the Override column to customize the PMacro. To set an
override value, double click on the Resource and an entry dialog box is displayed. The dialog box consists of
either an entry text box or a dropdown list depending on the Resource. Enter a value or select a value from the
dropdown list and select the ok button. Do this for as many values as you would like customized.

To finish, select File -> Save or File -> Save As from the menu on the main window. The Save As dialog box is
displayed. Enter the name for the new PMacro and press the Save button.

Once a PMacro is placed on the Map, it can be further customized. To do this, select the Edit button, then
select the PMacro. Right click on the PMacro and select the Modify menu item. The Pmacro Properties dialog
box for that particular PMacro is displayed. Customize any additional resources or change the configured
Overrides if desired.

5.2 Drawing Style Table


Several resources require an entry from the Drawing Style Table. A Drawing Style Table is a list of several
Drawing Styles that are used to color a PMacro under different conditions, for instance, an unacknowledged
alarm and an acknowledged alarm. The unacknowledged is set to one Drawing Style and the acknowledged
alarm is set to another drawing Style. The two Drawing Styles are listed in a Drawing Style Table. The PMacro
resource is set to the Drawing Style Table.

To add or modify a Drawing Style Table:

- Insure that the Edit button is selected.

- Select the Library Selector button.

- Select the Drawing Style Tables tab.

- Right click on a Drawing Style Table from the list.

- Select Add or Modify. The Drawing Style Table Editor dialog box appears:

12 PMacros Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

The left hand window lists all of the available Drawing Styles. The right hand window displays the Drawing Style
Table.

Name: This text box contains the name of the Drawing Style Table.
Up: This button repositions a selected Drawing Style in the Drawing Style Table.

Delete: This button deletes a selected Drawing Style from the Drawing Style Table.
Down: This button repositions a selected Drawing Style in the Drawing Style Table.

Each position in the Drawing Style Table represents a different dynamic state, for instance, an analog high alarm
state or an analog low alarm state. Therefore, each PMacro requires a different number of Drawing Styles in the
Drawing Style Table that it accesses.

The tables below describe the meaning of each position in the Drawing Style Table for various PMacros:

Analog State Colors

Drawing Style Index Analog Alarm State


0 Not Used
1 Low Unreasonable
2 Low Emergency
3 Low Pre-Emergency
4 Normal
5 High Pre-Emergency
6 High Emergency
7 High Unreasonable
Copyright 2008 QEI, Inc PMacros 13
WorldView PC Developerrs Guide WVPC-2000-PG

Station State Colors

Priority Drawing Style Index Audible Alarm Acknowledgement


0 0 None Automatic
1 1 Single Automatic
2 2 Single Required
3 3 Cycle Required
4 4 Continuous Required

Status State Colors

Drawing Style Index Status Point Value


0 0
1 1
2 2
3 3

Blocked Flag Colors

Drawing Style Index Blocked State


0 Not Used
1 Blocked

Condition Flag Colors

Drawing Style Index State Value


0
1
2
3
4
5
6
7

14 PMacros Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

Tag Flag Colors

Drawing Style Index Tag State


0
1
2
3
4
5
6
7

The following sections describes the resources for each PMacro

5.3 Analog Bar PMacro


A example of an analog bar PMacro is shown below. The height of the bar represents the value of the analog
point associated with the PMacro. The flags below the bar indicate the condition state, tagged state and blocked
state of the associated analog point. An analog bar can be displayed either horizontally or vertically.

5.3.1 Analog Bar Resources


Alarm Blocked Flag Drawing Style Table
Determines the Drawing Style Table used to determine the color of the PMacros blocked flag.

Alarm Blocked Flag Enable


Determines whether the PMacros blocked flag is enabled or disabled. The user can turn the flag On of Off.

Alarm Blocked Flag Offset X


Determines the X offset of the blocked flag relative to the analog bar.

Alarm Blocked Flag Offset Y

Copyright 2008 QEI, Inc PMacros 15


WorldView PC Developerrs Guide WVPC-2000-PG

Determines the Y offset of the blocked flag relative to the analog bar.

Analog Scale Factor


Overrides the scale factor of the associated analog point for display purposes.

Bar Length
Determines the length (in WorldView units) of the analog bar. If the user draws a line horizontally or vertically
and subtracts the X and Y value that the user get that will give the user the bar lengths.

Bar Width
Determines the width (in WorldView units) of the analog bar.

Condition Flag Drawing Style Table


Determines the Drawing Style Table used to determine the color(s) of the PMacros condition flag.

Condition Flag Enable


Determines whether the PMacros condition flag is enabled or disabled. The user can turn the flag On of Off.

Condition Flag Offset X


Determines the X offset of the condition flag relative to the analog bar.

Condition Flag Offset Y


Determines the Y offset of the condition flag relative to the analog bar.

Flag Scale Factor X


Stretches or shrinks the x-axis of the PMacro flag symbols.

Flag Scale Factor Y


Stretches or shrinks the y-axis of the PMacro flag symbols.

Lower Limit
Determines the lower limit of the analog bar. When the analog point value is at or below the lower limit, the
analog bar will have zero height.

Magnification
Determines the overall magnification of the PMacro.

NAK Drawing Style Table


Determines the Drawing Style Table used to determine the color of the analog bar if the associated analog point
currently has an unacknowledged alarm.

Normal Drawing Style Table


Determines the Drawing Style Table used to determine the color of the analog bar if the analog point currently
has no unacknowledged alarms.

Orientation
Determines the orientation of the PMacro. Options are Default, Vertical or Horizontal.

Point Name
Associates a PMacro with an analog point.

16 PMacros Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

Select Box Drawing Style


Determines the color(s) of the select box that appears around the PMacro when it is selected.

Tag Flag Drawing Style Table


Determines the Drawing Style Table used to determine the color(s) of the PMacros tag flag.

Tag Flag Enable


Determines whether the PMacros tag flag is enabled or disabled.

Tag Flag Offset X


Determines the X offset of the tag flag relative to the analog bar.

Tag Flag Offset Y


Determines the Y offset of the tag flag relative to the analog bar.

Upper Limit
Determines the upper limit of the analog bar. When the analog point value is at or above the upper limit, the
analog bar will have the maximum height, as determined by the Bar Length resource.

5.4 Analog Value PMacro


A example of an analog value PMacro is shown below. The value of the associated analog point is displayed in
text format. The flags to the right indicate the condition state, tagged state and blocked state of the associated
analog point. The only items for input for this display are the point name and text style.

5.4.1 Analog Value Resources


Alarm Blocked Flag Drawing Style Table
Determines the Drawing Style Table used to determine the color of the PMacros blocked flag.

Alarm Blocked Flag Enable


Determines whether the PMacros blocked flag is enabled or disabled.

Analog Scale Factor


Overrides the scale factor of the associated analog point for display purposes. This item can be used to change
the unit of measure such as Volts to KVolts, Watts to KWatts, and the like.

Condition Flag Drawing Style Table


Determines the Drawing Style Table used to determine the color(s) of the PMacros condition flag.

Condition Flag Enable


Determines whether the PMacros condition flag is enabled or disabled.

Horizontal Justification
Copyright 2008 QEI, Inc PMacros 17
WorldView PC Developerrs Guide WVPC-2000-PG

Determines the Horizontal Justification of the PMacro text. Options are Default, Left, Right, Center and Decimal.

NAK Drawing Style Table


Determines the Drawing Style Table used to determine the color of the analog point text if the associated analog
point currently has an unacknowledged alarm.

Normal Drawing Style Table


Determines the Drawing Style Table used to determine the color of the analog point text if the analog point
currently has no unacknowledged alarms.

Orientation
Determines the orientation of the PMacro. Options are Default, Vertical or Horizontal.

Point Name
The Point Name resource displays a list of station names and a list of point names for that station in an auto
complete pull down listing. This resource associates a PMacro with an analog point.

Precision
Determines the number of decimals places to be displayed after the decimal point.

Select Box Drawing Style


Determines the color(s) of the select box that appears around the PMacro when it is selected.

Sign Flag Enable


Determines whether a negative (-) sign appears to the left of the value text if the associated analog point value is
negative.

Tag Flag Drawing Style Table


Determines the Drawing Style Table used to determine the color(s) of the PMacros tag flag.

Tag Flag Enable


Determines whether the PMacros tag flag is enabled or disabled.

Text Style
Determines the Text Style to be used to display the analog point value text.

5.5 Mobile Icon PMacro


A Mobile Icon is a mobile PMacro whose position on the WorldView Map is determined by two associated
analog points, whose value determine the X and Y positions of the PMacro. In addition, other attributes such as
rotation and magnification can be controlled by other associated analog points. A example of a mobile icon
PMacro is shown below.

18 PMacros Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

5.5.1 Mobile Icon Resources


Analog Point1
Specifies the name of an analog point whose value will be displayed beside the mobile icon symbol.

Color Status Point Name


Determines the color of the PMacro. The value of the status point is used to index into the Drawing Style Table
specified in the Normal Drawing Style Table resource.

Magnification
Determines the overall magnification of the PMacro. This value is only used if an analog point is not specified in
the Magnification Point Name resource (below).

Magnification Point Name


Specifies the name of an analog point, whose value will be used to determine the overall magnification of the
PMacro.

Normal Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro.

Rotation Point Name


By specifying the name of an analog point, the rotation of the mobile icon symbol can be controlled by adjusting
the point value.

Scale Factor On X Axis


Scales the X Axis of the PMacro symbol by the specified amount.

Scale Factor On Y Axis


Scales the Y Axis of the PMacro symbol by the specified amount.

Symbol 0
Specifies the symbol to be displayed when the value of the status point specified in the Symbol Status Point
Name resource is equal to 0.

Symbol 1
Specifies the symbol to be displayed when the value of the status point specified in the Symbol Status Point
Name resource is equal to 1.

Symbol 2
Specifies the symbol to be displayed when the value of the status point specified in the Symbol Status Point
Name resource is equal to 2.

Symbol 3
Specifies the symbol to be displayed when the value of the status point specified in the Symbol Status Point
Name resource is equal to 3.

Symbol Status Point Name


Determines which mobile icon symbol to display.

Text Point1
Specified the text value that appears beside the mobile icon symbol. (see sample above).
Copyright 2008 QEI, Inc PMacros 19
WorldView PC Developerrs Guide WVPC-2000-PG

Text Point2
Specifies the text value that appears beside the mobile icon symbol. (see sample above).

Text X Offset
Specifies the relative X position of the three text items which appear beside the PMacro symbol.

Text Y Offset
Specifies the relative Y position of the three text items that appear beside the PMacro symbol.

X Analog Point Name


The value determines the X coordinate of the PMacro symbol in WorldView units.

Y Analog Point Name


The value determines the Y coordinate of the PMacro symbol in WorldView units.

5.6 Pushbutton PMacro


A pushbutton PMacro is used to create a target on the map that can perform one of the following tasks when
clicked:

Jump to a new view in the current map

Jump to a new view in a different map.

Jump to the default view in a different map.

Open a Graph.

Run a Command Sequence on the Master Station.

Access a WorldView Note.

Run a Windows application.

The required Button Arguments and Button Data for the different pushbutton types are summarized below:

Task Button Button Button Button Button Button Data


Type Argument 1 Argument 1 Argument Argument
Data Type 2 Data 2 Type

Jump to new View _ _ _ _ <Name of


view in the View>
current map.

Jump to new View <Name of String _ _ <Name of


view in a Map> View>
different
map.

20 PMacros Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

Jump to View <Name of String _ _ _


default view Map>
in a different
map.

Open a Graph _ _ _ _ <EGRAPH


Graph Number>

Run Task <Command Integer _ _ SEQPRO


Command Sequence
Sequence Number>

Access a Note _ _ _ _ <Note Topic


Note Name>

Run SysC <Command String _ _ <Application


Windows md Line Name>
Application Parameters>

5.6.1 Pushbutton Resources


Button Label
Determines the text for the button label.

Button Label Drawing Style Table


Determines the color of the button label text.

Button Label Text Style


Determines the Text Style of the button label text.

Magnification
Determines the overall magnification of the button.

Rotation (degrees)
Determines the rotation angle (in degrees) of the button.

Scale Factor On X Axis


Scales the X Axis of the button symbol by the specified amount.

Scale factor On Y Axis


Scales the Y Axis of the button symbol by the specified amount.

Symbol 0
Specifies the symbol to display for the pushbutton when the button has not been clicked. Any symbol may be
used.

Symbol 1
Specifies the symbol to display for the pushbutton while the button is being clicked. Any symbol may be used.

Copyright 2008 QEI, Inc PMacros 21


WorldView PC Developerrs Guide WVPC-2000-PG

5.7 Station Color PMacro


The Station Color PMacro displays a fixed symbol, whose color changes according the alarm state of the
associated station point.

5.7.1 Station Color Resources


Button Label
Specifies the text that appears beside the PMacro symbol.

Button Label Drawing Style Table


Determines the color of the text that appears beside the PMacro symbol.

Button Label Text Style


Determines the text style of the text that appears beside the PMacro symbol.

Button Label X Offset


Determines the X Offset of the text that appears beside the PMacro symbol.

Button Label Y Offset


Determines the Y Offset of the text that appears beside the PMacro symbol.

Magnification
Determines the overall magnification of the PMacro.

NAK Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro symbol if the associated station
currently has an unacknowledged alarm. The index into the Drawing Style Table is determined by the highest
priority alarm of any point belonging to the station.

Normal Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro symbol if the associated station
currently has no unacknowledged alarms. The index into the Drawing Style Table is determined by the highest
priority alarm of any point belonging to the station.

Point Name
Associates the PMacro with a station point.

Rotation (degrees)
Determines the rotation angle (in degrees) of the PMacro symbol.

Scale Factor On X Axis, Scale Factor On Y Axis


Scales the X Axis of the PMacro symbol by the specified amount. Scales the Y Axis of the PMacro symbol by
the specified amount.

Select Box Drawing Style


Determines the color(s) of the select box that appears around the PMacro when it is selected.

Symbol
Associates a symbol with the PMacro.

22 PMacros Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

5.8 Station Symbol PMacro


A Station Symbol PMacro displays a different symbol for each station alarm priority. The color of the symbols
can also be varied according to the station alarm priority.

5.8.1 Station Symbol Resources


Button Label
Specifies the text that appears beside the PMacro symbol.

Button Label Drawing Style Table


Determines the color of the text that appears beside the PMacro symbol.

Button Label Text Style


Determines the text style of the text that appears beside the PMacro symbol.

Button Label X Offset


Determines the X Offset of the text that appears beside the PMacro symbol.

Button Label Y Offset


Determines the Y Offset of the text that appears beside the PMacro symbol.

Magnification
Determines the overall magnification of the PMacro.

NAK Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro symbol if the associated station
currently has an unacknowledged alarm. The index into the Drawing Style Table is determined by the highest
priority alarm of any point belonging to the station.

NAK Symbol 0
Specifies the symbol to display if the associated station currently has an unacknowledged alarm and the highest
priority alarm of any point belonging to the station is 0.

NAK Symbol 1
Specifies the symbol to display if the associated station currently has an unacknowledged alarm and the highest
priority alarm of any point belonging to the station is 1.

NAK Symbol 2
Specifies the symbol to display if the associated station currently has an unacknowledged alarm and the highest
priority alarm of any point belonging to the station is 2.

NAK Symbol 3
Specifies the symbol to display if the associated station currently has an unacknowledged alarm and the highest
priority alarm of any point belonging to the station is 3.

NAK Symbol 4
Specifies the symbol to display if the associated station currently has an unacknowledged alarm and the highest
priority alarm of any point belonging to the station is 4.

Copyright 2008 QEI, Inc PMacros 23


WorldView PC Developerrs Guide WVPC-2000-PG

Normal Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro symbol if the associated station
currently has no unacknowledged alarms. The index into the Drawing Style Table is determined by the highest
priority alarm of any point belonging to the station.

Point Name
Associates the PMacro with a station point.

Rotation (degrees)
Determines the rotation angle (in degrees) of the PMacro symbol.

Scale Factor On X Axis


Scales the X Axis of the PMacro symbol by the specified amount.

Scale Factor On Y Axis


Scales the Y Axis of the PMacro symbol by the specified amount.

Select Box Drawing Style


Determines the color(s) of the select box that appears around the PMacro when it is selected.

Symbol 0
Specifies the symbol to display if there are no active alarms on any point belonging to the associated station.

Symbol 1
Specifies the symbol to display if the associated station currently has no unacknowledged alarms and the
highest priority alarm of any point belonging to the station is 1.

Symbol 2
Specifies the symbol to display if the associated station currently has no unacknowledged alarms and the
highest priority alarm of any point belonging to the station is 2.

Symbol 3
Specifies the symbol to display if the associated station currently has no unacknowledged alarms and the
highest priority alarm of any point belonging to the station is 3.

Symbol 4
Specifies the symbol to display if the associated station currently has no unacknowledged alarms and the
highest priority alarm of any point belonging to the station is 4.

5.9 Status Color PMacro


A Status Color PMacro displays a fixed symbol, whose color varies according to the state of the associated
status point. For single bit status points, State 0 and State 1 are available. For dual bit status points, State 0
thru State 3 are available. An example of a Status Color PMacro is shown below.

State 0 State 1 State 2 State 3

24 PMacros Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

5.9.1 Status Color Resources


Alarm Blocked Flag Drawing Style Table
Determines the Drawing Style Table used to determine the color of the PMacros blocked flag.

Alarm Blocked Flag Enable


Determines whether the PMacros blocked flag is enabled or disabled.

Alarm Blocked Flag Offset X


Determines the X offset of the blocked flag relative to the center point of the PMacro symbol.

Alarm Blocked Flag Offset Y


Determines the Y offset of the blocked flag relative to the center point of the PMacro symbol.

Button Label
Specifies the text that appears beside the PMacro symbol.

Button Label Drawing Style Table


Determines the color of the text that appears beside the PMacro symbol.

Button Label text Style


Determines the text style of the text that appears beside the PMacro symbol.

Button Label X Offset


Determines the X Offset of the text that appears beside the PMacro symbol.

Button Label Y Offset


Determines the Y Offset of the text that appears beside the PMacro symbol.

Condition flag Drawing Style table


Determines the Drawing Style Table used to determine the color of the PMacros condition flag.

Condition Flag Enable


Determines whether the PMacros condition flag is enabled or disabled.

Condition Flag Offset X


Determines the X offset of the condition flag relative to the center point of the PMacro symbol.

Condition flag Offset Y


Determines the Y offset of the condition flag relative to the center point of the PMacro symbol.

Control Fail Timeout

Copyright 2008 QEI, Inc PMacros 25


WorldView PC Developerrs Guide WVPC-2000-PG

Specifies the time that the control panel remains displayed after a control operation has failed. Specifying a non-
zero value allows the user to retry a control without reselecting the point.

Control Success Timeout


Specifies the time that the control panel remains displayed after a successful control has been performed.
Specifying a non-zero value allows you to issue multiple controls without reselecting the point.

Dialog Code
The specified dialog code determines the type of dialog box that is displayed when the user clicks on the
PMacro. The table below describes each dialog code: The two standard codes in use are 0 and 1.
0 STANDARD
1 TAP CHANGER
2 NO CONTROL ICON
3 AUTO EXECUTE
4 SET MANUAL
5 SET MANUAL WITH TAG

Flag Scale Factor X


Stretches or shrinks the x-axis of the PMacro flag symbols.

Flag Scale Factor Y


Stretches or shrinks the y-axis of the PMacro flag symbols.

Magnification
Determines the overall magnification of the PMacro.

NAK Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro symbol if the associated status
point currently has an unacknowledged alarm. The index into the Drawing Style Table is determined by the
value of the status point.

Normal Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro symbol if the associated status
point currently has no unacknowledged alarms. The index into the Drawing Style Table is determined by the
value of the status point.

Point Name
Associates the PMacro with a status point.

Rotation (degrees)
Determines the rotation angle (in degrees) of the PMacro symbol.

Scale Factor On X Axis


Scales the X Axis of the PMacro symbol by the specified amount.

Scale Factor On Y Axis


Scales the Y Axis of the PMacro symbol by the specified amount.

26 PMacros Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

Select Box Drawing Style


Determines the color(s) of the select box that appears around the PMacro when it is selected.

Symbol
Associates a symbol with the PMacro.

Tag Flag Drawing Style Table


Determines the Drawing Style Table used to determine the color(s) of the PMacros tag flag.

Tag Flag Enable


Determines whether the PMacros tag flag is enabled or disabled.

Tag Flag Offset X


Determines the X offset of the tag flag relative to the center point of the PMacro symbol.

Tag Flag Offset Y


Determines the Y offset of the tag flag relative to the center point of the PMacro symbol.

Copyright 2008 QEI, Inc PMacros 27


WorldView PC Developerrs Guide WVPC-2000-PG

5.10 Status Symbol PMacro


A Status Symbol PMacro displays a different symbol for each state of the associated status point. In addition,
the color of each symbol can be varied according to the value of the status point. For single bit status points,
State 0 and State 1 are available. For dual bit status points, State 0 thru State 3 are available. An example of a
Status Symbol PMacro is shown below:

State 0 State 1 State 2 State 3

5.10.1 Status Symbol Resources


Alarm Blocked Flag Drawing Style Table
Determines the Drawing Style Table used to determine the color of the PMacros blocked flag.

Alarm Blocked Flag Enable


Determines whether the PMacros blocked flag is enabled or disabled.

Alarm Blocked Flag Offset X


Determines the X offset of the blocked flag relative to the center point of the PMacro symbol.

Alarm Blocked Flag Offset Y


Determines the Y offset of the blocked flag relative to the center point of the PMacro symbol.

Button Label
Specifies the text that appears beside the PMacro symbol.

Button Label Drawing Style Table


Determines the color of the text that appears beside the PMacro symbol.

Button Label Text Style


Determines the text style of the text that appears beside the PMacro symbol.

Button Label X Offset


Determines the X Offset of the text that appears beside the PMacro symbol.

Button Label Y Offset


Determines the Y Offset of the text that appears beside the PMacro symbol.

Condition flag Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacros condition flag.

Condition Flag Enable


Determines whether the PMacros condition flag is enabled or disabled.
28 PMacros Copyright 2008 QEI, Inc.
WVPC-2000-PG WorldView PC Developers Guide

Condition Flag Offset X


Determines the X offset of the condition flag relative to the center point of the PMacro symbol.

Condition flag Offset Y


Determines the Y offset of the condition flag relative to the center point of the PMacro symbol.

Control Fail Timeout


Specifies the time that the control panel remains displayed after a control operation has failed. Specifying a non-
zero value allows the user to retry a control without reselecting the point.

Control Success Timeout


Specifies the time that the control panel remains displayed after a successful control has been performed.
Specifying a non-zero value allows you to issue multiple controls without reselecting the point.

Dialog Code
The specified dialog code determines the type of dialog box that is displayed when the user clicks on the
PMacro. The table below describes each dialog code: The two standard codes in use are 0 and 1.
0 STANDARD
1 TAP CHANGER
2 NO CONTROL ICON
3 AUTO EXECUTE
4 SET MANUAL
5 SET MANUAL WITH TAG

Flag Scale Factor X


Stretches or shrinks the x-axis of the PMacro flag symbols.

Flag Scale Factor Y


Stretches or shrinks the y-axis of the PMacro flag symbols.

Magnification
Determines the overall magnification of the PMacro.

NAK Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro symbol if the associated status
point currently has an unacknowledged alarm. The index into the Drawing Style Table is determined by the
value of the status point.

NAK Symbol 0
Specifies the symbol to display if the status point currently has an unacknowledged alarm and the status point
state is 0.

NAK Symbol 1
Specifies the symbol to display if the status point currently has an unacknowledged alarm and the status point
state is 1.

NAK Symbol 2

Copyright 2008 QEI, Inc PMacros 29


WorldView PC Developerrs Guide WVPC-2000-PG

Specifies the symbol to display if the status point currently has an unacknowledged alarm and the status point
state is 2.

NAK Symbol 3
Specifies the symbol to display if the status point currently has an unacknowledged alarm and the status point
state is 3.

Normal Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro symbol if the associated status
point currently has no unacknowledged alarms. The index into the Drawing Style Table is determined by the
value of the status point.

Point Name
Associates the PMacro with a status point.

Rotation (degrees)
Determines the rotation angle (in degrees) of the PMacro symbol.

Scale Factor On X Axis


Scales the X Axis of the PMacro symbol by the specified amount.

Scale Factor On Y Axis


Scales the Y Axis of the PMacro symbol by the specified amount.

Select Box Drawing Style


Determines the color(s) of the select box that appears around the PMacro when it is selected.

Symbol 0
Specifies the symbol to display if the status point currently has no unacknowledged alarms and the status point
state is 0.

Symbol 1
Specifies the symbol to display if the status point currently has no unacknowledged alarms and the status point
state is 1.

Symbol 2
Specifies the symbol to display if the status point currently has no unacknowledged alarms and the status point
state is 2.

Symbol 3
Specifies the symbol to display if the status point currently has no unacknowledged alarms and the status point
state is 3.

Tag Flag Drawing Style Table


Determines the Drawing Style Table used to determine the color(s) of the PMacros tag flag.

Tag Flag Enable


Determines whether the PMacros tag flag is enabled or disabled.

Tag Flag Offset X


Determines the X offset of the tag flag relative to the center point of the PMacro symbol.
30 PMacros Copyright 2008 QEI, Inc.
WVPC-2000-PG WorldView PC Developers Guide

Tag Flag Offset Y


Determines the Y offset of the tag flag relative to the center point of the PMacro symbol.

5.11 Status Text PMacro


A Status text PMacro displays a different user defined text string according to the value of the associated status
point. In addition, the text color can be varied according to the value of the status point. For single bit status
points, String 0 and String 1 are available. For dual bit status points, String 0 thru String 3 are available. Note
that the position of the MBT flags are fixed and cannot be moved. An example of a Status Text PMacro is
shown below:

5.11.1 Status Text Resources


Alarm Blocked Flag Drawing Style Table
Determines the Drawing Style Table used to determine the color of the PMacros blocked flag.

Alarm Blocked Flag Enable


Determines whether the PMacros blocked flag is enabled or disabled.

Condition Flag Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacros condition flag.

Condition Flag Enable


Determines whether the PMacros condition flag is enabled or disabled.

Control Fail Timeout


Specifies the time that the control panel remains displayed after a control operation has failed. Specifying a non-
zero value allows the user to retry a control without reselecting the point.

Control Success Timeout


Specifies the time that the control panel remains displayed after a successful control has been performed.
Specifying a non-zero value allows you to issue multiple controls without reselecting the point.

Dialog Code
The specified dialog code determines the type of dialog box that is displayed when the user clicks on the
PMacro. The table below describes each dialog code:
0 STANDARD
1 TAP CHANGER
2 NO CONTROL ICON
3 AUTO EXECUTE
4 SET MANUAL
5 SET MANUAL WITH TAG

Horizontal Justification
Determines the horizontal justification of the PMacro text. Options are Default, Left, Right, Center and Decimal.

Copyright 2008 QEI, Inc PMacros 31


WorldView PC Developerrs Guide WVPC-2000-PG

NAK Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro text if the associated status point
currently has an unacknowledged alarm. The index into the Drawing Style Table is determined by the value of
the status point.

Normal Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro text if the associated status point
currently has no unacknowledged alarms. The index into the Drawing Style Table is determined by the value of
the status point.

Orientation
Determines the orientation of the PMacro. Options are Default, Horizontal or Vertical.

Point Name
Associates the PMacro with a status point.

Select Box Drawing Style


Determines the color(s) of the select box that appears around the PMacro when it is selected.

String 0
Specifies the text that will be displayed when the associated status point state is 0.

String 1
Specifies the text that will be displayed when the associated status point state is 1.

String 2
Specifies the text that will be displayed when the associated status point state is 2.

String 3
Specifies the text that will be displayed when the associated status point state is 3.

Tag Flag Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacros tag flag.

Tag Flag Enable


Determines whether the PMacros tag flag is enabled or disabled.

Text Style
Determines the Text Style to be used for the PMacro text.

5.12 Text Value PMacro


A Text Value PMacro displays the value of a text point. Note that the position of the MBT flags are fixed and
cannot be moved. An example of a Text Value PMacro is shown below:

5.12.1 Text Value Resources


Alarm Blocked Flag Drawing Style Table
32 PMacros Copyright 2008 QEI, Inc.
WVPC-2000-PG WorldView PC Developers Guide

Determines the Drawing Style Table used to determine the color of the PMacros blocked flag.

Alarm Blocked Flag Enable


Determines whether the PMacros blocked flag is enabled or disabled.

Condition Flag Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacros condition flag.

Condition Flag Enable


Determines whether the PMacros condition flag is enabled or disabled.

Horizontal Justification
Determines the horizontal justification of the PMacro text. Options are Default, Left, Right, Center and Decimal.

NAK Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro text if the associated text point
currently has an unacknowledged alarm.

Normal Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacro text if the associated status point
currently has no unacknowledged alarms. The index into the Drawing Style Table is determined by the value of
the status point.

Orientation
Determines the orientation of the PMacro. Options are Default, Horizontal or Vertical.

Point Name
Associates the PMacro with a status point.

Select Box Drawing Style


Determines the color(s) of the select box that appears around the PMacro when it is selected.

Tag Flag Drawing Style Table


Determines the Drawing Style Table used to determine the color of the PMacros tag flag.

Tag Flag Enable


Determines whether the PMacros tag flag is enabled or disabled.

Text Style
Determines the Text Style to be used for the PMacro text.

6 Drawing the Map


Now that most of the prep work has been completed, it is time to draw the Map. If you are importing the Map
from an AutoCAD drawing, the task is to import the drawing, then replace the AutoCAD symbols with PMacros.
If the Map is being drawn by hand, the task is to create the static graphical objects, then add PMacros. These
steps are typically performed in an repetitive manor.

Copyright 2008 QEI, Inc Drawing the Map


33
WorldView PC Developerrs Guide WVPC-2000-PG

Before importing or drawing, there should be at least three Layers created, one for the static background, one
for PMacros, and the other for text strings. Insure that the Layers are visible; if you place an object on the Map
and the selected Layer is not visible, the objects will not be displayed until the Layer is turned on.

6.1 Multiple Selections


When there are many objects on a Map, you may want to select several objects at the same time. There are
two ways to do this, either (1) select the Select button on the Edit toolbar, left click on the Map, drag the cursor
around the objects you want to select, then release the mouse button, or (2) while holding the Ctrl key on the
keyboard, select each object by left clicking on them. When the objects are selected, they can be moved around
the Map as a group. It is also possible to group these objects together so they can be manipulated as one
object. After selecting the objects, right click inside the group area then select Group -> Group from the popup
menu. Once grouped, selecting any of the objects in the group will select the entire group. To ungroup, select
the group, right click and select Ungroup for the popup menu.

It is also possible to change the Drawing Style, Text Style, or Layer assignment of individual objects or of a
Group. Select the objects or group, right click and select Recolor, Restyle, or Relayer from the popup menu.
The objects or groups will be changed to the color of the currently selected Drawing Style, or Text Style, or
Layer. Note that only objects drawn with the color {dynamic} or the Text Style {textStyle} will change color or
Text Style. Also note that if the Layer you change to is not visible, the selected objects will not be visible until
that Layer is turned on.

It is possible to draw a portion of a Map, say for instance a circuit, then copy it to another section of the Map. To
do this, select the objects or groups you want to copy, right click and select Copy then Paste from the popup
menu. A positioning box appears on the Screen. Place the box where you want the objects copied, then left
click; the objects are copied to that position on the Map.

You can use the Change Station feature to change the station name Resource of PMacros. This is very useful
in the cut and paste procedure previously described. Select the objects or groups you want to change, right
click and select Change Station from the popup menu. The change Station dialog box appears.

Select the From: Station name and the To: Station name and select
the Rename button. The PMacros are renamed and statistics are
presented to show the number of PMacros modified. Select the
browse button to get more information on PMacros not modified or
Station names not found. Select Cancel to exit the dialog box.

Objects can also be deleted from the Map. Select the objects or groups you want to delete and press the Delete
key on the keyboard. The objects or groups are removed from the Map.

34 Drawing the Map Copyright 2008 QEI, Inc.


WVPC-2000-PG WorldView PC Developers Guide

6.2 Drawing Tips


When drawing the Map, the following tips may be useful:

- Use temporary horizontal and vertical lines as a ruler. When completed, delete the lines. Alternately, a
Layer could be created that is used to draw the guide lines. Draw the lines on this Layer and turn the Layer
off when no longer needed. The Layer can be turned back on when updating the Map. Remember, to draw
horizontal and vertical lines, press and hold the shift key before drawing the line.

- Create the view (drawing) with the most information in it and use it as a template for the other views. It is
easier to delete objects than it is to add objects.

- Allow enough space for dynamic fields. For instance, use 123.45MBT as a position holder for analog
values.

- Use a different symbol for different dynamic states, for instance an open breaker verses a closed breaker.
Do not rely just on color to differentiate the different states. This allows for color-blind operators and bad
monitors.

- When importing one map on another, watch origin of DFX file. Try to get the CAD department to make
different origins so that the drawings lay at different positions on the WorldView Map.

- To set Layer visibility: From the Views and Layers window (Layers tab), select the Layer you want to set.
Insure that the Edit button is pressed. Right click on the Layer and set the Layer to Visible and not to Auto.
Zoom to the level where you want to see the Layer turned on. Right click on the Layer and select the Modify
menu item. Set the Maximum scale by selecting the Current button. Set the Layer to Auto.

- To create a View, place the Map at the location and zoom level where you want the new View. From the
Views and Layers window (Views tab), right click on the View folder icon and select the Add menu item.
Enter the name of the new view and select the Current button to set the zoom level and location of the new
view.

- To set the background color, select View -> Background Color from the menu on the main window.
Remember that if the Print in True-Color option is selected (View -> Options -> Map View tab), the Map is
printed as it is seen on the monitor, including the background color. If the option is not selected, the Maps
background is printed in white, which will save a lot of ink.

Copyright 2008 QEI, Inc Drawing the Map


35

S-ar putea să vă placă și