You are on page 1of 284

Document Number: WV-201

WorldView for Windows


Editor’s Guide
____________________________________________

October 23, 2009

This manual describes how to use the editing facilities in WorldView for Windows.

Survalent Technology Corporation


Mississauga, Ontario
Copyright © 2000 – 2009 Survalent Technology Corporation

All rights reserved

WV-201 WorldView for Windows Editor’s Guide

Survalent Technology Corporation


2600 Argentia Road
Mississauga, Ontario L5N 5V4

TEL (905) 826-5000

FAX (905) 826-7144

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).

Worldview for Windows Revision i


Editor’s Guide
Contents

1 Introduction 1-1

1.1 Other Documentation .................................................................................................................. 1-2

2 Overview 2-1

2.1 Libraries....................................................................................................................................... 2-1


2.2 Edit Tools .................................................................................................................................... 2-2
2.2.1 File Menu ............................................................................................................................. 2-3
2.2.2 Edit Menu ............................................................................................................................. 2-4
2.2.3 View Menu ........................................................................................................................... 2-4
2.2.4 Map Menu ............................................................................................................................ 2-5
2.2.5 Tool Bar ............................................................................................................................... 2-5
2.2.6 Navigation Bar ..................................................................................................................... 2-5
2.2.7 Edit Bar ................................................................................................................................ 2-6
2.3 Library Selector ........................................................................................................................... 2-7

3 Getting Started 3-1

3.1 Library Selector ........................................................................................................................... 3-2


3.2 Creating Drawing Styles.............................................................................................................. 3-4
3.3 Creating Text Styles .................................................................................................................... 3-6
3.4 Creating Symbols ........................................................................................................................ 3-7
3.4.1 Breaker Symbol .................................................................................................................... 3-8
3.4.2 Pushbutton Symbol ............................................................................................................ 3-10
3.4.3 Substation Symbol ............................................................................................................. 3-11
3.4.4 Load Symbol ...................................................................................................................... 3-12
3.4.5 Switch Symbol ................................................................................................................... 3-13
3.4.6 Transformer Symbol .......................................................................................................... 3-14

Worldview for Windows Contents i


Editor’s Guide
3.4.7 Fuse Symbol .......................................................................................................................3-16
3.5 Drawing Style Tables ................................................................................................................3-20
3.6 Creating Pmacros .......................................................................................................................3-22
3.6.1 Pushbutton Pmacro .............................................................................................................3-23
3.6.2 Analog Point Pmacro ..........................................................................................................3-26
3.6.3 Substation Pmacro ..............................................................................................................3-28
3.6.4 Breaker Pmacro ..................................................................................................................3-29
3.6.5 Switch Pmacro ....................................................................................................................3-31
3.6.6 Fuse Pmacro .......................................................................................................................3-31
3.7 The Map .....................................................................................................................................3-32
3.7.1 Substation Layer .................................................................................................................3-32
3.7.2 Feeder Layer .......................................................................................................................3-44
3.7.3 Main Layer .........................................................................................................................3-51

4 Drawing Styles 4-1

4.1 Drawing Style Editor ...................................................................................................................4-1


4.1.1 Name ....................................................................................................................................4-3
4.1.2 Color Add .............................................................................................................................4-3
4.1.3 Color Modify ........................................................................................................................4-5
4.1.4 Color Insert ...........................................................................................................................4-5
4.1.5 Color Delete .........................................................................................................................4-5
4.1.6 Line Width ............................................................................................................................4-5
4.1.7 Line Style .............................................................................................................................4-6
4.1.8 Cyclic Colors ........................................................................................................................4-6
4.1.9 Pixmap ..................................................................................................................................4-6
4.1.10 Apply ....................................................................................................................................4-6
4.1.11 Undo .....................................................................................................................................4-6
4.1.12 Save ......................................................................................................................................4-7
4.1.13 Cancel ...................................................................................................................................4-7
4.2 Drawing Style Table Editor .........................................................................................................4-7
4.2.1 Name ....................................................................................................................................4-8
4.2.2 Drawing Style Selection List ................................................................................................4-9
4.2.3 Drawing Style Table Element List .......................................................................................4-9
4.2.4 Apply ....................................................................................................................................4-9
4.2.5 Undo .....................................................................................................................................4-9
4.2.6 Save ......................................................................................................................................4-9
4.2.7 Cancel ...................................................................................................................................4-9
4.3 Using Drawing Style Tables ......................................................................................................4-10
4.3.1 Analog Point .......................................................................................................................4-10
4.3.2 Status Point .........................................................................................................................4-11
4.3.3 Station .................................................................................................................................4-11
4.3.4 Unacknowledged Alarms ...................................................................................................4-12
4.3.5 Flags ...................................................................................................................................4-13
4.3.6 Owner Tags ........................................................................................................................4-14
4.3.7 Pushbutton ..........................................................................................................................4-15
4.3.8 Segment ..............................................................................................................................4-15
4.3.9 Line Section ........................................................................................................................4-16

Worldview for Windows Contents ii


Editor’s Guide
4.3.10 Customizing Drawing Style Tables.................................................................................... 4-16

5 Text Styles 5-1

5.1 Name ........................................................................................................................................... 5-3


5.2 Select Font ................................................................................................................................... 5-3
5.3 Orientation ................................................................................................................................... 5-3
5.4 Horizontal Justification ............................................................................................................... 5-4
5.5 Vertical Justification.................................................................................................................... 5-4
5.6 Apply ........................................................................................................................................... 5-4
5.7 Undo ............................................................................................................................................ 5-4
5.8 Save ............................................................................................................................................. 5-5
5.9 Cancel .......................................................................................................................................... 5-5

6 Symbols 6-1

6.1 Creating a New Symbol............................................................................................................... 6-2


6.2 Opening an Existing Symbol ....................................................................................................... 6-3
6.3 Editing a Symbol ......................................................................................................................... 6-4
6.3.1 Symbol Origin ...................................................................................................................... 6-5
6.4 Symbol Table .............................................................................................................................. 6-6
6.4.1 Name .................................................................................................................................... 6-7
6.4.2 Symbol Selection List .......................................................................................................... 6-7
6.4.3 Symbol Table Element List .................................................................................................. 6-8
6.4.4 Apply .................................................................................................................................... 6-8
6.4.5 Undo ..................................................................................................................................... 6-8
6.4.6 Save ...................................................................................................................................... 6-8
6.4.7 Cancel................................................................................................................................... 6-8
6.5 Using Symbol Tables .................................................................................................................. 6-8
6.5.1 Flags ..................................................................................................................................... 6-9
6.5.2 Owner Tags ........................................................................................................................ 6-11
6.5.3 Customizing Symbol Tables .............................................................................................. 6-12

7 Pmacros 7-1

7.1 Editing a Pmacro ......................................................................................................................... 7-3


7.1.1 Editing Resources................................................................................................................. 7-7
7.1.2 Deleting a Pmacro .............................................................................................................. 7-10
7.2 Pmacro Classes .......................................................................................................................... 7-10
7.2.1 Analog Value Pmacro ........................................................................................................ 7-11
7.2.2 Analog Bar Pmacro ............................................................................................................ 7-12
7.2.3 Analog Gauge Pmacro ....................................................................................................... 7-13
7.2.4 Analog History Pmacro ...................................................................................................... 7-14
7.2.5 Mobile Icon Pmacro ........................................................................................................... 7-15
7.2.6 Mobile Icon Bitmap Pmacro .............................................................................................. 7-16
7.2.7 Pseudo Color Pmacro (VMS SCADA Only) ..................................................................... 7-16

Worldview for Windows Contents iii


Editor’s Guide
7.2.8 Pseudo Symbol Pmacro (VMS SCADA Only) ..................................................................7-17
7.2.9 Pseudo Text Pmacro (VMS SCADA Only) .......................................................................7-18
7.2.10 Pushbutton Symbol Pmacro ...............................................................................................7-19
7.2.11 Station Color Pmacro .........................................................................................................7-20
7.2.12 Station Symbol Pmacro ......................................................................................................7-21
7.2.13 Status Color Pmacro ...........................................................................................................7-22
7.2.14 Status Symbol Pmacro ........................................................................................................7-23
7.2.15 Status Text Pmacro .............................................................................................................7-24
7.2.16 Text Value Pmacro .............................................................................................................7-25
7.2.17 Pushbutton Bitmap Pmacro ................................................................................................7-26
7.2.18 Station Bitmap Pmacro .......................................................................................................7-27
7.2.19 Status Bitmap Pmacro ........................................................................................................7-28
7.2.20 Time Value Pmacro ............................................................................................................7-29
7.2.21 Templates ...........................................................................................................................7-30
7.3 Pmacro Resources ......................................................................................................................7-32
7.3.1 Alarm Blocked Flag Drawing Style Table .........................................................................7-32
7.3.2 Alarm Blocked Flag Enable ...............................................................................................7-32
7.3.3 Alarm Blocked Flag Offset X.............................................................................................7-33
7.3.4 Alarm Blocked Flag Offset Y.............................................................................................7-33
7.3.5 Analog Scale Factor ...........................................................................................................7-33
7.3.6 Angle Length ......................................................................................................................7-33
7.3.7 Angle Start ..........................................................................................................................7-33
7.3.8 Arrow Head Size ................................................................................................................7-33
7.3.9 Bar Length ..........................................................................................................................7-34
7.3.10 Bar Width ...........................................................................................................................7-34
7.3.11 Bitmap 0, 1, 2, 3, 4 .............................................................................................................7-34
7.3.12 Bitmap Height ....................................................................................................................7-34
7.3.13 Bitmap Width .....................................................................................................................7-34
7.3.14 Button Argument 1 Data ....................................................................................................7-35
7.3.15 Button Argument 1 Type ....................................................................................................7-35
7.3.16 Button Argument 2 Data ....................................................................................................7-35
7.3.17 Button Argument 2 Type ....................................................................................................7-35
7.3.18 Button Data.........................................................................................................................7-36
7.3.19 Button Label .......................................................................................................................7-36
7.3.20 Button Label Drawing Style Table .....................................................................................7-37
7.3.21 Button Label Text Style......................................................................................................7-37
7.3.22 Button Label X Offset ........................................................................................................7-37
7.3.23 Button Label Y Offset ........................................................................................................7-37
7.3.24 Button Type ........................................................................................................................7-37
7.3.25 Color Status Point Name ....................................................................................................7-38
7.3.26 Condition Flag Drawing Style Table ..................................................................................7-38
7.3.27 Condition Flag Enable ........................................................................................................7-39
7.3.28 Condition Flag Offset X .....................................................................................................7-39
7.3.29 Condition Flag Offset Y .....................................................................................................7-39
7.3.30 Control Fail Timeout ..........................................................................................................7-39
7.3.31 Control Panel Filename ......................................................................................................7-40
7.3.32 Control Panel Point Prefix ..................................................................................................7-40
7.3.33 Control Panel String 1, 2, 3 ................................................................................................7-40
7.3.34 Control Panel X Position ....................................................................................................7-40

Worldview for Windows Contents iv


Editor’s Guide
7.3.35 Control Panel Y Position .................................................................................................... 7-40
7.3.36 Control Success Timeout ................................................................................................... 7-41
7.3.37 Data Item ............................................................................................................................ 7-41
7.3.38 Dial Colour ......................................................................................................................... 7-42
7.3.39 Dial Direction ..................................................................................................................... 7-42
7.3.40 Dialog Code ....................................................................................................................... 7-42
7.3.41 Disallow Manual Set .......................................................................................................... 7-49
7.3.42 Drawing Style..................................................................................................................... 7-49
7.3.43 Draw from base .................................................................................................................. 7-49
7.3.44 Erase Before Draw ............................................................................................................. 7-50
7.3.45 Filename ............................................................................................................................. 7-50
7.3.46 Flag Scale Factor X ............................................................................................................ 7-51
7.3.47 Flag Scale Factor Y ............................................................................................................ 7-51
7.3.48 Gauge Subtype ................................................................................................................... 7-51
7.3.49 Gauge Type ........................................................................................................................ 7-51
7.3.50 Horizontal Justification ...................................................................................................... 7-51
7.3.51 Image Scale Factor, X Axis................................................................................................ 7-52
7.3.52 Image Scale Factor, Y Axis................................................................................................ 7-52
7.3.53 Label Color......................................................................................................................... 7-52
7.3.54 Label Position X ................................................................................................................. 7-52
7.3.55 Label Position Y ................................................................................................................. 7-52
7.3.56 Label Text .......................................................................................................................... 7-53
7.3.57 Label Text Style ................................................................................................................. 7-53
7.3.58 Limit Color ......................................................................................................................... 7-53
7.3.59 Limit Max Value ................................................................................................................ 7-53
7.3.60 Limit Min Value ................................................................................................................. 7-53
7.3.61 Limit Center Color ............................................................................................................. 7-53
7.3.62 Limit Max Visible % .......................................................................................................... 7-54
7.3.63 Limit Min Visible % .......................................................................................................... 7-54
7.3.64 Limits Number ................................................................................................................... 7-54
7.3.65 Lower Limit ....................................................................................................................... 7-54
7.3.66 Magnification ..................................................................................................................... 7-54
7.3.67 Magnification Point Name ................................................................................................. 7-54
7.3.68 Major / Minor Divisions..................................................................................................... 7-55
7.3.69 Major / Minor Divisions Color........................................................................................... 7-55
7.3.70 Major Divisions Precision .................................................................................................. 7-55
7.3.71 Major Divisions Text Color ............................................................................................... 7-55
7.3.72 Major Divisions Text Style ................................................................................................ 7-55
7.3.73 Minimum Size (Pixels)....................................................................................................... 7-55
7.3.74 NAK Bitmap 0, 1, 2, 3, 4 ................................................................................................... 7-56
7.3.75 NAK Drawing Style Table ................................................................................................. 7-56
7.3.76 NAK Symbol 0, 1, 2, 3, 4 ................................................................................................... 7-56
7.3.77 Needle Color ...................................................................................................................... 7-56
7.3.78 Needle Type ....................................................................................................................... 7-57
7.3.79 Needle Visible Percentage ................................................................................................. 7-57
7.3.80 Normal Drawing Style Table ............................................................................................. 7-57
7.3.81 Orientation.......................................................................................................................... 7-57
7.3.82 Owner Tag Flag Drawing Style Table ............................................................................... 7-58
7.3.83 Owner Tag Flag Enable ..................................................................................................... 7-58

Worldview for Windows Contents v


Editor’s Guide
7.3.84 Owner Tag Flag Offset X ...................................................................................................7-58
7.3.85 Owner Tag Flag Offset Y ...................................................................................................7-58
7.3.86 Owner Tag Flag Symbols ...................................................................................................7-58
7.3.87 Point Name .........................................................................................................................7-58
7.3.88 Point Title 1, 2, 3 ................................................................................................................7-59
7.3.89 Precision .............................................................................................................................7-59
7.3.90 Radius .................................................................................................................................7-59
7.3.91 Rotation (degrees) ..............................................................................................................7-59
7.3.92 Scale Factor On X Axis ......................................................................................................7-60
7.3.93 Scale Factor On Y Axis ......................................................................................................7-60
7.3.94 Select Box Drawing Style ..................................................................................................7-60
7.3.95 Sign Flag Enable.................................................................................................................7-60
7.3.96 Station Name ......................................................................................................................7-60
7.3.97 Station Name 2, 3, 4 ...........................................................................................................7-60
7.3.98 String 0, 1, 2, 3 ...................................................................................................................7-61
7.3.99 Symbol................................................................................................................................7-61
7.3.100 Symbol 0, 1, 2, 3, 4 .............................................................................................................7-61
7.3.101 Symbol Status Point Name .................................................................................................7-61
7.3.102 Tag Flag Drawing Style Table............................................................................................7-62
7.3.103 Tag Flag Enable..................................................................................................................7-62
7.3.104 Tag Flag Offset X ...............................................................................................................7-62
7.3.105 Tag Flag Offset Y ...............................................................................................................7-62
7.3.106 Thousands Separator ..........................................................................................................7-63
7.3.107 Text Style ...........................................................................................................................7-63
7.3.108 Time Format .......................................................................................................................7-63
7.3.109 Tool Tip Text......................................................................................................................7-63
7.3.110 Upper Limit ........................................................................................................................7-64
7.3.111 View Name .........................................................................................................................7-64
7.3.112 X Analog Point Name ........................................................................................................7-65
7.3.113 Y Analog Point Name ........................................................................................................7-65
7.3.114 Current Value Enable .........................................................................................................7-65
7.3.115 Enable Time .......................................................................................................................7-65
7.3.116 Enable Current 15M Max (or Min) ....................................................................................7-65
7.3.117 Enable Current Hour (Day or Week) Max (or Min) ...........................................................7-65
7.3.118 Enable Previous 15M (Hour, Day or Week) Max (or Min) ...............................................7-65
7.3.119 Format String ......................................................................................................................7-66
7.3.120 Warn on Execute ................................................................................................................7-66
7.4 Pushbuttons ................................................................................................................................7-67
7.4.1 View Pushbutton ................................................................................................................7-67
7.4.2 Graph Pushbutton ...............................................................................................................7-68
7.4.3 Task Pushbutton .................................................................................................................7-69
7.4.4 Note Pushbutton .................................................................................................................7-71
7.4.5 Image Pushbutton ...............................................................................................................7-72
7.4.6 External Data Pushbutton ...................................................................................................7-75
7.4.7 Report Pushbutton ..............................................................................................................7-77
7.5 Menu Files .................................................................................................................................7-79
7.5.1 Task Menu ..........................................................................................................................7-79
7.5.2 Analog Point Menu.............................................................................................................7-81
7.5.3 View Menu .........................................................................................................................7-82

Worldview for Windows Contents vi


Editor’s Guide
7.5.4 Report Menu....................................................................................................................... 7-84
7.6 Creating DSNs and UDL Files .................................................................................................. 7-85
7.6.1 Creating a DSN (Data Source Name) ................................................................................ 7-85
7.6.2 Creating a UDL File ........................................................................................................... 7-87
7.7 Missing Resource Check ........................................................................................................... 7-90
7.8 Sharing Resources With Other Users ........................................................................................ 7-91
7.8.1 Export Object ..................................................................................................................... 7-91
7.8.2 Import objects..................................................................................................................... 7-92

