Wonderware Creating and Managing ArchestrA Graphics User’s Guide 10/21/15 No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Schneider Electric Software, LLC. No liability is assumed with respect to the use of the information contained herein. Although precaution has been taken in the preparation of this documentation, Schneider Electric Software, LLC assumes no responsibility for errors or omissions. The information in this documentation is subject to change without notice and does not represent a commitment on the part of Schneider Electric Software, LLC. The software described in this documentation is furnished under a license agreement. This software may be used or copied only in accordance with the terms of such license agreement. © 2015 Schneider Electric Software, LLC. All rights reserved. Schneider Electric Software, LLC 26561 Rancho Parkway South Lake Forest, CA 92630 U.S.A. (949) 727-3200 http://software.schneider-electric.com/ ArchestrA, Avantis, DYNSIM, EYESIM, Foxboro, Foxboro Evo, I/A Series, InBatch, InduSoft, IntelaTrac, InTouch, PIPEPHASE, PRO/II, PROVISION, ROMeo, Schneider Electric, SIM4ME, SimCentral, SimSci, Skelta, SmartGlance, Spiral Software, VISUAL FLARE, WindowMaker, WindowViewer, and Wonderware are trademarks of Schneider Electric SE, its subsidiaries, and affiliated companies. An extensive listing of Schneider Electric Software, LLC trademarks can be found at: http://software.schneider-electric.com/legal/trademarks/. All other brands may be trademarks of their respective owners. 3 Contents Welcome .................................................. 17 Documentation Conventions ......................................................... 17 Technical Support .......................................................................... 18 Chapter 1 About Creating and Managing ArchestrA Symbols.................................... 19 Managing ArchestrA Symbols ....................................................... 20 Managing Symbols in the Graphic Toolbox ............................... 20 Managing Symbols in Automation Objects ................................ 21 Re-using ArchestrA Symbols ......................................................... 21 ArchestrA Symbols and Instantiation ......................................... 22 ArchestrA Symbol Creation: The ArchestrA Symbol Editor ....... 23 The ArchestrA Symbol Editor .................................................... 23 Elements ...................................................................................... 25 Properties .................................................................................... 30 Animations .................................................................................. 34 Embedded Symbols ........................................................................ 39 Appearance of Embedded Symbols ............................................ 39 Changing Embedded Symbols .................................................... 40 Embedding and Instantiation .................................................... 41 Symbol Change Propagation ...................................................... 42 Size Propagation and Anchor Points .......................................... 43 Creating and Managing ArchestrA Graphics User’s Guide 4 Contents Estimating Graphic Performance ................................................. 44 Estimating Symbol Performance ................................................ 45 Understanding GPI Rating Calculations ................................... 46 Examining a Symbol with a 4.5 GPI Rating .............................. 51 Saving a Symbol that May Impact Run-time Performance ...... 52 Showing Quality and Status .......................................................... 53 Showing Quality and Status with the Status Element ............. 53 Showing Quality and Status by Overriding .............................. 53 Chapter 2 Comparing WindowMaker and ArchestrA Symbol Editor ...................... 55 Differences between WindowMaker and the ArchestrA Symbol Editor ............................................................ 55 Elements ...................................................................................... 55 Appearance .................................................................................. 56 Enhanced Functionality .............................................................. 56 Procedures for Common WindowMaker Tasks and Techniques ........................................................................... 58 Using Graphics ............................................................................ 58 Using Animations ........................................................................ 60 Using Scripts ............................................................................... 65 Chapter 3 Managing Symbols ..................................... 67 About Symbols ................................................................................ 67 Creating a New Symbol ................................................................ 68 Creating Symbols in the Graphic Toolbox ................................. 68 Creating Symbols in AutomationObject Templates .................. 69 Creating Symbols in AutomationObject Instances ................... 69 Opening Symbols for Editing ......................................................... 70 Organizing Symbols in the Graphic Toolbox ................................ 71 Creating Graphic Toolsets in the Graphic Toolbox ................... 71 Moving Symbols between Graphic Toolsets .............................. 72 Renaming Symbols ...................................................................... 72 Copying Symbols ......................................................................... 72 Renaming Graphic Toolsets ........................................................ 73 Deleting Graphic Toolsets .......................................................... 73 Moving Graphic Toolsets ............................................................ 73 Customizing Graphic Toolsets .................................................... 74 Importing and Exporting Symbols as ArchestrA Object Files .... 74 Importing Symbols ...................................................................... 74 Exporting Symbols ...................................................................... 75 Creating and Managing ArchestrA Graphics User’s Guide Contents5 Programmatically Importing and Exporting ArchestrA Symbols ..................................................................... 76 Implementing the GraphicAccess API ....................................... 77 Importing ArchestrA Symbols from XML Files ......................... 79 Exporting ArchestrA Symbols to XML Files ............................. 79 Exporting and Importing Overridden Text Strings .................. 79 Associating All Galaxy Graphics with an InTouchViewApp ....... 83 Deleting a Symbol .......................................................................... 84 Creating Multiple Configurations of a Symbol ............................. 84 Understanding Visual and Functional Symbol Configurations ........................................................................ 85 Different Symbol Wizard Work Flows ....................................... 86 Embedded Symbols ........................................................................ 86 Appearance of Embedded Symbols ............................................ 86 Changing Embedded Symbols .................................................... 87 Configuring Security for Symbols ................................................. 87 Writing to Attributes Configured for Secured or Verified Writes ............................................................................ 89 Working with the SignedWrite() Function for Secured and Verified Writes ...................................................... 89 SignedWrite() Run-time Behavior .............................................. 90 SignedWrite() Scripting Tips ...................................................... 91 Examples of Using the Attribute Parameter in the SignedWrite() Function .......................................................... 92 Secured and Verified Write Applied Examples ......................... 94 Viewing a Symbol in Read-Only Mode .......................................... 96 Chapter 4 Using the ArchestrA Symbol Editor ............... 97 Showing, Hiding, and Adjusting Panels ....................................... 98 Panning and Zooming the Canvas ................................................ 98 Panning ........................................................................................ 98 Zooming ..................................................................................... 100 Configuring Designer Preferences .............................................. 103 Using the Symbol Wizard Editor ................................................ 105 Chapter 5 Working with Graphic Elements .................. 109 About Graphic Elements .............................................................. 109 Drawing and Dragging Elements ............................................... 110 Drawing Rectangles, Rounded Rectangles, Ellipses, and Lines ............................................................... 110 Drawing Polylines, Polygons, Curves, and Closed Curves ..... 111 Drawing