8 Map Editing 8-1

8.1 File Menu .................................................................................................................................... 8-1


8.1.1 New Map .............................................................................................................................. 8-2
8.1.2 Open ..................................................................................................................................... 8-3
8.1.3 Import ................................................................................................................................... 8-4
8.1.4 Export ................................................................................................................................... 8-4
8.1.5 Portable Map Export ............................................................................................................ 8-4
8.1.6 Save ...................................................................................................................................... 8-4
8.1.7 Save As................................................................................................................................. 8-4
8.1.8 Reservations ......................................................................................................................... 8-5
8.1.9 Publish LS’s ......................................................................................................................... 8-5
8.2 Edit Menu .................................................................................................................................... 8-5
8.2.1 Undo / Redo ......................................................................................................................... 8-6
8.2.2 Cut ........................................................................................................................................ 8-6
8.2.3 Copy ..................................................................................................................................... 8-6
8.2.4 Paste ..................................................................................................................................... 8-7
8.2.5 Clear ..................................................................................................................................... 8-7
8.2.6 Find ...................................................................................................................................... 8-8
8.2.7 Modify .................................................................................................................................. 8-8
8.2.8 Group.................................................................................................................................... 8-8
8.2.9 Ungroup................................................................................................................................ 8-9
8.2.10 Alignment ........................................................................................................................... 8-10
8.2.10.1 Left ......................................................................................................................................... 8-10
8.2.10.2 Right ...................................................................................................................................... 8-10
8.2.10.3 Top ......................................................................................................................................... 8-10
8.2.10.4 Bottom ................................................................................................................................... 8-10
8.2.10.5 Center Vertical ....................................................................................................................... 8-10
8.2.10.6 Center Horizontal ................................................................................................................... 8-10
8.2.10.7 Spaced Vertical ...................................................................................................................... 8-10
8.2.10.8 Spaced Horizontal .................................................................................................................. 8-11
8.2.10.9 Distribute as Matrix ............................................................................................................... 8-11
8.2.10.10 Same Height ....................................................................................................................... 8-12
8.2.10.11 Same Width ........................................................................................................................ 8-12
8.2.10.12 Same Size ........................................................................................................................... 8-12
8.2.11 Change Station ................................................................................................................... 8-12
8.2.12 Front ................................................................................................................................... 8-12
8.2.13 Back ................................................................................................................................... 8-13
8.2.14 Recolor ............................................................................................................................... 8-13

Worldview for Windows Contents vii


Editor’s Guide
8.2.15 Restyle ................................................................................................................................8-13
8.2.16 Relayer................................................................................................................................8-13
8.2.17 Nudge Functions.................................................................................................................8-13
8.2.18 Select Member ....................................................................................................................8-13
8.3 View Menu ................................................................................................................................8-14
8.3.1 Edit Bar...............................................................................................................................8-14
8.3.2 Edit Tools ...........................................................................................................................8-14
8.3.3 Alignment Bar ....................................................................................................................8-14
8.3.4 Background Images ............................................................................................................8-15
8.3.5 Tree Lists ............................................................................................................................8-15
8.3.6 Library Selector ..................................................................................................................8-16
8.4 Map Menu..................................................................................................................................8-17
8.4.1 Set Extent ...........................................................................................................................8-17
8.4.2 Set Grid...............................................................................................................................8-17
8.4.3 Optimize Map .....................................................................................................................8-18
8.4.4 Layer Statistics ...................................................................................................................8-19
8.4.5 Grid Enabled.......................................................................................................................8-20
8.5 Tool Bar .....................................................................................................................................8-20
8.6 Navigation Bar ...........................................................................................................................8-21
8.6.1 Layers .................................................................................................................................8-21
8.6.2 Views and Layers Lists ......................................................................................................8-22
8.6.3 Edit Mode ...........................................................................................................................8-22
8.7 Edit Bar ......................................................................................................................................8-22
8.7.1 Select ..................................................................................................................................8-22
8.7.2 Library Selector ..................................................................................................................8-24
8.7.3 Toggle Grid ........................................................................................................................8-24
8.7.4 Toggle Alignment Toolbar .................................................................................................8-24
8.7.5 Line .....................................................................................................................................8-24
8.7.6 Modifying Line Properties .................................................................................................8-25
8.7.7 Rectangle ............................................................................................................................8-26
8.7.8 Filled Rectangle ..................................................................................................................8-26
8.7.9 Modifying Rectangle Properties .........................................................................................8-26
8.7.10 Ellipse .................................................................................................................................8-26
8.7.11 Filled Ellipse.......................................................................................................................8-27
8.7.12 Arc ......................................................................................................................................8-27
8.7.13 Filled Arc ............................................................................................................................8-27
8.7.14 Modifying Arc Properties ...................................................................................................8-27
8.7.15 Closed Polygon...................................................................................................................8-29
8.7.16 Filled Polygon ....................................................................................................................8-29
8.7.17 Open Polygon .....................................................................................................................8-29
8.7.18 Modifying Polygon Properties ...........................................................................................8-30
8.7.19 Text String ..........................................................................................................................8-30
8.7.20 Modifying String Properties ...............................................................................................8-31
8.7.21 Symbol................................................................................................................................8-31
8.7.22 Modifying Symbol Properties ............................................................................................8-31
8.7.23 Pmacro ................................................................................................................................8-32
8.7.24 Pmacro Properties Dialog ...................................................................................................8-32
8.7.25 Attaching a Point Name to a Pmacro..................................................................................8-33
8.8 Groups .......................................................................................................................................8-36

Worldview for Windows Contents viii


Editor’s Guide
8.8.1 Creating a Group ................................................................................................................ 8-36
8.8.2 Segment .............................................................................................................................. 8-37
8.8.3 Select Member ................................................................................................................... 8-39
8.9 Views ......................................................................................................................................... 8-40
8.9.1 Creating a View.................................................................................................................. 8-40
8.9.2 Modifying a View .............................................................................................................. 8-42
8.9.3 Background Images ............................................................................................................ 8-43
8.9.4 Deleting a View.................................................................................................................. 8-45
8.9.5 Adding a Views Folder ...................................................................................................... 8-46
8.9.6 Deleting a Folder ................................................................................................................ 8-47
8.9.7 Organizing Views............................................................................................................... 8-47
8.9.8 Set As Default View........................................................................................................... 8-49
8.10 Layers ........................................................................................................................................ 8-49
8.10.1 Creating a Layer ................................................................................................................. 8-50
8.10.2 Setting Automatic Declutter Levels ................................................................................... 8-51
8.10.3 Deleting a Layer ................................................................................................................. 8-53
8.10.4 Layer Drawing Order ......................................................................................................... 8-53
8.10.5 Organizing Layers .............................................................................................................. 8-53

9 World Map Import 9-1

9.1 DXF File Import .......................................................................................................................... 9-2


9.1.1 Saved DXF Import Parameters ............................................................................................ 9-5
9.1.2 Text-to-Symbol Replacement in Microstation ..................................................................... 9-7
9.1.3 DWG / DXF File import ...................................................................................................... 9-8
9.2 Import From WorldView for VMS ............................................................................................. 9-9
9.3 Portable Map Export ................................................................................................................. 9-11

10 Change Control 10-1

10.1 Change Control With Reservations ........................................................................................... 10-1


10.1.1 Setup................................................................................................................................... 10-1
10.1.2 Reserving the WorldView Database .................................................................................. 10-2
10.1.3 Publishing Your Edits ........................................................................................................ 10-3
10.1.4 Update ................................................................................................................................ 10-4
10.2 Change Control Without Reservations ...................................................................................... 10-6
10.2.1 Control of Editing .............................................................................................................. 10-6
10.2.2 Publish and Update ............................................................................................................ 10-7

Worldview for Windows Contents ix


Editor’s Guide
1 Introduction

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 2, Overview, introduces you to the editing facilities.

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 7, Pmacros, describes how to create and modify pmacros.

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.

Worldview for Windows Introduction 1-1


Editor’s Guide
1.1 Other Documentation
This document is designed for the people who maintain your WorldView database. It does not describe in detail
how to manage map windows within WorldView nor how to navigate through a map (e.g. pan and zoom, and
request views). These are described in the companion document:

WorldView for Windows Operator’s Guide, document number WV-200

which should be regarded as pre-requisite reading for this editor’s guide.

For further background reading, you will also find the following SCADA documents useful (particularly the ones
related to the point database):

Table 1-1 Useful Documents


VMS SCADA Windows SCADA
Document Number Document Number Title
DB-900 DB-401 Point Database Editing Guide
DB-901 DB-402 Alarm Database Editing Guide
DB-902 DB-403 Calculation Database Editing Guide
DB-903 DB-404 Historical Database Editing Guide
DB-904 DB-405 Report Database Editing Guide

Worldview for Windows Introduction 1-2


Editor’s Guide
2 Overview

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.

Worldview for Windows Overview 2-1


Editor’s Guide
A pmacro is a complex object that represents a SCADA database point and/or acts as a poke point. Pmacros
associated with database points use symbols and text strings to display the current values of the points. When
you click on a point-related pmacro, it displays a dialog box that allows you to interact with the associated point
(e.g. to perform a control operation or acknowledge an alarm). Other types of pmacro serve as poke points that
allow you to bring up trend graphs, images and reports, or to jump to other views in the map. The WorldView
editor allows you to create a library of as many pmacros 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.

2.2 Edit Tools


The WorldView editor is built into the WorldView program itself. To go into edit mode, click on the Edit button in
the tool bar.

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.

Insensitive Edit button

Worldview for Windows Overview 2-2


Editor’s Guide
In edit mode, navigation through the map is the same as in view mode with one exception: poke points
associated with views don’t work. When you click on a view poke point, the editor doesn’t take you to that view.
The editor instead highlights the poke point and expects you to do something to it (i.e. edit it).

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.

2.2.1 File Menu

• New Map Create new map


• New Alarm View Create new alarm view
• New Opresum Create new operator Summary
view
• New Workspace Create a new workspace
• Open… Open existing map, symbol,
pmacro
• Import Open the Import popup window
• Export Open the Export popup window
• Close Close map, symbol or pmacro
• Save Save map, symbol or pmarco
• Save As… Open Save As dialog
• Reservations Open the Reservations popup
window
• Publish LS’s Publish line sections
• Projector Remote Opens Projector Control window
Control
• Login Login
• Logout Logout
• Set password Set a password
• Login Workstation Login Workstation
• Logout Logout Workstation
Workstation
• Print… Request print screen
• Print Preview Print preview
• Print Setup… Print setup
• Page Setup… Page Setup
• Exit Exit WorldView program

Worldview for Windows Overview 2-3


Editor’s Guide
2.2.2 Edit Menu

• 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…

2.2.3 View Menu

• Status Bar Display/hide status bar


• Tool Bar Display/hide tool bar
• Edit Bar Toggle edit mode and edit bar
• Navigate Bar Display/hide navigation bar
• Edit tools Display/hide Edit toolbar
• Alignment Bar Display/hide alignment bar
• Background Images Display/hide background images
• Tree Lists… Open Tree Lists window
• Library Selections… Open Library Selectior window
• Options… Open Options window
• Save Configuration Save current screen layout
• Trace events Open trace window

Worldview for Windows Overview 2-4


Editor’s Guide
2.2.4 Map Menu

• Set Extent… Open Set Extent window


• Set Grid… Open Set Grid window
• Optimize Map… Open Optimize Threshold window
• Layer Statistics… Get layer statistics
• Grid Enabled Ctrl+G Toggle Grid

2.2.5 Tool Bar

New Window Open a window with same contents as active window

Open Open a file

Save Save symbol, pmacro or map

Cut Cut object(s) from the map and copy to the clipboard

Copy Copy object(s) to the clipboard

Paste Copy items from the clipboard onto the map or symbol

Print Print

2.2.6 Navigation Bar

Layers Open the Layers drop-down menu

Views and layers List Open the Views and Layers pop-up window

Edit Mode Toggle edit mode and edit bar

Worldview for Windows Overview 2-5


Editor’s Guide
2.2.7 Edit Bar

The Edit bar appears whenever you are in Edit mode. The Edit bar is described in detail in section 8.7, Edit Bar.

Select an object for modification/deletion


Open the Library Selector pop-up window
Toggle Grid
Open Alignment Toolbar
Draw a Line with the selected drawing style
Draw a Rectangle with line/color of selected drawing style
Draw a Filled Rectangle with color of selected drawing style
Draw an Ellipse with line /color of selected drawing style
Draw a Filled Ellipse with color of selected drawing style
Draw a Arc with line/color of selected drawing style
Draw a Filled Arc with color of selected drawing style
Draw a Closed Polygon with line/color of selected drawing style
Draw a Filled Polygon with color of selected drawing style
Draw an Open Polygon with line/color of selected drawing style
Write Text String with font of selected text style and color of selected drawing style
Place on map a symbol selected from the symbol library
Place on map a pmacro selected from the pmacro library

Worldview for Windows Overview 2-6


Editor’s Guide
2.3 Library Selector

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.

Figure 2-1 Library Selector

Use of the Library Selector to access the various libraries is described throughout this document.

Worldview for Windows Overview 2-7


Editor’s Guide
3 Getting Started

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).

Figure 3-1 Simple Substation Example

Worldview for Windows Getting Started 3-1


Editor’s Guide
In this chapter, we’re going to use a white background because in printed versions of this document, the screen
captures look much better with white backgrounds. If you prefer a black background, that’s fine (in a WorldView
print screen, the background is not printed, so you need not worry about having print screens full of ink).

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.

3.1 Library Selector


In this chapter, we’re going to create not only a map but also some of the drawing styles, text styles and
symbols that go into the map. The libraries of drawing objects are accessible via the Library Selector window.
Survalent Technology supplies extensive libraries of such drawing objects, in fact all that you need to create a
good map. At some point, though, you will want to customize these objects and create new ones of your own so
that your map reflects your company’s drawing standards. Before we actually do some map editing, therefore,
we’re going to create some of the drawing objects needed to build the map of Figure 3-1 and add them to our
libraries. This will be the subject of the next few sections. Another reason for creating brand new drawing
objects is that if we modify existing ones, we’ll change the appearance of any existing maps that use them. We
don’t want to do that on our first go around.

To begin, let’s create a new empty map window to work in.

Figure 3-2 Empty WorldView Window

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)

Worldview for Windows Getting Started 3-2


Editor’s Guide
Notice that the Audible Alarm Silence is dimmed
(not available). To make it available, you have to
log into a privileged SCADA account.

Figure 3-3 New Map Window

4. To log in, click on the Login pushbutton.

In the Login window that appears, enter your


username and password and then click on OK.

5. After logging in, click on the Edit mode button to open the Edit toolbar that consist the Library Selector
button.

6. Now click on the Library Selector button.

This opens the Library Selector window shown


in (Figure 3-4). This is the starting point. You
will be creating many of the items you need for
your sample WorldView map from here

Figure 3-4 Library Selector Window

Worldview for Windows Getting Started 3-3


Editor’s Guide
3.2 Creating Drawing Styles
A drawing style consists of both colors and line styles. If you specify multiple colors in a drawing style, the
system will cycle through those colors at the rate of one color per second. This is how blinking and other fancy
effects can be produced.

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

the Library Selector button.

In the Library Selector window, click on the


Drawing Styles tab to bring it to the front and then,
with the mouse pointer in the Drawing Styles
window, right-click to open the pop-up menu, as
shown in Figure (Figure 3-5)

Figure 3-5 Pop-up Menu in


Drawing Styles Window

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).

Worldview for Windows Getting Started 3-4


Editor’s Guide
Figure 3-6 a)Drawing Style Editor,
b)Yellow Drawing Style

Figure 3-7 Color Window

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.

Worldview for Windows Getting Started 3-5


Editor’s Guide
9. Now we need to add some drawing styles that will appear to flash on and off. Start by adding a new drawing
style called _Alarm Yellow.
10. Click on the Color Add… button and select the first yellow box on the left by clicking on it once and then
click on the OK button to close the Color window.
11. Select Color Add… again. This time add black (the last box in the first column on the left) and click on OK. If
your screen background is black, anything drawn in this drawing style will appear to flash on and off, at the
rate of one color per second, when you’re not in edit mode.
12. Click on the Save button to close the Drawing Style Editor window and to save the new drawing style.
13. Repeat steps 8 to 12 for _Alarm Red using red and black.
14. Repeat steps 8 to 12 for _Alarm Orange using orange and black.
15. Now we need a couple of different line styles. Select the _Yellow drawing style we created earlier, right-click
on it and then select Modify.
16. Change the name to _Yellow Bus Bar and change the Line Width to 3 pixels. Lines drawn with this drawing
style will be 3 screen pixels wide at all zoom levels where the lines are visible (i.e. not de-cluttered). Save
the changes you made, and click Yes when asked if you want to create a new drawing style.
17. Open the _Yellow drawing style again. Change the name to _Yellow Feeder and change the line width to 2
pixels and save it.
You have now added to the drawing styles library the drawing styles that you’ll need for the sample map. Note
that this has been just a quick introduction. For a more detailed description of the Drawing Style Editor, see
Chapter 4, Drawing Styles.

3.3 Creating Text Styles


A text style consists of a font and font size, as well as other attributes such as orientation and alignment. A text
style does not specify color. The color of a text string is defined by the string’s associated drawing style (see
Section 3.2, Creating Drawing Styles).

1. With the mouse in the Text Styles window,


right-click to open a pop-up menu similar to the
one we saw earlier with drawing styles.

2. In the pop-up menu, click on the Add button.


The Text Style Editor will appear.

Figure 3-8 Text Styles of Library Selector

Worldview for Windows Getting Started 3-6


Editor’s Guide
3. In the Library Selector window, click on the
Text Styles tab to bring it to the front.

4. Type _Arial 200 into the Name field, as shown


in (Figure 3-9).

5. Click on the Select Font… button. This will


bring up the Font window shown in
(Figure 3-10).

Figure 3-9 Text Styles Editor

6. Click in the data entry box under the Size menu


and type in a value of 28.

7. Click on the OK button to close the Font


window

Figure 3-10 Font Window

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.

3.4 Creating Symbols


A symbol is a set of one or more drawing objects grouped together to represent something, that something
typically being a real world device such as a switch or a valve. Each symbol can be used many times in the
map. If you decide to change the appearance of a symbol, all you need to do is edit the symbol in the library and
all instances of the symbol in the map will be updated automatically.

Worldview for Windows Getting Started 3-7


Editor’s Guide
Figure 3-11 Symbols Tab of Library Selector

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.

3.4.1 Breaker Symbol

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.

1. To create a new symbol, access the Symbols


tab of the Library Selector window and right-
click anywhere in the list of symbols. In the
pop-up menu that appears, select Add.

Figure 3-12 Creating A New Symbol

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.)

Worldview for Windows Getting Started 3-8


Editor’s Guide
4. From the Map pull-down menu, select Set
Grid. A Grid dialog will appear. The spacing
should default to 10000 x 10000. If not, fill in
these values. Leave the Offsets set to zero.

5. Check the Grid Enabled check box and click on


Ok. (If you want to see the grid, you can check
the Grid Visible check box too.)

Figure 3-13 Grid Dialog

6. Click on the Filled Box button in the Edit bar.

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.

Figure 3-14 Red Square Symbol

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.

Worldview for Windows Getting Started 3-9


Editor’s Guide
9. In the File name field of the Save As window,
type the name _Breaker Closed and then click
on the Save button. This will save your symbol
and close the Save As window. But don’t close
the symbol yet.

Figure 3-15 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.

3.4.2 Pushbutton Symbol

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).

Figure 3-16 Pushbutton Symbol

1. Open the Library Selector, and in the Symbols list, right-click and select the Add function. A symbol drawing
window will appear.

Worldview for Windows Getting Started 3-10


Editor’s Guide
2. Access the Drawing Styles pane of the Library Selector and select the _Gray drawing style. 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 both the Grid Enabled and Grid Visible check boxes, and click on OK.

4. Select the Filled Box symbol from the Edit bar.

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.

3.4.3 Substation Symbol

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.

Figure 3-17 Substation Symbol

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.

Worldview for Windows Getting Started 3-11


Editor’s Guide
4. Select the Filled Ellipse tool from the Edit bar.

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.

3.4.4 Load Symbol

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).

Figure 3-18 Symbol of a Load

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.

4. Select the Filled Polygon tool from the Edit bar.

Worldview for Windows Getting Started 3-12


Editor’s Guide
5. Position the cursor at X:0 Y:5000 and click once. Drag the cursor down until the coordinates read X:8000
Y:0 and click once. Then drag the cursor up to the coordinates X:8000 Y:10000 and click twice. The drawing
will fill in the last line for you and fill in the polygon in yellow.

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.

3.4.5 Switch Symbol

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).

Figure 3-19 Open and Closed Switches

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.

6. Draw another circle the same size, beginning at X:5000 Y:0.

Worldview for Windows Getting Started 3-13


Editor’s Guide
7. Turn off the grid by selecting Set Grid (from the Map pull-down menu) and clearing the Grid Enabled check
box (by clicking on it), and click on OK.

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)).

1. In the Edit bar, click on the Select (arrow) tool.

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.

6. Close all open windows under the main WorldView Window.

3.4.6 Transformer Symbol

Next, we’ll make a symbol to represent a transformer.


The symbol for a transformer is shown in (Figure 3-20).

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.

Worldview for Windows Getting Started 3-14


Editor’s Guide
5. Position the cursor at X:0 Y:2000 and click once.

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.

Figure 3-20 Transformer Symbol

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.

Worldview for Windows Getting Started 3-15


Editor’s Guide
3.4.7 Fuse Symbol

Next, we’re going to create two different symbols for a fuse, one for each state of the fuse.

Figure 3-21 Open and Close Fuse Symbols

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).

Worldview for Windows Getting Started 3-16


Editor’s Guide
Figure 3-22 Partial Fuse

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).

Figure 3-23 Partial Fuse 2

7. With the Select tool, select the first circle, right-click on it, and from the pop-up menu that appears,
select modify.

Worldview for Windows Getting Started 3-17


Editor’s Guide
8. The Arc Properties dialog will open as shown in
(Figure 3-24). Change the value of the Start
field from 0 to 180, and change the Angle field
from 360 to 180 and click on OK.

Figure 3-24 Arc Properties Dialog

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).

Figure 3-25 Partially completed _Fuse Closed Symbol

Worldview for Windows Getting Started 3-18


Editor’s Guide
12. Select the circle you just drew and click on the copy and paste icons in the toolbar. Center the copy of the
circle over the second intersection of the semi-circle and the straight line, and click once to paste it. The
symbol is now complete and should look like the closed fuse in (Figure 3-21).

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).

Figure 3-26 Open Fuse

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.

Worldview for Windows Getting Started 3-19


Editor’s Guide
3.5 Drawing Style Tables
Drawing style tables are arrays of drawing styles used to dynamically color code things in the map. Drawing
styles contained in a drawing style table are selected by indexing according to the value of some parameter
associated with the object being color-coded. Examples of the use of drawing style tables are to color-code:

• 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.

_Unacknowledged Alarms Table

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.

Figure 3-27 Adding a Drawing Style Table

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.

Worldview for Windows Getting Started 3-20


Editor’s Guide
3. In the Name field, enter _Unacknowledged
Alarms.

Figure 3-28 Drawing Style Table Editor

4. In the scrollable list of drawing styles on


the left, click once on _Alarm Red and then once
on _Alarm Yellow (in that order). As you click on
each drawing style, you should see its name
appear in the list on the right. See (Figure 3-29).

5. Click on the Save button to save your drawing


style table and close the Drawing Style Table
Editor.

Figure 3-29 New Drawing Style Table

_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.

_Unacknowledged Station Alarms


1. Now we’ll create a table to use with stations in which at least one point has an unacknowledged alarm.
Access the Drawing Style Table Editor as above, and enter the name _Unacknowledged Station Alarms.
2. Add the color _Alarm Orange to the table, and then click on the Save button to save the table and close the
editor.

Worldview for Windows Getting Started 3-21


Editor’s Guide
_Acknowledged Station Alarms
1. Now we’ll create a table to use with stations that do not have any points with unacknowledged alarms.
Access the Drawing Style Table Editor as above, and enter the name _Acknowledged Station Alarms.
2. Add the color _Orange to the table, and then click on the Save button to save the table and dismiss the
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.

3.6 Creating Pmacros


Pmacros are dynamic objects that:

• display the values of database points, or


• act as poke points, or
• both of the above

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.

Pmacros can be associated with other things besides database points:

• clicking on a view pmacro brings up another view of the map


• clicking on a graph pmacro brings up an associated trend graph
• clicking on a task activation pmacro sends a run/stop message to an application
• clicking on an image pmacro brings up a pop-up photo
• clicking on a report pmacro brings up a Microsoft Excel or Query report
• clicking on an external data pushbutton retrieves a record from an external database

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.

Worldview for Windows Getting Started 3-22


Editor’s Guide
In this section, we will create a number of pmacros that will reference the drawing styles, text styles symbols
and drawing style tables that we have just created in the previous sections.

3.6.1 Pushbutton Pmacro

We’ll start with a pushbutton pmacro.

1. In the Pmacros list of the Library Selector,


right-click and select the Add function.

2. This brings up a Create Pmacro window


containing a list of pmacro classes that we can
choose from.

Figure 3-30 Adding a New Pmacro

3. Select Pushbutton Symbol from the list and


click OK.

4. This brings up a Pmacro Properties window, as


shown in (Figure 3-32). The Pmacro
Properties window contains three columns:
Resource, Override, and Default.

Figure 3-31 Selecting Pushbutton Symbol

Worldview for Windows Getting Started 3-23


Editor’s Guide
5. In the pushbutton Pmacro Properties window,
double-click on the Button Label Text Style
resource to open the Button Label Text Style
dialog.

Figure 3-32 Properties of Pushbutton Pmacro

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.

6. In the Button Label Text Style dialog, find and


select _Arial 200. Then click on the OK button
to close the dialog.

Figure 3-33 Button Label Text Style


Resource Dialog

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.

Figure 3-34 Button Label Drawing Style Table Resource Dialog

Worldview for Windows Getting Started 3-24


Editor’s Guide
8. Scroll down and double-click on the Symbol 0 resource. This will bring up a Symbol 0 dialog containing a list
of all of the available symbols. See (Figure 3-35). Locate the _Pushbutton symbol, click on it once and click
OK. The gray pushbutton symbol that we drew in section 3.4.2, Pushbutton Symbol, will appear in the
pmacro display window.

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.

9. To test how well the text style fits and looks on


the pushbutton, double-click on the Button
Label resource, enter F1, and select OK. The
label we just entered is shows up on the button
at the bottom left hand corner. The text size is
ok, but the text isn’t centered.

Figure 3-35 Symbol 0 Resource Dialog

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.

Figure 3-36 Button Label X and Y Offset Resource Dialogs

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.

Worldview for Windows Getting Started 3-25


Editor’s Guide
Figure 3-37 Save As Window

16. Click on the Close button under the File menu. This will close the Pushbutton pmacro

3.6.2 Analog Point 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.

2. From the Create Pmacro window that appears,


select Analog Value.

3. This causes the Pmacro Properties window for


the Analog Value pmacro to appear.

Figure 3-38 Selecting Analog Value Pmacro

Worldview for Windows Getting Started 3-26


Editor’s Guide
Figure 3-39 Properties of Analog Value Pmacro

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.

Figure 3-42 Text Style Resource Dialog

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.

Worldview for Windows Getting Started 3-27


Editor’s Guide
3.6.3 Substation Pmacro

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:

• existence of unacknowledged alarms on any point on the station


• priority of highest priority outstanding or unacknowledged alarm on any point on the station

Station pmacros can also act as view poke points.

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.

1. As we did above, start a new pmacro edit by


right-clicking in the Pmacros list of the Library
selector, and selecting the Add function.

2. In the Create Pmacro window that appears,


select station_color and then click on OK.

Figure 3-43 Creating A Station Color Pmacro

3. A Pmacro Properties window appears


containing resources for the Station Color
pmacro.

4. Note that there are five Button Label resources.


Since a substation pmacro would normally be
used several times (once for each substation),
we’ll leave the Button Label itself blank, to be
filled in when each instance is placed on the
map.

Figure 3-44 Properties of Station Color Pmacro

Worldview for Windows Getting Started 3-28


Editor’s Guide
5. Double click on the Magnification resource. A
Magnification dialog will appear, as shown in
(Figure 3-45). Enter 80 into the data entry field
and then click OK.

Figure 3-45 Magnification Resource Dialog

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.

8. Double-click on the Symbol resource, and in


the Symbol resource dialog that appears,
select _Substation and then click on OK.
The _Substation symbol that we created in
section 3.4.3, Substation Symbol, should
appear in the pmacro drawing area in orange.

Figure 3-46 Symbol Resource Dialog

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.

3.6.4 Breaker Pmacro

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.

Worldview for Windows Getting Started 3-29


Editor’s Guide
1. Start a new pmacro edit as we did above. From
the Create Pmacro window, select
status_symbol and click OK.

Figure 3-47 Creating A Status Symbol Pmacro

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.

Figure 3-48 Alarm Blocked Flag Enable Resource Dialog

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.

5. Double click on the NAK Symbol 0 resource


and select the _Breaker Open symbol by
clicking on it once. Click on OK to close the
dialog.

Figure 3-49 NAK Symbol 0 Resource Dialog

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.

Worldview for Windows Getting Started 3-30


Editor’s Guide
8. Scroll down until you can see the resources Symbol 0 and Symbol 1. Enter the _Breaker Open and
_Breaker Closed symbols into these resources.

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.

3.6.5 Switch Pmacro

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.

3. Double click on the Magnification resource.


In the resource dialog of (Figure 3-45) that appears, enter the value 5 and then click on OK.

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.

5. Double-click on the NAK Symbol 0 resource.


In the resource dialog of (Figure 3-49) that appears, select the _Switch Open symbol and click on OK.
Similarly, for the NAK Symbol 1 resource, specify the _Switch Closed symbol.

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.

3.6.6 Fuse Pmacro

Now we will create a Pmacro to represent a fuse.

1. Start a new pmacro edit as we did above. From the Create Pmacro window, select status_symbol and click
on OK.

2. Double-click on the Magnification resource.


In the resource dialog of (Figure 3-45) that appears, enter the value 5 and then 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.

Worldview for Windows Getting Started 3-31


Editor’s Guide
5. Double-click on the Symbol 0 resource and assign the _Fuse Open symbol to it. Similarly, assign the _Fuse
Closed symbol to the 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.

3.7 The Map


Now we are ready to create the map itself, using the symbols and Pmacros that have been created. Our first
task is to create and populate a layer called Substation.

3.7.1 Substation Layer

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.

Figure 3-50 Saving A New Map

Worldview for Windows Getting Started 3-32


Editor’s Guide
4. Click on the Tree List button located on
the Navigation bar. This brings up the Views
and Layers window, shown in (Figure 3-51).

Figure 3-51 Views and Layers Window

5. Click on the Layers tab to bring the Layers


pane to the front. You will see a folder icon with
the title Layers, as shown in (Figure 3-52).

Figure 3-52 Layers Tab

6. With the mouse over the Layers folder, right-


click to obtain a pop-up menu as shown in
(Figure 3-53). From this menu, select Create
Layer. This will bring up an Edit Layers dialog,
as shown in (Figure 3-54).

Note that you are allowed to create layers only


if the view is in Edit mode.

Figure 3-53 Layers Pop up Manu

Worldview for Windows Getting Started 3-33


Editor’s Guide
7. In the Layer Name field, enter Substation and
click OK. The Layers list now contains one
entry in it, Substation.

Figure 3-54 Edit Layers Dialog

8. Select the Substation layer by clicking on it


once. As shown in (Figure 3-55), this highlights
the layer name to indicate that the layer is
selected for insertion of graphics objects. The
green dot beside the layer name means that
the layer is currently visible (i.e. not
decluttered), and the capital A means that the
layer is set to Auto declutter.

Figure 3-55 Views and Layers Window with


Substation Selected

9. Dismiss the Views and Layers window

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.

Figure 3-56 Layers Selection Button

Worldview for Windows Getting Started 3-34


Editor’s Guide
11. From the Map pull-down menu, select Set Grid. If this function is dimmed, it’s because you are not logged
into a privileged account. As soon as you log in, the Set Grid function will be available. In the Grid dialog,
set the two Spacing fields to 1000, check the Grid Enabled check box and click OK.

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.

16. Click on the Text button in the Edit bar.

17. Click in the center of the view window. This will


open the String Properties dialog shown in
(Figure 3-57). In the String data entry field,
type Substation.

18. Change the Horizontal Justification from


Default to Center.

19. Click on the OK button to close the String


Properties dialog.

Figure 3-57 String Properties Dialog

Worldview for Windows Getting Started 3-35


Editor’s Guide
20. At first, the lettering may be very large and you may not be able to see all of the word. Using the Zoom
buttons located on the Navigation bar, zoom in and out until the word Substation is about the same size as
in the window in (Figure 3-58).

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.

23. Click on the Pmacro button in the Edit bar.

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.

Worldview for Windows Getting Started 3-36


Editor’s Guide
In this sample map, we’re not going assign point names to any of the pmacros. This will be described in
Chapter 8, Map Editing.

Figure 3-60 Substation with Five Breakers

25. In the Library Selector window, click on the Symbols tab, and from the list of symbols, select the
Transformer symbol.

26. Click on the Symbol button in the Edit bar.

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

Worldview for Windows Getting Started 3-37


Editor’s Guide
28. Click on the Drawing Styles tab in the Library Selector and from the list of drawing styles, select the Yellow
Bus Bar drawing style.

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).

Figure 3-63 Figure 3-64

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).

Worldview for Windows Getting Started 3-38


Editor’s Guide
35. Now draw two lines connecting the Bus Bar to
the two breakers directly above the Bus Bar.

36. Draw four more lines to connect both


transformers to the breakers directly above and
below them. Your map should now look like
(Figure 3-65).

Figure 3-65

37. Draw a line extending upward from each of the


two uppermost breakers. The line should
extend near the top of the window.

38. Click on the Drawing Styles tab of the Library


Selector, and select the _Yellow Feeder
drawing style.

39. Draw four lines, one from each of the four


lowest breakers, downwards towards the
bottom of the screen. The lines should extend
about half of the distance between the breaker
and the bottom of the window.
Your map should now resemble the map in
(Figure 3-66).

Figure 3-66

40. Draw a line extending upward from each of the


two uppermost breakers. The line should
extend near the top of the window.

41. Click on the Drawing Styles tab of the Library


Selector, and select the _Yellow Feeder
drawing style.

Draw four lines, one from each of the four lowest


breakers, downwards towards the bottom of the
screen. The lines should extend about half of the
distance between the breaker and the bottom of the
window. Your map should now resemble the map
in (Figure 3-67).

Figure 3-67

42. Click on the Drawing Styles tab of the Library Selector and select the _Green drawing style.

Worldview for Windows Getting Started 3-39


Editor’s Guide
43. Click on the Text Styles tab and select the _Arial 100 text 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.

47. Repeat the above procedure for Volts C.

48. Click on the Pmacros tab of the Library Selector and select the _Analog pmacro.

49. Click on the Pmacro button in the Edit toolbar.

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).

Worldview for Windows Getting Started 3-40


Editor’s Guide
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).

Worldview for Windows Getting Started 3-41


Editor’s Guide
Figure 3-71

56. Choose the Select tool from the Edit toolbar


and right-click on the first pushbutton pmacro.
In the pop-up menu that appears, select
Modify.

Figure 3-72 Selecting Modify

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.

Figure 3-73 Button Data Resource Dialog

Worldview for Windows Getting Started 3-42


Editor’s Guide
58. In the Pmacro Properties window, double-click on the Button Label resource. In the Button Label resource
dialog that appears, enter the string F1 as the label, and click on OK. Note that the label you just entered
appears in the Override column of the Pmacro Properties window.

Figure 3-74 Button Label Resource Dialog

59. In the Pmacro Properties window, click on OK to save your overrides.

60. Repeat steps 54 to 57 for the second pushbutton, specifying F2 in the Button Label resource.

61. Click on the Tree List button to open up the


Views and Layers window and click on the
Views tab to bring it to the front. With the
cursor over the Views folder, right-click and
from the pop-up menu that appears, select Add
View.

Figure 3-75 Add View

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.)

Worldview for Windows Getting Started 3-43


Editor’s Guide
Figure 3-76 Creating the Substation View

The substation layer is now complete. We will now create the Feeder layer.

3.7.2 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).

Worldview for Windows Getting Started 3-44


Editor’s Guide
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.

10. Set the Magnification resource to a value of 3.

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.

Worldview for Windows Getting Started 3-45


Editor’s Guide
13. Using the Panning Tool, move the
map so that the only thing visible is the S/S
pushbutton as shown in (Figure 3-79) .

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).

Worldview for Windows Getting Started 3-46


Editor’s Guide
21. Select the switch again and click on the copy button on the tool bar. Click on paste and place the copy of
the switch so it lines up under line 4 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.

23. Your map should now resemble (Figure 3-81).

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.).

(The numbers and white lines are shown only to


identify the three individual lines. Don’t draw the
white lines and numbers.)

Figure 3-82

Worldview for Windows Getting Started 3-47


Editor’s Guide
25. Copy the switch on the right and paste
it at the bottom of line 3 in (Figure
3-83).

26. Select the Pmacro tool in the Edit bar.


Select the Switch pmacro in the Library
selector and place a switch next to line
2 in (Figure 3-83).

Figure 3-83

27. Select the Line Draw tool in the Edit bar


and draw another horizontal line as
shown in
(Figure 3-84).

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).

Worldview for Windows Getting Started 3-48


Editor’s Guide
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

Worldview for Windows Getting Started 3-49


Editor’s Guide
32. Select the Load symbol from the
Symbols pane of the Library Selector.
Click on the Symbol tool in the Edit
bar, and place a Load symbol at the
end of the line you just drew so it
resembles (Figure 3-89).

Figure 3-89 Feeders with Load

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.

36. Your map should now resemble (Figure 3-90).

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.

Worldview for Windows Getting Started 3-50


Editor’s Guide
3.7.3 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.

Figure 3-91 Selecting A Layer To Draw Into

3. Using the scroll bars, move the map so that it resembles (Figure 3-92).

Figure 3-92

4. From the Pmacros pane of the Library


Selector, select the _Substation pmacro.

5. Select the Pmacro tool in the Edit bar, and


place a _Substation pmacro so that it
completely covers the substation but doesn’t
cover the feeder, as shown in (Figure 3-93).
It’s ok if the entire substation pmacro can’t be
seen on the screen

Figure 3-93

Worldview for Windows Getting Started 3-51


Editor’s Guide
6. Access the Pmacro Properties window for the _Substation pmacro you just put down. Set the View Name
resource to Substation (this is a view we created earlier in paragraph 3.7.1, Substation Layer), and close
the Pmacro Properties window.

7. Click on the Tree List button to access the


Views and Layers window. In the Layers pane
of the Views and Layers window, right-click on
the Substation layer. In the pop-up menu that
appears, select Modify.

Figure 3-94 Modify Layer

8. In the Edit Layers dialog that appears, click on


the upper Set Current button. The Zoom Out
Declutter Point field will update to show you the
scale (magnification), in world units per pixel, at
which you are currently viewing the map. Click
on OK.

This will be the largest scale at which the


Substation layer will be visible when its
declutter mode is set to Auto. When you zoom
out beyond this magnification level, all objects
contained in this layer will disappear.

Figure 3-95 Setting Zoom Out Declutter Level

9. Repeat steps 7 and 8 for the Feeder layer.

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.

11. Zoom out until your map resembles (Figure 3-96).

Worldview for Windows Getting Started 3-52


Editor’s Guide
Figure 3-96

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

Worldview for Windows Getting Started 3-53


Editor’s Guide
The layers will turn off at certain magnification levels so as to keep the screen decluttered. For example, if you
start at the Main view, and zoom in, you will see that at a certain magnification, the orange circle representing
the substation disappears and the feeder and internal structure of the substation appear. What is happening is
that the Main layer is automatically turning off and the Substation and Feeder layers are turning on.

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.

Worldview for Windows Getting Started 3-54


Editor’s Guide
4 Drawing Styles

This chapter describes how to use the Drawing Style and Drawing Style Table editors. Both editors are
accessible via the Library Selector window.

4.1 Drawing Style Editor


Clicking on the Drawing Styles tab of the Library Selector causes a list of the existing drawing styles to be
displayed, as shown in (Figure 4-1).

Figure 4-1 List of Drawing Styles

Each drawing style in the list defines a combination of the following graphics attributes:

• colors (up to 8 colors)


• line thickness
• line style

Worldview for Windows Drawing Styles 4-1


Editor’s Guide
If you are editing a symbol (as opposed to a map), the list of drawing styles includes one extra drawing style
named {dynamic}. See (Figure 4-2). In a symbol embedded in a pmacro, any symbol graphics that are drawn in
{dynamic} are dynamically colored according to the state of the point associated with the pmacro.

Figure 4-2 Drawing Styles for Symbols

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.

Right-clicking anywhere in the list of drawing


styles opens an “Add, Modify, Delete” option
list. You can use Add or Modify to create new
drawing styles or to modify existing ones.

Figure 4-3 Add/Modify/Delate Drawing Style

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.

Worldview for Windows Drawing Styles 4-2


Editor’s Guide
Figure 4-4 Add Drawing Style Figure 4-5 Modify Existing Drawing Style

The Drawing Style Editor options are described below.

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”).

4.1.2 Color Add

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.

Figure 4-6 Color Window

Worldview for Windows Drawing Styles 4-3


Editor’s Guide
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.

Add to Custom Colors

You can create custom colors as follows:

• 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 add multiple colors to a drawing style, just use


the Color Add... function repeatedly.

(Figure 4-7) shows an example of a drawing style


containing two colors: red and black. It is a
drawing style used to draw analog point values for
points that have unacknowledged emergency limit
violation alarms. The fact that the WorldView
program cycles through the red and black colors at
the rate of one color per second is what makes
such points blink.

Figure 4-7 Multiple Colors in A Drawing Style

Worldview for Windows Drawing Styles 4-4


Editor’s Guide
4.1.3 Color Modify

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.

4.1.4 Color Insert

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.

4.1.5 Color Delete

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.

4.1.6 Line Width

You can select a line width from 1 to 4 pixels using


this tool. This affects all solid lines and some
dashed lines, depending on the drawing object. For
example, a dashed 4-pixel line will be used in a
rectangle but only a dashed 1-pixel line will be
used for a circle.

Figure 4-8 Line Width

Worldview for Windows Drawing Styles 4-5


Editor’s Guide
4.1.7 Line Style

There are five choices for line style:


ƒ Solid
ƒ Dashed
ƒ Dot
ƒ DashedDot
ƒ DashedDotDot

Figure 4-9 Line Style

4.1.8 Cyclic Colors

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

This function is not presently used.

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).

Worldview for Windows Drawing Styles 4-6


Editor’s Guide
4.1.12 Save

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.

4.2 Drawing Style Table Editor


Clicking on the Drawing Style Tables tab of the Library Selector causes a list of the existing drawing style tables
to be displayed, as shown in (Figure 4-10).

Right clicking anywhere in the list of drawing style


tables opens an “Add, Modify, Delete” option list.
You can use Add or Modify to create new drawing
style tables or to modify existing ones.

Figure 4-10 List of Drawing Styles Tables

Figure 4-11 Add/Modify/Delate Drawing Style Table

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).

Worldview for Windows Drawing Styles 4-7


Editor’s Guide
If you click on Modify, the Drawing Style Table Editor shows the data for the selected drawing style table, as
illustrated in (Figure 4-13). Note that if you modify an existing drawing style table, you will change the
appearance of all objects that use that drawing style table.

Figure 4-12 Add New Drawing Style Table

Figure 4-13 Modify Existing Drawing Style Table

The options of the Drawing Style Table Editor are described below.

4.2.1 Name

This is the name of the drawing style table.

Worldview for Windows Drawing Styles 4-8


Editor’s Guide
4.2.2 Drawing Style Selection List

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.

4.2.3 Drawing Style Table Element List

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.

Worldview for Windows Drawing Styles 4-9


Editor’s Guide
4.3 Using Drawing Style Tables
Drawing style tables are used by pmacros, line sections and segments to dynamically color their graphics
elements according to values contained in the SCADA database. The various uses of drawing style tables are
described below.

4.3.1 Analog Point

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.

Figure 4-14 Analog Point Drawing Styles Table

Table 4-1Analog Drawing Style Table Elements


Index Drawing Style Used When Point:
0 ANALOG_NORMAL Not used (place-holder)
1 ANALOG_REASON Violates lower reasonability limit
2 ANALOG_EMGERG Violates lower emergency limit
3 ANALOG_PREEMERG Violates lower pre-emergency limit
4 ANALOG_NORMAL Is in its normal range
5 ANALOG_PREEMERG Violates upper pre-emergency limit
6 ANALOG_EMGERG Violates upper emergency limit
7 ANALOG_REASON Violates upper reasonability limit

Worldview for Windows Drawing Styles 4-10


Editor’s Guide
4.3.2 Status Point

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.

Figure 4-15 Status Point Drawing Style Table

Table 4-2 Elements in Status Point Drawing Style Table


Index Drawing Style Used When Point:
0 STATUS_0 Is in state 0
1 STATUS_1 Is in state 1
2 STATUS_2 Is in state 2
3 STATUS_3 Is in state 3

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.

Worldview for Windows Drawing Styles 4-11


Editor’s Guide
Figure 4-16 Station Drawing Style Table

Table 4-3 Elements of Station Drawing Style Table


Index Drawing Style Used When Highest Priority Alarm Is:
0 STATION_0 0
1 STATION_1 1
2 STATION_2 2
3 STATION_3 3
4 STATION_4 4

4.3.4 Unacknowledged Alarms

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.

Worldview for Windows Drawing Styles 4-12


Editor’s Guide
4.3.5 Flags

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.

Figure 4-17 Condition Code Drawing Style Table

Table 4-4 Elements of Condition Code Drawing Style Table


Index Drawing Style Used When Point Is:
0 FLAGERROR not used
1 FLAGNORMAL Normal
2 FLAGTELEMETRYFAILED Telemetry Failed
3 FLAGMANUALLYSET Manually Set
4 FLAGCALCULATED Calculated From Manually Set Data
5 FLAGUNSET Unset (Setpoint)
6 FLAGERROR not used
7 FLAGERROR not used

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.

Worldview for Windows Drawing Styles 4-13


Editor’s Guide
Table 4-5 Elements of Tag Drawing Style Table
Index Drawing Style Used When:
0 FLAGNORMAL Point is normal
1 FLAGFULLTAG Highest level tag is full tag
2 FLAGHOLDCLOSETAG Highest level tag is hold open or hold closed tag
3 FLAGSELECTED Point is selected for control
4 FLAGOPENING Point is opening following control
5 FLAGCLOSING Point is closing following control
6 FLAGINTERLOCKING Point has control-inhibiting interlock
7 FLAGINFORMATIONALTAG Highest level tag is information tag

Table 4-6 Elements of Alarm Blocked Drawing Style Table


Index Drawing Style Used When:
0 STANDARD_CYAN Not used (this is a required placeholder)
1 FLAGBLOCKED Point does not have blocked alarms
2 FLAGBLOCKED Point has one or more blocked alarms

4.3.6 Owner Tags

Owner tags are tag types that you can customize. Each owner tag type maps to one of the following:

• Inhibit all control


• Inhibit open control
• Inhibit close control
• Do not inhibit control

You can have as many owner tag types as you wish.


When you enable the owner tag indicator in a pmacro, you have to specify a drawing style table. Each element
of the drawing style table is associated with an owner tag type. The WorldView program selects the drawing
style for an owner tag indicator by indexing into the drawing style 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 drawing
style table for these owner tags could look like the one in Table 4-7.

Worldview for Windows Drawing Styles 4-14


Editor’s Guide
Table 4-7 Drawing Style Table for Owner Tags
Index Drawing Style Used When Highest Level Owner Tag Is:
0 Normal None
1 StationGuarantee Station Guarantee
2 WorkPermit Work Permit
3 HoldOff Hold Off
4 Caution Caution
5 WorkAndTest Work and Test
6 Information Information

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.

Table 4-8 Elements of Pushbutton Drawing Style Table


Index Drawing Style Used When:
0 STANDARD_BLACK Pushbutton is not “depressed”
1 STANDARD_WHITE Pushbutton is “depressed”

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.

Table 4-9 Elements of Segment Drawing Style Table


Index Drawing Style Used to Color Segment When:
0 SEGMENT_0 Point is in state 0
1 SEGMENT_1 Point is in state 1
2 SEGMENT_2 Point is in state 2
3 SEGMENT_3 Point is in state 3

Worldview for Windows Drawing Styles 4-15


Editor’s Guide
4.3.9 Line Section

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).

Table 4-10 Elements of an SCS (Electric) Drawing Style Table


Index Line Section Status
0 de-energized
1 de-energized, looped
2 energized
3 energized, paralleled
4 energized, looped
5 energized, paralleled, looped
6 calculated outage
7 partially de-energized, looped
8 partially energized
9 partially energized, paralleled
10 partially energized, looped
11 partially energized, paralleled, looped
12 partial calculated outage

4.3.10 Customizing Drawing Style Tables

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.

Worldview for Windows Drawing Styles 4-16


Editor’s Guide
Table 4-11 Modified ANALOG_DEFAULT and NAK_ANALOG_DEFAULT Tables
Drawing Styles Drawing Styles
Index in ANALOG_DEFAULT in NAK_ANALOG_DEFAULT
0 ANALOG_NORMAL ANALOG_NORMAL
1 ANA_LO_REAS NAK_ANA_LO_REAS
2 ANA_LO_EMERG NAK_ANA_LO_REAS
3 ANA_LO_PREEM NAK_ANA_LO_PREEM
4 ANALOG_NORMAL ANALOG_NORMAL
5 ANA_UP_PREEM NAK_ANA_UP_PREEM
6 ANA_UP_EMERG NAK_ANA_UP_EMERG
7 ANA_UP_REAS NAK_ANA_UP_REAS

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.

Worldview for Windows Drawing Styles 4-17


Editor’s Guide
5 Text Styles

This chapter describes how to use the Text Style editor.

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).

Figure 5-1 List of Text Styles

Each text style defines a combination of the following text attributes:

• font (including style and size)


• orientation
• justification

Worldview for Windows Text Styles 5-1


Editor’s Guide
Right clicking anywhere in the list of text
styles opens an “Add, Modify, Delete” option
window. You can use Add or Modify to create
new text styles or to modify existing ones.

Note that if you modify an existing text style,


you will change the appearance of all existing
text that uses that text style.

Figure 5-2 Add/Modify/Delete Text Style

If you click on Add, the Text Style Editor


window opens with a blank name and default
text attributes, as shown in (Figure 5-3).

Figure 5-3 Add New Text Style

If you click on Modify, the Text Style editor


shows the data for the selected text style, as
illustrated in (Figure 5-4).

Figure 5-4 Modify Existing Text Style

Worldview for Windows Text Styles 5-2


Editor’s Guide
The Text Style Editor options are described below.

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”).

5.2 Select Font


Clicking on the Select Font.. pushbutton causes a Font window to be displayed, as shown in (Figure 5-5).

Figure 5-5 Font Window

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.

Worldview for Windows Text Styles 5-3


Editor’s Guide
5.4 Horizontal Justification

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.

Left Right Center 4.00 (Decimal)

The default option is “Left”.

5.5 Vertical Justification

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.

Baseline Top Bottom Center

The default option is Baseline.

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.

Worldview for Windows Text Styles 5-4


Editor’s Guide
5.8 Save
This saves the new or modified text style and closes the Text Style Editor window. 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.9 Cancel
This dismisses the Text Style Editor without saving any changes made since the last Save.

Worldview for Windows Text Styles 5-5


Editor’s Guide
6 Symbols

This chapter describes how to use the Symbol and Symbol Table editors.

Symbols may be used in several ways:

• 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.

SymbolsWorldview for Windows Symbols 6-1


Editor’s Guide
A list of the symbols available in your database can be obtained by clicking on the Symbols tab of the Library
Selector. See (Figure 6-1).

Figure 6-1 List of Simbols

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.

6.1 Creating a New Symbol


To create a new Symbol, right-click anywhere in the symbol list, and from the options list that appears, select
Add.

Figure 6-2 Creating A New Symbol

A Symbol Editor window, labeled Untitled, will be displayed, as shown in (Figure 6-2), that is very similar to the
Map Editor window.

SymbolsWorldview for Windows Symbols 6-2


Editor’s Guide
At the top of the Symbol Editor window are the same navigation tools and Library Selector pushbutton as in the
Map Editor. At the right is the edit bar, again the same as that available in the Map Editor, but with the pmacros

pushbutton desensitized.

Figure 6-3 Symbol Editor Window

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.

6.2 Opening an Existing Symbol


To edit an existing symbol, right-click on the desired symbol and select the Modify option.

Figure 6-4 Opening an Existing Symbol

Alternatively, you can select “Open” from the File pull-down menu.

SymbolsWorldview for Windows Symbols 6-3


Editor’s Guide
In the Open window that appears:

• Select “Symbol [*.syl]” from the “Files of


type:” pop-up menu.

• Navigate to the syl folder using the


navigation tools at the top of the Open
window: from the “wmp” folder, click on
the “Up One Level” folder icon to go up
one level to the “standard” folder, and
then click on the “syl” folder. This will
display a scrollable list of all of the
symbols contained in the “syl” folder.

Figure 6-5 Open Window

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.

Figure 6-6 Selecting an Existing Symbol to Open

6.3 Editing a Symbol


As mentioned before, the drawing tools available for symbol editing are a subset of those available in the Map
Editor for map editing. See Chapter 8, Map Editing, for a description of the editing tools. Note that the Set
Grid… feature in the Map Editor is also available in the Symbol Editor, and can be used to help you construct
good-looking symbols with precisely defined coordinates.

To save a symbol, you can use the Save pushbutton, or use the Save or Save As functions in the File pull-down
menu.

SymbolsWorldview for Windows Symbols 6-4


Editor’s Guide
6.3.1 Symbol Origin

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.

SymbolsWorldview for Windows Symbols 6-5


Editor’s Guide
6.4 Symbol Table
Clicking on the Symbol Tables tab of the Library
Selector causes a list of the existing symbol tables
to be displayed, as shown in (Figure 6-7).

Figure 6-7 List of Symbol Tables

Right clicking anywhere in the list of symbol tables


opens an “Add, Modify, Delete” option window. You
can use Add or Modify to create new symbol tables
or to modify existing ones.

Figure 6-8 Add/Modify/Delete Symbol Table

If you click on Add, the Symbol Table Editor


window opens with a blank name and an empty
symbols list, as shown in (Figure 6-9).

Figure 6-9 New Symbol Table

SymbolsWorldview for Windows Symbols 6-6


Editor’s Guide
If you click on Modify, the Symbol Table Editor shows the data for the selected symbol table, as illustrated in
(Figure 6-10).

Figure 6-10 Existing Symbol Table

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.

The options of the Symbol Table Editor are described below.

6.4.1 Name

This is the name of the symbol table.

6.4.2 Symbol Selection List

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.

SymbolsWorldview for Windows Symbols 6-7


Editor’s Guide
6.4.3 Symbol Table Element List

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.

6.5 Using Symbol Tables


Symbol tables are used by pmacros to dynamically display the status of points in your map. The various uses of
symbol tables are described below. (The use of symbol tables is analogous to that of drawing style tables. See
section 4.3, Using Drawing Style Tables.)

SymbolsWorldview for Windows Symbols 6-8


Editor’s Guide
6.5.1 Flags

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”.

Figure 6-11 Condition Code Symbol Table

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.

Table 6-1 Elements of Condition Code Symbol Table


Index Drawing Style Used When Point Is:
0 flagerror not used
1 {Null} Normal
2 flagtelemetryfailed Telemetry Failed
3 flagmanuallyset Manually Set
4 flagcalculated Calculated From Manually Set Data
5 flagunset Unset (Setpoint)
6 flagerror not used
7 flagerror not used

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.

SymbolsWorldview for Windows Symbols 6-9


Editor’s Guide
Figure 6-12Tag Symbol Table

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.

Table 6-2 Elements of Tag Symbol Table


Index Drawing Style Used When:
0 {Null} Point has no tag
1 flagfulltag Highest level tag is full tag
2 flagholdopentag Highest level tag is hold open or hold closed tag
3 flagselected Point is selected for control
4 flagopening Point is opening following control
5 flagclosing Point is closing following control
6 flaginterlocking Point has control-inhibiting interlock
7 flaginformational Highest level tag is information tag

SymbolsWorldview for Windows Symbols 6-10


Editor’s Guide
Figure 6-13 Alarm Blocked Flag Symbol Table

Table 6-3 Elements of Alarm Blocked Symbol Table


Index Drawing Style Used When:
0 {Null} Point does not have any blocked alarms
1 flagblocked Point has one or more blocked alarms

6.5.2 Owner Tags

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.

SymbolsWorldview for Windows Symbols 6-11


Editor’s Guide
Table 6-4 Symbol Table for Owner Tags
Index Symbol Used When Highest Level Owner Tag Is:
0 StationGuarantee Station Guarantee
1 WorkPermit Work Permit
2 HoldOff Hold Off
3 Caution Caution
4 WorkAndTest Work and Test
5 Information Information

6.5.3 Customizing Symbol Tables

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.

SymbolsWorldview for Windows Symbols 6-12


Editor’s Guide
7 Pmacros

This chapter describes how to use the Pmacro editor.

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.

Worldview for Windows Pmacros 7-1


Editor’s Guide
Table 7-1Pmacro Classes
Class of Description
Pmacro
Analog Bar Displays the value of an analog point in the form of a bar graph
Analog Gauge Display the value of an analog point using a gauge
Analog History Displays historical max/min values of one or more analog points, with timestamps
Analog Value Displays the value of an analog point as a numeric text string
Mobile Icon Displays a symbol at a location determined by the values of two analog points
Mobile Icon Displays a bitmap at a location determined by the values of two analog points
Bitmap
Pushbutton Acts as a poke point for views, graphs, images, notes and command sequences.
Bitmap Displayed using a bitmap.
Pushbutton Acts as a poke point for views, graphs, images, notes and command sequences.
Symbol Displayed using a symbol.
Station Bitmap Displays the alarm status of a station by displaying bitmaps
Station Color Display the alarm status of a station by coloring a symbol
Station Symbol Displays the alarm status of a station by displaying symbols
Status Bitmap Displays the value of a status point by displaying a different bitmap for each state
Status Color Displays the value of a status point by coloring a symbol
Status Symbol Displays the value of a status point by displaying a different symbol for each state
Status Text Displays the status of a status point by displaying a text string
Template Displays a complex object that contains pmacros, symbols, graphics and text strings
Text Value Displays the value of a text point by displaying a text string
Time Value Displays the current time

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.

Worldview for Windows Pmacros 7-2


Editor’s Guide
Figure 7-1 List of Pmacros

Some of the pmacros in your library were there when you first got your system. They were provided by
Survalent Technology Corporation.

7.1 Editing a Pmacro


To create a new pmacro, access the Pmacros tab of the Library Selector, right-click anywhere in the pmacro list
and select the Add function.

Figure 7-2 Adding A New Pmacro

A Create Pmacro window will appear, as shown in (Figure 7-3). This window shows a list of the available
pmacro classes.

Worldview for Windows Pmacros 7-3


Editor’s Guide
Figure 7-3 Create Pmacro Window

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.

Figure 7-4 Pmacro Properties Window

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.

Worldview for Windows Pmacros 7-4


Editor’s Guide
In the Pmacro Properties window:

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 OK applies the changes and closes the


Pmacro Properties window. To get the Pmacro
Properties window back, click on the Edit button.
Alternatively you can select Modify from the Edit
pull-down menu.

Worldview for Windows Pmacros 7-5


Editor’s Guide
Cancel

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.

Figure 7-5 Save As Window

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.

Figure 7-6 Accessing an Existing Pmacro

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.

Worldview for Windows Pmacros 7-6


Editor’s Guide
Figure 7-7 Open Window

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).

Figure 7-8 Editing an Existing Pmacro

7.1.1 Editing Resources

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.

Worldview for Windows Pmacros 7-7


Editor’s Guide
Library Resource

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).

The dialog contains the name of the pmacro in the


title bar, the name of the resource below that,
followed by a data entry field and a scrollable list of
the elements in the library. If the pmacro already
has a value for this resource, the value appears in
the data entry field and the corresponding library
element in the list is highlighted.

Figure 7-9 Library Resource Dialog

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

An enable/disable resource has a simple Yes or No


value. The dialogs used for these resources are
illustrated in (Figure 7-10). The name of the
pmacro is shown in the title bar. Below that is a
check box and the name of the resource. The
check box is checked for Yes and unchecked for
No.
Figure 7-10 Check Box Dialog

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.

Worldview for Windows Pmacros 7-8


Editor’s Guide
Value Resource

Value resources are simple numeric values or text


strings. The dialogs used for these resources are
illustrated in (Figure 7-11). The name of the
pmacro is shown in the title bar. Below that is the
name of the resource and below that is a data entry
field for the resource value. If the resource already
has a value, the data entry field is initialized to that
value.

Figure 7-11 Data Entry Dialog

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).

The name of the pmacro is shown in the title bar,


below which is the resource name. This is followed
by a data entry field and a scrollable list of allowed
types. If the resource already has a value, it will
appear in the data entry field, and the
corresponding item in the list will be highlighted.

Figure 7-12 Type Selector Dialog

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

A filename resource specifies a file, such as one


that contains an image, a menu definition or a
report. An example is shown in (Figure 7-13).

You can either enter the desired filename into the


data entry field or select it from the list.

Figure 7-13 Filename Dialog

Worldview for Windows Pmacros 7-9


Editor’s Guide
A point name resource specifies the name of a
point. An example is shown in (Figure 7-14).

Figure 7-14 Point Name Dialog

Point Name 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.

7.1.2 Deleting a Pmacro

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.

7.2 Pmacro Classes


This section describes the various pmacro classes and identifies the resources used by each class. The
resources are described in detail in section 7.3, Pmacro Resources.

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.

Worldview for Windows Pmacros 7-10


Editor’s Guide
7.2.1 Analog Value Pmacro

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).

Figure 7-15Properties of Analog Value Pmacro

Worldview for Windows Pmacros 7-11


Editor’s Guide
7.2.2 Analog Bar Pmacro

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).

Figure 7-16 Properties of Analog Bar Pmacro

Worldview for Windows Pmacros 7-12


Editor’s Guide
7.2.3 Analog Gauge Pmacro

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).

Figure 7-17 Properties of Analog Gauge Pmacro

Worldview for Windows Pmacros 7-13


Editor’s Guide
7.2.4 Analog History Pmacro

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).

Figure 7-18 Properties of Analog History Pmacro

Worldview for Windows Pmacros 7-14


Editor’s Guide
7.2.5 Mobile Icon Pmacro

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).

Figure 7-19 Properties of Mobile Icon Pmacro

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).

Worldview for Windows Pmacros 7-15


Editor’s Guide
7.2.6 Mobile Icon Bitmap Pmacro

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.

7.2.7 Pseudo Color Pmacro (VMS SCADA Only)

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.

Figure 7-20 Properties of Pseudo Color Pmacro

Worldview for Windows Pmacros 7-16


Editor’s Guide
7.2.8 Pseudo Symbol Pmacro (VMS SCADA Only)

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.

The resources used by the Pseudo Symbol pmacro


are shown in (Figure 7-21).

The “Symbol 0” resource specifies the name of the


symbol to be displayed when the pseudo point is in
state 0, etc

Figure 7-21 Properties of Pseudo Symbol Pmacro

Worldview for Windows Pmacros 7-17


Editor’s Guide
7.2.9 Pseudo Text Pmacro (VMS SCADA Only)

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.

Figure 7-22 Properties of Pseudo Text Pmacro

Worldview for Windows Pmacros 7-18


Editor’s Guide
7.2.10 Pushbutton Symbol Pmacro

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.

Figure 7-23 Properties of Pushbutton Symbol Pmacro

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.

Worldview for Windows Pmacros 7-19


Editor’s Guide
7.2.11 Station Color Pmacro

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).

Figure 7-24 Properties of Station Color Pmacro

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

Worldview for Windows Pmacros 7-20


Editor’s Guide
7.2.12 Station Symbol Pmacro

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.

Figure 7-25 Properties of Station Symbol Pmacro

Worldview for Windows Pmacros 7-21


Editor’s Guide
7.2.13 Status 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).

Figure 7-26 Properties of Status Color Pmacro

Worldview for Windows Pmacros 7-22


Editor’s Guide
7.2.14 Status Symbol Pmacro

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).

Figure 7-27 Properties of Status Symbol Pmacro

Worldview for Windows Pmacros 7-23


Editor’s Guide
7.2.15 Status Text Pmacro

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.

Figure 7-28 Properties of Status Text Pmacro

Worldview for Windows Pmacros 7-24


Editor’s Guide
7.2.16 Text Value Pmacro

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).

Figure 7-29 Properties of Text Value Pmacro

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.

Table 7-2 Standard Text Point Colors


Color
Code Color
0 Orange
1 Red
2 Green
3 Yellow
4 Blue
5 Magenta
6 Cyan
7 White

Worldview for Windows Pmacros 7-25


Editor’s Guide
7.2.17 Pushbutton Bitmap Pmacro

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).

Figure 7-30 Properties of Pushbutton Bitmap Pmacro

Worldview for Windows Pmacros 7-26


Editor’s Guide
7.2.18 Station Bitmap Pmacro

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.

Figure 7-31 Properties of Station Bitmap Pmacro

Worldview for Windows Pmacros 7-27


Editor’s Guide
7.2.19 Status Bitmap Pmacro

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).

Figure 7-32 Properties of Status Bitmap Pmacro

Worldview for Windows Pmacros 7-28


Editor’s Guide
7.2.20 Time Value Pmacro

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.

Figure 7-33 Properties of Time Value Pmacro

Worldview for Windows Pmacros 7-29


Editor’s Guide
7.2.21 Templates

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.

In the Library Selector dialog (Figure 7-34), there’s


a tab labeled Templates. Right-click and select
Add, and an editor similar to the control panel
editor will appear to allow you to create a template
and place both graphics and pmacros in it.

Figure 7-34 Library Selector

Templates are instantiated in the map via a class of


pmacro called a Template pmacro. You can create
as many templates and template pmacros as you
like (Figure 7-35)

Figure 7-35 Create Pmacro

Worldview for Windows Pmacros 7-30


Editor’s Guide
In the template pmacro, there’s a resource called
Template that allows you to assign the template to
that pmacro.

Figure 7-36 Pmacro Resource

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.)

Figure 7-37 Station Manu

An example of an instance of this template in a map is shown below.

Worldview for Windows Pmacros 7-31


Editor’s Guide
Besides station pmacros, the contents of templates are presently pretty much limited to static objects, such as
menus and pushbutton links to fixed objects or documents. This serves the purpose that most of you are looking
for: to create navigation bars to be placed in views and that can be easily maintained and expanded when
needed.

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:

• You cannot add groups, views, layers or other templates to a template.

• Templates are stored in “Standard\Templates” and have the extension “.template”.

• Templates don’t have the station part of the points defined in the template instance pmacro as control panels
do.

7.3 Pmacro Resources

The following is a description of all of the pmacro resources that are available.

7.3.1 Alarm Blocked Flag Drawing Style Table

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.

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.

Worldview for Windows Pmacros 7-32


Editor’s Guide
7.3.3 Alarm Blocked Flag Offset X

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.

7.3.4 Alarm Blocked Flag Offset Y

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.

7.3.5 Analog Scale Factor

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.

7.3.6 Angle Length

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.

7.3.7 Angle Start

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.

7.3.8 Arrow Head Size

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.

Worldview for Windows Pmacros 7-33


Editor’s Guide
7.3.9 Bar Length

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.

7.3.10 Bar Width

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.

7.3.12 Bitmap Height

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.

7.3.13 Bitmap Width

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.

Worldview for Windows Pmacros 7-34


Editor’s Guide
7.3.14 Button Argument 1 Data

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.

7.3.15 Button Argument 1 Type

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

7.3.16 Button Argument 2 Data

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.

7.3.17 Button Argument 2 Type

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

Worldview for Windows Pmacros 7-35


Editor’s Guide
7.3.18 Button Data

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

Table 7-3 Meaning of Button Data Resource


Button Type Meaning of Button Data

View Name of a view.


When you click on the pushbutton, the viewer takes you to the view whose name is
identified by the value of this resource. How to create views is described in chapter 8,
Editing Maps.
Graph Graph number.
When you click on the pushbutton, the viewer brings up a graph window containing a
graph whose number is identified by the value of this resource. How to create graphs is
described in chapter 8, Trend Graphs, of the WorldView for Windows Operator’s
Manual.
Task Name of a task mailbox.
When you click on the pushbutton, the viewer brings up either a task activation dialog or
a task menu that allows you to run or stop applications. Both the task activation dialog
and the task menu are described in the WorldView for Windows Operator’s Guide.
Note Name of a note topic.
When you click on the pushbutton, the viewer brings up a Note window showing the
contents of the note.
Image Not used.
External SQL statement that retrieves a record from a relational database.
Data
When you click on the pushbutton, the viewer executes the SQL statement to retrieve
the record and displays its contents in a pop-up window.
Report Not used.

7.3.19 Button Label

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.

Worldview for Windows Pmacros 7-36


Editor’s Guide
Although the resource name has the word button in it, the resource can be used with non-pushbutton pmacros
as well as pushbutton pmacros. It can be used with station and status pmacros to make the displayed pmacro
include a station or device name.

7.3.20 Button Label Drawing Style Table

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.

7.3.21 Button Label Text Style

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.

7.3.22 Button Label X Offset

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.

7.3.23 Button Label Y Offset

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.

7.3.24 Button Type

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.

Worldview for Windows Pmacros 7-37


Editor’s Guide
Figure 7-38 Pushbutton Type Selection Dialog

The purposes of the various pushbutton types are listed in Table 7-4.

Table 7-4 Pushbutton Types


Pushbutton Type Purpose of Pushbutton
View Bring up a view in the map
Graph Bring up a trend graph
Task Send a message to a mailbox
Note Bring up a note
Image Bring up a pop-up photo
External Data Retrieve and display the contents of a record from a relational database
Report Bring up a report or query via Microsoft Excel or Query

7.3.25 Color Status Point Name

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.

7.3.26 Condition Flag Drawing Style Table

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.

Worldview for Windows Pmacros 7-38


Editor’s Guide
Table 7-5 Condition Codes
Condition
Code Meaning
F Telemetry failed
M Manually set
* Calculated from manually set data
U Unset setpoint
E Error

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.

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.

7.3.28 Condition Flag Offset X

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.

7.3.29 Condition Flag Offset Y

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.

7.3.30 Control Fail Timeout

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.

Worldview for Windows Pmacros 7-39


Editor’s Guide
7.3.31 Control Panel Filename

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.

7.3.32 Control Panel Point Prefix

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.

7.3.33 Control Panel String 1, 2, 3

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.

7.3.34 Control Panel X Position

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.

7.3.35 Control Panel Y Position

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.

Worldview for Windows Pmacros 7-40


Editor’s Guide
7.3.36 Control Success Timeout

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.

7.3.37 Data Item

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.

Figure 7-39 Data Item Dialog

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.

Worldview for Windows Pmacros 7-41


Editor’s Guide
The tooltip for the point identifies the data item that
is being displayed if it’s not current value. It also
shows the current value.

7.3.38 Dial Colour

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.

7.3.39 Dial Direction

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.

7.3.40 Dialog Code

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.

Worldview for Windows Pmacros 7-42


Editor’s Guide
Figure 7-40 Selecting a Dialog Code for a Status Pmacro

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-41 Normal Control Panel - Dialog Code 0

Worldview for Windows Pmacros 7-43


Editor’s Guide
Figure 7-42 Tap Changer Control Panel - Dialog Code 1

Figure 7-43 Alternate Control Panel - Dialog Code 2

Figure 7-44 Direct Control Panel - Dialog Code 3

Figure 7-45 Direct Set Manual Panel – Figure 7-46 Direct Set Manual With Tag –
Dialog Code 4 Dialog Code 5

Worldview for Windows Pmacros 7-44


Editor’s Guide
Figure 7-47 Direct Control Panel for multi points
pmacros when only one Point name is defined -
Dialog Code 6

Figure 7-48 Direct Control Panel for multi points


pmacros when all tree Point name are defined -
Dialog Code 6

Figure 7-49 Direct Open on press Close on release –


Dialog Code 7

Figure 7-50 Direct Control Panel - Dialog Code 8

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.

Worldview for Windows Pmacros 7-45


Editor’s Guide
Figure 7-51 Direct Control Panel - Dialog Code 9

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.

Figure 7-52 Tag Dialog Control Panel - Dialog Code 11

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.

Worldview for Windows Pmacros 7-46


Editor’s Guide
Pushbutton Pmacro

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.

Analog History Pmacro

For Analog History pmacros, the dialog code


determines the organization of the Analog
History window. A value of zero produces the
standard display shown here, where each
value appears on a separate line.

Figure 7-55 Normal Analog History Window with


Dialog Code 0

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).

Figure 7-56 3-Phase Analog History with Dialog Code 3

Worldview for Windows Pmacros 7-47


Editor’s Guide
Analog Point Pmacro

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.

Figure 7-57 Selecting a Dialog Code for an Analog Pmacro

Figure 7-58 Analog Point with Dialog Code 0- Default

Worldview for Windows Pmacros 7-48


Editor’s Guide
For analog points, dialog code 1 (Menu) causes the viewer to display a menu when you click on the pmacro.
The definition and usage of these menus is the subject of section 7.5, Menu Files

Dialog code 2 (Set manual only) causes the Analog


Set Manual dialog to appear when the pmacro is
selected.

Figure 7-59 Analog Point with Dialog Code 2


( Set manual only)

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.

7.3.41 Disallow Manual Set

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.

7.3.42 Drawing Style

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.

7.3.43 Draw from base

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.

Worldview for Windows Pmacros 7-49


Editor’s Guide
Figure 7-60 Draw from base

7.3.44 Erase Before Draw

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.

Table 7-6 Use of Associated Files


Pmacro File Location of file
Analog value, dialog code 1 Menu file wmp
Task pushbutton, dialog code 1 Menu file wmp
Image pushbutton Image file Image directory
External data pushbutton .udl file qry
Report pushbutton .xls or .qry file qry

Worldview for Windows Pmacros 7-50


Editor’s Guide
7.3.46 Flag Scale Factor X

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.

7.3.47 Flag Scale Factor Y

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.

7.3.48 Gauge Subtype

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

7.3.49 Gauge Type

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

7.3.50 Horizontal Justification

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:

Worldview for Windows Pmacros 7-51


Editor’s Guide
• Default (i.e. use the justification of the text style)
• Left
• Right
• Center
• Decimal

See section 5.4, Horizontal Justification, for a description of what these choices mean.

7.3.51 Image Scale Factor, X Axis

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.

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.

7.3.53 Label Color

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.

7.3.54 Label Position X

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.

7.3.55 Label Position Y

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.

Worldview for Windows Pmacros 7-52


Editor’s Guide
7.3.56 Label Text

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.

7.3.57 Label Text Style

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.

7.3.58 Limit Color

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.

Note that colors for a maximum of 6 limits can be defined.

7.3.59 Limit Max Value

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.

Note that a maximum of 6 limits can be defined.

7.3.60 Limit Min 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.

Note that a maximum of 6 limits can be defined.

7.3.61 Limit Center Color

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.

Worldview for Windows Pmacros 7-53


Editor’s Guide
7.3.62 Limit Max Visible %

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.

7.3.63 Limit Min Visible %

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.

7.3.64 Limits Number

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.

7.3.65 Lower Limit

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).

7.3.67 Magnification Point Name

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

Worldview for Windows Pmacros 7-54


Editor’s Guide
resource to produce the total amount of magnification. The variability afforded by the Magnification Point Name
resource allows you to enlarge the mobile icon under certain conditions to alert the operator.

7.3.68 Major / Minor Divisions

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.

7.3.69 Major / Minor Divisions Color

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.

7.3.70 Major Divisions Precision

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.

7.3.71 Major Divisions Text Color

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.

7.3.72 Major Divisions Text 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.

7.3.73 Minimum Size (Pixels)

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.

Worldview for Windows Pmacros 7-55


Editor’s Guide
If the value of this resource is zero (the default), the point is always selectable, no matter what its size, as long
as it can be seen. 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 size in pixels.

7.3.74 NAK Bitmap 0, 1, 2, 3, 4

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.

7.3.75 NAK Drawing Style Table

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.

7.3.76 NAK Symbol 0, 1, 2, 3, 4

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.

7.3.77 Needle Color

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.

Worldview for Windows Pmacros 7-56


Editor’s Guide
7.3.78 Needle Type

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

7.3.79 Needle Visible Percentage

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.

7.3.80 Normal Drawing Style Table

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.

Worldview for Windows Pmacros 7-57


Editor’s Guide
7.3.82 Owner Tag Flag Drawing Style Table

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.

7.3.83 Owner Tag Flag Enable

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.

7.3.84 Owner Tag Flag Offset X

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.

7.3.85 Owner Tag Flag Offset Y

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.

7.3.86 Owner Tag Flag Symbols

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.

7.3.87 Point Name

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.

Worldview for Windows Pmacros 7-58


Editor’s Guide
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.

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”.

7.3.88 Point Title 1, 2, 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.

7.3.91 Rotation (degrees)

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.

Worldview for Windows Pmacros 7-59


Editor’s Guide
7.3.92 Scale Factor On X Axis

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.

7.3.93 Scale Factor On Y Axis

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.

7.3.94 Select Box Drawing Style

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.

7.3.95 Sign Flag Enable

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.

7.3.96 Station Name

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.

7.3.97 Station Name 2, 3, 4

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

Worldview for Windows Pmacros 7-60


Editor’s Guide
on each of these resources opens a data entry dialog of the type shown in (Figure 7-14) to allow you to enter or
browse for a station name.

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.

Table 7-7 Use of Symbols With Analog Points


Resource Used When Analog Point Value Is:
Symbol 0 Positive
Symbol 1 Zero
Symbol 2 Negative

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.

7.3.101 Symbol Status Point Name

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.

Worldview for Windows Pmacros 7-61


Editor’s Guide
7.3.102 Tag Flag Drawing Style Table

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.

Table 7-8 Tag Flag Characters


Flag Character Meaning
T Point is tagged
S Device is selected for control
O Device is opening
X Device is closing
I Point is interlocked

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”.

See paragraph 7.3.103, Tag Flag Enable.

7.3.103 Tag Flag Enable

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.

7.3.104 Tag Flag Offset X

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”.

See paragraph 7.3.103, Tag Flag Enable.

7.3.105 Tag Flag Offset Y

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”.

Worldview for Windows Pmacros 7-62


Editor’s Guide
See paragraph 7.3.103, Tag Flag Enable.

7.3.106 Thousands Separator

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.

7.3.107 Text Style

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.

7.3.108 Time Format

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.

Table 7-9 Time Format Codes


Code Meaning Code Meaning
%a Abbreviated week day name %A Full weekday name
%b Abbreviated month name %B Full month name
%c Date/time representation for locale %d Day of month as decimal number
%H Hour in 24-hour format %I Hour in 12-hour format
%j Day of year as decimal number
%m Month as decimal number %M Minute as decimal number
%p Current locale's AM/PM indicator
%S Second as decimal number %U Week number in year (Sunday)
%w Weekday as decimal number %W Week number in year (Monday)
%x Date representation for current locale %X Time representation for locale
%y Year without century %Y Year with century
%z Time-zone name %% Percent sign

7.3.109 Tool Tip Text

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

Worldview for Windows Pmacros 7-63


Editor’s Guide
Loads

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.

7.3.110 Upper Limit

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.

7.3.111 View Name

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.

If you leave this resource blank, then when


you click on the station symbol, instead of
jumping to a view, the pmacro displays a
dialog box that allows you to acknowledge
all alarms on the station.

Figure 7-61 Dialog for Station With No 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.

Note that view names in all pmacros are case-insensitive.

Worldview for Windows Pmacros 7-64


Editor’s Guide
7.3.112 X Analog Point Name

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.

7.3.113 Y Analog 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.

7.3.114 Current Value Enable

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.

7.3.115 Enable Time

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.

7.3.116 Enable Current 15M Max (or Min)

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.

7.3.117 Enable Current Hour (Day or Week) Max (or Min)

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.

Worldview for Windows Pmacros 7-65


Editor’s Guide
7.3.119 Format String

This resource is used only by Analog History


pmacros, and allows you to customize the column
headings. Each column heading is separated by a
vertical bar "|". You can control the horizontal
justification by using preceding control characters:
< for left, > for right, and ^ for center.

Figure 7-62 Analog History Format String

7.3.120 Warn on Execute

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.

Figure 7-63 Dialog for Warning message

Worldview for Windows Pmacros 7-66


Editor’s Guide
7.4 Pushbuttons
This section describes in more detail how the various types of pushbuttons can be created and used. For
completeness of the description, the Pmacro Properties dialogs that are illustrated in this section correspond to
instantiated pmacros (i.e. pmacros that have been placed on the map and whose instance-specific data, such
as view name or graph number, has been filled in).

7.4.1 View Pushbutton

An example of an instantiated View pushbutton pmacro is shown in (Figure 7-64). In this example, only the
following were specified on instantiation:

• name of the view (ABERDEEN S/S SLD)


• pushbutton label (AB S/S)

Figure 7-64 Example of View Pushbutton Definition

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.

Worldview for Windows Pmacros 7-67


Editor’s Guide
Right-clicking on a view pushbutton brings up a pop-up menu that offers "Open" and "Open in New Window".

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.

7.4.2 Graph Pushbutton

An example of an instantiated Graph pushbutton pmacro is shown in (Figure 7-65). In this example, only the
following were specified on instantiation:

• graph number (12, specified by the Button Data resource)


• button label (Load and Weather Data)

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

Figure 7-65 Example of Graph Pushbutton Definition

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.

Worldview for Windows Pmacros 7-68


Editor’s Guide
7.4.3 Task Pushbutton

An example of an instantiated Task pushbutton pmacro is shown in (Figure 7-66). In this example, only the
following were specified on instantiation:

• command sequence number (specified by the Button Argument Data resource)


• task name (specified by the Button Data resource)
• button label (specified by the Button Label resource)

Figure 7-66 Example of Task Pushbutton Definition

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.

Worldview for Windows Pmacros 7-69


Editor’s Guide
There are a number of SCADA applications that support this task pushbutton interface. These are summarized
in Table 7-10. Note that on the VMS SCADA platform, you can write your own applications using the FDB
Library API.

Table 7-10 SCADA Applications That Support Task Pushbuttons


Button Button Button Application Application
Application Data Argument 1 Argument 2 “Run” Action “Stop” Action
Command SEQPRO command not used Starts the Stops the
Sequencing sequence # specified specified
(VMS and command command
Windows) sequence. sequence.

Historical Data THIST dataset # not used Takes an None.


Collection immediate sample
(VMS only) in the specified
dataset.

Load Shed LSEXEC load control not used Sheds the Restores the
(VMS only) set # specified load. specified load.

AGC (VMS AGCITF AGC not used Execute specified None.


only) command command

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.

Worldview for Windows Pmacros 7-70


Editor’s Guide
7.4.4 Note Pushbutton

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:

Figure 7-67 Example of Note Pushbutton Definition

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.

The Notes dialog contains right-click copy and paste functions.

Figure 7-68 Note dialog

Worldview for Windows Pmacros 7-71


Editor’s Guide
7.4.5 Image Pushbutton

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.

Figure 7-69 Example of Image Pushbutton Definition

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:

• Image Scale Factor, X Axis


• Image Scale Factor, Y Axis

Worldview for Windows Pmacros 7-72


Editor’s Guide
Figure 7-70 Browsing for Image Files

Figure 7-71 Image Directory

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.

Worldview for Windows Pmacros 7-73


Editor’s Guide
You can pick any directory for your image files. We recommend that you do not use any folder within
WorldView's "standard" directory. This is because some of the image files may be quite large, and the
convenience of being able to transfer your map database via e-mail or floppy disk in the form of zips of the
"standard" folder would be lost if your "standard" folder contained the image files.
We suggest that you create a folder called Images within the C:/Program Files/Quindar directory and put your
image files there.

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.

Figure 7-72 Example of Pop Up Image

Worldview for Windows Pmacros 7-74


Editor’s Guide
7.4.6 External Data Pushbutton

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.

Figure 7-73 Example of External Data Pushbutton Definition

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.

Worldview for Windows Pmacros 7-75


Editor’s Guide
The SQL "select" statement that fetches the desired record is specified by the pmacro's Button Data resource.
For example, if you specify:

select * from XFRMRS where NAME = '005A'

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.

Figure 7-74 Dataview Window Displaying External Data Record

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.

Worldview for Windows Pmacros 7-76


Editor’s Guide
Important

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.

7.4.7 Report Pushbutton

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.

Figure 7-75 Example of Report Pushbutton Definition

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.

Worldview for Windows Pmacros 7-77


Editor’s Guide
The .xls and .qry files that generate these reports and queries must be located in the qry folder of the standard
directory. If your connection is to a VMS host, the preparation of such reports and queries is described in
chapter 5 of the ODBC Driver and SQL Server User's Guide. For each report or query pushbutton, the filename
of the .xls or .qry file to be invoked is specified by the pushbutton pmacro's Filename resource.

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.

Figure 7-76 All Files Option in Filename Dialog

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.

Worldview for Windows Pmacros 7-78


Editor’s Guide
7.5 Menu Files
This section describes how to create menus for task activation targets and analog points. The menus are
defined by text files located in the wmp folder of the standard directory.

7.5.1 Task Menu

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.

Figure 7-77 Task Pushbutton with Menu

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.

Worldview for Windows Pmacros 7-79


Editor’s Guide
Figure 7-78 Browsing for Menu Files

(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 "

Figure 7-79 Example of Task Menu File

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.

Worldview for Windows Pmacros 7-80


Editor’s Guide
7.5.2 Analog Point Menu

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.

Figure 7-80 Analog Value Pmacro With Menu

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"

Worldview for Windows Pmacros 7-81


Editor’s Guide
Figure 7-81 Analog Point Menu

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).

7.5.3 View Menu

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.

Worldview for Windows Pmacros 7-82


Editor’s Guide
Figure 7-82 View Pushbutton with Menu

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:

1,ABERDEEN S/S SLD,Aberdeen


1,BARTONVILLE S/S SLD,Bartonville
1,CAROLINE S/S SLD,Caroline
1,CENTRAL S/S SLD,Central

Figure 7-83 View Menu

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.

Worldview for Windows Pmacros 7-83


Editor’s Guide
It is also possible to assign Alarm views and Oprsum views to the View pushbuttons. The desired .ALV or .OPR
file is specified in the Filename resource.

7.5.4 Report Menu

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

Figure 7-84 Report Menu

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.)

Worldview for Windows Pmacros 7-84


Editor’s Guide
7.6 Creating DSNs and UDL Files
This section describes how to create data structures that define locations of databases that may be accessed
via External Data pushbuttons.

7.6.1 Creating a DSN (Data Source Name)

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.

Figure 7-85 ODBC Data Source Administrator

Click on the Add... pushbutton

In the Create New Data Source window that appears, select the driver that is appropriate for the desired
database.

Worldview for Windows Pmacros 7-85


Editor’s Guide
Figure 7-86 Create new data Source Window

In this example, we're creating a DSN for an Access 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.

Figure 7-87 ODBC Microsoft Access Setup Dialog

Then click on the Select... pushbutton.

Worldview for Windows Pmacros 7-86


Editor’s Guide
In the Select Database window that appears, browse for the desired database.

Figure 7-88 Select Database

Use the Network... pushbutton if your database is on another computer

7.6.2 Creating a UDL File

A UDL file is a thing that specifies a DSN.

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

Worldview for Windows Pmacros 7-87


Editor’s Guide
Double-click on the file you just created. A Data Link Properties dialog will appear, as shown below.

In the Provider property sheet, select the


appropriate OLE DB provider. For Microsoft
Access, choose Microsoft OLE DB Provider for
ODBC Drivers.

Then click on Next>> (or click on the Connection


tab).

Figure 7-89 Data Link Properties Provider Tab

The Connection property sheet is context sensitive-


-it only shows options that are relevant to the
provider selected on the previous sheet.

In the Connection property sheet, select the "Use


data source name" option.

Then select the desired DSN from the pop-up


menu of DSNs immediately below the "Use data
source name" option.

For Oracle, you must enter a user name and


password in section 2 (see (Figure 7-90)).

You can use the Test Connection pushbutton to


verify that the database is reachable.

Figure 7-90 Data Link Properties Connection


Tab

Worldview for Windows Pmacros 7-88


Editor’s Guide
Then go on to the Advanced property sheet.

The Advanced property sheet only shows options


that are relevant to the selected provider.

For Oracle or SQL Server, you must enable the


access permission for Read. (You don't need to do
this for an Access database.)

Figure 7-91 Data Link Properties Advanced Tab

Then go on to the All property sheet.

The All property sheet provides a summary of the


initialization properties for the database connection
that you're setting up. You can edit any of the
properties directly from this sheet by double-
clicking on the property or selecting the name and
clicking the Edit Value button.

For Oracle, you must set the Persist Security Info


property to True.

You do not need to change anything else. The


value of the Data Source name appears
automatically. So do Password and User ID if you
entered them on the Advanced property sheet.

Figure 7-92 Data Link Properties All Tab

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.

Worldview for Windows Pmacros 7-89


Editor’s Guide
7.7 Missing Resource Check
When a map is opened, and resources such as pmacros are found to be missing, WorldView generates a
"Missing Resource" report to show you what’s missing. The report is contained in a log file created in the wmp
folder. The name of the log file is the name of the map.

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).

Figure 7-93 Missing Resource Error Window

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:

Missing Resources Report


C:\Program Files\Quindar\Maps\Hamilton\Standard\Wmp\Hamilton.wmp
15/04/2005 12:42:24

Resource Name Resource Type # Refs


=====================================================================

STANDARD_YELLOW DRAWING_STYLE 10682


-----------------------------------------------------------------------
WDrawString 67
WDrawPoint 9042
WDrawSymbol 802
WDrawPmacro 493
WDrawArc 278

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.

Worldview for Windows Pmacros 7-90


Editor’s Guide
If you bring up the resource editor for a resource that contains references to missing resources, the editor tries
to show as much of the resource as possible so that you can make corrections if you decide to not try to recover
the missing resources.

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.

7.8 Sharing Resources With Other Users


Sharing of resources such as WorldView symbols, pmacros and control panels can be done in a user-friendly
manner by using the Export and Import functions.

7.8.1 Export Object

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.

Figure 7-94 Export Object

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

Worldview for Windows Pmacros 7-91


Editor’s Guide
exports. It does this in order to:
1) identify who the files came from, and
2) avoid conflicts if multiple people export resources with the same name.

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.

7.8.2 Import objects

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:

• It’s not necessary to have a prefix defined in order to do imports.

• 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).

Worldview for Windows Pmacros 7-92


Editor’s Guide
8 Map Editing

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.

8.1 File Menu

The File menu is illustrated in (Figure 8-1).


Only the items relevant to editing are described
below. The other functions are described in the
WorldView for Windows Operator’s Guide.

Figure 8-1 File Menu

Worldview for Windows Map Editing 8-1


Editor’s Guide
8.1.1 New Map

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.

Figure 8-2 New Map Window

Worldview for Windows Map Editing 8-2


Editor’s Guide
8.1.2 Open

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.

Figure 8-3 Open A Map

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.

Figure 8-4 Opening an Existing Map

Worldview for Windows Map Editing 8-3


Editor’s Guide
8.1.3 Import

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.

8.1.5 Portable Map Export

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.

If you attempt to exit WorldView without saving


your changes, you will be prompted to save your
changes before the program exits.

Figure 8-5 Prompt To Save Changes

8.1.7 Save As

The Save As function saves the current map under


a new name. The Save As window that is displayed
contains a File name data entry field in which you
type in the desired file name. If you want to save
the map under an existing name, thereby
overwriting the existing map, you can click on the
existing file name. Clicking on the Save button in
the Save As window saves the map.

Figure 8-6 Save As Window

Worldview for Windows Map Editing 8-4


Editor’s Guide
8.1.8 Reservations

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.

8.1.9 Publish LS’s

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:

System Configuration Status User’s Guide (document number SCS-300)

8.2 Edit Menu


The Edit pull-down menu is illustrated in (Figure 8-7).

Figure 8-7 Edit Menu

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.

Worldview for Windows Map Editing 8-5


Editor’s Guide
Only the items relevant to editing are described below. The other functions are described in the WorldView for
Windows Operator’s Guide.

Figure 8-8 Pop Up Menu Obtained on Right Click on an object

8.2.1 Undo / Redo

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.

Worldview for Windows Map Editing 8-6


Editor’s Guide
8.2.4 Paste

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.

Figure 8-9 Pasting a Substation

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.

Worldview for Windows Map Editing 8-7


Editor’s Guide
8.2.6 Find

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:

• “Replace with:” text field


• Replace pushbutton - this causes the found string to be replaced
• Replace/Next pushbutton - this causes the found string to be replaced and find the next instance of the
string
• Replace All pushbutton - this causes all instances of the string to be replaced

Figure 8-10 Find and Replace Text

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.

Worldview for Windows Map Editing 8-8


Editor’s Guide
Next, select the Group function, and from the sub-
menu that appears, select Group again. The
objects will now be grouped.

When you click on a group, the editor highlights


your selection by one selection rectangle
encompassing all of the objects in the group. In a
selection rectangle for a group, the handles are
colored magenta instead of yellow.
In (Figure 8-11), all of the circuitry on the right side
of the substation had been grouped and is now
selected.

Figure 8-11 Grouped Half of Substation

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.

Worldview for Windows Map Editing 8-9


Editor’s Guide
The editor will not allow you to ungroup a group that has been assigned to a segment or line section. The
Ungroup function is insensitive if the group that you have selected is associated with a segment or line section.
You must break any such association before you can ungroup the group.

8.2.10 Alignment

This function brings up a pop-up menu shown in


(Figure 8-12) with options to align the selected
objects, evenly space and make the selected
objects the same size, width and height.

Figure 8-12 Alignment Menu

There is also an equivalent alignment toolbar that can be obtained via the alignment pushbutton in the Edit
toolbar.

8.2.10.1 Left

This function aligns the left edge of the selected objects.

8.2.10.2 Right

This function aligns the right edge of the selected objects.

8.2.10.3 Top

This function aligns the top edge of the selected objects.

8.2.10.4 Bottom

This function aligns the right edge of the selected objects.

8.2.10.5 Center Vertical

This function aligns the selected objects centered vertically.

8.2.10.6 Center Horizontal

This function aligns the selected objects centered horizontally.

8.2.10.7 Spaced Vertical

This function evenly spaces the selected objects vertically.

Worldview for Windows Map Editing 8-10


Editor’s Guide
8.2.10.8 Spaced Horizontal

This function evenly spaces the selected objects horizontally.

8.2.10.9 Distribute as Matrix

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.

Figure 8-13 Matrix Alignment Dialog

Auto Spacing (Preserves Order)

ƒ 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.

Manual Spacing (Does Not Preserve Order)

ƒ 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.

Worldview for Windows Map Editing 8-11


Editor’s Guide
8.2.10.10 Same Height

This function allows you to make the selected objects the same height as the:
ƒ maximum height object, or
ƒ minimum height object

8.2.10.11 Same Width

This function allows you to make the selected objects the same width as the:
ƒ maximum width object, or
ƒ minimum width object

8.2.10.12 Same Size

This function allows you to make the selected objects the same size as the:
ƒ biggest object, or
ƒ smallest object

8.2.11 Change Station

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.

When you click on the Rename button, all point


names on the old station are changed to
corresponding points on the new station.

Note that it is the point names in the selected


pmacros that are changed, not the points
themselves. Selected objects that are not pmacros
are not affected.

On completion of the operation, the Change Station


dialog reports how many pmacros were modified,
how many were not modified because their points
were not on the old station, and how many could
not be modified because the corresponding points
were not found on the new station.

Figure 8-14 Change Station

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.

Worldview for Windows Map Editing 8-12


Editor’s Guide
8.2.13 Back

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.

8.2.17 Nudge Functions

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.

8.2.18 Select Member

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.

Worldview for Windows Map Editing 8-13


Editor’s Guide
8.3 View Menu
(Figure 8-15) illustrates the View menu.

Figure 8-15 View Manu

Only the items relevant to editing are described below. The other functions are described in the WorldView for
Windows Operator’s Guide.

8.3.1 Edit Bar

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.

See paragraph 2.2.6, Navigation Bar.

8.3.2 Edit Tools

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.

8.3.3 Alignment 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.

Worldview for Windows Map Editing 8-14


Editor’s Guide
8.3.4 Background Images

This toggle function allows you to turn on or off background images in a map.

8.3.5 Tree Lists

This function brings up the Views and Layers window shown in (Figure 8-16).

The Views and Layers window contains four


tabbed panes. The one labeled Views shows a list
of all of the views that are defined in the map. From
this pane, you can create, modify and delete views.
You can also organize your views in a hierarchical
fashion via folders and sub-folders. Details about
creating and maintaining views are provided in
section 8.9, Views.

Figure 8-16 Views and Layers Window

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.

Worldview for Windows Map Editing 8-15


Editor’s Guide
A button bar equivalent for the Tree Lists function is available in the navigation bar.

A detailed description of how to create and manage layers is provided in section 8.10, Layers.

8.3.6 Library Selector

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.

Figure 8-17 Library Selector Window

Worldview for Windows Map Editing 8-16


Editor’s Guide
8.4 Map Menu
The Map menu is shown in (Figure 8-18)

Figure 8-18 Map Menu

It contains four functions that are described below.

8.4.1 Set Extent

This function brings up a dialog that allows


you to override the extent of the map.

To change the extent, set the mouse pointer


to where you want the lower left corner and
record the coordinates. Repeat for the upper
right coordinates. Then access the Set Map
Extent dialog and enter these coordinates.

Figure 8-19 Set map extent Dialog

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.

8.4.2 Set Grid

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.

Worldview for Windows Map Editing 8-17


Editor’s Guide
If you uncheck Grid Visible, the grid will not be
displayed even when it’s enabled. Even though
you can’t see the grid in this case, you can still
feel the effects of the grid in that objects and end-
points appear to jump from grid-point to grid-point
as you move the mouse.

Figure 8-20 Grid Dialog

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.

Figure 8-21 Example of Visible Grid

8.4.3 Optimize Map

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.

Worldview for Windows Map Editing 8-18


Editor’s Guide
Values of approximately 100 have been found to
produce dramatically improved display response
times for large maps.

Figure 8-22 Optimize Map Dialog

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.

8.4.4 Layer Statistics

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.

Invoking the Layer Statistics function


brings up the Save As dialog to allow
you to specify the name and directory
for the report file.

Figure 8-23 Save As Window for Layer Statistics


Report File

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).

Worldview for Windows Map Editing 8-19


Editor’s Guide
Figure 8-24 Layer Statistics Report File

8.4.5 Grid Enabled

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.

8.5 Tool Bar


The editing functions that are contained in the Tool bar have already been described for their menu counterparts
in section 8.1, File Menu, and 8.2, Edit Menu. The non-editing functions are described in detail in the
WorldView for Windows Operator’s Guide. They will just be listed here.

New Window Open a window with same contents as active window

Open Open a file

Save Save symbol, pmacro or map

Cut Cut object(s) from the map and copy to the clipboard

Copy Copy object(s) to the clipboard

Paste Copy items from the clipboard onto the map or symbol

Print Print

Worldview for Windows Map Editing 8-20


Editor’s Guide
8.6 Navigation Bar
The navigation bar contains some functions related to editing. Only the editing functions are described below.
The non-editing functions are described in the WorldView for Windows Operator’s Guide.

Layers Open the Layers drop-down menu

Views and layers List Open the Views and Layers pop-up window

Edit Mode Toggle edit mode and edit bar

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.

Figure 8-25 Selecting a Layer

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.

Worldview for Windows Map Editing 8-21


Editor’s Guide
8.6.2 Views and Layers Lists

This performs the same function as the Tree Lists item in the View menu. See paragraph 8.3.5, Tree Lists.

8.6.3 Edit Mode

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 Edit Bar


The Edit bar contains drawing tools that allow you to select the type of graphics that you wish to place on the
map. The edit bar is only available when you are in edit mode and appears automatically when you go into edit
mode.

The contents of the edit bar are described below.

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.

If you left-click, the object will be highlighted by a selection


rectangle that contains eight yellow handles.

You can:

• move the selected object by dragging it to the desired location

• delete the object by pressing Shift + Delete

• 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

Worldview for Windows Map Editing 8-22


Editor’s Guide
If you right-click, a pop-up menu of functions to perform on the selected object will appear. With the exception of
Select Member, these functions have counterparts in the Edit pull-down menu and are described in section 8.2,
Edit Menu.

If you double-click on an object, WorldView reacts


as though you had selected it, right-clicked, and
chosen Modify.

The Modify function brings up a Properties dialog


of a type that is appropriate to the selected object.
These dialogs allow you to review the definition of
the object as well as make changes, and are
described below with the appropriate drawing tool.

Figure 8-26 Pop up Menu

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 top-middle, bottom-middle and side-middle handles are not active.

• 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.

Worldview for Windows Map Editing 8-23


Editor’s Guide
8.7.2 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.3 Toggle Grid

This performs the same function as the Library Selector item in the View Menu. See paragraph 8.3.6, Library
Selector.

8.7.4 Toggle Alignment Toolbar

This pushbutton brings up an object alignment toolbar described bellow.

Align the right


Align the top edge edge of the
of the selected selected objects Align the bottom
objects edge of the Align the selected
selected objects objects centered
horizontally
Align the left edge Align the selected
of the selected objects centered
objects vertically Make the selected
objects the same height
as the:
-maximum height object
-maximum width object
-biggest object
Evenly space the Distribute the objects
selected objects Evenly space the
selected objects in a matrix of rows and
vertically columns
horizontally
Make the selected
objects the same height
as the:
-minimum height object
-minimum width object
-smallest object

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.

Worldview for Windows Map Editing 8-24


Editor’s Guide
As is the case when adding any object to the map, make sure you’ve selected the desired layer into which you
want the object to go. You can do this by using the Layers drop-down menu (described in paragraph 8.6.1,
Layers) or the Layers pane of the Views and Layers window (described in section 8.10, Layers). Also, if you’re
adding graphics primitives such as lines, shapes or text strings, make sure you have selected the desired
drawing style, and in the case of text, the desired text style. You can do this via the Library Selector.

8.7.6 Modifying Line Properties

If you right-click on a line and select the Modify


function, a Point Properties window appears
showing the properties of the selected line.

The Point Properties dialog identifies the layer and


drawing style of the selected line. To change these,
use the Relayer and Recolor functions.

Figure 8-27 Point Properties Dialog for Line

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.

Figure 8-28 X-Y Coordinates Dialog

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.)

Worldview for Windows Map Editing 8-25


Editor’s Guide
8.7.7 Rectangle

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.

8.7.8 Filled Rectangle

This tool allows you to draw filled rectangles in the same manner as described above for unfilled
rectangles.

8.7.9 Modifying Rectangle Properties

If you right-click on a rectangle and select the


Modify function from the pop-up menu, a Point
Properties window appears showing the properties
of the selected rectangle. This is the same Point
Properties dialog that we saw in the previous
paragraph for lines, except that there are now five
coordinate pairs instead of two (the last one is a
repeat of the first one).

The coordinates can be modified in the same


manner as described for lines. The editor will not
prevent you from completely distorting the
rectangle by changing the coordinates of its
vertices.

Figure 8-29 Point Properties Dialog for


Rectangle

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.

Worldview for Windows Map Editing 8-26


Editor’s Guide
8.7.11 Filled Ellipse

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.

8.7.13 Filled Arc

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.

8.7.14 Modifying Arc Properties

If you right-click on an ellipse (or any arc)


and select the Modify function from the pop-
up menu, an Arc Properties dialog appears
for the selected ellipse. The Arc Properties
dialog identifies the layer and drawing style
of the ellipse. You can modify these by
using the Relayer and Recolor functions.

Figure 8-30 Arc Properties Dialog

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

Worldview for Windows Map Editing 8-27


Editor’s Guide
considered as part of an ellipse, and the XY coordinates that are stored are those of a bounding box for the
complete ellipse.

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.

The diagram in (Figure 8-31) shows the location of


the angles in an ellipse, with 0 on the right edge of
the horizontal plane of the ellipse, and the angle
being measured in a counter clockwise direction.

The coordinates inside the circle are what you will


find on any arc you create. By modifying the Start,
Angle, and XY co-ordinates, you can precisely
control the shape and placement of an ellipse or
arc.

Figure 8-31 Start, Angle for Arcs

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.

Worldview for Windows Map Editing 8-28


Editor’s Guide
Table 8-1Modifying the Properties of an Arc
Ellipse Start Angle Mode Style Appearance

1 0 360 Open Pie

2 -45 270 Open Pie

3 -45 270 Closed Pie

4 -45 270 Filled Pie

5 -45 270 Filled Chord

8.7.15 Closed Polygon

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.

8.7.16 Filled Polygon

This tool allows you to create a closed polygon. The procedure is the same as that described above for a
closed polygon.

8.7.17 Open 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.

Worldview for Windows Map Editing 8-29


Editor’s Guide
8.7.18 Modifying Polygon Properties

If you right-click on a polygon (of any type) and


select the Modify function from the pop-up menu, a
Point Properties dialog appears for the selected
polygon. The Point Properties dialog, which is the
same one that is displayed for lines and rectangles,
identifies the layer and drawing style of the
polygon. You can modify these by using the
Relayer and Recolor functions.

The coordinates list, which is scrollable, can be


modified in the same way as for lines and
rectangles. You can also change a polygon from
filled to unfilled and vice versa.

Figure 8-32 Point Properties Dialog for Polygon

8.7.19 Text String

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.

There is no limit on the length of the text string that


you can enter, but there are no text wrap tools, so
the string will display on one line.

The String Properties dialog allows you to override


the current text style’s horizontal and vertical
justification and the orientation for the text string.
See Chapter 5, Text Styles, for definitions of these
text styles attributes. Don’t overuse this override
capability, or you may find that you won’t be able to
make simple global changes later on.

The String Properties dialog also allows you to


specify an angle of rotation (in degrees).

Figure 8-33 String Properties Dialog

Worldview for Windows Map Editing 8-30


Editor’s Guide
8.7.20 Modifying String Properties

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.

8.7.22 Modifying Symbol Properties

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.

The XY coordinate fields allow you to precisely


locate the symbol where you want. The Scale X
and Scale Y fields give you the option of changing
not only the size of the symbol but also the aspect
ratio.

Symbols can also be rotated. The angle of rotation


is specified in degrees counterclockwise.

Figure 8-34 Symbol Properties Dialog

Worldview for Windows Map Editing 8-31


Editor’s Guide
8.7.23 Pmacro

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.

Figure 8-35 Displayed Pmacros

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.

8.7.24 Pmacro Properties Dialog

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.

Figure 8-36 Pmacro Properties Dialog for Status Symbol Pmacro

Worldview for Windows Map Editing 8-32


Editor’s Guide
Each class of pmacro has its own type of Pmacro Properties dialog. These dialogs are the same as those used
with the Pmacro editor to create the pmacros, and are described in Chapter 7, Pmacros.

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.

8.7.25 Attaching a Point Name to a Pmacro

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.

Figure 8-37 Point Name Resource Dialog

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.

Worldview for Windows Map Editing 8-33


Editor’s Guide
When you click on the desired station name, the Point Browser window updates to show an alphabetically-
ordered list of all of the points on the selected station, as shown in (Figure 8-39). The list is filtered to contain
only points of the type that is appropriate to the pmacro.

Figure 8-38 Station List in Point Browser

Figure 8-39 Point List in Point Browser

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.

Worldview for Windows Map Editing 8-34


Editor’s Guide
Figure 8-40 Point Name Resource Dialog with Point Name

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.

Figure 8-41 Point Name in Override Column of Status Symbol Pmacro

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.

Figure 8-42 Control Dialog for Status Point

Worldview for Windows Map Editing 8-35


Editor’s Guide
8.8 Groups
Grouping multiple objects together can be a very useful way to edit parts of your map. When you click on any
element of a group (in edit mode), the entire group is highlighted by one selection rectangle that completely
surrounds the group of objects. You can move or re-size the group as if it was one object.

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.

8.8.1 Creating a Group

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.

After selecting the objects, right-click anywhere


within the outer selection rectangle, and in the pop-
up menu that appears, select Group. In the sub-
menu that appears after that, select Group again.

Figure 8-43 Creating a Group

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.

Worldview for Windows Map Editing 8-36


Editor’s Guide
To ungroup a group, right-click on any element of
the group and in the pop-up menu that appears,
select Ungroup.

If a group has been assigned to a status point


(segment) or a line section record, you cannot
ungroup the group until you delete the group’s
association to the point or line section. You don’t
have to delete the point or line section itself – just
the group’s association to the point or line section.

Figure 8-44 Ungroup

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.

To turn a group into a segment, right-click on any


element of the group. In the pop-up menu that
appears, select Group. In the sub-menu that
appears, the Segment item is now selectable.
When you select it, a special Segment Pmacro
Properties dialog appears.

Figure 8-45 Creating A Segment

Worldview for Windows Map Editing 8-37


Editor’s Guide
In the Group sub-menu, the Group item is still selectable because you can create groups of groups. The Line
Section item is selectable only if you have the System Configuration Status program on your system.

Figure 8-46 Pmacro Properties Dialog for Segment

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.

Worldview for Windows Map Editing 8-38


Editor’s Guide
8.8.3 Select Member

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.)

Figure 8-48 Group Internal Identifier

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).

Worldview for Windows Map Editing 8-39


Editor’s Guide
Figure 8-49 Select Member

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.

You can also include a photo as the background of a view.

8.9.1 Creating a View

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).

Worldview for Windows Map Editing 8-40


Editor’s Guide
Figure 8-50 Adding a View in the Views and Layers Window

In the pop-up menu that appears, select Add View.


An Edit Views dialog will appear, as shown in (Figure 8-51).

Type in the desired view name into the View field


and click on OK.

View names are case-insensitive.

The Lower Left and Upper Right X-Y fields are


initialized to the coordinates of the lower left and
upper right corners of the map window, so you
don’t have to enter these if the desired view is
exactly what’s currently in the map window. But
you can adjust these if you wish.

When you click on OK, the Edit Views dialog is


removed and the new view name is added to the
list of views in the Views pane of the Views and
Layers window.

Figure 8-51 Edit Views Dialog

Worldview for Windows Map Editing 8-41


Editor’s Guide
Double-clicking on the view name takes you
immediately to that view.

Figure 8-52 New View

8.9.2 Modifying a View

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.

Figure 8-53 Modifying a View

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.

Worldview for Windows Map Editing 8-42


Editor’s Guide
Figure 8-54 Confirmation to Create View

8.9.3 Background Images

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.

Figure 8-55 Background Image Browser

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.

Worldview for Windows Map Editing 8-43


Editor’s Guide
Figure 8-56 View Definition with Background Image, Streched to Fit

An example of a view with a photo of a substation as a background is shown in (Figure 8-57).

An example of an overview with a logo (Survalent’s) as a background is shown in (Figure 8-58).

Figure 8-57 View with Background Image (Stretched to Fit)

Worldview for Windows Map Editing 8-44


Editor’s Guide
Figure 8-58 View with Logo Image (Not Stretched to Fit)

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.

8.9.4 Deleting a View

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.

Worldview for Windows Map Editing 8-45


Editor’s Guide
Figure 8-59 Confirmation to Delete View

8.9.5 Adding a Views Folder

To add a views folder, right-click on the main Views


folder and select Add Folder from the pop-up
menu. In the Enter Name Of Folder dialog that
appears, type in the desired name of the folder.

Figure 8-60 Enter Name of Folder Dialog

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.

Figure 8-61 New Folder

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.

Worldview for Windows Map Editing 8-46


Editor’s Guide
8.9.6 Deleting a Folder

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.

Figure 8-62 Confirmation to Delete View

8.9.7 Organizing Views

To move a view up or down in a list:

1. Click on the view that you wish to move.


2. Drag the view to the position after which you wish the view to appear and release the mouse button.

Folders can be moved in the same way. To move a view into a folder:

1. Click on the view that you wish to move.


2. Drag the view to the folder icon of the target folder and release the mouse button.

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.

Worldview for Windows Map Editing 8-47


Editor’s Guide
Figure 8-63 Closed Folder Figure 8-64 Open Folder With Three Views In It

Note that folders can be placed inside other folders to create a multi-level hierarchy of views.

To bring a view or folder out of a folder:

1. Click on the view or folder that you wish to


move.

2. Drag the view or folder to another view or


folder name (not icon) and release the mouse
button.

(Figure 8-65) illustrates taking view 2 out of “My


folder” by dragging it and releasing the mouse
button when the pointer was over the name “My
folder”.

Figure 8-65 Taking View 2 Out Of "My folder"

Worldview for Windows Map Editing 8-48


Editor’s Guide
8.9.8 Set As Default View

To make a view the default view, right-click on the


view name and select Set As Default View from the
pop-up menu. The arrow beside the default view
name is highlighted red. From now on, this is the
view that will appear when you click on the Default
View button in the navigation bar.

Figure 8-66 Default View

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.

Worldview for Windows Map Editing 8-49


Editor’s Guide
8.10.1 Creating a Layer

To create a layer, access the Views and Layers


window by clicking on the Tree Lists button in the
navigation bar or by using the Tree Lists function in
the View menu. In the Views and Layers window,
click on the Layers tab.

Right-click on the Layers folder. In the pop-up


menu that appears select Create layer.

This will bring up an Edit Layers dialog, as shown


in (Figure 8-68).

Figure 8-67 Create Layer

Enter the desired layer name into the Layer Name


data field and click on OK.

The Edit Layers dialog will be dismissed and the


new layer will be added to the end of the list of
layers in the View and Layers window.

The Zoom Out and Zoom In Declutter Point data


specify the minimum and maximum zoom levels,
respectively, for automatic decluttering. This is
described in paragraph 8.10.2, Setting Automatic
Declutter Levels.

Figure 8-68 Edit Layers Dialog

Worldview for Windows Map Editing 8-50


Editor’s Guide
8.10.2 Setting Automatic Declutter Levels

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.

Figure 8-69 Modify Layer

This brings up the Edit Layers dialog that we saw earlier.

Worldview for Windows Map Editing 8-51


Editor’s Guide
Click on the Set Current button beside the Zoom
Out Declutter Point field. This causes the current
scale in world units per pixel to be calculated and
filled into the Zoom Out Declutter Point field. Click
on OK.

Now zoom in to the maximum zoom level at which


you wish the layer to be visible. Access the Layer
dialog again by right-clicking on the layer name in
the layers list. Click on the Set Current button
beside the Zoom In Declutter Point field. This
causes the current scale in world units per pixel to
be calculated and filled into the Zoom In Declutter
Point field. Click on OK. Now, when you zoom
outside of these two zoom levels, the layer will
automatically turn off (if the layer is in auto-
declutter mode). Setting the declutter mode of a
layer is described in the WorldView for Windows
Operator’s Guide.

Figure 8-70 Setting Maximum and Minimum


Scale for Automatic Declutter

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.

Figure 8-71 Confirmation to Create New Layer

Worldview for Windows Map Editing 8-52


Editor’s Guide
8.10.3 Deleting a 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.

Figure 8-72 Confirmation to Delete Layer

8.10.4 Layer Drawing Order

The Layer Drawing Order pane of the Views and


Layers window displays a list of all of the layers
that are in your map. The order of the layers in this
list is the order in which the layers are re-drawn by
WorldView whenever navigate through the map.
This order is initially the order in which the layers
were created.

Figure 8-73 Layer Drawing Order

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.

8.10.5 Organizing Layers

As in the case of views, you can hierarchically organize your layers in folders.

Worldview for Windows Map Editing 8-53


Editor’s Guide
To create a new folder, right-click on the Layers
folder and select Create Folder from the pop-up
menu. An Enter Name Of Folder dialog will appear
(the same one that we saw for views). Enter the
desired name of the new folder and click on OK.

Figure 8-74 Creating A Folder for Layers

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.

Figure 8-75 Hierarchical Layer Folders

Setting the declutter modes of layers is described in the WorldView for Windows Operator’s Guide.

Worldview for Windows Map Editing 8-54


Editor’s Guide
When you decide how to organize your layer folders, keep in mind a very powerful layer control feature that is
available to the operators. In the right-click pop-up menu are some functions that can be used to place entire
folders of layers into automatic or manual declutter mode:

• 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.

Worldview for Windows Map Editing 8-55


Editor’s Guide
9 World Map Import

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.

Worldview for Windows World Map Import 9-1


Editor’s Guide
9.1 DXF File Import
To import a DXF file, you have to be logged into a privileged account. If you are importing for the first time,
create a new (and empty) map window by selecting New Map from the File menu. This creates an empty
WorldView map window.

Figure 9-1 Selecting New Map in File Manu

Switch to Edit Mode, and from the File menu,


select Import, and then from the next sub-menu
that appears, select DXF R12 File.

When you select the DXF R12 File item, a browse


window is displayed inviting you to select the DXF
file you wish to import.

Figure 9-2 Selecting DXF R12 File item

Worldview for Windows World Map Import 9-2


Editor’s Guide
Figure 9-3 Import DXF files

When you select the desired DXF file, a DXF Import Settings window is displayed.

Figure 9-4 DXF Import Settings

In the DXF Import Settings window:

• 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 allow for later additions to the map

• to support monitors with different aspect ratios (e.g. 3x4, 16x9 etc) from that where the import is being
performed.

Worldview for Windows World Map Import 9-3


Editor’s Guide
• The X and Y offsets are calculated for you to center the imported map at origin 0,0 in the WorldView
coordinate space. These can be edited if you don’t wish the imported map to be centered in WorldView’s
coordinate space.

• 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.

Worldview for Windows World Map Import 9-4


Editor’s Guide
Figure 9-5 Import Progress Bar

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.

Figure 9-6 Import Error Message

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.

9.1.1 Saved DXF Import Parameters

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.

Worldview for Windows World Map Import 9-5


Editor’s Guide
If you click on Import without saving the defaults, you are asked whether you wish to save the current settings.
You can say No if you wish. If you say yes, you will be prompted to enter or browse for a filename.

Figure 9-7 Confirmation to Save Import Settings

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.

Worldview for Windows World Map Import 9-6


Editor’s Guide
9.1.2 Text-to-Symbol Replacement in Microstation

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

// Notes: Separators are SPACE, TAB and QUOTE

MICROSTATION 1

MS_CONVERSION "HYDRO" "ZZZ" 3D_BREAKER_CLOSED STANDARD 1.0 1.0


MS_CONVERSION "SW_LABEL" "M5-51" 60POLE STANDARD 1.0 1.0

// EOF

The cross-reference file contains the following keywords:

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.

Worldview for Windows World Map Import 9-7


Editor’s Guide
• Font

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.

9.1.3 DWG / DXF File import

The DWG / DXF import function is a more advanced function that presently supports all versions of AutoCAD
DWG and DXF up to AutoCAD 2008.

Figure 9-8 Selecting a DWG/DXF File in File Menu

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.

Worldview for Windows World Map Import 9-8


Editor’s Guide
9.2 Import From WorldView for VMS
This section describes how to import WorldView text files that were exported from WorldView for VMS. The file
extensions of these exported text files are listed in Table 9-1.

Table 9-1 Exported Text File Extensions


File
Extension File Type
.wms WorldView map
.gcs Drawing styles and drawing style tables
.fns Text styles
.pms Pmacros
.sms Symbols and symbol tables
.ims Pixmap ASCII file

To import a WorldView database from VMS:

1. Open a new map (using the New Map function in the File pull-down menu).

2. Import the libraries in the following order:

• Drawing Styles
• Pixmaps
• Text Styles
• Symbols
• Pmacros

Figure 9-9 Selecting Drawing Styles

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.

Worldview for Windows World Map Import 9-9


Editor’s Guide
Figure 9-10 Import drawing styles

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.

Figure 9-11 Import Map

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

Worldview for Windows World Map Import 9-10


Editor’s Guide
files. Generally, you would import the libraries only once but re-import the map(s) whenever there are changes
on the VMS system that you want on your PC. If there were changes in any of the libraries on the VMS system,
then you would re-import those too.

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.

9.3 Portable Map Export


This function allows you to export a map to a text file (with .wms extension) with its point IDs replaced by the
actual point names. The purpose of this is to produce a map that can be re-imported into another system where
the point IDs are different, such as when moving from a VMS to a Windows SCADA system. On import to the
other system, WorldView looks up every point name and produces and saves new point IDs.

Figure 9-12 Portable Map Export

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.

Worldview for Windows World Map Import 9-11


Editor’s Guide
Figure 9-13 Export Map

Worldview for Windows World Map Import 9-12


Editor’s Guide
10 Change Control

10.1 Change Control With Reservations


WorldView supports a Reservation system that prevents multiple users from editing the map simultaneously.

• 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.

The Reservation system is only available for Windows SCADA.

10.1.1 Setup

The WorldView reservation system is enabled via the WorldView page of the System Parameters editor in the
SCADA Explorer.

To enable reservations, you have to:

Worldview for Windows Change Control 10-1


Editor’s Guide
ƒ Specify the directory on the network that contains the official copy of the WorldView database. In the
example above, this is a directory called Repository on a computer called Servert.

ƒ Check the Enable Reservations checkbox.

ƒ And, of course, place your official copy of the WorldView database in the specified repository directory.
The repository directory contains the Standard folder.

10.1.2 Reserving the WorldView Database

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:

Figure 10-1 Error message

To reserve the WorldView database, use the Reservations sub-menu in the File menu.

Figure 10-2 Reservation the WorldView database

If someone else has the database reserved, WorldView identifies the reservation holder’s account name and
workstation to you.

Worldview for Windows Change Control 10-2


Editor’s Guide
10.1.3 Publishing Your Edits

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.

Figure 10-3 Publishing the Edits

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.

Worldview for Windows Change Control 10-3


Editor’s Guide
The Publish operation is logged in the operations log. Reserve, Release and Update functions are not logged.

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.

Worldview for Windows Change Control 10-4


Editor’s Guide
A value of zero in the Publish Check Time parameter means check only at startup. Once you acknowledge that
you’ve seen the message (by clicking on OK), WorldView does not re-issue the message unless you restart
WorldView or another Publish occurs.

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.

Worldview for Windows Change Control 10-5


Editor’s Guide
10.2 Change Control Without Reservations
If you choose to not enable the Reservation system, or if your SCADA system is based on VMS, then you have
to use a more hands-on approach. However, basically, in order to publish your changes to other PCs, all you
really have to do is transfer the files that you have created and modified to those other PCs. These files are all
contained in various sub-folders of:

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.

10.2.1 Control of Editing

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.

Consider including the following in your procedure:

• 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).

Worldview for Windows Change Control 10-6


Editor’s Guide
• A mechanism exists to ensure that updated maps are distributed to all users. You can use e-mail, CDs, or
LAN-based file transfers. A very convenient way to completely update a PC is to zip the entire standard
directory on the PC where the edits were made, copy the zip file to the target PC, and unzip the zip file into
the target PC’s standard directory. Just say yes to All when the Confirm File Overwrite dialog appears.

• 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).

10.2.2 Publish and Update

Sharing a WorldView Database

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"

Worldview for Windows Change Control 10-7


Editor’s Guide
For an Update function, you can create a file called "Update.bat" that contains just one statement:

Xcopy <file://tycho/ScadaCommon/standard> \\tycho\ScadaCommon\standard


"c:\program files\quindar\worldview\standard" /S/Q

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:

Xcopy "c:\program files\quindar\worldview\standard"


<file://tycho/ScadaCommon/standard> \\tycho\ScadaCommon\standard /S/Q

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.

Worldview for Windows Change Control 10-8


Editor’s Guide

You might also like