Home

M-Graphics User`s Manual - Johnson Controls

1. Sai ie e Bo I SA OO ee ole es olelxel oi ac za aa Aloolbar Figure 3 6 Arrange Toolbar Getting Started 3 5 Text Style Toolbar Use the Font toolbar for changing the font attributes of text objects in a display Figure 3 7 FToolbar Figure 3 7 Text Style Toolbar Color Palette Use the Color Palette to select new colors during Configure mode in the M Graphics application The Color Palette includes fill border background and text colors Figure 3 8 Double clicking on the Color Palette opens the Color Palette dialog box Figure 3 9 Color Palette o moe IE EOS Ef CToolbar Figure 3 8 Color Palette Toolbar Color Palette x _ isms me hcl ea cle Cu nn 6h Figure 3 9 Color Palette Dialog Box Right clicking on the empty area surrounding the spin button control of the Color Palette toolbar brings up Color Palette Tool menu Figure 3 10 3 6 Operator s Guide Lange when floating Lange when docked 2 rows when large 3 rows when large vw A rows when large Evedropper Reset default colors Figure 3 10 Color Palette Tool Menu This menu can be used to change the size of the Color Palette large small and to set the number of rows of colors visible at a time 2 3 or 4 There is also an option to reset the factory d
2. LE YL aN en VY a Ui SKI Getting Started 3 11 Description Groups several objects into one symbol The resulting symbol can be moved as one object Ungroups the symbol into individual objects Moves the selected objects on top of all the objects Moves the selected objects to the bottom of all the objects in the current work area Moves the selected objects up one layer in the display Moves the selected objects down one layer in the display Rotates the selected objects to the left in 90 degree increments Rotates the selected objects to the right in 90 degree increments Flips the selected objects to a horizontal position Flips the selected objects to a vertical position Enables rotation of static objects to any angle Aligns objects according to their tops Aligns objects according to their bottoms Aligns objects according to their middles Aligns objects according to their left sides Aligns objects according to their right sides Aligns objects according to their centers Aligns objects according to both centers Distributes objects evenly across Distributes objects evenly down Makes multiple objects in the display a uniform height Makes multiple objects in the display a uniform width Makes multiple objects in the d
3. Cancel Apply Help Figure 15 7 GWXGauge ActiveX Properties Dialog Box Bar Tab 3 Modify the parameters using Table 15 6 Table 15 6 Bar Tab Parameters Parameter Show Bar Fill Color Bar Back Color Edge Color Edge Style Description If checked a bar appears next to the slider Allows user to select or create a color for the bar of the gauge Determines the color behind the resizing bar Determines the color of the edge of the bar Determines the style of the edge of the bar thin line medium line thick line etched bump raised sunken or no edge Bias Bar If checked changes the configuration of the bar so that the bar resizes from its center 15 12 Controls Editing Needle Parameters Note The needle parameters apply only to a circular gauge To edit needle parameters 1 Double click on the GWXGauge ActiveX control The GW xXGauge ActiveX Properties dialog box appears 2 Select the Needle tab Figure 15 8 ICONICS GW Gauge Actives Properties Scale l Scaler l Fonts Slider Dial Warning Ones General Background Caption Bar Needle Value M Show Needle circular gauge only Fill Color m Needle Width Medium sl WM Shadows Needle Length Medium sl Edge Color ia Edge Style Thin Line sl Cancel Amply Help Figure 15 8 GWXGauge ActiveX Properties Dialog Box Needle Tab 3 Modify the parameters using Table 15 7 Table 15 7 Needle Ta
4. Interbus CR si ERAN 3 D Floating root 3 D Flow regulator Sp 3 D Evaporator tank 3 D Flow nozzle SE straightening vane 3 0 Drum dryer 3 0 Gate valve i 3 0 Helical miser 3 D Gas holder 3 0 Hopper D apratow 3 0 Hand control crusher valve Kaz 0 Horizontal i 3 D Restriction 3 D Packed vessel 3 D Plug valve 30 Programmable orifice drilled in 3 D Rotary logic contro separator column auxiliary location valve H 3 D Ribbon blender 2 0 Foll blend 3 0 Bodibal mis T TU 3 0 Bol crusher p Boll stand 3 0 Rotary actuated E 4 Appendix Table E 1 Other Symbols Examples Cont 3 D Rotary calciner 3D Rotary shel dryer 3 Rotary plug valve 3D Scrubber 3D Target type ZENO AIX Rotary dryer 3D Screw Thermometer Conveyor ERR Rotary plug valve 3 0 Solid bowl 3 D Spray dryer centrifuge T r i 3 D Static mixer 3 D Stop check valve O Settler thickener HE capacitance level meter 3D Trap 3D Vacuum i safety valve 3D Valve 3 D Variable area A Weigh hopper flow indicator Control valve Cracked pipe vertical horizontal oo 3 D Solid bowl 3 D Vibrating centrifuge PID Loop 3 0 Yacuum SCTeen Controller 1 crstallizer P 3 D pachuca 120 GER ENEE Check valve cretallizer long horizontal GE Flange with bolts Flow element Hand valve op left RT SA Das detector A Control value Accelerometer
5. void GetObjectDimensions float left float top float width float height Gets the object s size and location void StretchObject float scaleX float scaleY float anchorX float anchorY Stretches the object based on the specified scale factors The parameters scaleX and scaleY are values such that 0 0 is 0 and 1 0 is 100 The anchor values are used to change the way the object shifts position during stretching For example to resize an object from its center the anchor values should be the center coordinates of the object This method only works for objects that are top level visible GwxText OLE Automation Reference A 19 Boolean SetAliasDefinition BSTR aliasName BSTR newDefinition Sets the alias definition for all dynamic objects associated with this visible object If this Gwx Visible is also a GwxSymbol this function is recursively applied to all objects grouped within the symbol The function returns False if no matching alias names were found True otherwise See also GwxDisplay SetAliasDefinition and GwxDynamic SetAliasDefinition IDispatch GetDynamicObjectFromName BSTR nameSubstring Gets the dynamic object with the specified name or portion of a name which is attached to this visible object IDispatch GetDynamicObjectFromIndex long index Gets the dynamic object with the specified zero based index which is attached to this visible object index zero is the first attached dynamic This fu
6. Figure 14 4 Insert Object Dialog Box 2 Select Create Control and ICONICS TWX View32 for the object type 3 Click OK A TWXView32 control is added to the display Figure 14 5 Note As a shortcut Gi a TWXView32 ActiveX control by Piu clicking on the icon in the ActiveX toolbar TWxXView32 ActiveX Control 14 17 Display1 M Graphics by Johnson Controls aeli a Aea sl eL aia ooo 2 Brr F L H e aI g A Ka P ES gi 7 De ree ae lel aA giel eicdckclele emm Figure 14 5 TWXView32 Control in M Graphics Display 14 18 Controls Editing General Parameters To edit general parameters 1 Double click on the TWX View32 control The TWX View32 ActiveX Properties dialog box appears Figure 14 6 PHAY ewi Activex Properties Details Time Rates Feng Settings General Fonts Workspace Grids Ranges Pree Cee err errr irs Viewer Title Trend Viewer About Plot Type Time Plot sl Configuration File SE East Ne Assigned I URL Path _ Saves Ne Assigned Cancel Amply Help Figure 14 6 ActiveX Properties Dialog Box General Tab 2 Select the General tab 3 Modify the parameters using Table 14 11 Note Choose the plotting style first because this choice determines which options are available TWxXView32 ActiveX Control 14 19 Table 14 11 General Tab Parameters Parameter Viewer Title Plot Type Filename Load Save As URL Path
7. Font Font Style Size aria Regular 20 25 Fp Arial Black Fp Arial Narrow Fp Bookman Old Style Fp Comic Sans MS Courier Effects T Strikeout T Underline Sample AaBbY yZZ x Cancel App Help Figure 17 12 GWXSlider ActiveX Properties Dialog Box Fonts Tab 3 Modify the parameters using Table 17 11 Table 17 11 Fonts Tab Parameters Parameter Property Name Font Font Style Size Effects Sample Description Allows user to choose which text to change the font of CurrentValueFont MainCaptionFont or ScaleLabelFont Displays the current font and a scrolling list of fonts available Determines the style of the font regular bold italic or bold italic Allows user to select the size of the font from a drop down menu Allows strikeouts and underlining of the text chosen Displays a real size example of the font style and size chosen GWXSlider ActiveX Control 17 19 Viewing the About Information To view the about information 1 Double click on the GWXSlider ActiveX control The GWXSlider ActiveX Properties dialog box appears Figure 17 13 ICONICS GW Slider Actives Properties Scale Background Caption Value Fonts General Slider Slow Spin Buttons Fast Spin Buttons Data Source D Zoe Antike Tage W Range Override Low Range fo Tags High Range Do Taas Auto Start Runtime Mode Update Hate E millizeconds IW Preserve As
8. M Graphics runs standalone or within an ActiveX document container We recommend the following 2 6 GHz Pentium 4 processor Windows 2000 Professional or Windows XP Professional operating system 256 MB Random Access Memory RAM 128 MB minimum 40 GB hard drive 17 inch monitor with 1024 x 768 minimum resolution video with 2 MB memory that supports 16 bit 65 535 colors M Graphics Features M Graphics features include true 32 bit design universal OPC connectivity powerful display creation tools containment of ActiveX controls and OLE objects ActiveX document server comprehensive OLE automation interface fast dynamic animation M Graphics active control advanced symbol library M Graphics File Name Extensions In M Graphics a file can be saved as M Graphics display file gdf M Graphics template file tdf Symbol files sdf Metasys is a registered trademark of Johnson Controls Inc All other marks herein are the marks of their respective owners 2004 Johnson Controls Inc Chapter 3 M Graphic s User s Manual Getting Started Introduction M Graphics can be run as a standalone program or in an ActiveX document container This chapter describes how to start M Graphics create a new display open a display save a display print a display use zoom manage display area define summary information view Statistics view object count statistics start Runtime load a display
9. SOO a A i Em Pick Object gt Present_ Value 10 Select OK 11 Delete Present_ Value from OWSExec command line parameter 12 Select OK 13 Select OK and save file Note This applies only to the M5 Workstation Adding Focus Window Screen to Object when Clicking Left or Right Mouse Button To add focus window screen to object when clicking left or right mouse button Right click object Select Dynamics gt Action gt Pick Select Pick tab Select Action gt Launch Application L 2 3 4 5 Select left or right mouse button 6 Select Custom 7 Select FOC from Metasys Application 8 Select Browse Pick Object gt Present_Value 9 Select OK 10 Delete Present_ Value from the OWSExec command line parameter F 10 Appendix 11 Select OK 12 Select OK and save file Creating a Slider Bar To create a slider bar EE E E em Paste slider bar onto graphic Right click slider bar Select Edit Symbol Right click Slider tab Select Property Inspector Select Location tab Enter High and Low Range Override limits Select Edit Aliases Select Tag Browser box 10 Select Object gt Present_Value 11 Select OK and save Adding On Off Binary Commands to Pushbuttons To add on off binary commands to pushbuttons l So ee EE From Command menu select Dynamics gt Intrinsics gt Pushbutton Left click on the graphic screen From the Pick tab select Action gt Download
10. Text Bitmap Metafile Symbol OLE Object OLE Control Template Object Total Static Objects Size Location Rotation Hide Color Analog Color Flash Pick Digital Selector Analog Selector Animator Unique Data Connections Process Point Tag Time Date Local Variable Button Expression Constant Total Dynamic Objects Total Data Sources 1 1 A A A A A A A A A 2 Oo 2 2 objcount Figure 3 11 Object Count Dialog Box 2 Click OK to return to the display Starting Runtime To start Runtime In M Graphics select Runtime on the menu bar 3 22 Operator s Guide Loading a Display in Runtime To load a display in Runtime 1 On the File menu select Open The Open File dialog box appears 2 Select a display file and click on the OK button The display appears in the selected window Printing the Full Screen in Runtime To print the full screen in Runtime 1 On the File menu select Print The Print dialog box displays 2 Fill in the required fields and click OK Exiting M Graphics To exit M Graphics On the File menu select Exit IMPORTANT If you have not saved the changes in Configure mode and you exit during Runtime all changes are lost If the M3 Workstation logs out for any reason while updating M Graphics in a container all changes are lost Make sure to save all files before logging out Make sure to save to the correct locat
11. 13 4 Configuring M Graphics ActiveX Control 13 5 Chapter 14 TWXView32 ActiveX Control cccscsecsscecssceesecsseenasnens 14 1 PET OOO COUN sea E EE OEE EEEE EA 14 1 Key e ee ca sisrsc veins eeersis sso eniaranssnia sere peesesiaesetsanesseaeseensessseeesiaseeessieeeiaees 14 2 TWXVieWS2 ActiveX Control 14 2 TWXViews2 ActiveX in M Graphics cccccsececcseeecceeeeecseeseeceeeeessaesesseuseesaaseessaaess 14 3 KEES 14 3 TWXView32 in Configure and Runtime Modes naannnnnnnnnenennnnnnnnnnnennnnnenrnnnennnee 14 4 Runtime TWXView32 Toolbar a nnaannnannnannnannnennnnnnnnnnnrnnnnrnnrennnrnnnrrnnrrnnrrnrrennrennene 14 4 International Language Gupport 14 5 Asynchronous Dowpnloacdmg 14 5 Internal Architecture of ActiveX ccccccecceceeeecseeeeseeeeseeeeseacesseeeeseeseseaeesseeeeseeesseeeens 14 5 TWXView32 Object Capability 0 0 0 cccccccccccecceseeeeeesseeceeeseeeeeeeseeeeeesseeeseeseeaeeeeesaees 14 5 TWX VIEW 32 Propers crc ianusteanteeat inniinn ei a a aAa a aE 14 6 OCE EN eu Ee 14 8 Methods Properties for the TWXView32 ACTIVEX ccccceeececseeeeeeeeeeeeseeeeseeeessaaeees 14 8 Methods Properties for Supporting Objects cceeceeeceeeeeeeeeeeeeeeeaeeeeeeeaaaeeeesseees 14 11 Procedure el E 14 15 Detailed Procedures 1 sc1scccsecccnecscnenscnenscnenscensenensenensenensceesseeessseessseessses 14 16 Inserting a TWXViIew32 Control 14 16 Editing General SE 14 18 Editing Fonts dt 14 20 Edi
12. App Help Figure 15 4 GWXGauge ActiveX Properties Dialog Box General Tab 2 Select the General tab 3 Modify the parameters using Table 15 3 Note Uncheck Preserve Aspect Ratio when changing the Gauge Type from the default Vertical to a Horizontal or Circular gauge type Table 15 3 General Tab Parameters Parameter Data Source Tags Range Override Auto Start Runtime Mode Preserve Aspect Ratio Update Rate Gauge Type Length Factor Start Angle End Angle Gradients About Description Displays the current data source Allows user to browse and select a tag Allows user to override the ranges associated with the selected tag If checked automatically starts processing data when display is put in Runtime mode If checked maintains gauge ratio when the user changes its dimensions Determines how fast the system updates the data being displayed through the gauge in milliseconds Displays the available gauge types in a drop down menu vertical horizontal or circular Determines the diameter circular or length vertical or horizontal and the length of the dial hand for the gauge Determines where in the display the gauge begins for circular gauges only Determines where in the display the gauge ends for circular gauges only Determines if the gauge appears to be light sourced Displays the About information GWxXGauge ActiveX Control 15 9 Editing Background Parameters T
13. Description Specifies the file name of the M Graphics display to be loaded in this control Use the Browse button to browse for display files Specifies appearance of the window border No Border or Fixed Single Specifies appearance of border Flat or 3 D Automatically sets the background color of the control to match the background color of the container in which this control is embedded This property only works if the container supports the AmbientBackColor property M Graphics and Visual Basic forms both support this property Automatically enters Runtime mode when the control s container enters Runtime mode This property only works if the container supports the AmbientUserMode property M Graphics and Visual Basic forms both support this property Indicates the control will override the scroll bar visibility settings of the display currently loaded in the control When not checked the control will use the scroll bar settings defined in the currently loaded display Determines if the horizontal scroll bar is visible This property is ignored if Override Scrollbar Settings is not checked Determines if the vertical scroll bar is visible This property is ignored if Override Scrollbar Settings is not checked For more information about the properties of the M Graphics ActiveX see the OLE Automation Reference chapter in this manual specifically the section describing the GWXview32 object type Note Convert is a s
14. Provides 50 75 100 150 250 and custom zoom options Allows user to drag a box around an area to zoom to Zooms to selected objects Sizes the display so all objects in the display fit into the window Allows user to see the entire work area Zooms in one particular part of graphic Opens a dialog box containing summary information and statistics Displays statistics for objects actions and display sizes Allows user to hide show one or more layers on the work area Hides shows toolbars Hides shows toolbars Hides shows status bar Hides shows horizontal scroll bar Hides shows vertical scroll bar Hides shows both scroll bars Hides shows grid Allows user to see what a display will look like in Runtime mode without entering Runtime Allows user to select the properties of any ActiveX object Allows user to select a language 3 10 Operator s Guide Table 3 5 Format Menu Format Menu Toolbar Options Button Template Layers Set Configuration Mode Password Background Color Fill Color Line Color Line Width Line Style Toggle Fill Kal Si Toggle Freeze Font Display Properties Save Properties as Preferences Reset Default Display Properties Application Preferences Apply Preferences to Properties Reset Default Application Preferences Description Opens submenu with the following options apply template remove applied template edit applied
15. Set ell nothing Set rect nothing Set sym nothing Using Visual Basic for Applications VBA 12 25 The following list demonstrates the unique name technique Create one rectangle and assign object name Rect_1 Duplicate this to create one more rectangle Group Rect_1 and Rect_2 Duplicate this group using the Duplicate button Ungroup the duplicate object Ss Se eS a Read the Object name by using the Property Inspector dialog box Notice that the Object names of the two rectangles the third and the fourth are Rect_3 and Rect_4 Using VBA to Connect with Other Applications Example Design a display and a spreadsheet each with two data points and have them communicate to each other through VBA 1 Open anew M Graphics project 2 On the Tools menu select Macros gt Visual Basic Editor 3 On the Tools menu select References This opens a list of available references to applications Check the box next to Microsoft Excel Release 8 0 Object Library References Project x Available References L Internet Explorer Scripting Object Model _ Marquee Control Library _ Mcrosoft Access 8 0 Object Library C Microsoft ActiveMovie Control _ Microsoft ActiveX Plugin _ Microsoft Binder 8 0 Object Library D L Microsoft Common Dialog Control 5 0 sup _ Microsoft DAO 2 5 3 5 Compatibility Librar Priority Microsoft DAO 3 0 Object Library _ Microsoft DAO 3 5 Object Library L Mcrosoft Data
16. Specifies the starting and ending size of the object that has changing dimensions Scales the object in proportion to the incoming signal Reveals the object Deletes this dynamic Identifies the object for OLE automation Describes the object and determines the ToolTips displayed Allows user to enter data 11 14 Advanced User s Adding a Location Dynamic To add a location dynamic 1 Select the object 2 On the Dynamics menu select Actions gt Location The Property Inspector appears with the Location tab Figure 11 4 Property Inspector Fa Elipse Location Fiotation DataSource Drag Drop Data Source OPC Tags Tags Menu IT Slid 26t Limits Gontinuoue Update E etente fo High E Delete Object Hame Descriptions Custom Data Custom IT Range Override Cancel Apply Help Figure 11 4 Property Inspector Dialog Box Location Tab 3 Establish a data connection 4 Fill in the location dynamic parameters using Table 11 5 5 Click OK Adding Dynamics 11 15 Table 11 5 Location Parameters Parameter Data Source OPC Tags Drag Drop Data Source Tags Menu Direction Buttons Range Override Set Limits Slider Tracking Continuous Update Detents Object Name Description Custom Data Delete Description Lists the tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a tag Specifies if the Data So
17. When objects or symbols are selected in M Graphics colored handles appear around the selection Table 5 1 describes the color definitions Table 5 1 Select Handle Color Definitions Color of Handle Description Blue Handles The symbol does not have a dynamic tag assigned and is not Frozen Red Handles The symbol has a dynamic assigned Green Handles The symbol is Frozen White Handles on All The solid handled is used as a reference when Symbols Except for One using the Arrangement function The symbol became solid because it was the last symbol in the selected group of symbols Text may be rotated in 90 degree increments by using the Rotate Left and Rotate Right buttons The rotation ability 1s available for multi line text left center and right alignments text objects Process Points PPTs data entries state fields time dates and buttons Note Checkboxes and Radio buttons may not be rotated Creating Objects 5 5 Procedure Overview Table 5 2 Creating Objects To Do This Draw a Line Draw a Segmented Line Draw a Rectangle Square Draw an Ellipse Circle Insert Text Define Text Font Draw an Arc Define Line Style Define Line Width Fill an Object with Color Import Bitmaps Import Metafiles Import Symbols Export a Metafile Freeze an Object Insert an Object Follow These Steps From the Draw menu select Straight Line Left click on the work area Drag the mouse and release
18. A Storage facility 4 P style _ Cut away 4 Elevated Tank 1 cutaway Liquid storage with 10 segments drum Valve 1 Desktop P Flow meter Appendix F Tips and Hints Introduction M Graphics User s Manual F 1 This appendix suggests ways to improve efficiency while using M Graphics This chapter describes how to e add graphic Hot Links to other screens e add fan rotation to a graphic e add command operation box to object when clicking left or right mouse button e add focus window screen to object when clicking left or right mouse button e create a slider bar e add on off binary commands to pushbuttons e add override binary commands to pushbuttons e add the auto binary command to a pushbutton January 2001 Johnson Controls Inc Code No LIT 6440240 F 2 Appendix Key Concepts Characteristics of Good Graphics A good graphic serves one of the following two functions l To Inform A graphical representation of data e g green for normal temperature values and notifies the operator of certain data conditions e g flashing condition when in alarm To Navigate Provides quick and intuitive means to view various aspects of building equipment and areas building pictures floors mechanic systems Benefits of good graphics allows operators to quickly make decisions or evaluations demonstrates the advantages of graphics over text based information overcomes limitations of text b
19. Add an Analog Color Dynamic Add a Flash Dynamic Add a Pick Dynamic Add a Digital Selector Dynamic Add an Analog Selector Dynamic Add an Animator Dynamic Add Time Date Create a Process Point Data Entry PPT DE Create a Pushbutton Create a Checkbox Create a Radio Button Create a Display Button Follow These Steps Select the object On the Dynamics menu select Actions gt Size Establish a data connection Fill in the size dynamic parameters Click OK Select the object On the Dynamics menu select Actions gt Location Establish a data connection Fill in the location dynamic parameters Click OK Select the object On the Dynamics menu select Actions gt Rotation Establish a data connection Fill in the rotation dynamic parameters Click OK Select the object On the Dynamics menu select Actions gt Hide Establish a data connection Fill in the hide dynamic parameters Click OK Select the object On the Dynamics menu select Actions gt Color Establish a data connection Fill in the color dynamic parameters Click OK Select the object On the Dynamics menu select Actions gt Analog Color Establish a data connection Fill in the analog color dynamic parameters Click OK Select the object On the Dynamics menu select Actions gt Flash Establish a data connection Fill in the flash dynamic parameters Click OK Select the object On the Dynamics menu select Actions gt Pick Establish a d
20. Description Displays title of the display Determines available plot types e Time Plot plots variables vs time e XY Plot plots variable vs variable e Bar Plot plots a variable plot bar form e Logarithmic Plot plots variables relative to the value of another variable logarithmically e Strip Chart plots variables vs time however this window plots data vertically With strip charts you can only display ranges for two pens in the Range window Displays name of current file with v32 extension Loads a new configuration file over an existing one Saves the configuration data in a file with a v32 If checked saves the trend window to a URL In addition the user can load a new configuration file over an existing file by using the Load button 14 20 Controls Editing Fonts Parameters To edit fonts parameters 1 Double click on the TWX View32 control The TWX View32 ActiveX Properties dialog box appears 2 Select the Fonts tab Figure 14 7 TWXViewS2 ActiveX Properties Details Time Rates Pens Settings About Info General Workspace Grids Ranges Font Selection For Details tw properties font Figure 14 7 TWXView32 ActiveX Properties Dialog Box Fonts Tab 3 Modify the parameters using Table 14 12 Table 14 12 Fonts Tab Parameters Parameter Description Font Selection For Determines for which section the font is set details ranges time settings or title Set Font Ope
21. Determines if a pens text is displayed Determines if a pens units is displayed Determines if a pens value is displayed Determines if a pens Hi Lo information is displayed Determines if a pens Hi Lo Alarm information is displayed Determines if a pens HiHi LoLo Alarm information is displayed Determines if signal quality will be displayed Determines if X axis values are shown for XY plots Determines if the details field is displayed Default True Text color of all text in the details field Gets sets the size of the details area Gets sets the number format of the pen Determines if a pens time information is displayed Determines if a pens date information is displayed Gets sets American or European date format Gets sets the number of visible pen details to be drawn in the details display area Table 14 9 Grids Object Properties Properties Boolean ShowGrids OLE COLOR GridColor short GridWidth BSTR GridStyle short GridNumber Description Determines if grids are displayed in the Viewer s main display area Default True The color of the grid The grid width in logical units Gets sets grid style such as Solid Dotted Dashed etc Gets sets grid number Procedure Overview TWxXView32 ActiveX Control 14 15 Table 14 10 TWXView32 ActiveX Control To Do This Insert a TWXView32 Control Edit General Parameters Edit Fonts Parameters Edit Workspace Parameters Edit Grids P
22. EOC AN EE 10 19 SEUNG SAFI EE 10 20 Chapter E e Vater 11 1 ET OO UC HOW PIINPEIE EEE PE PEET A nese denen in edema E E A AA 11 1 e ee nnn 11 2 EN UN TE 11 2 NS MSS sts EEE E E AE 11 3 D e A E E E 11 4 ACION DYN IIGS caen E E lt puriensatacbannctsnaes 11 4 CLS CIOF DYN MIC aeae E E E E E 11 8 MN ICONIC S ere E TE E E 11 9 6 M Graphics User s Manual e Re E 11 11 Detailed Procedures sc sesseais ecisase tte semsateedimensdecsernecsxtnsete den aetordineninedea sieseesaee 11 12 Adding a Size IDV MEM e 11 12 Adding a LOCATION RE e 11 14 Adding a Rotation DY NAMIC EE 11 16 Adding a Hide DY MANN Gea cecenaabeeenceseractatacasettiece EEk EE Eaa 11 18 Adding a Color Re UE 11 20 Adding an Analog Color Dy AUN e 11 22 Adding a Flash Dynamic cccccccccceeececeeeeeceeeeeceeeeeeeaeeeesseueesseueeesaeeeeesaeeeesaaeeesaaes 11 24 Adding a Pick Dynamic ccccceececeeeeeeceeeeeceeeeeceeeeeesaeeeesseeeeeseaeeesseeeessaesessageeesanes 11 26 Adding a Digital Selector Dvpamtc 11 28 Adding an Analog Selector Dvpamtc 11 30 Adding an Animator RU sashes see dethadaceksucctadesesesostactheeentaatanssausdeneesOhecxehenaieentates 11 32 Adno E TMS E 11 34 Creating a Process Point Data Entry PPT DE ccccccccceeeececeeeeeeeeaeeeeeeeaaeeeees 11 35 Creating a Ae EE 11 37 Greating a ee e EEN 11 38 Creating a Radio Button 11 40 Creating a Display Button ccccccceccccceseeeeeeeeeeeeesaeeeeeseeeeeeeseeeeeeeseaeeeeesaaeeeee
23. For changes on tags consider using Find Replace with wildcards to the desired group of objects to be searched replaced Consider a company logo or similar pictures placed in many displays in different positions By one operation all of the displays can be modified For example to increase in size make one logo bigger select Update Function and don t forget to uncheck Preserve Object s Size 9 4 Operator s Guide Procedure Overview Table 9 1 Using the Property Inspector To Do This Edit Object Parameters in the Property Inspector Update Shared Objects Follow These Steps Double click on an object Edit the parameters and click OK to return to the work area On the Edit menu select Update Shared Objects Fill in the fields Using the Property Inspector 9 5 Detailed Procedures Editing Object Parameters in the Property Inspector To edit object parameters in the Property Inspector 1 Double click on an object The Property Inspector dialog box appears Figure 9 1 2 Edit the parameters and click OK to return to the work area The fields of the Property Inspector dialog box may vary slightly depending on what type of object is being inspected Updating Shared Objects To update shared objects 1 On the Edit menu select Update Shared Objects The Update Shared Objects dialog box appears Figure 9 2 Updated Shared Objects Scope Preserve S lection Li Object Dimensions sub
24. GWXSlider ActiveX in M Graphics Display GWXSlider ActiveX Control 17 7 Editing General Parameters To edit general parameters 1 Double click on the GWXSlider ActiveX control The GWXSlider ActiveX Properties dialog box appears Figure 17 4 ICONICS GW Slider Actives Properties Scale Background Caption Value Fonts General Slider Slow Spin Buttons Fast Spin Buttons Data Source D Zoe Antike Tage W Range Override Low Range fo Tags High Range Do Taas Auto Start Runtime Mode Update Hate E millizeconds IW Preserve Aspect Ratio heuer Length Factor Do cs Slider Type Horizontal About Cancel Apply Help Figure 17 4 GWXSlider ActiveX Properties Dialog Box General Tab 2 Select the General tab 3 Modify the parameters using Table 17 3 Note Uncheck Preserve Aspect Ratio when changing the Slider Type from the default Horizontal to a Vertical Slider Type Table 17 3 General Tab Parameters Parameter Data Source Tags Range Override Auto Start Runtime Mode Preserve Aspect Ratio Gradients Slider Type Update Rate Length Factor About Description Displays the current data source Allows user to browse and select a tag Allows user to override the ranges associated with the selected tag lf checked automatically starts processing data when display is put in Runtime mode If checked maintains slider ratio when the user changes its
25. Identifies the object for OLE Automation Describes the object and determines the ToolTips displayed Allows user to enter data 4 Click OK One of the radio buttons is always selected 11 42 Advanced User s Creating a Display Button To create a display button 1 On the Dynamics menu select Intrinsics gt Display Button Wizard 2 Click in the display The Display Button Wizard appears Figure 11 19 Display Button Wizard Load Display e Figure 11 19 Display Button Wizard 3 Fill in the parameters using Table 11 18 4 Click OK Adding Dynamics 11 43 Table 11 18 Display Button Wizard Parameters Parameter Size Action Display File Label Label Position Font Description Determines size of button very small small medium large very large Determines button e action load display embedded window pop up window and drag drop load Lists the file the display button loads Determines if a label appears on the button and what that label says Determines if label appears on the top or bottom Determines font of the label Metasys is a registered trademark of Johnson Controls Inc All other marks herein are the marks of their respective owners 2004 Johnson Controls Inc M Graphics User s Manual 12 1 Using Visual Basic for Applications VBA Introduction Visual Basic for Applications VBA is a Microsoft Visual Basic programming system application VBA is an industry stand
26. On the Draw menu select Export gt Metafile emf 2 Selecta file and click OK Freezing an Object To freeze an object 1 Select the object 2 On the Format menu select Toggle Freeze A lock appears on the cursor when over the object Creating Objects 5 9 Inserting an Object To insert an object 1 On the Edit menu select Insert New Object The Insert Object dialog box appears Figure 5 3 Insert Object EE Ge C Create New ActveMovweControl Object ActiveS etup TextCt Object Lancel Wiese Lis Analog Profile Control 7 ComfortControl HH d Object ICONICS National Instruments Activ ILONICS GWG auge Activer Add Control Inserts a new ActhveMovieLontol Object object K Into your document Create Control Result 2 Figure 5 3 Insert Object Dialog Box Choose either Create New Create from File or Create Control in the Insert Object dialog box Select the object type The Add Control button allows you to add a control to the existing list To create control specify a control from the list of controls displayed at the right Click OK 5 10 Operator s Guide Troubleshooting Common Problems Table 5 3 Troubleshooting Objects Situation Solution For M Graphic displays or Do not use embedded Metafile images or symbols built using rebuild convert the Metafile images See note impacted Metafile images To rebuild memory leaks occur causing depletion of
27. SI ogy 204 oo SR 20 M Graphic s Users Manual C 1 Appendix C French Symbol Library Introduction This chapter provides examples of the French symbols included with M Graphics Symbols are continually added refer to the software for a complete set January 2001 Johnson Controls Inc Code No LIT 6440210 C 2 Appendix Key Concepts Symbol Library The symbol libraries with prebound tags provided with M Graphics aid in the creation of facility drawings Users can just modify the alias name to change the binding reference There are four categories of symbols DIN French Johnson Controls and other To import a symbol in M Graphics click the Import Symbol icon EI or on the Draw menu select Import and click on Symbol French Symbols Examples Table C 1 French Symbols Examples Goal qaCCess Chlalen GEN damper I aprinkler Li conta E doorace chlast L arrei stark stop E detect k sprinklers foontac i B bomalm prosrdr 1 dryclal dryclin switch FireD amper FHE fire fire dampers AN French Symbol Library radar cooling battery fzondet Li contdif afalm C 3 d reader heating battery 4 damper x L smoke eu i contpos afstat filter hardware btr plumbing contact contalm fuse trans elebtry eleger htg
28. UnregServer Unregisters application Command Line Examples In the following command line example M Graphics starts with the tanks gdf display file C Program Files Johnson Controls M Graphics gwx32 EXE C Program Files Johnson Controls M Graphics Examples TANKS GDF In the following example M Graphics starts in Runtime with the tanks gdf display loaded and the application window in the middle of your screen C Program Files Johnson Controls M Graphics gwx32 EXE C Program Files Johnson Controls M Graphics Examples TANKS GDF Runtime Selecting a Language To select a language 1 From the View menu select Select Language The Select Language dialog box appears Figure 4 4 Select Language Pe Dutch Netherlands a List English Australia English English Belize English Canada Localized English Caribbean English Ireland C Native English Jamaica English Mew Zealand English South Africa Jh Installed Locales Only English Trinidad y Tobago English United Krngdorm Available Language English United States zl Translations Only Cancel Help Figure 4 4 Select Language Dialog Box 2 Define the parameters Refer to Table 4 3 Customizing M Graphics 4 7 Table 4 3 Select Language Parameters Parameter Description List Lists available languages Installed Locale Only Lists all local languages available Available Languages List all local languages available to choo
29. Using Templates 8 5 Editing an Applied Template To edit an applied template 1 On the Format menu select Template gt Edit Applied Template Note Only template objects are visible in Edit Applied Template mode 2 After modifications to the template are finished on the Format menu select Template gt Cancel Edit Applied Template to exit Edit Applied Template mode and return to Normal mode Updating Template Displays This function is only available when editing a tdf file To update template displays 1 On the Format menu select Template gt Update Template Displays 2 Enter the files for updating 3 Click OK Note Make sure the Working Directory points to the folder that contains the tdf file in order to update the gdf files 8 6 Operator s Guide M Graphics Users Manual 9 1 Chapter 9 Using the Property Inspector Introduction This chapter describes the Property Inspector This chapter describes how to e edit object parameters in the Property Inspector e update shared objects January 2001 Johnson Controls Inc Code No LIT 64400090 9 2 Operator s Guide Key Concepts Property Inspector The Property Inspector dialog box lets you view and change object parameters The Property Inspector contains several tabs The primary tab is General which reflects the properties of a given static object The Property Inspector may also display additional tabs which show information about
30. c cccccceececeeeeeeeeeeeeeeceeessueeeseeseteueesseeesseeeeneeeens 15 9 Editing Caption NEE 15 10 Selten EE 15 11 Editing Needle en 15 12 Editing value Parameters EE 15 13 Editing Scale1 Harametere 15 14 Editing Scale2 barametere 15 15 Editing Fonts ETC 15 16 Editing Slider Dial Parameters ccccscccccseececesececeeeeeceeseessueeessueeeesauseessuseessagees 15 17 Editing Warning Zones Parameters ccccccceeecceeeeceeeeeseeeeceueeseneeseeeeeaeeeeseeeensaees 15 19 Viewing the About Information EE 15 20 Chapter 16 GWXSwitch ActiveX Control cccsccecsssecsecssneesseeenecees 16 1 MIOU CHOWN sin E O E 16 1 KOV ee 61 0 Pane E E nee eee 16 2 GWKSWIITCR ACIIVEX GOMWO EE 16 2 GWAX SWITCH ACTIVE geleet 16 2 PFOCEUUIE OVEVICW icsaisseiezsisvinrsiesyiendnssdesebecndesadessdeasbzcedesabeontacetesztesateaet 16 4 Detailed e 16 5 Inserting a GWXSwitch ActiveX Control 16 5 Editing General Parameters n 0nnnn0nnnnnnannnonennnonennnrrerrrnnnnrrrsrrrrenennrennnrrrnnnrrerenreee 16 7 Editing Background Parameters bk 16 9 Table of Contents 9 Editing Caption Parameters ccccecccceecccsesceeeeeeeeeaeeeeeseeeeeseueeesaeeeeeseeeeeseaseesaaees 16 10 Editing Labels Parameters n00nnnannnnannnnennnnnnnernnnnnnrnnnrersrrrrnnrrnsrerrnnrrsnrrrnnernsreene 16 11 Editing Fonts Parameters ccccccsscccseeecceeccceseeceuseccueesceneecsueessueeceueesseneessusessaees 16 12 VIEWING the About Information c c
31. float startAngle float endAngle Boolean isFilled OLE COLOR fillColor OLE COLOR lineColor long lineWidth GWXLINESTYLE lineStyle Boolean hasShadow OLE COLOR shadowColor GWX3DEDGESTYLE edgeStyle Boolean isHidden BSTR objectName Creates and returns a GwxArc object with the specified attributes in the current display Angles are specified in degrees See also GwxArc and Gwx Visible Available only in Configure mode IDispatch CreateSymbol BSTR objectName Groups all currently selected objects into a GwxSymbol object giving the resulting symbol object the specified object name Returns the resulting GwxSymbol object See also GwxSymbol and Gwx Visible Available only in Configure mode Boolean UngroupSymbol BSTR objectName Ungroups the GwxSymbol object with the specified object name Although the function destroys the specified GwxSymbol it does not destroy the objects that were grouped in that symbol Returns True for success False for failure Available only in Configure mode void DuplicateSelection Creates duplicates of the currently selected objects Available only in Configure mode IDispatch GetHeadObject Gets the head visible object In Configure mode the head object is the selected object with the solid blue or red resize grips In Runtime mode the head object is the pickable object that currently has focus If there is no head object this method returns Null 51 52 53 54 53
32. this string is displayed as informational text in a ToolTip 8 BSTR UserCustomData This string is used to store custom data Use this property to associate any additional data with the dynamic object Methods l Boolean SetAliasDefinition BSTR aliasName BSTR newDefinition Sets the alias definition for this dynamic object only Returns False if no matching alias names were found True otherwise See also GwxDisplay SetAliasDefinition and GwxVisible SetAliasDefinition 2 IDispatch GetVisibleObject Gets the visible object to which this dynamic is attached GwxDigitalSelector GwxDigitalSelector has all the properties and methods of GwxDynamic plus the additional methods described below Methods Boolean SetConnectionInfo short objectNumber BSTR dataSource Boolean showWhenTrue Sets data connections for this digital selector object The parameter objectNumber is a zero based index representing an immediate child of this symbol object to which this dynamic is attached index zero 1s the first child object See also GwxDigitalSelectorInfo GwxDigitalSelectorInfo Currently unused In the future versions of M Graphics this object may include properties of individual data connections for GwxDigitalSelector objects A 24 Appendix GwxDigitalColor GwxDigitalColor has all the properties and methods of GwxDynamic GwxDigitalColorInfo Currently unused In the future versions of M Graphics this object
33. 1 Left click on the objects 2 On the Arrange menu select Align and choose one of the following tops bottoms middles lefts rights or centers Spacing Objects Evenly To space objects evenly 1 Left click on the objects 2 On the Arrange menu select Space Evenly and choose either across or down Making Objects the Same Size To make objects the same size 1 Left click on the objects you wish to make a uniform size 2 On the Arrange menu select Make Same Size and choose one of the following height width or both Arranging Objects 7 7 Adding Layers To add a layer 1 On the Format menu select layers gt Add Layer The Edit Layer dialog box appears Figure 7 2 Edit Layer Properties x 0 1000 Lauer Name Change Layer Order 4 d Runtime Data Layer Request data when layer is initially hidden oom Visibility Range Declutter Low oom Threshold 7 fo High Zoom Threshold LS UU IW Release data when layer becomes hidden Hide Layer When Data Source i FALSE zero i SS T Explicitly Hide Layer S Help Lauer Name Figure 7 2 Edit Layer Properties Dialog Box 2 Refer to Table 7 2 Table 7 2 Edit Layer Properties Parameters Field Description Layer Name Enter layer name indicating what the layer contains or why the layer is separate Change Layer Order Move selected layer up or down in the list Zoom Visibility Range Assign Zoom Threshold to declutter
34. 1 Right click on the graphic image or symbol computer system 2 Under the Popup menu select Convert To resources This results in Symbol to convert the graphic image to an degraded performance M Graphics symbol format and potential system 3 Save the changes lock up 4 Run the M Graphics display An error appears Reboot the M5 Workstation PC to restore the evaluating expressions in network connection a pop up balloon when the cursor is over a symbol with an action This problem is caused by the N10OPC Server intermittently losing its connection to the network Text typed in the default To make the font size of text the same in Runtime _ font size becomes smaller and Configure modes in Runtime mode and 1 Select all objects Reselect the Arial font and deii ee ied type 10 in the size field adie GA ge 2 Deselect the Stretch Text On Resize property in the Property Inspector Text tab 3 Deselect the Scale Font When Stretching Text property in the Display Properties General tab 4 Select the Scaleable Display and Preserve Aspect Ratio properties in the Display Properties General tab Note This problem is not unique to M Graphics but is a general Metafile format issue based on how the Metafile images are originally created Chapter 6 M Graphics Users Manual 6 1 Editing Objects Introduction This chapter explains how to edit objects in M Graphic displays This chapter describes how to
35. 20 US gle LOON een ene cee ene E A eee ee eee 3 20 Managing the Display Area EEN 3 21 Deining Summary INTONMALION eresse aE EEEE EENET 3 21 NASW a Le 3 21 Viewing Object Count Statistics ccccccccccccccesseeceeeeeeeeeeseeeeeeseeeeeeeseeeeeessaaeeeeseaees 3 22 staring RUNNUM EE 3 22 Loading a Display in Runtime cceecccseececeeeeceeeeeneeeeaeeeeseneeseeeeaeeeseaeeeseeeesaeeeeaes 3 23 Printing the Full Screen in Huntme 3 23 Fe TEI WI RA net 3 23 Chapter A Customizing M Graphics ccscccessesesscssssseseeeseneseeenees 4 1 lef ley 1 EE 4 1 IOV COCCI eege 4 2 M Graphics Custom Settings ccieciicc cots enadedaseauecsts eesannssaaiovsceusendetiasesecnousssnnneiaewesecueeaniads 4 2 Command Line Ee LC 4 2 Application dE le 4 2 Display Properties ccccccssecccescccescecceeeeceeeceuceseacessueeecaucessueessseeecsusesusessueesneeeeneas 4 3 Display Configuration Mode Password cccccccseeeceeeeeeeeeeseeeeeeeesaeeeeesseaeeeesseeeeeeas 4 3 EE 4 4 RTE BR ee Ee S soeia EREDETE ERNER 4 5 Customizing the Launch of M Graphics and Wumdows 4 5 Sel CUM a EE 4 6 Defining General Application Preferences ccccccseececseeeeeeeeeeeseeeeesseeeeesenseeseeeeees 4 7 Defining Window Application Preferences ccccecseecceeeeeceeeseeeeseeeesseeeeseeeeeaeeesaes 4 8 Defining Runtime Application Preferences ccccccccsececseeeceeeeeseeeeeeeeseeeeseeeeeneeeens 4 10 Defining Grid Application Prefe
36. Create Control in the Insert Object dialog box Select the object type Click OK 5 6 Operator s Guide Detailed Procedures Drawing a Line To draw a line 1 On the Draw menu select Straight Line The mouse pointer appears as a pencil 2 Left click on the work area 3 Drag the mouse and release the button Note Hold down the Shift key for a 45 or 90 line Drawing a Segmented Line To draw a segmented line 1 On the Draw menu select Segmented Line 2 Left click and release the mouse from point to point Drag the left mouse button for freehand drawing Drawing a Rectangle Square To draw a rectangle square 1 On the Draw menu select Rectangle Square The mouse pointer changes to a box and cross hair 2 Left click and drag to form the box Note Pressing Shift while you draw forms a perfectly square box Drawing an Ellipse Circle To draw an ellipse circle 1 On the Draw menu select Ellipse Circle 2 Left click and drag the pointer anywhere in the work area to form an ellipse Note Pressing Shift while drawing forms a circle Inserting Text To insert text 1 On the Draw menu select Text 2 Left click on the work area 3 Type the text and left click outside the text to insert Note If direct editing use the Backspace to delete characters The Delete button deletes all text Creating Objects 5 7 Defining Text Font To define font types 1 Select the text objects in your dis
37. Displays the current font and a scrolling list of fonts available Determines the style of the font regular bold italic or bold italic Allows user to select the size of the font from a drop down menu Allows strikeouts and underlining of the text chosen Displays a real size example of the font style and size chosen GWxXGauge ActiveX Control 15 17 Editing Slider Dial Parameters Note The slider track applies to only a horizontal or vertical gauge The knob section applies to all types of gauges To edit slider dial parameters 1 Double click on the GWXGauge ActiveX control The GW xXGauge ActiveX Properties dialog box appears 2 Select the Slider Dial tab Figure 15 13 ICONICS GW Gauge Actives Properties General Background Caption Bar Needle Value Scale Scale2 Fonts S eDsl WamingZones M Show Slider Dial I Track Current Maus Fill Color T Continuous Update Detents ja E dge Color E Slider Position Left or Bottom sl Edge Style Raised Slider Track hornzontal vertical gauge only order fi Edge Color fl Edge Style Sunken ll Cancel ech Help Figure 15 13 GWXGauge ActiveX Properties Dialog Box Slider Dial Tab 3 Modify the parameters using Table 15 12 15 18 Controls Table 15 12 Slider Dial Tab Parameters Parameters Show Slider Dial Track Current Value Continuous Update Detents Slider Position Slider
38. Graphics Returns the newly created GwxPick object on success Null if the operation failed See also GwxPick and GwxDynamic Available only in Configure mode IDispatch CreateButton long buttonType float x float y BSTR label GWXTEXTALIGNMENT alignment Boolean stretchText Boolean isFilled long fillColor long lineColor long lineWidth long lineStyle Boolean hasShadow long shadowColor long edgeStyle Boolean isHidden BSTR objectName Creates and returns a GwxButton object with the specified attributes in the current display A button object will be non operational until a GwxPick object is attached to it See also GwxButton GwxPick GwxDynamic GwxText and Gwx Visible Available only in Configure mode IDispatch CreateTimedate BSTR textObjectName BSTR dynamicObjectName long formatType BSTR timeFormat BSTR dateFormat Creates a GwxTimedate object with the specified attributes and attaches it to the GwxText object with the specified object name Returns the newly created GwxTimedate object on success Null if the operation failed See also GwxTimedate GwxText GwxVisible and GwxDynamic Available only in Configure mode IDispatch CreateProcessPoint BSTR textObjectName BSTR dynamicObjectName GWXDATATYPE dataType Boolean update Boolean dataEntry Boolean hasInitialValue VARIANT initialValue BSTR format Creates a GwxProcessPoint object with the specified attributes and attaches it to the GwxText object wit
39. Group M On Up Initial Stabe luv sl Data Source Tags Menu Value On Down arc Value On Up Gee Kep Shortcut Mone Delete Object Mame Description Custom Data Custom E Figure 1 Cancel Apply Help 1 18 Property Inspector for Radio Button Dynamic 3 Fill in the parameters using Table 11 17 Adding Dynamics 11 41 Table 11 17 Radio Button Parameters Field Action Mouse Type Group Execution Trigger Initial State Data Source Tags Menu Value On Down OPC Value On Up Key Shortcut Delete Object Name Description Custom Data Description Lists all the Pick action options load display drag drop load display back display forward pop up window embedded window close window launch application download value toggle value set aliases alias dialog run VBA Script and custom command Lists the mouse button activating the pick left middle or right Lists all the Pick action options Displays the group where the action returns Displays when the value returns On Down while down or on up Displays current state of action item Displays the name of the current file Opens the Expression Editor Aliases Local Variables or Simulation Variables dialog box Displays the return value when down Opens the OPC Universal Tag Browser Displays the return value when up Defines a key shortcut for this action Deletes the dynamic
40. Horizontal Square and Vertical Table 11 1 describes the different styles All three styles are supported on Microsoft Windows 2000 Professional and Windows XP Professional operating systems Table 11 1 Gradient Styles Style Description Horizontal The Horizontal style has the light focus coming from the top or the bottom of the object Square The Square style has the light focus coming from a corner Vertical The Vertical style has the light focus coming from either the right or the left side of the object Gradient Offsets This feature allows the variation of colors to be selected There are two options available in the Configure Gradient dialog box Offset X and Offset Y Figure 11 2 gives an example of these options Note Any number between 100 and 100 may be entered for both the Offsets DI 25 is e RRE EE bebe IE ORDONON aa Figure 11 2 Offset X and Offset Y by Percentage Brightness When only using one color the option of selecting a percentage of brightness is available Any number between O and 100 may be entered for the brightness level When using two colors the brightness adjustment option disappears and a second color may be selected 11 4 Advanced User s Dynamics Dynamics animate and control display objects using values established in the data source connection Refer to the Establishing Data Source Connections chapter for details Add multiple dynamic connections to a single obje
41. Links to other screens l From the Command menu select Dynamics gt Intrinsics gt Pushbutton Left click on the graphic screen 3 From the Pick tab select Action gt Load Action 4 Using the Browse button select the graphic file needed for the Hot Link Select Open 6 From the Button tab replace the highlighted button text with 7 the Hot Link graphic name Select OK Adding Fan Rotation to a Graphic To add a fan rotation to a graphic Ee a E bech bech Fesch Fesch bech ke JI Ch NA A WO NO KF ODO Paste the fan on graphic Right click fan Select Edit Symbol Right click on blade Select Property Inspector Select Rotation Select Expression Select Tags Pick Object gt Present_ Value Select Arithmetic gt Multiplication Select Shift plus Tags Buttons together Select Gwsim ramp long Select OK From the Rotation tab select Range Override Enter O for the Low Range Enter 1000 for the High Range Select OK and save Tips and Hints F 9 Adding Command Operation Box to Object when Clicking Left or Right Mouse Button To add command operation box to an object when clicking left or right mouse button Right click object Select Dynamics gt Action gt Pick Select the Pick tab Select Action gt Launch Application Select mouse button left right Select Custom button Select CMD from Metasys Application Select Browse button
42. Location D AWINNT System382 STDOLE2 TLB Language Standard References Figure 12 2 References Dialog Box M Graphics Native Display Objects M Graphics native objects like ellipses rectangles symbols and dynamic actions are not exposed to VBA by default However they can be referenced from VBA if they have an Object Name assigned through Property Inspector dialog box A reference actually a dispatch pointer to a named object can then be retrieved by one of following methods of the ThisDisplay Symbol and Visible objects Table 12 1 Refer to the OLE Automation Reference section of this manual for more information on these functions Using Visual Basic for Applications VBA Table 12 1 ThisDisplay Symbol and Visible Methods Method ThisDisplay Get VisibleObjectFrom Name Name ThisDisplay Get DynamicObjectFrom Name Name ThisDisplay Get VisibleObjectFrom Index Long Value Symbolname Get VisibleObjectFromin dex Long value Symbolname GetVisibleObject FromName Name VisibleObjectName GetDynamicObject Fromindex Long value VisibleObjectName GetDynamicObject FromName Name Description This function takes the name of a visual object in the display and reports back the object associated with that name Upon storing the result of this function in a variable can change the properties of the object in the display by changing the fields of the varia
43. Object Mame Description Custom Data Custom Cancel Apply Help Figure 11 8 Property Inspector Dialog Box Analog Color Tab 3 Establish a data connection 4 Fill in the analog color parameters using Table 11 9 5 Click OK Adding Dynamics 11 23 Table 11 9 Analog Color Parameters Parameters Data Source OPC Tags Drag Drop Data Source Tags Menu Fill Color Start End Start Color End Color Line Color Start End Shadow Color Start End Range Override Low High Default Color When Above Below Range Delete Object Name Description Custom Data Description Lists the Tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a Tag Specifies if the Data Source is eligible for drag and drop operation Opens Expression Editor Aliases Local Variables or Simulation Variables dialog box Changes starting and ending fill color of the object Changes starting fill color of the object when the analog signal is at its lowest value Changes ending fill color of the object This is the color that appears when the analog signal is at its highest value When the analog signal is between its minimum and maximum values the color is a mix of the start and end colors Changes starting and ending line color of the object Changes starting and ending shadow color of the object Activates an operating range other than the default with specific
44. Recommendations for Better Graphics Performance with Integrated N1 Networks Introduction This chapter discusses guidelines and recommendations for designing an M Graphics display for better performance with integrated N1 networks This appendix describes how to e change the maximum update rate e select multiple files and change the maximum update rate August 9 2002 Johnson Controls Inc www johnsoncontrols com Code No LIT 1201165 Software Release 5 1 G 2 Guidelines and Recommendations for Better Graphics Performance with Integrated N1 Networks Key Concepts Guidelines and Recommendations for Better Graphics Performance Overview M Graphics Release 4 0 introduced the use of layers which allows a drawing to have multiple layers This feature enables each layer to have its own symbols dynamics and data Use layers to simplify creating and displaying graphics To keep the M Graphics response time acceptable and reduce the communication load on the N1 network follow the guidelines in this section Target Maximum of 150 Objects Attributes Tagged per Graphic In graphics that use more than 150 tags distribute tags to hidden M Graphics layers that have OLE for Process Controls OPC server requests disabled when hidden Refer to Arranging Objects LIT 6440070 However the maximum number of tags including all the graphics layers should not exceed a total of 150 Multiple tags that reference the same object bu
45. Selects the desired data collection rate or number of samples Pens Handles the signal connection editing and configuration for the data displayed in the trend Settings Determines various settings for the control About Info Lists copyright and version information 14 8 Controls OLE Automation This section describes the OLE automation interface for TWX View32 Each ActiveX exposes a set of objects which are used to configure and automate the control Each object categorizes an area of functionality Table 14 2 lists the objects exposed by the TWX View32 Activex Interfaces OTitle IORanges IOTimeSettings IODetails IOPen IOGrids The following properties and methods are categorized by the object in which they exist Methods Properties for the TWXView32 ActiveX Table 14 2 Properties for the TWXView32 ActiveX Properties Boolean AutoStartRuntime long ReadyState LPDISPATCH Title LPDISPATCH XGrids LPDISPATCH YGrids LPDISPATCH Ranges LPDISPATCH TimeSettings LPDISPATCH Details OLE_COLOR BackColor OLE_COLOR DispColor OLE_COLOR ForeColor Boolean ShowTitle Boolean ShowRanges Boolean ShowDetails Continued on next page Description Autostarts the Runtime mode when the container application switches from Design to Active mode Used for asynchronous download of configuration data Dispatch interface to Title object Dispatch interface to X Grids Dispatch interface to Y Grids Dispatch interfac
46. Square cccccccccssssseeeeceaeeseeeeecseeaeeeeeeesueeseeeessaeaeeeeeeessaeseeeees 5 6 Drawing an Ellipse Cirele E 5 6 gistelaill ale TOX e A E tee ere ee ere ere tere ere 5 6 DOMAGE OM EE 5 7 DNN ie Ke 5 7 Defining Line Style ccc ccccccceceeeeeeceeeseeeseeeeeeeseeeeceeseeeeeeeseeaeeesseaaeeeeseeeseeseaaeeeeseas 5 7 Defining Line Wd 5 7 Filling an Object with Color ccccccccccccsseceeeceeeeeceeeeeeeseeeeeeeseeeeeeeseeeeesseeeeesseeeeeeeas 5 7 anjer aia eMe dn E E 5 8 MPO GE 5 8 O O E 5 8 EXPONO A Metal ripitin EE AE EEA ES 5 8 FRCS ZING IER OI CCl E E E E E E E A EN E E 5 8 MASS FUG NV OCU EE 5 9 EE EEN 5 10 Common Gielen E 5 10 Chapters Editing ObjectS sssnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn nnn 6 1 NET O GU CON E 6 1 Key ee Te 6 2 Belg Die e In E 6 2 cto Ee 6 2 PING VS Replace eler e E 6 2 tee Eer OV ON VIGW wiincsisiciaesiic snwezicedinend sebdnadicnbiwendcundvendaendswadastdersdsedeeszoecnes 6 3 RTE Re e TE TE 6 4 Editing the Length of a LING ENEE 6 4 POD OSI ONUMG A El eors ona EA E 6 4 Editing the Vertices of a Segmented Lme 6 4 Resizing a IAC ClAMOIC EE 6 4 Rocz aT E Mie 6 5 RSMO ANA E 6 5 Eating tne Snape Of AMATO E 6 5 Cutting an Obert 6 5 Copying AT IO OC EE 6 5 4 M Graphics User s Manual Pasting an ODJECE a a ai aa aaa ene ee ee ee ee 6 6 Using GE RE 6 6 D piCaANG AM ODJECE csccecesteeasaccseecoenclacusaanesadaameassneatouseaeaedeonanaceaaantnaceusateoeeacteaneese
47. These Steps From the Command menu select Dynamics gt Intrinsics gt Pushbutton Left click on the graphic screen From the Pick tab select Action gt Load Action Using the Browse button select the graphic file needed for the Hot Link Select Open From the Button tab replace the highlighted button text with the Hot Link graphic name Select OK Paste the fan on graphic Right click fan Select Edit Symbol Right click on blade Select Property Inspector Select Rotation Select Expression Select Tags Pick Object gt Present_Value Select Arithmetic gt Multiplication Select Shift plus Tags buttons together Select Gwsim ramp long Select OK From the Rotation tab select Range Override Enter 0 for the Low Range Enter 1000 for the High Range Select OK and save Right click object Select Dynamics gt Action gt Pick Select the Pick tab Select Action gt Launch Application Select the mouse button Select Custom button Select CMD from the Metasys Application Select Browse button Pick Object gt Present_Value Select OK Delete Present_Value from OWSExec command line parameter Select OK Select OK and save file Right click object Select Dynamics gt Action gt Pick Select Pick tab Select Action gt Launch Application Select Left or Right mouse button Select Custom Select FOC from Metasys Application Select Browse Pick Object gt Present_Value Select OK Delete Present_Value for the OWSExec command line pa
48. Wizard Click in the work area The Display Button Wizard appears Fill in parameters Click OK 11 12 Advanced User s Detailed Procedures Adding a Size Dynamic To add a size dynamic 1 Select the object 2 On the Dynamics menu select Actions gt Size The Property Inspector appears with the Size tab Figure 11 3 Property Inspector EJ Ellipse Size Rotation DataSource ODrag Drop Data Source OPC Tage Tags Menu Shark Size jo Zi T Range Override End Size 100 Ea geld Ge Scale Hia EES F cip Delete Object Name P Descriptions Custom Data Custom Cancel Apply Help Figure 11 3 Property Inspector Dialog Box Size Tab 3 Establish a data connection 4 Fill in the size dynamic parameters using Table 11 4 Click OK Adding Dynamics 11 13 Table 11 4 Size Action Parameters Parameter Data Source OPC Tags Drag Drop Data Source Tags Menu Size Toolbar Range Override Start Size End Size Scale Clip Delete Object Name Description Custom Data Description Lists the tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a Tag Specifies if the Data Source is eligible for drag and drop operation Opens Expression Editor Aliases Local Variables or Simulation Variables dialog box Specifies the direction to size the object Activates an operating range other than the default range for the data point
49. all the windows by assigning a unique ID to each window Events are actions associated with a window Events can occur through user actions such as mouse clicks key presses or as a result of another window s actions When an event occurs a message is sent to the operating system that broadcasts the message to other windows Each window can take appropriate action based on its own instructions Examples of event handling are repainting of a window by itself when uncovered by another window closing minimizing or maximizing a window by clicking on the appropriate control etc Many of the standard events or messages are handled automatically by VBA Other events are exposed to the user as Event procedures and the user can write powerful code to deal with Event procedures without having to deal with unnecessary details Using Visual Basic for Applications VBA 12 3 Object Oriented Programming Visual Basic is an object oriented programming language Contrary to procedural languages like C or BASIC VB uses objects to create applications Examples of objects are forms controls M Graphics displays databases etc Create your own objects from a set of rules called classes Objects and classes simplify your coding and increase code reuse Classes Classes are sets of rules that define objects Objects in Visual Basic are created from classes An object is an instance of a class The class defines an object s interfaces default me
50. attached dynamics In Figure 9 1 the text object has a size action a flash action and a hide action Property Inspector NI Text Text Color Wo wan j T Fil Color Line Style No Line T Shadow Color P 30 Edge None zl Gradient Fill Si Fill Patterrr Ho Pattern Freeze Object W Stretch Text On Resize Font Arial Size 10 Font stacy a Text Lett sl Zl oeg tet Object Name Po Description IS Share Keyword Po Custom Data a Euston Cancel Apply Help Figure 9 1 Property Inspector Dialog Box Text Tab Using the Property Inspector 9 3 Update Shared Objects Enter a keyword shared by all the objects in the Share Keyword field Any change can be made to an object of the group and can be applied to the rest of objects by using Update Shared Objects Figure 9 2 Tips on Using Shared Objects Consider a display with many inputs and outputs If all input label objects are marked as shared e g with input keyword and all output label objects are marked as shared e g with output keyword it 1s very fast and easy to modify the color size 3D effect and shadow for all of them Change one object and apply the change to the rest Consider a project with many pumps If all desired pumps are marked as shared with same keyword one can quickly and easily change the appearance If the pumps are connected to different signals make sure Preserve Dynamic Tags is checked
51. context menus contain shortcuts to frequently performed actions VBA Editor Toolbars The toolbars provide quick access to commands in the programming environment By default the Standard toolbar is displayed Additional toolbars for editing form design and debugging toggles on or off the Toolbars command on the View menu VBA Editor Toolbox The toolbox provides a set of tools used at design time to place controls on a form In addition to the default toolbox layout create custom layouts by selecting Add Tab from the context menu and adding controls to the resulting tab VBA Editor Project Explorer Window The Project Explorer Window lists the forms and modules in the current project As you create add or remove files from a project Visual Basic reflects the changes in the Project Explorer window which contains a current list of the files in the project Project Using Visual Basic for Applications VBA 12 5 A project is the collection of files used to build an application In the VBA project there is a collection of modules all modules are stored along with M Graphics objects in the same file gdf However it is possible to export the modules to bas files the class modules to cls files and forms to frm files A project consists of e one project file that keeps track of all the components vbp e one file for each form frm e one binary data file for each form containing data for properties of controls
52. custom versions In addition it provides realtime support for loading a resource only DLL to support an international language This DLL is compiled as a standard Win32 DLL and is made up of all the resources and the ODL file of the TWXView32 module Asynchronous Downloading The TWXView32 supports asynchronous downloading of configuration data when used inside ActiveX Document servers such as M Graphics to produce documents To enable this feature on the General property pages check the Use URL Path checkbox and supply a URL Uniform Resource Locator path In case of viewing ActiveX documents within an Intranet setup the user supplies a computer name and directory specifying the location of the TWX View32 configuration data must be a shared directory by using the convention file Computer Name Directory filename V32 Internal Architecture of ActiveX TWX View32 allows the data to be collected at a different rate and graphically drawn at a multiple of the data collection rates in order to minimize overall system load Currently minimal scan rate is set to be ten milliseconds and it is required that all data collection rates set by the user be an integer multiple of ten milliseconds In addition the user configures the desired number of samples to view on the screen up to a maximum of 3600 and the desired window time period All objects exposed by the TWX View32 can be accessed directly through OLE automation and their associa
53. device Modifiable Parameters To improve performance modify the following parameters in the nlopc ini file e Adjust the PollRate to values between 40 000 to 60 000 milliseconds ms 40 to 60 seconds for jobs with more than 100 tags per graphics if the Network Controller NC idle time is under 50 when graphical features run Expect slower analog value refresh in M Graphics at these time values Binary changes and analog alarm data are still reported whenever a change occurs The default is 20 000 milliseconds 20 seconds e Set DormantCycles to between 2 and 10 instead of the default of 72 72 gives 12 hour dormancy in the cache for faster release of unused points from the OPC cache For normal operations a value of 6 is recommended 6 gives 1 hour dormancy Note For more information regarding the nlopc ini file refer to Appendix B NI OPC Data Access Server Advanced Concepts Technical Bulletin LIT 643325 G 4 Guidelines and Recommendations for Better Graphics Performance with Integrated N1 Networks Maximum Update Rate Default Value The Maximum Update Rate determines how often data is obtained from the OPC server and from the Simulation Values The Maximum Update Rate default value was 50 milliseconds for Release through Release 5 This value is unnecessarily fast for the needs of our OPC servers The default value has been increased to 1 000 milliseconds 1 second to reduce the Central Processing Unit CPU acti
54. g_Excel_Sheet Range al O g_Excel_Sheet Range a2 O End Sub Using Visual Basic for Applications VBA 12 27 6 Create two process points in your display Make sure that the Data Entry checkbox is checked for both process points Connect one point to a local variable al and the other to a local variable named a2 This double tilde is a standard notation for local variables in M Graphics Property Inspector NI Text PPT DE DataSource Drag Drop Data Source UPL Tags Tags Menu OPC Request Type NATIVE Clent Display Type DOUBLE Format ore bh Compte i E input Range oir SCH S High Sid States Object Mame Description Custom Data Bustam Point Type M Update IT Data Entry Conti Eckes Cancel Apply Help Figure 12 12 Configuration of Process Point 7 Now go back to the Visual Basic editor 8 Make anew procedure designed to read from and write to Excel Go to Insert Procedure in the menu bar 12 28 Advanced User s 10 11 12 Name the procedure Read_Write and enter in the following code ee Sub Read Write ByVal Co As Integer This procedure reads from or writes to excel based on the condition Co passed as a parameter Dim Point As GwxPoint Dim St As String Used to store cell name Dim St2 As String Used to store variable name Dim X As Integer For X 1 To 2 add a to the value X conve
55. in Runtime print the full screen in Runtime exit M Graphics January 2001 Johnson Controls Inc Code No LIT 6440030 3 2 Operator s Guide Key Concepts M Graphics Screen Figure 3 1 shows an example of an M Graphics screen vi Display M Graphics by Johnson Controls File Edit View Format Arange Draw Dynamics Toole Runtime Help Derren EE CC EE arial Ajo HA ezus bk N L Ka K g A ob A A ip A k d ay dei SBR 8 il zs k BOUF e fa Iwglnumsbadsuuzmpopleenanaleli 3 2 For Help press F well y 159 100 Primary Layer Figure 3 1 M Graphics Screen Work Area The work area is where you build your M Graphics displays Figure 3 1 shows only a portion of the entire work area that can be accessed by the scroll bars When the document is saved information about the current view is saved with the display so that it can be restored when the display is reloaded Toolbars Getting Started 3 3 Status Bar The status bar is displayed at the bottom of the M Graphics screen The left area of the status bar describes actions of menu items and toolbar buttons as you navigate through menus or select a toolbar button The right area of the status bar displays cursor coordinates zoom percent and grid snap on off The M Graphics tools that create displays are grouped by functionality and are available through the menu options and the toolbars Main Toolbar The Main toolbar is
56. may include properties of individual data connections for GwxDigitalColor objects GwxAnalogSelector GwxAnalogSelector has all the properties and methods of GwxDynamic GwxAnalogColor GwxAnalogColor has all the properties and methods of GwxDynamic GwxAnimator GwxAnimator has all the properties and methods of GwxDynamic GwxSize GwxSize has all the properties and methods of GwxDynamic GwxLocation GwxLocation has all the properties and methods of GwxDynamic GwxRotation GwxRotation has all the properties and methods of GwxDynamic GwxFlash GwxFlash has all the properties and methods of GwxDynamic GwxHide GwxHide has all the properties and methods of GwxDynamic GwxPick GwxPick has all the properties and methods of GwxDynamic OLE Automation Reference A 25 GwxProcessPoint GwxTimedate GwxPoint GwxProcessPoint has all the properties and methods of GwxDynamic GwxTimedate has all the properties and methods of GwxDynamic GwxPoint is the object type that M Graphics uses to represent data connections If several GwxDynamic objects are connected to the same data source they reference a single shared GwxPoint object GwxPoint objects handle OPC tags expressions constant values and M Graphics local variables GwxPoint objects cannot be explicitly created or destroyed M Graphics automatically manages the lifetimes of GwxPoint objects based on the data source connections of the GwxDynamic objects in t
57. modules are the foundation of most Visual Basic applications They can contain procedures that handle events general procedures and form level declarations of variables constants types and external procedures The code in a form module is specific to the particular application to which the form belongs it might also reference other forms or objects within that application The form module files have an extension frm 12 8 Advanced User s Class Modules Class modules cls file name extension are the foundation of object oriented programming in Visual Basic Write code in class modules to create new objects These new objects can include customized properties and methods Forms are just class modules that can have controls placed on them and can display form windows ActiveX Modules Various ActiveX modules include ActiveX Documents ActiveX Designers and User Controls From the standpoint of writing code these modules should be considered the same as form modules M Graphics VBA Project The M Graphics VBA project is loaded whenever you launch the VBA Editor from M Graphics This project contains groups of modules by default such as e M Graphics Native Objects e Modules ThisDisplay module and GwxTools module e Forms Each module can contain VBA code functions subroutines event handlers and global declarations GwxTools Module GwxTools is a custom module with common subroutines used in the VBA Wizard describ
58. not animating 11 34 Advanced User s Adding a Time Date To add time date 1 Select the object 2 On the Dynamics menu select Intrinsics gt Time Date 3 Click in the work area The Property Inspector appears with the Time Date tab Figure 11 14 Property Inspector Text Time Date Display Time only Time Format hemnes H 09 35 45 AM 9 35 45 Date Eormmat DIER 3785701 37872001 05 08701 01709708 08 5ep 1 Saturday U8 September 2001 Object Hame Description m Custom D ata Custom Cancel Apply Help Figure 11 14 Property Inspector Dialog Box Time Date Tab 4 Select a time and date format 5 Click OK Note Additional properties relating to the visual appearance of the Time Date object can be made by selecting the Text tab The text page for Time Date objects is similar to the page used to edit static text objects Adding Dynamics 11 35 Creating a Process Point Data Entry PPT DE To create a PPT DE 1 On the Dynamics menu select Intrinsics gt Process Point 2 Click in the work area The Property Inspector dialog box appears with the PPT DE tab Figure 11 15 Property Inspector EJ Text PPT DE DataSource D Drag Drop Data Source UPL Tags Tags Menu OPC Request Type NATIVE sl Chent Display Type DOUBLE Format ore T maade i input henge Loman yy E S High Sid States
59. on a square handle and drag it to resize the ellipse Note Pressing Shift while resizing maintains the Aspect Ratio of the object Resizing an Arc To resize an arc 1 Select the arc 2 Press the left mouse button on a square handle drag it to reshape the arc and release Editing the Shape of an Arc To edit the shape of an arc Right click on the arc to display the Format menu and choose Edit Arc The mouse pointer changes to a cross hair and allows you to change the shape of the arc Cutting an Object To cut an object 1 Select the object to cut A box with square handles surrounds the object 2 On the Edit menu select Cut The object is removed from the display and sent to the clipboard Note Youcan also use the Delete key to cut selected objects and place them onto the clipboard Copying an Object To copy an object 1 Select an object A box with handles surrounds the object 2 On the Edit menu select Copy The object is copied to the clipboard 6 6 Operator s Guide Pasting an Object To paste an object from the clipboard On the Edit menu select Paste The object is pasted near the center of the M Graphics display Using Paste Special To use Paste Special 1 On the Edit menu select Paste Special The Paste Special dialog box appears Figure 6 1 Source Bitmap Image Paste Bitmap Image Picture Metafile Device Independent Bitmap Hi Display As Icon Poste Link Insert
60. on the al icon in the M Graphics ActiveX toolbar 16 6 Controls Display M Graphics by Johnson Controls Ma lg et oer d G S Ie amp Gal a te Be Se Figure 16 3 GWXSwitch ActiveX in M Graphics Display GWXSwitch ActiveX Control 16 7 Editing General Parameters To edit general parameters 1 Double click on the GWXSwitch ActiveX control The GWxXSwitch ActiveX Properties dialog box appears Figure 16 4 ICONICS GW Switch Activex Properties NI Switch Style Vertical Rocker Switch 1 sl Data Source local bt Tags Update Fate E milliseconds Override Default Switch Colors Reverse On Off Values ii Eoa W W Auto Start Runtime Mode FE Caler 3 hd Preserve Aspect Ratio W Gradients About Cancel Ampy Help Figure 16 4 GWXSwitch ActiveX Properties Dialog Box General Tab 2 Select the General tab 3 Modify the parameters using Table 16 3 Note Uncheck Preserve Aspect Ratio when changing the Switch Style from the default Vertical Rocker Switch 1 to another Switch Style 16 8 Controls Table 16 3 General Tab Parameters Parameter Switch Style Data Source Tags Update Rate Reverse On Off Values Auto Start Runtime Mode Preserve Aspect Ratio Gradients Override Default Switch Colors About Description Allows user to select a switch type Vertical Rocker Vertical Slider Vertical Toggle Horizontal Rocker Horizontal Slider Horizontal Toggle Dia
61. on the form frx These files are not editable and are automatically generated for any frm file that contains binary properties such as Picture or Icon e optionally one file for each class module cls e optionally one file for each standard module bas e optionally one or more files containing ActiveX controls ocx e optionally a single resource file res Project File The project file is a list of all the files and objects associated with the project as well as information on the environment options This information is updated every time you save the project All of the files and objects can be shared by other projects Properties Window The Properties window lists the property settings for the selected form or control A property is a characteristic of an object such as size caption or color Object Browser The Object Browser lists objects available for use in a project and provides quick navigation through your code Use the Object Browser to explore objects in Visual Basic and other applications view methods and properties are available for those objects and paste code procedures into the application 12 6 Advanced User s Form Designer The form designer serves as a window that you customize to design the interface of your application Add controls graphics and pictures to a form to create the look you want Each form in an application has its own form designer window Code Editor Windo
62. set Runtime Alias January 2001 Johnson Controls Inc Code No LIT 6440100 10 2 Advanced User s Key Concepts Data Source Connections Each dynamic object allows one or more data source connections for its primary values Some dynamics also allow range overrides these range overrides are also data source connections A data source connection is a Tag representing a value in the system a constant value a local M Graphics variable an Alias a mathematical expression which can include Tags constants and local variables a simulated equation At Runtime users can drag drop source support and browse local variables and Aliases Type Data Source connections directly into the Data Source field in the Property Inspector dialog box of the various dynamics Figure 10 1 or click the OPC Tags to open the OPC Universal Tag Browser Figure 10 2 Establishing Data Source Connections 10 3 Property Inspector EJ Elipse Size Rotation DataSource Drag Drop Data Source OPC Tags Tags Menu Start Size fo PA T Range Override 100 o E m kee E End Size Ce Scale lte EES RH C Clip Delete Object Name Description Custom Data Custom Cancel Apply Help Figure 10 1 Property Inspector Size Dynamic OPC Universal Tag Browser Clicking the OPC Tags button in the Property Inspector opens the OPC Universal Tag Browser The OPC Universal Tag Browser all
63. simulation variables are useful for testing display animations when an OPC server is unavailable Figure 10 4 gfwsim ramp long ofwsim ramp float gfwsim random long gfwsim random bool gfwsim toggle bool gfwsimsine double simulval Figure 10 4 M Graphics Simulated Values Dialog Box 10 8 Advanced User s Expressions Expressions allow calculations to be performed on incoming data An Expression builder is available to aid in creating expressions Figure 10 8 An expression 1s a data connection with the string x as a token The addition operator is able to chain the strings together To use a Tag within the expression use the following syntax Tag name To use a local variable within the expression use the following syntax local_ variable name Types of expressions are listed in Table 10 3 Table 10 3 Expressions Expressions Options Arithmetic addition subtraction multiplication division modules open parenthesis close parenthesis Relational less than greater than less than or equal greater than or equal equal to not equal to Logical and or not Bitwise and or not XOR shift left shl shift right shr Functional conditional sine cosine tangent arcsine arccosine arctangent square root raised to power logarithm natural logarithm exponential absolute value integer ceiling integer floor minimum maximum Note A problem occurs in M Graphics Release 3 0 a
64. success False for failure 4 Boolean FileSaveAs BSTR filename Saves the current display using the specified file name Returns True for success False for failure 5 Boolean FileNew Starts a new empty display Returns True for success False for failure 6 Boolean FilePrint Prints the current display Returns True for success False for failure 7 void ShowWindow Shows the M Graphics main window 8 void HideWindow Hides the M Graphics main window 9 void RefreshWindow Redraws the visible portion of an M Graphics display 10 void BringWindowToTop Brings the M Graphics main window to the top of the window z order 11 void ExitApplication Exits M Graphics 12 void MinimizeWindow Minimizes the M Graphics main window 13 void MaximizeWindow Maximizes the M Graphics main window 14 void RestoreWindow Restores the non minimized non maximized window size and position 15 void SetWindowDimensionsPixels long left long top long width long height Sets the M Graphics main window size and location in pixels 16 void GetWindowDimensionsPixels long left long top long width long height Gets the M Graphics main window size and location in pixels 17 void SetWindowDimensionsPercent float left float top float width float height Sets the M Graphics main window size and location as a percentage of the total screen size Parameters should be values in the range of 0 0 t
65. the Format menu select Reset Default Display Properties or Reset Default Application Preferences On the Format menu select Set Configuration Mode Password Enter the password Confirm the password Click OK Customizing M Graphics 4 5 Detailed Procedures Customizing the Launch of M Graphics and Windows To customize the launch of M Graphics and Windows 1 Right click Start and select Open The Start menu window appears 2 Double click on the Programs folder 3 Double click on the Johnson Controls folder 4 Right click the M Graphics icon and select Properties The M Graphics Properties dialog box appears Figure 4 3 M Graphics Properties x General Shortcut x Ose 4 del M Graphics Target type Application Target location bin Target C Progam Files Johnson Controls M Graphics gwx32 e Start in C Progam Files Johnson Controls IV Graphics gw Shortcut key None Run Normal window Ka Find Target Change ken sl zl sa shortcut Figure 4 3 Shortcut to M Graphics Properties Dialog Box 5 Click the Shortcut tab and enter the appropriate command line options at the end of the Target field Refer to Table 4 2 and the Command Line Examples section 4 6 Operator s Guide Table 4 2 Command Line Options Option Description Runtime Launches M Graphics in Runtime automatically suppressing Splash screen NoSplash No Splash screen RegServer Registers application
66. the VBA code as in the diagram below to the body of the subroutine eo Display1 ThisDisplay Code Declarations Private Sub GwxDisplay_PostRuntimeStart Change color of ellipse MyEllipse to random green color when entering runtime Define a variable of type GwxEllipse Dim obj As GwxEllipse Assign ellipse to variable stop on failure Set obj ThisDisplay GetVisibleObject FromName MyEllipse If obj Is Nothing Then Stop Set new fill color Randomize obj fill Color RGB 0 Rnd 255 0 Release the object Set obj Nothing End Sub Figure 12 9 M Graphics Ellipse Modified From VBA 9 Save the M Graphics Project by selecting File Save Display 1 10 Test the example by switching to the display and going into Runtime The color of the ellipse changes to green Unique Object Names Example Assume you have a symbol which consists of a rectangle and an ellipse Write code that modifies these objects in any copy of the symbol You must assign partial names to both objects which name them MyRect_ and MyEll_ Here is the code that shows how to access these objects in a specific symbol Dim sym As GwxSymbol Set sym FindSomehowDesiredSymboli user method to choose the symbol Dim ell As GwxEllipse rect As GwxRectangle Set ell sym GetVisibleObjectFromName MyRect_ Set rect sym GetVisibleObjectFromName MyEll do something with these objects release references
67. the operation failed The newly created object has no data connections to add data connections use GwxDigitalSelector SetConnectionInfo See also GwxDigitalSelector GwxDigitalSelectorInfo GwxSymbol GwxVisible and GwxDynamic Available only in Configure mode Events This section describes the events that are exposed to M Graphics s integrated Visual Basic for Applications scripting 1 void DisplayLoadQ This event is fired just after a display is loaded into M Graphics 2 void DisplayUnload This event is fired just before a display is unloaded from M Graphics 1 e just prior to loading a new display into M Graphics or prior to closing M Graphics 3 void PreRuntimeStart This event is fired just before M Graphics is put into Runtime mode 4 void PostRuntimeStart This event is fired when M Graphics has finished entering Runtime mode 5 void PreRuntimeStop This event is fired just before M Graphics exits Runtime mode 6 void PostRuntimeStop This event is fired after M Graphics has exited Runtime mode 7 void PreAnimateDisplay This event is fired just before M Graphics animates a display animating a display is the process of requesting the tags from the OPC servers Displays are animated when loaded during Runtime mode and deanimated when unloaded during Runtime mode 8 void PostAnimateDisplay This event is fired after M Graphics has finished animating a display A 16 Appendi
68. view only shows the most basic display 7 4 Operator s Guide Procedure Overview Table 7 1 Arranging Objects To Do This Group Objects Ungroup Objects Reposition Objects Rotate Objects Flip Objects Align Objects Space Objects Evenly Make Objects Same Size Add Layers Remove Layers Duplicate Layers Edit Layer Properties Set Currently Active Layer Follow These Steps Select objects On the Arrange menu select Group into Symbol Select a group On the Arrange menu select Ungroup Symbol Select an object On the Arrange menu select one of the following bring to front send to back bring forward or send backward Select an object On the Arrange menu select Free Rotate and click and drag on a handle or Rotate Flip and one of the following rotate left or rotate right Select an object On the Arrange menu select Rotate Flip and choose either flip horizontal or flip vertical Left click on the objects On the Arrange menu select Align and choose one of the following tops bottoms middles lefts rights or centers Left click on the objects On the Arrange menu select Space Evenly and choose either across or down Left click on the objects you wish to make a uniform size On the Arrange menu select Make Same Size and choose one of the following height width or both On the Format menu select Layers gt Add Layer Refer to Table 7 2 On the Format menu select Lay
69. 0 11 30 Advanced User s Adding an Analog Selector Dynamic To add an analog selector dynamic 1 Select two or more objects 2 On the Dynamics menu select Selectors gt Analog Selector The Property Inspector dialog box appears with the Analog Selector tab Figure 11 12 Property Inspector Symbol Analog Selector Data Source Drag Drop Data Source OPC Tags Tags Menu GO DD EE Change Order 4 d 50 000 100 000 Reset f Range Override Feck EES d Hide Below Range High T EE y Hide Above Range Object Name Description SS Custom Data m Custom Frame Number 1 Cancel Apply Help Figure 11 12 Property Inspector Dialog Box Analog Selector Tab 3 Establish a data connection 4 Fill in the analog selector dynamic parameters using Table 11 13 Adding Dynamics 11 31 Table 11 13 Analog Selector Parameters Parameter Data Source OPC Tags Drag Drop Data Source Tags Menu Percentage Percentage List Change Reset Change Order Range Override Frame Number Hide Below Range Hide Above Range Description Lists the Tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a Tag Specifies if the Data Source is eligible for drag and drop operation Opens the Expression Editor Aliases Local Variables or Simulation Variables dialog box Allows objects to display when the data point value is a
70. 0 Ee A 20 Eeer A 21 EU ee 6 eae ene eee ee Re ee eee E E ee eee A 21 E Ee A 21 E te A 21 BIN E A 21 10 M Graphics User s Manual E EE A 21 GU E e EE A 22 ITD YN e A 22 SADIA S cle 6 EE A 23 RSW DIGIT elei e E A 23 E Re ts ee A 24 E Re e UE e ele e BE A 24 GWANAS Cl e A 24 GwxAnalogColor EE A 24 E gn ae E A 24 QW EE A 24 NTO CATION EE A 24 RTT ON EE A 24 SN E A 24 VTLS EEN A 24 AWK le EE A 24 Gwxbirocessbomt A 25 TINS E EEN A 25 NIP ONE EE A 25 ON A 6 cece ee ee en E ee ee A 26 Appendix B DIN Symbol LIDrary cccsccssscsssscsnsssnsseeessenseeeeseenseeonees B 1 le dee Ee e E B 1 EEN B 2 VO LLID IY eege B 2 DIN YMO oR so lt 2 99 S ene ene een en ee eee ee ee ae eee ee B 3 Appendix C French Symbol Library ccccccessecesseesseeesseenseeeneeeesesenees C 1 TOO CHOW E C 1 TOY EE C 2 SLL ee MMOL E C 2 French Symbols Exvamples C 3 Appendix D Johnson Controls Symbol Library sseeeeseeeees D 1 MOGU UON E D 1 EE D 2 Symbol Library ee D 2 Johnson Controls Symbols Exvamples D 3 Appendix E Other Symbol Library cccccseceeeeseseeeeseenseeeeseeeneeenees E 1 SIU OOUCHON PERANAN NE ENE ENE A ANE TA E EE E EE E 1 EE ee E 2 Table of Contents 11 SYMBOL MORAY EE E 2 Other Symbols EXaMpleS eege ee E 3 AppendixF Tips and DES eegeeget testee eege kee dE hees F 1 BT OU CUD E F 1 EEN F 2 Characteristics Of Good Graphics cccccceeccceeeseeeeeceeeeeeeseeeeeeeeaeeeeee
71. 001 Johnson Controls Inc Code No LIT 6440150 15 2 Controls Key Concepts GWxXGauge ActiveX Control The GWXGauge ActiveX is an ActiveX control that can be inserted in the M Graphics application The GWXGauge ActiveX displays and modifies data in a virtual instrument panel format on graphics Use the GWxXGauge ActiveX to display analog data with color and alarm settings The GWXGauge ActiveX supports connection to OPC compliant servers and provides excellent capabilities for managing data GWxXGauge ActiveX Properties The GWXGauge ActiveX Properties dialog box is the configuration interface to the GW XGauge ActiveX Double clicking anywhere in the GW XGauge ActiveX client during Configure mode opens the GW xXGauge ActiveX Properties dialog box Figure 15 1 The dialog box fields are described in Table 15 1 ICONICS GWAG auge Activex Properties x Scale Scale Fonts Slider Dial Warming ones Ge General Background Caption Bar Needle Value Data Source afwsim ramp float Tags Range Override low Hange if sel High Prange ij Se bh Auto Start Runtime Mode E Preserve Aspect Ratio Update Hate g milliseconds Gauge Type Vertical sl pte Atigle peed ff Gradients Length Factor Dm 2 End Shole BE About Cancel Apply Help Figure 15 1 GWXGauge ActiveX Properties Dialog Box GWxXGauge ActiveX Control 15 3 Table 15 1 GWXGauge ActiveX Properties Dialog Box Properties Pag
72. 2 Runtime toolbar v i 2 Click on the Focus Pen button ER The Focus Pen s Selection dialog box appears Figure 14 21 3 Edit the options Focus Pen s Selection Ed Trend Pens Options ofwsim sine double M Visible E Show Samples StairPlot AutoScale Alarm Lines Pen Marker Vv Show Tooltips II Focus Pen Select Figure 14 21 Focus Pen Selection Dialog Box TWxXView32 ActiveX Control 14 35 Moving Between Samples in Runtime To move between samples in Runtime 1 In Runtime double click in the display to open the TWX View32 Runtime toolbar only available in Freeze mode 2 Click on one of the following buttons DI page left cursor left nl cursor right or ml page right 3 Hold the Shift key while pressing the cursor right left buttons moves the cursor left or right ten samples default 14 36 Controls Chapter 15 M Graphics User s Manual 15 1 GWXGauge ActiveX Control Introduction The GWXGauge is an ActiveX control that can be inserted into the M Graphics application to display analog data This chapter describes how to insert a GWXGauge ActiveX control edit general parameters edit background parameters edit caption parameters edit bar parameters edit needle parameters edit value parameters edit scalel parameters edit scale2 parameters edit fonts parameters edit slider dial parameters edit warning zones parameters view about information January 2
73. 56 OLE Automation Reference A 9 Boolean SetHeadObject BSTR objectName Sets the head object to the visible object with the specified name Returns True for success False for failure Boolean SetAliasDefinition BSTR aliasName BSTR newDefinition Sets the alias definition of the specified alias name for all dynamic objects in the display This function can be used in Runtime mode to easily change the data connections of dynamic objects on the fly Returns False if no matching alias names were found True otherwise See also GwxVisible SetAliasDefinition and GwxDynamic SetAliasDefinition Boolean OpenTagBrowser long hWndParent BSTR tagName Opens the Tag Browser with the specified window handle as the parent window The parameter tagName receives the tag name selected by the user Returns True if the user presses the OK button False if the user presses the Cancel button Boolean SelectPaletteColor OLE_COLOR SelectedColor Opens the M Graphics Color Palette dialog box The parameter SelectedColor receives the color selected by the user Returns True if the user presses the OK button False if the user presses the Cancel button Boolean QueryRanges BSTR dataSource double lowRange double highRange Queries the OPC server for the high and low range values of the specified tag name dataSource Boolean QueryDataType BSTR dataSource GWXDATATYPE dataType Queries the OPC server for the data type of the specified ta
74. B and VBA document containing useful information Note that the VBA in M Graphics is the same as the one in Microsoft Office applications Word PowerPoint Access Excel and other products Once you master VBA in M Graphics you are able to program in all other applications There are many examples included with M Graphics that are good sources of information and VBA programming tips and tricks It is also possible and helpful to open two or more instances of M Graphics in each instance open the VBA Editor and copy and paste the VBA code between the instances VBA Wizards Using Visual Basic for Applications VBA 12 13 VBA Wizards are M Graphics objects with Visual Basic code behind them The code is run either in Design mode to help to configure M Graphics object or in Runtime mode to execute a specific task Normally the VBA code is stored in the current document saved from the VBA Editor when the display is saved and re loaded to VBA Editor when a display is open in M Graphics However if the rules described below are followed the VBA code can be bound to an M Graphics object When such an object is pasted dropped to another instance of M Graphics to Symbol Library or to scrap desktop this code goes with it The VBA Wizard can be run to perform a specific task either in Design or Runtime mode Design Mode M Graphics can launch the VBA Wizard macro in Design mode by double clicking the VBA Wizard By default
75. BSTR objectName Boolean rounded Creates and returns a GwxRectangle object with the specified attributes in the current display See also GwxRectangle and Gwx Visible Available only in Configure mode IDispatch CreateText float x float y BSTR text long alignment Boolean stretchText Boolean isFilled OLE COLOR fillColor OLE COLOR lineColor long lineWidth GWXLINESTYLE lineStyle Boolean hasShadow OLE COLOR shadowColor GWX3DEDGESTYLE edgeStyle Boolean isHidden BSTR objectName Creates and returns a GwxText object with the specified attributes in the current display See also GwxText and GwxVisible Available only in Configure mode A 8 Appendix 45 46 47 48 49 50 IDispatch CreatePolyline VARIANT vertices Boolean isFilled OLE COLOR fillColor OLE COLOR lineColor long lineWidth GWXLINESTYLE lineStyle Boolean hasShadow OLE COLOR shadowColor GWX3DEDGESTYLE edgeStyle Boolean isHidden BSTR objectName Creates and returns a GwxLine object with the specified attributes in the current display The parameter vertices are an array of float values such that the Elements 0 2 4 6 of the array are x coordinates of the vertices of the line and Elements 1 3 5 7 of the array are y coordinates of the vertices of the line See also GwxLine and GwxVisible Available only in Configure mode IDispatch CreateArc GWXARCTYPE arcType float centerX float centerY float radiusX float radiusY
76. Bound List Controls 5 0 a _ Microsoft Excel 5 0 Object Library W Graph 8 0 Obiect Librarv ad Ce Microsoft Excel 8 0 Object Library Location D Program Files Microsoft Office Office EXCEL8 OLB Language Standard References Menu Figure 12 10 References Menu 12 26 Advanced User s 4 In the Project viewer window double click on the ThisDisplay Module You should see a code window with the words Option Explicit In that window you want to make global declarations that will be used later Option Explicit Public g Excel App As Excel Application Public g Excel Book As Excel Workbook Public g Excel Sheet As Excel Worksheet eo Display1 ThisDisplay Code Option Explicit Public g Excel_App As Excel Application Public g Excel Book As Excel Workbook Public g Excel Sheet As Excel Worksheet This Display Code1 Figure 12 11 ThisDisplay Code Window with Global Declarations 5 In the left combo box at the top of the code window select GwxDisplay In the right combo box select PreRuntimeStart By entering the following code you cause Excel to be launched before M Graphics goes into Runtime Private Sub GwxDisplay PreRuntimeStart Open up Excel and make it visible Set g Excel App CreateObject Excel application g Excel App Visible True Open up a sheet Set g Excel Book g Excel App Workbooks Add Set g Excel Sheet g Excel Book Worksheets 1 Initialize the two cells you will be using
77. C Multiple Files Figure 4 11 Choose Settings Dialog Box 2 Select preference categories 3 Click OK Saving Display Properties as Application Preferences To save display properties as application preferences 1 On the Format menu select Save Properties as Preferences The Choose Settings dialog box appears Figure 4 11 2 Select properties categories Click OK Resetting Default Application Preferences and Display Properties To reset factory default application preferences and display properties On the Format menu select Reset Default Display Properties or Reset Default Application Preferences Defining a Configuration Mode Password To define a Configuration mode password 4 18 Operators Guide 1 On the Format menu select Configuration Mode Password The Set Password for Current Display dialog box appears Figure 4 12 Set Password for Current Display NI Password Confirm ome pe Figure 4 12 Set Password for Current Display 2 Enter the Password 3 Confirm the Password 4 Click OK Note When password protected displays are opened the following Enter Password dialog box appears Figure 4 13 Enter Password test _gdf NI Password Challenge 19638 me n Figure 4 13 Enter Password Customizing M Graphics 4 19 Setting Up the Alarm Icon Path for ActiveX Control To set up the alarm icon path for ActiveX Control 1 From the Edit menu select
78. COLOR altShadowColor Creates a GwxF lash object with the specified attributes and attaches it to the visible object with the specified object name Returns the newly created GwxFlash object on success Null if the operation failed See also GwxFlash and GwxDynamic Available only in Configure mode A 12 Appendix 62 Dispatch CreateAnalogColorDynamic BSTR 63 visibleObjectName BSTR dynamicObjectName Boolean changeFill Boolean changeLine Boolean changeShadow OLE COLOR startFillColor OLE COLOR endFillColor OLE_COLOR startLineColor OLE _ COLOR endLineColor OLE_COLOR startShadowColor OLE COLOR endShadowColor Boolean defaultColorAbove Boolean defaultColorBelow Creates a GwxAnalogColor object with the specified attributes and attaches it to the visible object with the specified object name Returns the newly created GwxAnalogColor object on success Null if the operation failed See also GwxAnalogColor and GwxDynamic Available only in Configure mode IDispatch CreateDigitalColorDynamic BSTR visibleObjectName BSTR dynamicObjectName Boolean changeColorWhenTrue Boolean changeFill Boolean changeLine Boolean changeShadow long fillColor long lineColor long shadowColor BSTR dataSource Creates a GwxDigitalColor object with the specified attributes and attaches it to the visible object with the specified object name The object is created with one initial data connection Additional data connections can be added
79. Configuration Dialog Box 10 22 Advanced User s Table 10 10 Set Aliases Configuration Dialog Box Parameters Parameter Alias Name Aliases Alias Definition Add Remove Change Import Export Tags Menu File Name No Alias Settings Set Aliases From File Set Aliases Directly Description Shows Name assigned to Alias Displays definitions for all Aliases Changes the definitions for all selected Alias names Adds Alias to list Removes Alias from list Changes an Alias that is currently assigned Imports an Alias to the list Exports an Alias from the list Displays the Edit Expressions Alias Local Variables or Simulated Variables dialog box Contains the name of the text file Use the Browse button to locate a file If this option is selected no Aliases can be specified The Aliases can come from an external tab delimited text file These files can be exported from Excel created in Notepad or created using M Graphics Alias File Editor The Aliases can be specified directly in M Graphics and saved The Alias replacement strings are modifiable during Runtime via OLE automation Chapter 11 Adding Dynamics Introduction M Graphic s User s Manual This chapter explains how to make single or multiple dynamic connections from display objects to points from OPC data servers This chapter describes how to add a size dynamic add a location dynamic add a rotation dynamic a
80. D The parameters are the same as Custom Configure Do not release the dispatch pointers passed to this method After the method returns M Graphics does not release the dispatch pointer for the Automation object M Graphics keeps the dispatch pointer for the next time a Custom Command is executed The dispatch pointer is not released until this instance of M Graphics is closed GwxDisplay GwxDisplay is the object type for M Graphics displays Properties and methods of the GwxDisplay object type are described in detail below Also described are the events exposed to M Graphics s integrated Visual Basic for Applications VBA Properties OLE COLOR BackgroundColor Gets sets the current display s background color 1 Boolean Redraw When True automation calls when changing the visual appearance of a display will automatically refresh the display When False the user must explicitly refresh the display For instance you may want to change the attributes of many objects and refresh them all at once 2 Short ScaleMode Sets the scaling mode of the current display Valid values are e FixedScale 0 e Scaleable e ScaleablePreserveAspect 2 A 4 Appendix Methods 1 BSTR GetFileName Returns the name of the currently loaded display 2 Boolean FileOpen BSTR filename Loads the specified display Returns True for success False for failure 3 Boolean FileSave Saves the current display Returns True for
81. Insert New Object The Insert Object dialog box appears Figure 4 14 Create New Calendar Control 8 0 Lrystal Report Viewer Control Cancel O Create from File ILONICS National Instruments Achy ICONICS Also 23 Indicator Ac a teate Conio ILONICS Alermad orsa Aeport Active ICONICS AW ea ICONICS Gwa Gauge Activex Add Control Inserts a new CONICS Glaw ot 22 Indicator Gchves object into your document Result Figure 4 14 Insert Object Dialog Box 2 Select ICONICS AlarmWorX32 Indicator ActiveX Click OK The Alarm Icon appears 4 Double click on the Alarm Icon The ActiveX Control Properties dialog box appears 5 Select the Settings tab Figure 4 15 4 20 Operator s Guide ICONICS AlarmWor 32 Indicator Activex Control Properties General Settings Ranges Subscription Images Doc to launch olam views alarms nl regular view a runtime Browse Launch Doc wia Double Click Sound Suppression Period 60 Seconds Filter Suppress Sound via Fight Click Contest Menu M Global Sound Supression Replacement Color i Normal Color NE no alarm Cancel Apply Help Figure 4 15 ActiveX Control Properties Dialog Box Insert the path to the exe file in Doc to launch After the exe file path put the actual file name in quotes Add runtime at the end of the file name Click OK SS SS Chapter 5 M Graphics Users Manual 5 1 Creating O
82. M Graphics User s Manual 1 Table of Contents M Graphics User s Manual Introduction Chapter1 Using This Manual ccccssessseceseeeeecenseenseeeneseeees 1 1 TOO CHO E 1 1 EEN 1 2 Saleh Olam Za OM aretesss sete ence a EE EER 1 2 ONNE HEID WEE 1 2 Manual ee En te E 1 2 Chapter2 Introduction to M Graphics cccccesseseeeeeseseseeeeeeeenees 2 1 BEE OCU CHOON a EEEE EEEE EEEE AEAEE 2 1 Key ee TC 2 2 M Graphics Hardware and Software Heouremente 2 2 Wi Gia lee 2 2 M Graphics File Name Eviensions 2 2 Chapters Getting Started osionsa iaaa 3 1 BUT OU CHOI EE 3 1 EE 3 2 W we E AE TA E T E A E O T 3 2 NOTK AO E 3 2 TOODA E 3 3 M Graphics Version Checking Feature cccccccccsseeeceeeeeseeseeseeeeeeeeeeeesaeeeeeaaeeesaaes 3 6 NEE p e e madame aaenoubet ddan tnsciaeide ante snes onearhariaeooueetausba baw ninaalicucenoseds 3 Mouse tt ere CG 3 15 ROMUN e eeose nipon Ee E EREE E OE EE E ERRER 3 15 PUNUNG ON 3 16 Proc dure el i richest eco AR EEE A EEE 3 18 Detailed Procedures EE 3 19 SINO I GA a In e 3 19 Creating a New Display 3 19 opening aAa DI E 3 19 June 18 2004 Johnson Controls Inc www johnsoncontrols com 2 M Graphics User s Manual Saving a DISplay aasesaeqesoacueaenacsucsasbessancenaidensra ousuectneace senda neteseotaceade eouaeeaceceneceteeoaacoes 3 19 Pining AN IS E 3 19 Enabling the M Graphics Version Checking Feature aannnnennnnnnnnnnnnnnnnnnenennnnnnne 3
83. Object Mame Description Custom Data Bustam Point Type M Update IT Data Entry Confirm P keppad Cancel Apply Help Figure 11 15 Property Inspector Dialog Box PPT DE Tab 3 Establish a data point connection 4 Fill in the PPT DE dynamic parameters using Table 11 15 5 Click OK 11 36 Advanced User s Table 11 15 Process Point Data Entry Parameters Parameter Data Source OPC Tags Drag Drop Data Source Tags Menu Update Data Entry OPC Request Type Client Display Type Format Float Double Bool Byte Word Dword Char Short Long String Native Initial Value Input Range States Notes Description Lists the Tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a Tag Specifies if the Data Source is eligible for drag and drop operation Opens the Expression Editor Aliases Local Variables or Simulation Variables dialog box Defines a point type that the system updates realtime Allows the value of the connected point to be changed in Runtime mode Lists types of data requested by the OPC float double Boolean byte word dword character short long string and native Lists types of data displayed to the client float double Boolean byte word dword character short long and string Type or select the value format for the connected point Lists 18 default formats such as xxxx xx in a drop down
84. On the Edit menu select Paste On the Edit menu select Paste Special Select the format for the object paste or paste link Click OK Select an object On the Edit menu select Duplicate On the Edit menu select Find Fill in the fields Click OK On the Edit menu select Replace Fill in the fields Click OK On the Edit menu select Report Fill in the fields Click OK 6 4 Operator s Guide Detailed Procedures Editing the Length of a Line To edit the length of a line 1 Select the line 2 Press the left mouse button on a handle of the line 3 Drag the mouse to extend the line and release the mouse button Hold down the Shift key for a 45 or 90 line Repositioning a Line To reposition a line 1 Select the line 2 Drag to anew position and release the mouse button Editing the Vertices of a Segmented Line To edit the vertices of a segmented line 1 Select the line 2 Press Shift and right click The line s vertices appear and the mouse cursor appears as a cross arrow 3 Edit the midpoints and vertices of the segments Resizing a Rectangle To resize a rectangle 1 Select the rectangle left click on a square handle and drag to resize 2 Use the Shift key to maintain the Aspect Ratio of the rectangle while resizing Note Rounded rectangles may be free rotated and have 3D edges Editing Objects 6 5 Resizing an Ellipse To resize an ellipse 1 Select the ellipse 2 Left click
85. Period dialog box appears Figure 14 19 3 Edit the parameters Refer to Table 14 23 for details Trend Edit Period x Data Collection Rate Window Time Range Hours Mn Years Months Days rr St SE E Hours Display Collecti jo St ak Refresh 4 X Rate ac Rate Samples 480 Figure 14 19 Trend Edit Period Dialog Box Edit Period Table 14 23 Edit Trend Period Parameters Parameter Description Data Collection Determines how often data is collected per day Rate Display Refresh Determines how often the display refreshes Rate Window Time Determines number of days data is collected Range Samples Determines number of samples collected Toggling Freeze Unfreeze in Runtime To toggle freeze unfreeze in Runtime 1 In Runtime double click in the display to open the TWX View32 Runtime toolbar 2 Click on the Freeze button A to toggle between freeze and unfreeze 14 34 Controls Viewing Statistics in Runtime To view statistics in Runtime 1 In Runtime double click in the display to open the TWX View32 Runtime toolbar 2 Click on the Statistics button The Trend Statistics dialog box appears Figure 14 20 and lists current trend statistics Trend Statistics EN gofwsim sine double Real Time Trend Statistics Figure 14 20 Trend Statistics Dialog Box Editing the Focus Pen in Runtime To edit the focus pen in Runtime 1 In Runtime double click in the display to open the TWX View3
86. Plot X Axis Range Set X Range Fill Restore to Original Text Visible Ranges 2 tw properties ranges Figure 14 10 TWXView32 ActiveX Properties Dialog Box Ranges Tab 3 Modify the parameters using Table 14 15 14 24 Controls Table 14 15 Ranges Tab Parameters Parameter Border Options Position Format Size Global Ranges Low High Set X Range Fill Text Restore to Original Visible Ranges Description Determines the type of border bumped etched raised or sunken Determines range placement bottom bottom left bottom right left rectangle right top top left or top right Determines ranges field placement in the Trend window right or left Determines how the numbers representing the ranges appear XXX XX XXXX XXXX XX Describes the size of the entire ranges section large normal or small Enable disable global ranges and change the number of visible pens Specifies low range Specifies high range If you are using an XY plot X Ranges allows the user to set the value and format of the low and high X Ranges Determines fill color Determines text color Maintains the ranges even if the user changes something in Runtime Determines number of visible ranges TWXView32 ActiveX Control 14 25 Editing Details Parameters To edit details parameters 1 Double click on the TWX View32 control The TWX View32 ActiveX Properties dialog box appears 2 Select the De
87. Range Boolean Stairplot Description Gets sets the color associated with the pen Gets sets pen style such as Solid Dotted Dashed etc The width of the pen in logical units Default 1 Pen Description Pen Engineering Units Determines if a pen is to be drawn Pen signal point name High limit value Low limit value Gets sets a pen an X axis in XY plots High alarm value for pen Low alarm value for pen High high alarm value for pen Low low alarm value for pen Enables drawing of alarm lines Gets number of samples for the pen Get set override for high range If set True high range value will be computed from a Tag or Expression Get set override for low range If set True low range value will be computed from a Tag or Expression Enables stepwise plotting mode 14 14 Controls Table 14 8 Details Object Properties Properties BSTR BorderEdge BSTR BorderOptions OLE COLOR FillColor Boolean ShowPenPoint Boolean ShowPenText Boolean ShowPenUnits Boolean ShowPenValue Boolean ShowPenHiLo Boolean ShowPenHiLoAlarm Boolean ShowPenHiHiLoLoAlarm Boolean ShowPenValidity Boolean ShowXAxis Boolean ShowDetails OLE COLOR TextColor BSTR Size BSTR NumberFormat Boolean ShowPenTime Boolean ShowPenDate BSTR DateFormat Short Visible Pens Description Visual appearance of details Visual appearance of details The background color of the details field Determines if a pens information is displayed
88. Returns the newly created GwxLocation object on success Null if the operation failed See also GwxLocation and GwxDynamic Available only in Configure mode IDispatch CreateRotationDynamic BSTR visibleObjectName BSTR dynamicObjectName float startAngle float endAngle float pivotX float pivotY Boolean clockwise Boolean dial Boolean tracking short numberOfDetents Boolean continuousUpdate Creates a GwxRotation object with the specified attributes and attaches it to the visible object with the specified object name The parameters pivotX and pivotY are offsets from the center of the object Angles are specified in degrees Returns the newly created GwxRotation object on success Null if the operation failed See also GwxRotation and GwxDynamic Available only in Configure mode IDispatch CreateHideDynamic BSTR visibleObjectName BSTR dynamicObjectName Boolean hideWhenTrue Boolean disableObject Creates a GwxHide object with the specified attributes and attaches it to the visible object with the specified object name Returns the newly created GwxHide object on success Null if the operation failed See also GwxHide and GwxDynamic Available only in Configure mode IDispatch CreateFlashDynamic BSTR visibleObjectName BSTR dynamicObjectName Boolean hideObject Boolean flashWhenTrue Boolean altStateWhenOff Boolean changeFill Boolean changeLine Boolean changeShadow OLE COLOR altFillColor OLE_ COLOR altLineColor OLE
89. STR PenName BSTR RangeString BSTR PenType void SetPenLoRangeString BSTR PenName BSTR RangeString BSTR PenType void ChangeWinPeriod long NewPeriod Boolean SetTrendRightTDate DATE RightTDate0 Description Standard refresh method Call after visual modifications Adds a realtime pen Returns Dispatch interface of pen User must release interface when done Valid types are Real Time History Used in XY Plot to select a pen for X axis Returns a VARIANT String array of all pen names Deletes a pen Valid types are Real Time History Populates details info from the pen Valid types are Real Time History Enters Runtime Animate mode Exits Runtime Animate mode Returns True if Viewer is currently in Animate mode Otherwise False is returned Displays the viewer s About box Computes and stores statistical information Sets point name for high range of Range Object Use to replace point names and pen descriptions if desired Use to feed custom data for an assigned pen Sets point name for high range of a pen Sets point name for low range of a pen Changes trend period In Freeze mode sets the trend s right time and date Events Fired ReadyStateChange InAnimateMode UnableToCreateThread OutOfAnimateMode DatabaseChanged ErrorInLoadingData TWxXView32 ActiveX Control 14 11 Not all methods properties are supported during Runtime or Animation mode Methods Properti
90. Show Current value W Data Entry Value Format Lon a sl Tev t dge Color hg Fill Color Edge Style Sunken Foston E attom Y Cancel Ampy Help Figure 17 11 GWXSlider ActiveX Properties Dialog Box Value Tab 3 Modify the parameters using Table 17 10 Table 17 10 Value Tab Parameters Parameter Description Show Current Value If checked the current value of the tag displays in a box at the bottom of the slider Data Entry If checked user may type in new data values into the box when in Runtime mode Value Format Allows user to determine how the data is displayed from 21 numeric formats such as xxxx Text Edge Color Determines the color of the text and the edge of the box Fill Color Determines the color of the box that displays the values Edge Style Allows user to select a style for the edge of the box thin line medium line thick line etched bump raised sunken or no edge Position Determines the position of the value field relative to the slider track left right top or bottom 17 18 Controls Editing Fonts Parameters To edit fonts parameters 1 Double click on the GWXSlider ActiveX control The GWXSlider ActiveX Properties dialog box appears 2 Select the Fonts tab Figure 17 12 ICONICS GWeSlider Actives Properties General Slider Slow Spin Buttons Fast Spin Buttons Scale Background Caption Value Fonts Property Name Current alueF ont is
91. Steps On the Tools menu select Macros gt Visual Basic Editor Add code forms etc to accomplish desired task Open a display On the Tools menu select Macros gt Visual Basic Editor Open the ThisDisplay module from the VBA Editor Select the GwxDisplay module in left combo box of ThisDisplay module from the VBA Editor Select the desired event from the list in the right combo box On the File menu select Save Display 1 On the File menu select Close and Return to M Graphics On the View menu of the VBA Editor select Project Explorer Expand the M Graphics Objects group and double click the ThisDisplay GwxDisplay item Create a symbol On the Tools menu select Macros gt Create Macros Fill in the parameters Click OK Type code Return to M Graphics and double click on symbol Select a macro object in the display On the Tools menu select Macros gt Edit Macro Select a macro object in the display On the Tools menu select Macros gt Step Macro Select a macro object in the display On the Tools menu select Macros gt Run Macro On the Tools menu select Macros gt Clean VBA Unused Modules Using Visual Basic for Applications VBA 12 17 Detailed Procedures Creating and Editing VBA Scripts To create and edit VBA Scripts 1 Onthe Tools menu select Macros gt Visual Basic Editor The Visual Basic Editor appears Figure 12 4 z Microsoft Visual Basic Display1 design Eile Edit View In
92. TextColor BSTR Size double XHigh double XLow BSTR XNumberFormat Boolean OverHighRange Boolean OverLowRange Short Visible Pens Description Gets sets high range value Gets sets low range value Visual appearance of range display Visual appearance of range display Gets sets position of range display It can be Right Left Gets sets number format for range values Determines if the range field is displayed Default True Gets sets fill color of range display Size for Time display It can be large normal small Gets sets high range value for X axis in XY plots Gets sets low range value for X axis in XY plots Gets sets number format for X axis range values in XY plots Get set override for high range If set True high range value will be computed from a Tag or Expression Get set override for low range If set True low range value will be computed from a Tag or Expression Gets sets the number of visible pen ranges on the ranges display area if no Global ranges option is selected TWxXView32 ActiveX Control 14 13 Table 14 7 Pen Object Properties Properties OLE COLOR PenColor BSTR PenStyle short PenWidth BSTR PentText BSTR PenUnits Boolean PenVisible BSTR PenPointName double HighLimit double LowLimit Boolean PenXAxis double AlarmHigh double AlarmLow double AlarmHiHi double AlarmLoLo Boolean EnableAlarmLines long NumberOfSamples Boolean OverHighRange Boolean OverLow
93. Track Fill Color Edge Color Edge Style Knob Fill Color Edge Color Edge Style Description If checked the gauge has a slider dial If checked the current value is tracked If checked the data is updated continuously Allows user to set the increments that the slider dial will move within the gauge Determines where the slider will be placed left or bottom or right or top Determines the color of the bar the slider moves on Determines the color of the edge of the slider track Determines the style of the edge of the slider track thin line medium line thick line etched bump raised sunken or no edge Determines the color of the dial or slider Determines the edge color of the dial or slider Determines the style of the edge of the dial or slider thin line medium line thick line etched bump raised sunken or no edge GWXGauge ActiveX Control 15 19 Editing Warning Zones Parameters To edit warning zones parameters 1 Double click on the GWXGauge ActiveX control The GW xXGauge ActiveX Properties dialog box appears 2 Select the Warning Zones tab Figure 15 14 ICONICS GWAG auge Activex Properties General Background Caption Bar Neede Value Scalel Scale Fonts Slider Dial WamingZones i Show with Scalet IM Show With Scalez IY Zone Stark jo End po Fill Color M Zoe Start 70 En 90 Fill Color M Zoe Stat 90 Eng i00 Fill Color Zonet zeg
94. Value Select Tags Pick Object gt Present Value Select OK From the Pick tab enter 1 for the object s statel action or O for the object s stateO action into tags entry box From the Button tab replace the highlighted button text with the statel or stateO action De on or off Select OK Tips and Hints F 11 Adding Override Binary Commands to Pushbuttons To add override binary commands to pushbuttons 1 From the Command menu select Dynamics gt Intrinsics gt Pushbutton Left click on the graphic screen From the Pick tab select Action gt Download Value Select Tags Pick Object gt N1_Display_OV Select OK From the Pick tab enter 1 object s statel action or O object s stateO action into tags entry box 8 Select OK Note This applies only to the M5 Workstation Sa ee a Adding the Auto Binary Command to a Pushbutton To add the auto binary command to a pushbutton 1 From the Command menu select Dynamics gt Intrinsics gt Pushbutton 2 Left click on the graphic screen 3 From the Pick tab select Action gt Download Value 4 Select Tags 5 Pick Object gt N1_Display_OV 6 Select OK 7 From the Pick tab enter AUTO into tags entry box 8 From Button tab replace the highlighted button text with AUTO 9 Select OK Note This applies only to the M5 Workstation F 12 Appendix M Graphics User s Manual G 1 Appendix G Guidelines and
95. a specific VBA Wizard the code in these modules can be properly moved with the symbol If the macro name of the VBA Wizard is MacroName then all code modules must start with the string GwxMacroName_ This technique allows more code and form modules to be used for one VBA Wizard object and facilitates moving all this code with the object when necessary Using Visual Basic for Applications VBA 12 15 VBA Wizard Creation Tool Macro Because creating VBA Wizard objects would be a tedious task M Graphics offers a useful creation tool a macro that converts the object to VBA Wizard and generates the VBA template code The code can then be easily enhanced and modified by the user When a VBA Wizard is deleted or moved out of the current display the VBA code is not deleted automatically However you can use Clean Unused VBA Modules to remove all modules from the VBA Editor which start with the Gwx string and are not referenced from the currently displayed VBA Wizards either Design or Runtime mode based If you want to create a new Runtime based VBA Wizard add a pick dynamic with the Run VBA Script Refer to the Adding Dynamics chapter of this manual 12 16 Advanced User s Procedure Overview Table 12 3 Using VBA Scripts To Do This Create and Edit VBA Scripts Add Event Handlers Display the ThisDisplay Module Code Create a Macro Edit a Macro Step a Macro Run a Macro Clean VBA Unused Modules Follow These
96. ab Figure 17 8 ICONICS GWA Slider Activex Properties General Slider Slow Spin Buttons Fast Spin Buttons Background Caption Value Fonts MW Show Scale Low Flange P Taas KEEN High Range f 000 Taas Minor Tick Divisions E Label Every f Major Ticks Tick Color a Label Format vu Tick Style Thin Line T ext Color E E Scale Position Units Label Lett or Bottom Cancel Appy Help Figure 17 8 GWXSlider ActiveX Properties Dialog Box Scale Tab 3 Modify the parameters using Table 17 7 17 14 Controls Table 17 7 Scale Tab Parameters Parameter Show Scale Low Range High Range Label Every Label Format Text Color Units Label Major Tick Divisions Minor Tick Divisions Tick Color Tick Style Scale Position Description If checked the slider has a scale Determines the low number for the scale Determines the high number for the scale Determines the number of major ticks between labels Allows user to determine how the label is displayed from 21 formats such as xxxx Determines the color of the text Determines the unit text for the labels Determines the number of ticks between major divisions Determines the number of ticks between minor divisions Determines the color of the ticks Determines the style of the ticks thin line medium line thick line etched bump raised sunken or no edge Determines the location of the scale relative to the slider
97. ables disables use of URL path for asynchronous downloads Gets sets URL path name Gets sets the CSV file used for statistical information storage Enables disables Append mode for statistical file Enables disables the use of global ranges Default is True Enables disables the shifting of Grids during Runtime Default is True Gets sets initial offset for plotting Default is 0 Gets sets the cursor step for stepping in Freeze mode Enables disables restoring of ranges modified during Runtime Gets sets the language ID for loading a multilingual resource DLL Enables disables the color fill of trend display areas This should be used prior and after printing within the container to conserve color ink on the printer 14 10 Controls Table 14 3 Methods for the TWXView32 ActiveX Properties void Refresh Boolean AddRealTimePen BSTR PenName LPDISPATCHGetPen BSTR PenName BSTR PenType Boolean SetXAxis BSTR PenName VARIANT GetPenNames Boolean DeletePen BSTRPenName BSTR PenType Boolean SetDetailsFromPen BSTR PenName BSTR PenType Boolean EnterAnimate Boolean ExitAnimate Boolean GetAnimateMode void AboutBox Boolean ComputeStat void SetHiRangeString BSTR RangeString Boolean ReplacePoint BSTR PointName BSTROldString BSTRNewString Boolean DoPenText void SetPointValue BSTR PointName double PointValue DATE PointTDate void SetPenHiRangeString B
98. ale l Background Caption Value Fonts General Slider Slow Spin Buttons Fast Spin Buttons M Show Spin Buttons Increment zi Fill Color Repeat Hate ZU mg Arrow Color o W Acceleration Delay U00 ms Increment 100 Foston Surround Cancel Amply Help Figure 17 7 GWXSLider ActiveX Properties Dialog Box Fast Spin Buttons 3 Modify the parameters using Table 17 6 Table 17 6 Fast Spin Buttons Tab Parameters Parameter Description Show Spin Buttons If checked the slider has spin buttons Increment Determines the increment or decrement value when clicking on a spin button Repeat Rate Determines how often the increment action repeats when the user holds down the mouse on a spin button Fill Color Determines the color of the spin buttons Arrow Color Determines the color of the arrow Acceleration Allows user to keep holding down a spin button to accelerate the increment Delay Determines when the acceleration begins after spin buttons are pressed Increment Determines the increment or decrement value for the acceleration option Position Determines the position of the spin buttons relative to the slider group left or bottom group right or top or surround GWXSlider ActiveX Control 17 13 Editing Scale Parameters To edit scale parameters 1 Double click on the GWXSlider ActiveX control The GWXSlider ActiveX Properties dialog box appears 2 Select the Scale t
99. ame When Off Object Name Description Custom D ata A Custom E Cancel Apply Help Figure 11 13 Property Inspector Dialog Box Animator Tab 3 Establish a data connection 4 Fill in the animator dynamic parameters using Table 11 14 5 Click OK Adding Dynamics 11 33 Table 11 14 Animator Dynamic Parameters Data Source OPC Tags Drag Drop Data Source Tags Menu Change Frame Order Frame Number Frame Rate ms Animate When True Animate When False Invisible When Off Visible When Off Current Frame When Off First Frame When Off Description Lists the Tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a Tag Specifies if the Data Source is eligible for drag and drop operation Opens the Expression Editor Aliases Local Variables or Simulation Variables dialog box Changes the sequence number of the currently displayed object Allows you to reorder the object Displays sequence number of currently displayed object Lists the rate in milliseconds the frames change while animating Animates the object when the digital variable goes to its true state logical 1 Animates the object when the digital variable goes to its false state logical 0 Does not display any object when not animating Displays the specified object when not animating Displays most recent animation frame when not animating Displays first frame of the animation when
100. angle GwxEllipse GwxLine GwxText GwxArc GwxBitmap GwxMetafile GwxSymbol GwxOleObject GwxButton Returns Null if no matching object is found long GetNumberOfTopLevelVisibles Returns the number of visible objects in the root symbol of a display referred to as Top Level Visibles because they are the objects in top most level of the symbol hierarchy IDispatch GetVisibleObjectFromIndex long index Returns the Top Level Visible with the given zero based index An object with an index of zero is the object furthest back in the z order This function 1s useful for iterating through all the top level visible objects Boolean PopCurrentSymbol Pops the current symbol edit level up one level Returns True for success False for failure See also GwxSymbol PushCurrentSymbol Available only in Configure mode Boolean PopAliCurrentSymbol Pops the current symbol edit level back to the root level Returns True for success False for failure See also GwxSymbol PushCurrentSymbol Available only in Configure mode IDispatch GetDynamicObjectFromName BSTR objectName Gets the dynamic object with the specified object name The returned object is of type GwxDynamic or one of the GwxDynamic derived types GwxSize GwxLocation GwxRotation GwxHide GwxFlash GwxPick GwxDigitalColor GwxAnalogColor GwxAnimator GwxAnalogSelector GwxDigitalSelector GwxProcessPoint GwxTimedate Returns Null if no matching obj
101. apabilities for managing data GW lt XSlider ActiveX Properties The GWXSlider ActiveX Properties dialog box is the configuration interface to the GWXSlider ActiveX Double clicking anywhere in the GWxXSlider ActiveX client during Configure mode opens the GWXSlider ActiveX Properties dialog box Figure 17 1 The dialog box fields are described in Table 17 1 ICONICS GWeSlider Activex Properties x Scale Background Caption Value Fonts General Slider Slow Spin Buttons Fast Spin Buttons Data Source local_variable Tags W Range Override Lon Farge fo Tags High Range Do Tag W Auto Start Runtime Mode Update Rate E milizeconds hd Preserve Aspect Ratio D E Length F actor Do Slider Type Horizontal sl About Cancel Aon Help Figure 17 1 GWXSlider ActiveX Properties Dialog Box GWxXSlider ActiveX Control 17 3 Table 17 1 GWXSlider ActiveX Properties Dialog Box Properties Page General Slider Slow Spin Buttons Fast Spin Buttons Scale Background Caption Value Fonts Description Allows user to select the tag used as the data source for the slider Configures the appearance and behavior of the slider knob and track Configures the appearance and behavior of the slider spin buttons Configures the appearance and behavior of the slider spin buttons Configures the appearance of the scale of the slider Configures the appearance of the slider within the conta
102. apter provides examples of the DIN symbols included with M Graphics Symbols are continually added refer to the software for a complete set January 2001 Johnson Controls Inc Code No LIT 6440200 B 2 Appendix Key Concepts Symbol Library The symbol libraries with prebound tags provided with M Graphics aid in the creation of facility drawings Users can just modify the alias name to change the binding reference There are four categories of symbols DIN French Johnson Controls and other To import a symbol in M Graphics click the Import Symbol icon EI or on the Draw menu select Import and click on Symbol B 3 DIN Symbol Library DIN Symbols Examples Table B 1 DIN Symbols Examples LZ vr T f G2 D i W GA Bar 625 B23 y 182 CL 165 a4 A J 183 181 E47 z r W Ta GO CH casa Se Ur rg 253 Gu fet ME BES SHES N GG EN Zoe aoe 125 gt 193 103 seca ys Ae less 192 102 bde Pals We ak WS 191 101 Appendix B 4 Table B 1 DIN Symbols Examples Cont O U H d EI L JEF F dee del CG Loft 20E SUE 204 205 503 ZU T 20 o AL Ag e C S04 526 S 526 525 dei 521 AAN N E le SEI N SNH SZ 529 545 ee F a4 Har S IS eH BAT 4G 550 551 630 iN SE d 638 652 SR b35 B56 Bay DS XO KS Ge
103. arameters Edit Ranges Parameters Edit Details Parameters Edit Time Parameters Edit Rate Parameters Edit Pens Parameters Edit Settings Parameters View About Information Edit Pens in Runtime Edit Trend in Runtime Edit Period in Runtime Toggle Freeze Unfreeze in Runtime View Statistics in Runtime Edit the Focus Pen in Runtime Move Between Samples in Runtime Follow These Steps In M Graphics on the Edit menu select Insert New Object Select Create Control and ICONICS TWXView32 for the object type Click OK Double click on the TWXView32 control Select the General tab Modify the parameters Double click on the TWXView32 control Select the Fonts tab Modify the parameters Double click on the TWXView32 control Select the Workspace tab Modify the parameters Double click on the TWXView32 control Select the Grid tab Modify the parameters Double click on the TWXView32 control Select the Ranges tab Modify the parameters Double click on the TWXView32 control Select the Details tab Modify the parameters Double click on the TWXView32 control Select the Time tab Modify the parameters Double click on the TWXView32 control Select the Rate tab Modify the parameters Double click on the TWXView32 control Select the Pens tab Modify the parameters Double click on the TWXView32 control Select the Settings tab Modify the parameters Double click on the TWXView32 control Select the About tab I
104. ard and a powerful programming environment It is the fastest and easiest way to create and customize Microsoft Windows applications M Graphics is shipped with Microsoft VBA Release 5 0 VBA allows users to customize M Graphics to suit their specific requirements It also offers high level application programmability and features cross platform support for ActiveX technology It is identical with VBA in Microsoft Office applications and other third party products This chapter describes how to e create and edit VBA scripts e add event handlers e display the ThisDisplay module code e create a macro e edit a macro e step amacro e runa macro e clean VBA unused modules June 18 2004 Johnson Controls Inc 12 2 Advanced User s Key Concepts VBA Features Windows Events VBA allows you to e create debug and run custom scripts or macros e write Visual Basic code for M Graphics events e modify M Graphics native objects e connect ActiveX objects to each other and to M Graphics native objects VBA allows both Configure and Runtime operations A window is a rectangular region with its own boundaries Examples of windows include a Windows Explorer window a document window within Microsoft Word on M Graphics displays a dialog box text box message box command button etc A container is a window that contains one or more other windows buttons controls etc The Microsoft Windows operating system manages
105. ased information upholds the different expectations of graphics vs text based information upholds standards of graphics upholds standards of symbol usage templates and files estimated time to create graphics researches symbol examples from graphic library explains how much data to display on the screen explains navigational schemes explains existing standards that customers have in place saves money by helping to solve problems Usable Graphics Tips and Hints F 3 The following list describes how to create a usable graphic l Develop a standard to follow The standard defined by Johnson Controls is suitable Use storyboarding to simplify and speed up the process Identify advantages of graphics Quickly see alarms and statuses due to color changes b Physical locations of devices shown in piping duct or floor plans c Data from different systems can be in one display room temperatures all on one screen d Relationships between equipment can be emphasized boiler with pumps and valves shown with air handlers e Utilize riser diagrams for network layout AHU or fire systems Identify limitations of text displays a Data on the screen b Operator must read each point value Identify user expectations from graphic a Customize to suit the user b Utilize photos or other previously created drawings c Must come up fast d Must contain required information Provide estimated time to create g
106. ata Collection Rate Display Refresh Rate Hours Min Secs Msec Fa af a gd ee Window Time Range Years Months Days i A wi Hours Min Secs CNR tw properties rates Figure 14 13 TWXView32 ActiveX Properties Dialog Box Rate Tab 3 Modify the parameters using Table 14 18 Table 14 18 Rate Tab Parameters Parameter Description Data Collection Determines how often data is collected per day Rate Display Refresh Determines how often the display refreshes Rate Window Time Determines number of days data is collected Range Samples Determines number of samples collected 14 28 Controls Editing Pens Parameters Editing pens is available in Configure and Runtime modes 1 Double click on the TWX View32 control The TWX View32 ActiveX Properties dialog box appears 2 Select the Pens tab Figure 14 14 Taiviews2 Activex Properties x General Fonts Workspace Grids Ranges Details Time Rates i Pens Settings Expression Persistent Ho Edit Delete Replace T History Only Pen Description Cancel Ampy Help Figure 14 14 TWXView32 ActiveX Properties Dialog Box Pens Tab 3 Modify the parameters using Table 14 19 Note The maximum number of user configurable pens is 32 Table 14 19 Pen Tab Parameters Parameter Description Real Time Opens the Runtime mode Expression Opens the Edit Expressions dialog box Refer to the Adding Dynamics chapter for detail
107. ata connection Fill in the pick dynamic parameters Click OK Select the object On the Dynamics menu select Selectors gt Digital Selector Establish a data connection Fill in the digital selector dynamic parameters Click OK Select the object On the Dynamics menu select Selectors gt Analog Selector Establish a data connection Fill in the analog selector dynamic parameters Click OK Select the object On the Dynamics menu select Selectors gt Animator Establish a data connection Fill in the animator dynamic parameters Click OK Select the object On the Dynamics menu select Intrinsics gt Time Date Click in the work area Select a time and date format Click OK On the Dynamics menu select Intrinsics gt Process Point Click in the work area Establish a data point connection Fill in the PPT DE dynamic parameters Click OK On the Dynamics menu select Intrinsics gt Pushbutton Click in the work area The Property Inspector appears with tabs for Pick and Button Fill in the parameters Click OK On the Dynamics menu select Intrinsics gt Checkbox Click in the work area The Property Inspector appears with tabs for Pick and Checkbox Fill in the parameters Click OK On the Dynamics menu select Intrinsics gt Radio Button Click in the work area The Property Inspector appears with tabs for Pick and Radio Button Fill in the parameters Click OK On the Dynamics menu select Intrinsics gt Display Button
108. ats such as xxxx Determines the color of the text Determines the unit text for the labels Determines the number of ticks between major divisions Determines the number of ticks between minor divisions Determines the color of the ticks Determines the style of the ticks thin line medium line thick line etched bump raised sunken or no edge GWxXGauge ActiveX Control 15 15 Editing Scale2 Parameters To edit scale2 parameters 1 Double click on the GWXGauge ActiveX control The GW xXGauge ActiveX Properties dialog box appears 2 Select the Scale2 tab Figure 15 11 ICONICS GW Gauge Actives Properties Needle Value l Scale a Scaled l Fonts l Slider Dial Warning ones General Background Caption Bar W Show Scale HAART o eg Major Tick Divisions D High Range jooo Tags Minor Tick Divisions E Label Every e Major Ticks Jk Color Label Format e Tick Style Thin Line sl Text Color Units Label us Cancel Figure 15 11 GWXGauge ActiveX Properties Dialog Box Scale2 Tab 3 Modify the parameters using Table 15 10 Table 15 10 Scale2 Tab Parameters Parameter Description Show Scale Low High Range Label Every Label Format Text Color Units Label Major Tick Divisions Minor Tick Divisions Tick Color Tick Style If checked the gauge has a scale Determines the low and high numbers for the scale Determines the number of major ticks betwee
109. ay GwxDisplay item A ThisDisplay code window appears Figure 12 5 Display ThisDisplay Code lel Ed General D Declarations This Display Code Figure 12 5 ThisDisplay Code Window ThisDisplay contains two combo boxes at the top The top left combo box allows select items like General GwxDisplay The top right combo box shows events for the left combo selection For example the GwxDisplay item has events like DisplayLoad DisplayUnload and others Using Visual Basic for Applications VBA 12 19 Creating a Macro To create a macro 1 Create a symbol 2 On the Tools menu select Macros gt Create Macros The VBA Script Wizard dialog box appears Figure 12 6 YEA Script Wizard x Script Name OK Module Ed T Insert code to the script to parse parameters Help dii The delimitier is commatspacel Parameters IT Insert also a form please Form Mote The Script Wizard will add a speched module and possibly a form and will generate a script m VBA The Wizard will also insert the name of the script and parameters to the first line of custom data of current object as neccessary Figure 12 6 VBA Script Wizard Dialog Box 3 Fill in the parameters using Table 12 4 12 20 Advanced User s Table 12 4 VBA Script Wizard Dialog Box Parameters Parameter Script Name Module Insert code to the script to parse parameters Parameters Insert also a form pleas
110. b Parameters Parameter Description Show Needle If checked the gauge has a needle Fill Color Determines the color of the needle Shadow Determines the color of the shadow of the needle Edge Color Determines the color of the edge of the needle Edge Style Determines the style of the edge of the needle thin line medium line thick line etched bump raised sunken or no edge Needle Width Configures the width of the needle small medium or large Needle Length Configures the length of the needle small medium or large GWxXGauge ActiveX Control 15 13 Editing Value Parameters To edit value parameters 1 Double click on the GWXGauge ActiveX control The GW xXGauge ActiveX Properties dialog box appears 2 Select the Value tab Figure 15 9 ICONICS GWAG auge Activex Properties Scale Scales Forts SliderDial Warning ones Or rrr ie General Background Caption Bar Needle Value i Show Current value Iw Data Entry Value Format Jonn Testr Edge Color M Fill Color Edge Style Sunkern T Cancel op Help Figure 15 9 GWXGauge ActiveX Properties Dialog Box Value Tab 3 Modify the parameters using Table 15 8 Table 15 8 Value Tab Parameters Parameter Description Show Current Value If checked the current value of the tag is displayed in a box at the bottom of the gauge Data Entry If checked user may type in new data values into the box when in R
111. bject has all the properties and methods of Gwx Visible plus the additional method described below Method IDispatch GetOLEObject Gets the actual OLE object wrapped by GwxOleObject GwxEllipse has all the properties and methods of Gwx Visible GwxLine has all the properties and methods of Gwx Visible GwxBitmap has all the properties and methods of Gwx Visible GwxMetafile has all the properties and methods of Gwx Visible A 22 Appendix GwxButton GwxDynamic GwxButton has all the properties and methods of GwxVisible and GwxText GwxDynamic is the object type from which dynamic M Graphics objects size dynamic location dynamic etc are derived In other words all dynamic M Graphics objects have the properties and methods of GwxDynamic Properties 1 BSTR DataSource The primary data source for the dynamic object DataSource 1s a string which represents an OPC tag name an expression a constant value or an M Graphics local variable 2 Boolean RangeOverride Gets sets range override status When False M Graphics will use the ranges associated with the primary DataSource When True M Graphics will use the ranges defined in the HighRange and LowRange properties This property is only used for dynamics based on an analog data source GwxSize GwxLocation GwxRotation GwxAnalogColor GwxAnalogSelector GwxProcessPoint it is ignored for dynamics that are based on digital connections 3 BSTR HighRange Re
112. bjects Introduction This chapter explains how to create and configure objects to use in M Graphics displays This chapter describes how to January 2001 Johnson Controls Inc draw a line draw a segmented line draw a rectangle square draw an ellipse circle insert text define text font draw an arc define line style define line width fill an object with color import bitmaps import metafiles import symbols export a metafile freeze an object insert an object Code No LIT 6440050 5 2 Operator s Guide Key Concepts Configure Mode Configure mode is where you design displays In this mode create static and dynamic objects and set general display properties Draw Functions The Draw functions create display objects using various drawing tools The Draw functions are located in the Draw menu and the Draw toolbar M Graphics Symbols The main purpose of the Symbol Library is to preview and import previously stored M Graphics symbols back into M Graphics Refer to Appendix A OLE Automation Reference Appendix B DIN Symbol Library Appendix C French Symbol Library and Appendix D Johnson Controls Symbol Library in this manual for examples of symbols included in the Symbol Library Personal symbols may be saved to the Symbol Library for future use Insert Object This function inserts and embeds an OLE object such as a chart or an equation in the current display The application in which the object was
113. ble The following example rotates a rectangle named Square 45 degrees from horizontal This function takes the name of a dynamic object in the display and reports back the dynamic object associated with that name A dynamic object is not a physical observable object but an abstraction for the operation performed on a visible object i e Hide Rotation Size Once the dynamic object is stored in a variable you can change its properties The following example changes the data source of an M Graphics Hide object to zero hiding the visible object associated with the dynamic object This function selects an object based on the order in which visible objects on the screen were created The first visible object put on the screen has an index of 0 This function is useful for iterating through all the objects in a display The following code turns the first object created to green and the second to red Each M Graphics symbol has its own index that keeps track of the objects within it The GetVisibleObjectFromindex method when appended to the name of a symbol finds the visible object within the symbol with the specified index This function is useful for iterating through all objects in a symbol The following example turns the third visible object in a symbol named sym to green Finds a visible object within a symbol by the object name specified in M Graphics Every time a dynamic object is assigned to a unique visibl
114. ble click on the TWX View32 control The TWXView32 ActiveX Properties dialog box appears 2 Select the Time tab Figure 14 12 TWXView32 ActiveX Properties General Fonts Workspace Grids Ranges Details ners Rates Pens Settings About Info Style Colors Border Sunken M Fill Color Options Rectangle el Text Color Date MMWDD YY gt Format v Show Date Size Normal Show Millisecs tw properties time Figure 14 12 TWXView32 ActiveX Properties Dialog Box Time Tab 3 Modify the parameters using Table 14 17 Table 14 17 Time Tab Parameters Parameter Description Determines the type of border bumped etched raised or sunken Options Determines time placement bottom bottom left bottom right left rectangle right top top left or top right Date Format Determines appearance of dates MM DD YY or DD MMIYY Describes the size of the entire size section large normal or small Fill Color Determines fill color Text Color Determines text color Show Date Hides shows date Show Millisecs Hides shows milliseconds TWxXView32 ActiveX Control 14 27 Editing Rate Parameters To edit rate parameters 1 Double click on the TWX View32 control The TWX View32 ActiveX Properties dialog box appears 2 Select the Rate tab Figure 14 13 TWXView22 ActiveX Properties General Fonts Workspace Grids Ranges Details Time Rates Pens Settings About Info D
115. by calling this function again for the same visible object Returns the newly created GwxDigitalColor object on success Null if the operation failed See also GwxDigitalColor GwxDigitalColorInfo and GwxDynamic Available only in Configure mode OLE Automation Reference A 13 64 IDispatch CreatePickDynamic BSTR visibleObjectName BSTR dynamicObjectName GWXPICKACTION pickAction GWXBUTTONTYPE pickType GWXEXECUTIONTRIGGER executionTrigger GWXMOUSEBUTTON mouseButton Boolean initiallySelected BSTR groupName BSTR fileName Boolean modal Boolean center BSTR valuel BSTR value2 BSTR value3 Creates a GwxPick object with the specified attributes and attaches it to the visible object with the specified object name Valid values for GWXPICKACTION are e PickLoadDisplay 0 e PickDragDropLoad e PickPopupWindow 2 e PickDownloadValue 3 e PickToggleValue 4 e PickLaunchApp e PickClose e PickRunScript Valid values for GWXBUTTONTYPE are e ButtonNormal e ButtonCheck e ButtonRadio Valid values for GWXEXECUTIONTRIGGER are e TriggerOnDown e TriggerWhileDown 2 e TriggerOnDnWhileDn 3 e TriggerOnUp 4 e TriggerOnDnOnUp 5 e TriggerWhileDnOnUp 6 e TriggerOnDnWhileDnOnUp 7 Valid values for GWXMOUSEBUTTON are e MouseButtonLeft 0 e MouseButtonMiddle e MouseButtonRight 2 A 14 Appendix 65 66 67 68 Depending upon the value of pickAction some parameters may be ignored by M
116. caption parameters 1 Double click on the GWXSlider ActiveX control The GWXSlider ActiveX Properties dialog box appears 2 Select the Caption tab Figure 17 10 ICONICS GWSlider Active Properties General l Slider Slow Spin Buttons Fast Spin Buttons Scale Background 7 Caption Value Fonts M Show Main Caption IHC Slider Text Color bi W Shadow Color Foszitior Top Tooltip IHC Slider Cancel Ampy Help Figure 17 10 GWXSlider ActiveX Properties Dialog Box Caption Tab 3 Modify the parameters using Table 17 9 Table 17 9 Caption Tab Parameters Parameter Description Show Main Caption If checked the text entered underneath appears as the title of the slider Text Color Allows user to select a color for the text of the slider Shadow Color If checked allows user to select a color for the shadow of the caption text Position Determines the position of the caption left right top or bottom ToolTip Allows user to enter a word phrase or message to appear as a ToolTip to the user GWXSlider ActiveX Control 17 17 Editing Value Parameters To edit value parameters 1 Double click on the GWXSlider ActiveX control The GWXSlider ActiveX Properties dialog box appears 2 Select the Value tab Figure 17 11 ICONICS GW Slider Actives Properties General Slider Slow Spin Buttona Fast Spin Buttons Scale Background Caption 7 Value Fonts lM
117. ck on another object then choose Paste Visible Properties from the pop up menu to quickly give objects a similar look and feel fill color gradient line style Use templates to facilitate a common look and feel across an entire set of displays When you update the entire project only the template requires the updates G 6 Guidelines and Recommendations for Better Graphics Performance with Integrated N1 Networks Detailed Procedures Changing the Maximum Update Rate To change the Maximum Update Rate 1 On the Format menu select Application Preferences The Application Preferences Dialog Box appears 2 Select the Runtime tab Figure G 1 Application Preferences General Window Runtime Grid Load Tabs ToolTips Event Log Disabled Object Colors h Show Alternate Colors When Object i Disabled Fill Color es Line Color E Shadow Color E Disable Input Controls When MW Read Only Data MW Security Write Denied Runtime Focus Highlights h Show Hand Cursor h Show Focus Rectangle FillColor E Border Color E Point Fail Options h Show Alternate Colors On Point Failure Fill Color E Line Color P Shadow Color hd Point Fail Character Maximum Update Hate UU milizeconds Keyboard Number Pad Use for all Data Entries Keyboard ediurmn Number Pad Medium T Show Ranges Always start in Runtime Mode Suppress Save Change
118. com Milwaukee WI 53201 Printed in U S A M Graphic s Users Manual A 1 Appendix A OLE Automation Reference Introduction OLE automation is used to access properties and methods of objects in M Graphics January 2001 Johnson Controls Inc Code No LIT 6440190 A 2 Appendix Key Concepts Properties and Methods Properties are used to reference attributes 1f an object for example M Graphics display has a BackgroundColor property Methods are used to make the object perform an action for example a display has a FileOpen method which loads a new display Properties and methods can be called from Visual Basic scripts or from C programs The user can access the methods and properties of M Graphics objects to create new customized behavior for those objects There are numerous object types in M Graphics each with its own methods and properties This chapter describes in detail the methods and properties for the object types exposed by M Graphics Custom Configuration Every tab in the Property Inspector has a Custom button The Pick Dynamic action Launch Application brings up the OWSExec function for Metasys commands The user programs the custom configuration utility which 1s tied to the button Clicking this button creates an Automation object which has a certain program ID ProgID By default the ProgID is IcoCustom Configure This ProgID may be overridden by setting an alternative ProgID in the Windows r
119. created becomes active on the screen Insert object also allows you to insert an ActiveX control into the current display The property sheet for that ActiveX control is automatically opened after inserting the ActiveX control Color Palette The Color Palette defines the color of the object s background line or fill Figure 5 1 Color Palette CPalette Figure 5 1 Color Palette Creating Objects 5 3 Color Dialog Box Double clicking on the Color Palette displays the Color dialog box Figure 5 2 zix 4 Color Basic colors a TTT VI II M E Beine ston Calore gt gt ColorSalid um Gan Blue 255 Cancel Add to Custom Colors Figure 5 2 Color Dialog Box Choose from a range of colors and patterns in the color spectrum on the right Add a custom color or a textured color by clicking the Add to Custom Colors button Right clicking the Color Palette displays a menu which provides options for the size of the Color Palette dialog box eyedropper and resetting default colors 5 4 Operator s Guide Wildcards in Find Dialog Box Wildcard characters and can be used in Find What string Character can be used to match a group of characters Character can be used instead of one character Display all objects from current scope by choosing the Type Object Name and entering an asterisk to the Find What combo Select Handle Color Definitions Text Rotation
120. cription PreAnimateLayer BSTR layerName Fired before data for the layer is requested PostAnimateLayer BSTR layerName Fired after data for the layer has been requested PreDeanimateLayer BSTR layerName Fired before data for the layer is released PostDeanimateLayer BSTR layerName Fired after data for the layer has been requested Note For more information on Layers refer to the Arranging Objects chapter Unique Object Names Sometimes it is desired to access the same objects in all duplicates clones of the desired symbol in the same way This technique is useful for VBA Wizards that have a macro behind symbol This macro is shared by all duplicates of the symbol and can be run on any of these duplicates To allow this feature M Graphics supports partial names for objects in symbols The partial name is a name that ends with an underscore e g MyEllipse_ The duplicates of MyEllipse_ are then MyEllipse_1 MyEllipse_2 What is important is the symbol method GetVisibleObjectFromS ymbol partialName which accepts this partial name and returns the first occurrence of the specified object in specified symbol Additional Information For VBA programming working with the modules and forms and customizing of the VBA Editor refer to Microsoft Visual Basic 5 0 Programmer s Guide or documentation on VBA and the help file that comes with VBA You can open it from the VBA Editor from the menu bar You can also refer to any V
121. ct For example you can create an object that changes color and size based on values from point connections Types of dynamic connections include action selector and intrinsic Action Dynamics When an Action Dynamic is added to an object that has a gradient the object acts as it would normally The coloration simply contains the gradient fill If the object is given a rotation dynamic the shading of the gradient changes in areas For example as the object rotates past the X axis the shading flips sides of the object Several action dynamics are discussed in the following sections Size Use the size dynamic to define an object that changes size based on the realtime value of its connected data point The object automatically sizes to scale for incoming data points such that a 100 scale equals the full size of the drawn object Override the size by defining range override values During Runtime the size dynamic resizes the object in proportion to the percentage of the high low range of the connected data point Use the size dynamic for bar graphs liquid levels and thermometer mercury Location Slider The location dynamic changes the location of an object based on the value of a data point During Runtime mode the object moves within a specified distance horizontally vertically diagonally or along a specified path based on the value of the connected data point The slider dynamic emulates a mechanical slider con
122. ct Ei E3 iste Create New CONICS Awabeni Actives JUNI 3 Away eu Cancel C Create from File HCONICS GWG auge Actyer ICONICS Walder Actves ICONICS Gwis Swich Active ICONICS Gwis Vessel Activer ICONICS GWeviews Actyves Add Control Inserts a new CONICS GW Gauge Actives object into your document f Create Control Result Figure 15 2 Insert Object Dialog Box 2 Select Create Control and ICONICS GWXGauge ActiveX for the object type 3 Click OK A GWXGauge ActiveX control is added to the display Figure 15 3 Note As a shortcut insert a GWXGauge ActiveX control by clicking on the T icon in the M Graphics ActiveX toolbar 15 6 Controls Display M Graphics by Johnson Controls Je ito m Figure 15 3 GWXGauge ActiveX in M Graphics Display GWxXGauge ActiveX Control 15 7 Editing General Parameters To edit general parameters l Double click on the GWXGauge ActiveX control The GWXGauge ActiveX Properties dialog box appears Figure 15 4 ICONICS GWAG auge Actives Properties Scale Scales Fonts SliderDial Warning ones ge Genergd Background Caption Dar Needle Value Data Source afwsim ramp float Tage Range Override Lou Range Ze High Range Ze h Auto Gtart Runtime Mode a a E Update Rate g milliseconds Gauge Type Vertical ll stent etiale peed W Gradients Length Factor Dm End ngle BE About Cancel
123. d then OPC Data Access This expands to give you a listing of OPC Data Access servers Figure 10 6 Table 10 7 explains the OPC Universal Tag Browser fields 7 OPC Universal Tag Browser tem Id Filter Cancel Li My Computer z E 28 Data Access Pa Description Sp JCBNOPC 2 FU Display Details Ef JCNTDRLC TU et hy DISPLAY _ Se Add Hanen ERR PNI DISPLAY OV SEH G KE SE Hi OBJECT Add ltem Ca l A s o x Ge SE P Object Type HE UME Ly ZO Present Value Hate GE HAMM 24 Quality Remove All h e LT S Pa Send Command b Bey PHT UNITS Help Item ID Name Debug Figure 10 6 OPC Universal Tag Browser Dialog Box Establishing Data Source Connections 10 15 Table 10 7 Areas of the OPC Universal Tag Browser Areas of the Description OPC Universal Tag Browser Item ID Shows the full Tag name A list of previously selected points is available in the drop down list Filter Sends a filter to the OPC server Tag Name Displays the full Tag name in Item ID box if you double click or highlight Tag Names list Refresh Displays updated network information Details Displays information about specific item Add Branch Allows an additional branch to be added to the tree diagram Add Item Allows an additional item to be added Remove Allows selected item to be removed Remove All Allows everything in the Tag Name to be deleted Debug Debugs selected Tag when checked 2 Navigate the tree until the
124. dd a hide dynamic add a color dynamic add an analog color dynamic add a flash dynamic add a pick dynamic add a digital selector dynamic add an analog selector dynamic add an animator dynamic add time date create a Process Point Data Entry PPT DE create a pushbutton create a checkbox create a radio button create a display button June 18 2004 Johnson Controls Inc 11 1 11 2 Advanced User s Key Concepts Gradient Fill Feature The Gradient Fill feature supports the display background rectangles and rounded rectangles ellipses pies and chords lines and text back fill Gncluding Process Point PPT buttons and timedates To access this feature insert one of the items mentioned above and double click to open the Property Inspector Gradient Configuration Features Object colors may be changed from the Configure Gradient dialog box Figure 11 1 Clicking on the desired color opens the Color Palette To reverse the color when using both single and two color gradients check the Reverse Colors checkbox on the Configure Gradient dialog box Configure Gradient E Brightness ST 110 Color 1 IT Color 3 IT Reverse Colors Style Horizontal minara reli fi E Offset LS 1 UU e Detail steps 25 Quick Set fia e sF i ET EEN sn lm Figure 11 1 Configure Gradient Dialog Box Gradient Styles Kl Adding Dynamics 11 3 There are three different gradient styles
125. dialog box fields are described in Table 14 1 TWXView32 ActiveX Control 14 7 PHAY ew Activex Properties Details Time Rates Feng Settings General Fonts Workspace Grids Ranges annsee eu KEERRERKKKEERK KEREN EN KEEN RK Viewer Title Trend Viewer About Plot Type Time Plot sl Configuration File Filename ES Nor Assigned Save Ag M URL Path _Saveds _ Mot Assigned Cancel Apply Help Figure 14 3 TWXView32 ActiveX Properties Dialog Box Table 14 1 TWXView32 ActiveX Properties Dialog Box Tabs Properties Page Description General Default property page which handles title file selection web configuration plotting style Fonts Determines font The TWXView32 maintains four separate fonts title ranges details time font Workspace Configures various aspects of the trend display such as showing range information signal information etc Grids Manages the Grid Configuration for the trend display Ranges Determines the ranges for the trend display Depending on the selected plotting type some options may or may not be enabled Configure the number of visible pen ranges to be displayed Details Manages the detail display information area and enabled choices closely match the selected plotting type Configures the number of visible pen details to display Time Configures the style of the time display inside the trend Determines visible pen details Rates
126. dimensions Determines if the slider appears to be light sourced Displays the available slider types in a drop down menu vertical or horizontal Determines how fast the system updates the data being displayed through the slider in milliseconds Determines the length vertical or horizontal of the slider Displays the About information GWXSlider ActiveX Control 17 9 Editing Slider Parameters To edit slider parameters 1 Double click on the GWXSlider ActiveX control The GWXSlider ActiveX Properties dialog box appears 2 Select the Slider tab Figure 17 5 ICONICS GWA Slider Activex Properties E4 General der Slow Spin Buttons Fast Spin Buttons l W Show Slider Knob W Track Curent alue Fill Color Edge Color E T Continuous Update Deters fo Edge Style Fiaised Slider Track M Fill Color Edge Color h Wide Track Edge Style Sunken do Track Control Fast Spin Increment Repeat 200 Scale Background Caption Value Forts Cancel Apply Help Figure 17 5 GWXSlider ActiveX Properties Dialog Box Slider Tab 3 Modify the parameters using Table 17 4 17 10 Controls Table 17 4 Slider Tab Parameters Parameters Show Slider Track Current Value Continuous Update Detents Slider Track Knob Fill Color Wide Track Edge Color Edge Style Track Control Repeat Fill Color Edge Color Edge Style Description If checked the s
127. display which runs Visual Basic for Applications VBA ina standard point object or ina point dynamic not properly mapped during alias definition Multiple VBA Option Explicit statements appear in graphic files with VBA or duplicate VBA codes appear The graphic shows a compile error in VBA when running This occurs after templates have been edited and updated in the graphics Solution The graphic contains a corrupted point object Find this object and delete it To delete the corrupted object from the display 1 Select Edit gt Find and set the Type to Text Label 2 For example if lt lt N1 CSData S gt gt Present_Value is the corrupted information in the Find What field paste lt lt N1 CSData S gt gt Present_Value 3 Click Apply 4 Select the one object that appears in the displayed tree diagram 5 Click Show Selection In the top left corner the blue handles of the corrupted object appear 6 Click Close 7 Click Delete 8 Click Save As to save the display under a different name 9 Exit M Graphics 10 Restart M Graphics 11 Load the display in Runtime mode After editing or updating templates delete any multiple Option Explicit statements using the VBA Editor This problem is fixed at M Web Release 2 0 M3 Workstation Release 2 0 or M5 Workstation Release 1 1 with M Graphics Release 3 0 Earlier files with existing problems need to be edited to remove redundant code lines after upgradin
128. displayed by default across the top of the M Graphics window below the menu bar Use the Main toolbar for basic file and display maintenance Figure 3 2 DESS PEFFER Figure 3 2 Main Toolbar Dynamics Toolbar Use the Dynamics toolbar to make dynamic connections to data points in OPC servers Figure 3 3 Dynamics DToolbar Figure 3 3 Dynamics Toolbar ActiveX Toolbar Use the ActiveX toolbar to insert objects and controls Figure 3 4 me eee i D DE Figure 3 4 ActiveX Toolbar 3 4 Operator s Guide Table 3 1 ActiveX Toolbar ActiveX Toolbar Description Options OLE sai Allows an ActiveX object to be inserted GraphWorxs Allows a graphic to be inserted inside another graphic TrendGraph Allows a TrendGraph ActiveX object to be inserted AlarmWorxs Allows an AlarmWorxs ActiveX object to be inserted Gauge Control Allows a Gauge ActiveX object to be inserted Switch Control Allows a Switch ActiveX object to be inserted Slider Control E E is Ee le Allows a Slider ActiveX object to be inserted Draw Toolbar Use the Draw toolbar for drawing importing and editing objects Figure 3 5 Ih W e g Ald amp Figure 3 5 Draw Toolbar Arrange Toolbar Use the Arrange toolbar for grouping and ungrouping objects for aligning objects for rotating objects and shifting objects in layers Figure 3 6
129. dit menu select Report The Report dialog box appears Figure 6 4 Help Find what ii Advanced lt lt Type Scope Dynamic Tag sl Selection e Subsombal Cancel Match case Ge hole Display Apply Match whole word only Multiple Files _Aabvanced lt lt Options Eipetes Show Zapopchon Report to Notepad Figure 6 4 Report Dialog Box 2 Fill in the fields using Table 6 2 3 Click OK Chapter 7 Arranging Objects Introduction M Graphics User s Manual 7 1 M Graphics provides several features to arrange objects in the display This chapter describes how to group objects ungroup objects reposition objects rotate objects flip objects align objects space objects evenly make objects the same size add layers remove layers duplicate layers edit layer properties set currently active layer January 2001 Johnson Controls Inc Code No LIT 6440070 7 2 Operator s Guide Key Concepts Layers The use of layers in M Graphics is helpful since layers allow the elements in the display to be categorized separating the display into levels of detail through decluttering It is possible to add remove or duplicate a layer as well as edit the layer properties set the active layer set the next layer set the previous layer hide layers above the current layer and hide layers below the current layer Layer Configuration Every M Graphics display starts as a displa
130. diting and Runtime environments These parameters apply to the environment for the current display in M Graphics When a graphic s properties change save the graphic and new standards as Application Preferences Display Configuration Mode Password Passwords may be attached to the configuration of an M Graphics display When the password is defined and entered the Configuration mode of the display is accessible If the incorrect password is entered a warning message occurs and access is denied until the proper password is entered Set Password for Current Display NI Password Confirm coed pe Figure 4 1 Set Password for Current Display Note The display password does not apply to displays opened in Runtime mode When trying to open a password protected display Figure 4 2 appears before the user is able to enter the configuration Enter Password Test od Password Challenge 19638 ome tee Figure 4 2 Enter Password Note The challenge code is not necessary for M Graphics login 4 4 Operator s Guide Procedure Overview Table 4 1 Customizing M Graphics To Do This Customize the Launch of M Graphics and Windows Select a Language Define General Application Preferences Define Window Application Preferences Define Runtime Application Preferences Define Grid Application Preferences Define Load Tabs Application Preferences Define ToolTips Application Pre
131. dow Returns the new popup window s object of type GW Xview32 on success Null on failure void CloseAllIPopupWindows Closes all currently open popup windows Boolean ClosePopupWithTitle BSTR titleSubstring Closes the popup window which has the specified substring as part or all of the text in the popup window s title bar Returns True if the specified popup window was successfully closed False otherwise IDispatch GetOpenPopupWithTitle BSTR titleSubstring Gets the open popup window s object which has the specified substring as part or all of the text in the popup window s title bar The popup window s object is of type GW Xview32 Returns Null if no matching popup window is found Boolean IsRuntimeMode Returns True if M Graphics is currently in Runtime mode False otherwise void StartRuntime Puts M Graphics into Runtime mode A 6 Appendix 30 31 a2 33 34 35 36 37 38 void StopRuntime Takes M Graphics out of Runtime mode into Configure mode Boolean ToggleRuntime Toggles the current operator mode between Configure mode and Runtime mode Returns True if the method put M Graphics into Runtime mode False if the method put M Graphics into Configure mode IDispatch GetVisibleObjectFromName BSTR objectName Gets the visible object with the specified object name The returned object type will be GwxVisible or one of GwxVisible derived object types GwxRect
132. e The scope of local M Graphics variables is confined to the display in which they are defined Typically local variables would be used as values for animation effects 1 e simulated values that do not need to be defined at the system level State Fields State fields refer to the state of a variable Normally state fields are binary values each attached to a string having some type of meaning Figure 10 3 is an example of the State Field Configuration dialog box State Field Configuration ES State Value State String Add Remove Change Clear Al Import Export State Value State String oft on working trying really hard U A 4 Default String Cancel Help Figure 10 3 State Field Configuration Dialog Box Establishing Data Source Connections 10 7 Table 10 2 State Field Configuration Attributes Field State Value State String Add Remove Change Clear All Import Export Default String Simulated Values Description Displays the current value Displays the current string associated with the value Adds state value that appears in State Value box Removes selected state value Changes selected state value Clears all state values on list Displays the Open or Save As dialog box Displays the Open or Save As dialog box Displays the string that appears when state does not have a pre configured string M Graphics includes several predefined local simulation variables These
133. e Form Description Type the name of your script The script name should begin with a character and should contain alphanumeric characters only If there is already a macro or a module of that name choose another name Field Module is always grayed out because the module name is generated automatically based on macro name Check this box to generate extra code in the body of the script subroutine It helps in retrieving and storing parameters from the VBA Wizard object This code uses the GwxTools module to convert parameters to a string named StrPar which is local to your script subroutine Type any string you like You can obtain this string when the macro runs This field is designed to allow custom data specific to a VBA Wizard instance Different instances of the same objects can keep different data Using this field is optional This feature simplifies your code by allowing you to pass values into a macro Check this checkbox if you need a VBA form to be launched from the macro You are allowed to create any number of forms for the VBA Wizard assuming you follow the naming convention If you don t follow the convention the VBA code is not moved with the object when necessary Field Form is always grayed out and generated automatically based on macro name 4 Click OK A VBA Editor starts and the cursor appears in the body of Test subroutine in a module GwxTest_Main 5 Type the code which is run when you double cl
134. e General Background Caption Bar Needle Value Scale Scale2 Fonts Slider Dial Warning Zones Description Allows user to select the tag used as the data source for the gauge Configures gauge appearance within the container Configures the caption for the gauge and the text for the ToolTip Configures the color and style of the bar for a horizontal or vertical gauge Configures the color and style of the needle for a circular gauge Configures the format and style of the text box at the bottom of the gauge Configures the appearance of the interior left or bottom scale on the gauge Configures the appearance of a second interior left or bottom scale on the gauge Determines the font font style size and effects of selected text Configures the appearance of the slider for a horizontal or vertical gauge and dial for a circular gauge Configures the color and percentage for each warning zone Note Specific parameters are discussed in Detailed Procedures 15 4 Controls Procedure Overview Table 15 2 GWXGauge ActiveX Control To Do This Insert a GWXGauge ActiveX Control Edit General Parameters Edit Background Parameters Edit Caption Parameters Edit Bar Parameters Edit Needle Parameters Edit Value Parameters Edit Scale1 Parameters Edit Scale2 Parameters Edit Fonts Parameters Edit Slider Dial Parameters Edit Warning Zones Parameters View About Information Follow These St
135. e bottom and left side of the graphic Holding down the shift key and pressing the arrow keys adjusts the top right side of the object Tab Key Object Selection Use the Tab key to move the selector from one object to another The selector moves around the display in the order the objects were created If the object were put in a particular order the selector would move from the farthest object forward Graphic Libraries The North American Graphics Standardization team has created a small library of sample graphics and symbols The National Standard Graphics library contains pre engineered sample graphics that can be a starting place for building graphics Standard graphics can be added to The Advisor library at any time by uploading them to the M Graphics page For more information refer to the Advisor Express Exchange Web sites Information is located at The Advisor gt Engineering Technical section under Conferences and Field Support Center Tips and Hints F 7 Procedure Overview Table F 2 Tips and Hints To Do This Add Graphic Hot Links to Other Screens Add Fan Rotation to a Graphic Add Command Operation Box to Object when Clicking Left or Right Mouse Button Add Focus Window Screen to Object when Clicking Left or Right Mouse Button Create a Slider Bar Add On Off Binary Commands to Pushbuttons Add Override Binary Commands to Pushbuttons Add the Auto Binary Command to a Pushbutton Note Follow
136. e container If unchecked allows user to select a color for the background of the switch which has a border around it Show Back Face If checked the switch has an edge border Fill Color Allows user to select a color for the switch Default is gray Edge Style Allows user to select a style for the edge of the switch thin line medium line thick line etched bump raised sunken or no edge 16 10 Controls Editing Caption Parameters To edit caption parameters 1 Double click on the GWXSwitch ActiveX control The GW xXSwitch ActiveX Properties dialog box appears 2 Select the Caption tab Figure 16 6 ICONICS GWS witch Activex Properties Labels Fonts M Show Main Caption JICONICS Text Color mm W Shadow Color Tooltip IHC Switch Figure 16 6 GWXSwitch ActiveX Properties Dialog Box Caption Tab 3 Modify the parameters using Table 16 5 Table 16 5 Caption Tab Parameters Parameter Description Show Main Caption If checked the text entered underneath appears as the title of the switch Text Color Allows user to select a color for the text of the switch Shadow Color If checked allows the user to select a color for the shadow of the caption text ToolTip Allows user to enter a word phrase or message to appear as a ToolTip to the user GWxXSwitch ActiveX Control 16 11 Editing Labels Parameters To edit labels parameters 1 Double click on the GWXSwitch Activ
137. e object it is assigned an index The first dynamic object assigned is given an index of zero Since one visible object can be associated with many dynamic objects this function provides a useful way of manipulating dynamic objects The following code takes the second dynamic object associated with a rectangle named rect and changes its low range to 10 This function takes the name of a dynamic object associated with a visible object and allows you to represent the dynamic object with a variable 12 11 Example Dim obj As GwxRectangle Set obj ThisDisplay GetVisible ObjectFromName Square obj Angle 45 Dim obj As GwxHide Set obj ThisDisplay GetDynamic ObjectFromName hd obj dataSource 0 Dim obj1 As Object Dim obj2 As Object Set obj1 ThisDisplay GetVisibleObject FromIndex 0 Set obj2 ThisDisplay GetVisibleObject Fromindex 1 obj1 fillColor RGB O 255 0 obj2 fillColor RGB 255 0 0 Dim sym1 As GwxSymbol Dim obj As Object Set sym1 GetVisibleObjectFromName sym Set obj sym1 GetVisibleObject Fromlindex 2 obj fillColor RGB 0 255 0 Note that the third object has index of 2 First has index 0 Dim o_Vis As GwxRectangle Dim o_Dyn As Object Seto Vis ThisDisplay GetVisible ObjectFromName rect Set o Dyn o Vis GetDynamic ObjectFromIndex 1 o _dyn lowRange 10 12 12 Advanced User s Table 12 2 Additional VBA Events for Layering Event Des
138. e to ranges Dispatch interface to time settings Dispatch interface to details Background color Trend Area color Title color Determines if the main title is displayed Default True Determines if the ranges field is displayed Default True Determines if the details field is displayed Default True Properties Cont Boolean ShowTimelinfo Boolean MainToolbar BSTR PlotType BSTR BorderEdge BSTR BorderOptions LPFONTDISP TimeFont LPFONTDISP DetailsFont LPFONTDISP MainFont LPFONTDISP RangesFont short Appearance short BorderStyle Boolean FreezeMode short NumberOfPens BSTR FileName Boolean URLPathUsed BSTR URLPathName BSTR StatisticsFile Boolean StatFileAppend Boolean GlobalRanges Boolean ShiftGrids double StartUp short CursorStep Boolean RestoreRanges long LanguagelD Boolean FillBackColor TWXView32 ActiveX Control 14 9 Description Determines if the time field is displayed Default True Enables disables button toolbar Default True Determines PlotType Determines trend area settings Determines trend area settings Dispatch interface to the time font Dispatch interface to the detail font Dispatch interface to the main title font Dispatch interface to the range font Determines TWXView32 ActiveX appearance Determines TWXView32 ActiveX appearance Enables disables Freeze mode Returns number of currently Configured pens Gets sets file name for saving configuration data En
139. eX control The GWxXSwitch ActiveX Properties dialog box appears 2 Select the Labels tab Figure 16 7 ICONICS GW Switch Activex Properties I Show Labels Edge Style Sunken sl Un Label UI Label g OFF Fill Color When Or C Fill Color When Orr mi Fill Color when Off E Fill Color When Off Ri Text Color Text Color E Cancel Glo Help Figure 16 7 GWXSwitch ActiveX Properties Dialog Box Labels Tab 3 Modify the parameters using Table 16 6 Table 16 6 Labels Tab Parameters Parameter Description Show Labels If checked the switch has labels Edge Style Allows user to select a style for the edge of the labels thin line medium line thick line etched bump raised sunken or no edge On Label Allows user to enter the text for the on label Fill Color Determines the color of the on label when the When On switch is on Fill Color Determines the color of the on label when the When Off switch is off Text Color Determines the color of the text for the on label Off Label Allows user to enter the text for the oft label Fill Color Determines the color of the off label when the When On switch is on Fill Color Determines the color of the off label when the When Off switch is off Text Color Determines the color of the text for the off label 16 12 Controls Editing Fonts Parameters To edit fonts parameters 1 Double click o
140. eas 11 42 Chapter 12 Using Visual Basic for Applications VBA 12 1 TET OO UC HOW PIINE EEEE PEE PEE PEIEE eden esse E IA 12 1 EE eege 12 2 WIA E 12 2 WING ONG E 12 2 EE 12 2 Opec Onemied Programimi ee 12 3 Development Using Visual Basic for Applications ccccsecccseeeeseeeeeeeeeeeeeeeneeeens 12 3 VDA ele 12 4 Brent 12 5 M Grapnics VBA PIO 6CE scxsece ccnedcnceddegandsddaninesendewass ssibasenod aaa a a iaa ia aa 12 8 M Graphics Native Display Obiects 12 10 Olalre 02 ee 12 12 elei E el E e EE 12 12 Vue GE 12 13 VBA Wizard Creation Tool Macro WEE 12 15 EE EEN 12 16 Detailed Procedures scientist pstscatenedetetansntgetenassdedansnbaedupsieeatemaneaeteesotasaeea 12 17 Creating and Editing VBA Scripts ccccccccccceeeeeceeeeeeeeeseeeeceeeseeeseesseeeeeessaeeeeeas 12 17 AddNO E Vent R 1016 E 12 17 Displaying the ThisDisplay Module Code 12 18 reatino a Ma ME 12 19 N REAL Lee E 12 21 Stepping a Macro 12 21 PUNADO OMA TO EE 12 22 Table of Contents 7 Cleaning VBA Unused Module 12 22 leie 12 22 TIFOUDICSNOOUNG seroso EEE EEEE ENER A 12 29 Chapter 13 M Graphics ActiveX Control ccscsceeeeeeeeeneeeeneeeeenees 13 1 TTT OO e de e a a N R R EARE ER a E AE A 13 1 KV ee e e E 13 2 M GraphicS ActiveX COMO BE 13 2 Runtime Window Properties Mode nsaennnonnnnennnnennnnernnnnnnnsrrrnnnrnnnrersrnrenerrrsnrenne 13 2 EE 13 3 Detailed e 13 4 Inserting M Graphics ActiveX Control
141. ect 1s found IDispatch GetPointObjectFromName BSTR pointName Gets the data point object with the specified point name The returned object is of type GwxPoint Returns Null if no matching object is found 39 40 41 42 43 44 OLE Automation Reference A 7 Boolean DeleteObject BSTR objectName Deletes the visible object with the specified object name Returns True for success False for failure Available only in Configure mode Boolean DeleteDynamic BSTR objectName Deletes the dynamic object with the specified object name Returns True for success False for failure Available only in Configure mode void DeselectAllObjects Deselects all currently selected visible objects Available only in Configure mode IDispatch CreateEllipse float left float top float width float height Boolean isFilled OLE COLOR fillColor OLE COLOR lineColor long lineWidth GWXLINESTYLE lineStyle Boolean hasShadow OLE COLOR shadowColor GWX3DEDGESTYLE edgeStyle Boolean isHidden BSTR objectName Creates and returns GwxEllipse object with the specified attributes in the current display See also GwxEllipse and GwxVisible Available only in Configure mode IDispatch CreateRectangle float left float top float width float height Boolean isFilled OLE COLOR fillColor OLE COLOR lineColor long lineWidth GWXLINESTYLE lineStyle Boolean hasShadow OLE COLOR shadowColor GWX3DEDGESTYLE edgeStyle Boolean isHidden
142. ed which enables its user interface toolbar To connect a realtime pen to a signal using drag and drop the TWX View32 must be activated and in Runtime mode The drag and drop object is of text type containing a single signal name Functions Not Supported in Runtime The following functions are not supported in Runtime e replacing point names User uses delete add or within the VBA environment uses the Form Load event for replacing point names e changing of plot type of the trend e modifying file name for saving module s data e modifying the interface to the Timesettings object using OLE e modifying X axis of XY plots e modifying file name for saving statistics e modifying preference for global ranges e modifying preference for shifting grids e modifying preference for startup value e modifying preference for restoring range values Runtime TWXView32 Toolbar The buttons toolbar is the Runtime user interface to the ActiveX The toolbar offers the user access to various Runtime TWX View32 ActiveX functions and operations To view the toolbar double right click on TWX View32 during Runtime Disable the toolbar in order to configure trend or to zoom Trend Viewer Eo fics rs fea o gt xs nl al nl ml re tw toolbar Figure 14 1 Runtime TWXView32 Toolbar TWXView32 ActiveX Control 14 5 International Language Support TWX View32 has all of its strings saved in the resource file which can be modified to provide
143. ed in the next chapter The GwxTools module is not available to the user until a VBA Wizard is used Using Visual Basic for Applications VBA 12 9 ThisDisplay Module ThisDisplay represents the current M Graphics display 27 Project Display G3 Gwx32 Objects i A IODE EWALD oE Project Figure 12 1 Project Window with ThisDisplay Module The VBA programmer has full control over the properties and native objects of the current display and can control the rich animation interface of M Graphics The Automation properties and methods are accessible through the ThisDisplay module ThisDisplay is a representation of a current M Graphics display and contains all Automation properties and methods VBA can display Automation methods and properties only if the Automation object is checked in the References dialog box Note M Graphics is checked automatically for every new display Refer to Figure 12 2 12 10 Advanced User s References Project Available References Visual Basic For Applications a OLE Automation Microsoft Forms 2 0 Object Library GraphWorx32 _ Active Setup Control Library rs vn _ ActiveMovie control type library _ ActiveX Conference Control CCrsWop 1 0 Type Library Priority L CFtpWpop 1 0 Type Library C Corel PHOTO PAINT Type Library D L CorelDRAW Type Library _ Direct 1 0 Type Library _ DirectAnimation Library i 1 0 Tvce Librarv E E gt OLE Automation
144. edit the length of a line reposition a line edit the vertices of a segmented line resize a rectangle resize an ellipse resize an arc edit the shape of an arc cut an object copy an object paste an object use Paste Special duplicate an object find an object replace an object report an object January 2001 Johnson Controls Inc Code No LIT 6440060 6 2 Operator s Guide Key Concepts Edit Functions The Edit functions create display objects using various editing tools While editing graphics stay at 100 Zoom to maintain a reference for all graphic files This helps minimize the possibility of creating a graphic that is not sized properly when in the Runtime mode The Edit functions are located in the Edit menu Paste vs Paste Special When pasting objects into M Graphics the Paste Special function is recommended Paste Special is used for pasting objects in a specified format when more than one format is available The ability to paste an object as a bitmap or Metafile or device independent bitmap is available in the Paste Special dialog box The Paste function places a copy of the objects currently in the clipboard into the work area in native form The object remains on the clipboard until it is copied or cut This command is used to insert a copy of the clipboard contents at the insertion point Find vs Replace Functions The Find function operates the result in the display as a selection and it shows the r
145. edure Overview Establishing Data Source Connections 10 11 Table 10 6 Establishing Data Source Connections To Do This Connect to a Data Source Operate the OPC Universal Tag Browser Add a Simulated Variable Edit Expressions Edit Local Variables Create an Alias Edit an Alias Set Runtime Aliases Follow These Steps Select an object in the display On the Dynamics menu select a dynamic to add Enter the data source in the field or click on the OPC Tags button to open the OPC Universal Tag Browser Selecting Expressions from the options of the Tags button to open the Expression Editor may also do this Fill in the remaining dynamic fields Click on My Computer in the OPC Universal Tag Browser Navigate the tree until the point desired is in the list box Click OK From any Property Inspector dialog box click the Tags Menu button Select Simulation Variable Select a simulated value and click OK In the Property Inspector click Expression to open the Edit Expressions dialog box Edit the fields Click OK On the Dynamic menu select Edit Local Variables Edit the fields Click OK Select an object On the Dynamics menu select a dynamic to apply In the Data Source field enter an Alias Edit the Alias Select an object On the Dynamics menu select Edit Aliases Fill in the fields Click OK Click on the Set Aliases button on the Action tab in the Property Inspector Fill in parameters 10 12 Ad
146. efault color definitions of the Color Palette Note The Eyedropper feature can pick up colors from a display to add them to the Color Palette To accomplish this choose the Eyedropper menu item the mouse pointer changes to an eyedropper Click anywhere in the M Graphics window over the color you want to pick Deposit the color in the Color Palette by clicking over the desired color box in the rows of available colors Menus Getting Started 3 7 The following tables describe M Graphics menus and show corresponding toolbar buttons Only select menu options have corresponding toolbar buttons Table 3 2 File Menu File Menu Options New Open Save Save As Print Print Preview Print Setup Recently Used File List Exit Toolbar Button Description Creates a new display Opens a display Saves current display with either tdf or gdf extension Saves current display with a new name or extension Prints current display Displays file before printing Opens Print Setup dialog box with printer options Lists last four files opened in M Graphics Closes M Graphics 3 8 Operator s Guide Table 3 3 Edit Menu Edit Menu Options Undo Redo Cut Copy Paste Delete Paste Special Duplicate Select All Objects Select All Dynamics Delete Selected Dynamics Delete All Dynamics Find Replace Report Update Shared Objects Insert New Object Links Object Prope
147. efault shadow color Displays the default background color Displays the default gradient fill when selected Displays the default line width Displays the default line style Determines the depth of a selected object Determines text font and point size Determines whether a display is a Fixed Scale display where the objects do not change size when the main window is resized or a Scalable Display where objects automatically resize to fit within the main window The Preserve Aspect Ratio option scales the display proportionate to the screen Ss aspect ratio Determines the width and height of the working area world dimensions of the display Searches system for OPC data types and ranges during Configuration of the application Creates a backup file of current display with bak extension If the Query OPC Data Type and Ranges During Configuration box is checked the system looks for OPC Data Types and Ranges during the configuration of the application Defining Window Application Preferences M Graphics application preferences apply only to new displays To define window application preferences 1 On the Format menu select Application Preferences The Application Preferences dialog box appears 2 Select the Window tab Figure 4 6 Customizing M Graphics 4 9 Application Preferences 1_ _ Raised Resizable ei Sunken 5 Figure 4 6 Application Preferences Window Tab Note Some of the wi
148. egistry key Expose the Automation object from a DLL M Graphics uses this dispatch interface of this object to call the method Table A 1 boolean CustomConfigure long hWndParent Dispatch ObjectOne BSTR ObjectOneType IDispatch ObjectTwo BSTR ObjectTwoType Table A 1 Custom Configuration Definitions Object Description hWndParent Parent window handle of Property Inspector ObjectOne Dispatch pointer of the M Graphics object associated with the Gwx32 property page shown ObjectOneType String name of the object type for ObjectOne Note Check the object type to verify the support configuration ObjectTwo Dispatch pointer of the M Graphics display where object belongs ObjectTwoType String name of the object type for ObjectT wo OLE Automation Reference A 3 The Return Value is True if changes were made to the objects passed to the specific method The Return Value is False if no changes were made Custom Command Execution This is one of the options for the Pick Dynamic action in M Graphics Run custom functions and applications using the Custom Command option The custom application must be specified as either an executable EXE or a DLL Expose the Automation object from an EXE The EXE allows multiple instances of this Automation object without launching multiple instances of the application The first time a Pick action is selected as a Custom Command M Graphics creates an Automation object which has a certain ProgI
149. eps In M Graphics on the Edit menu select Insert New Object Select Create Control and ICONICS GWXGauge ActiveX for the object type Click OK Double click on the GWXGauge control Select the General tab Modify the parameters Double click on the GWXGauge control Select the Background tab Modify the parameters Double click on the GWXGauge control Select the Caption tab Modify the parameters Double click on the GWXGauge control Select the Bar tab Modify the parameters Double click on the GWXGauge control Select the Needle tab Modify the parameters Double click on the GWXGauge control Select the Value tab Modify the parameters Double click on the GWXGauge control Select the Scale1 tab Modify the parameters Double click on the GWXGauge control Select the Scale2 tab Modify the parameters Double click on the GWXGauge control Select the Fonts tab Modify the parameters Double click on the GWXGauge control Select the Slider Dial tab Modify the parameters Double click on the GWXGauge control Select the Warning Zones tab Modify the parameters Double click on the GWXGauge control Select the General tab Select the About button GWxXGauge ActiveX Control 15 5 Detailed Procedures Inserting a GWXGauge ActiveX Control To insert a GWXGauge ActiveX control 1 In M Graphics on the Edit menu select Insert New Object The Insert Object dialog box appears Figure 15 2 Insert Obje
150. er gt Remove Layer Select the layer to remove Click OK On the Format menu select Layer gt Duplicate Layer Select the layer to duplicate Click OK On the Format menu select Layers gt Edit Layer Properties Select desired layer Edit layer properties using Table 7 2 Click OK when finished On the Format menu select Layers gt Set Currently Active Layer Select desired layer Click OK Arranging Objects 7 5 Detailed Procedures Grouping Objects To group objects 1 Select objects 2 On the Arrange menu select Group into Symbol Note Individual objects are unable to be edited while grouped Ungrouping Objects To ungroup objects 1 Select a group 2 On the Arrange menu select Ungroup Symbol Repositioning Objects To reposition an object 1 Select an object 2 On the Arrange menu select one of the following bring to front send to back bring forward or send backward Rotating Objects To rotate objects 1 Select an object 2 On the Arrange menu select Free Rotate and click and drag on a handle or Rotate Flip and one of the following rotate left or rotate right Note Text bitmaps and metafiles cannot be rotated Objects that have been free rotated can also be flipped Flipping Objects To flip objects 1 Select an object 2 On the Arrange menu select Rotate Flip and choose either flip horizontal or flip vertical 7 6 Operator s Guide Aligning Objects To align objects
151. erty Inspector Drag Moves objects or selects multiple objects Drag Object Handles Moves stretches and resizes objects Drag from M Graphics to Becomes an icon and can be dragged back as Desktop the original object Shift while Stretching Object Maintains size of object in proportion Ctrl while Stretching Object Resizes from center of object Ctrl Drag Copies and duplicates within the display Shift Left click Selects deselects multiple objects one by one Shift Right click Edits text arc line or symbol objects Note If objects are selected use cursor keys to move by one pixel The Runtime mode activates all bindings and dynamics The Runtime environment functions according to how you configure the Runtime parameters in M Graphics Configure mode During Runtime you can load the screen print the screen close windows exit from the application get help and invoke the Configure mode Functions not supported in Runtime mode e replacing point names user should use delete add or within the VBA environment use the Form Load event for replacing point names e changing of plot type of the trend e modifying file name for saving module s data e getting through OLE the interface to the Timesettings object e modifying X axis of XY plots e modifying filename for saving statistics e modifying preference for global ranges e modifying preference for shifting grids e modifying preference for startup value e modify
152. es for Supporting Objects Table 14 4 Title Object Properties Properties BSTR TitleText Boolean ShowrTitle Description The main title of the viewer Activex Determines whether or not the main title is displayed Default True Table 14 5 TimeSettings Object Properties Properties BSTR BorderEdge BSTR BorderOptions BSTR DateFormat OLE_COLOR TextColor long DataUpdatePeriod long DataTotalPeriod long Samples OLE _COLOR FillColor long DataDisplayMult Boolean ShowDate BSTR Size Boolean ShowTimelnfo Boolean ShowMilliSecs DataUpdatePeriod DataTotalPeriod Samples Description Visual appearance of time display Visual appearance of time display American European Color for text displayed Data collection rate Total time period of data Number of samples to display Color for filling time area Gets sets drawing intervals relative to data collection Determines if date information is displayed in the Viewer s time field Default True Size for time display It can be large normal small Determines if the time field is displayed Default True Shows millisecond divisions on time axis Default False Set operations goes into effect the next time the TWXView32 has entered Runtime 14 12 Controls Table 14 6 Ranges Object Properties Properties double High double Low BSTR BorderEdge BSTR BorderOptions BSTR Position BSTR NumberFormat Boolean ShowRanges OLE COLOR FillColor OLE COLOR
153. esult as object hierarchy in the tree view information Both functions display the same dialog box options Note The Replace function replaces the Find What strings with Replace With string Procedure Overview Table 6 1 Editing Objects To Do This Edit the Length of a Line Reposition a Line Edit the Vertices ofa Segmented Line Resize a Rectangle Resize an Ellipse Resize an Arc Edit the Shape of an Arc Cut an Object Copy an Object Paste an Object Use Paste Special Duplicate an Object Find an Object Replace an Object Report an Object Editing Objects 6 3 Follow These Steps Select the line Press the left mouse button on a square handle of the line Drag the mouse to extend the line and release the mouse button Select the line Drag to a new position and release the mouse button Select the line Press Shift and right click Edit the midpoints and vertices of the segments Select the rectangle left click on a square handle and drag to resize Use the Shift key to maintain the Aspect Ratio of the rectangle while resizing Select the ellipse Left click on a square handle and drag it to resize the ellipse Select the arc Press the left mouse button on a square handle drag it to reshape the arc and release Right click on the arc to display the Format menu and choose Edit Arc Select the object to cut On the Edit menu select Cut Select an object On the Edit menu select Copy
154. fault Open the GwxDisplay module from the VBA Editor 4 Select the PostRuntimeStart event from the list in the right combo box 5 Insert VBA code as shown in the figure below to the body of the subroutine in the subroutine header Figure 12 8 2 Display ThisDisplay Code GwxDisplay PostRuntimeStart X Private Sub GwxDisplay _PostRuntimeStart Beep MsgBox Runtime started End Sub Figure 12 8 PostRuntimeStart Event Example Using Visual Basic for Applications VBA 12 23 Switch to M Graphics by closing the VBA Editor Test the event by clicking on Runtime on the menu bar You hear a beep and a message box with a message Runtime started appears M Graphics Native Display Objects Example Write code for changing the color of ellipse M Graphics native object during Runtime l 2 E Load an existing display or create a new M Graphics display Draw an ellipse by picking Ellipse from the Draw toolbar Name the Ellipse Object for this display a Double click on the Ellipse The Property Inspector box opens b Type the name MyEllipse in the object name field and then click on OK Open VBA Editor Select the ThisDisplay module Select the GwxDisplay module in left combo box of ThisDisplay module Select the PostRuntimeStart event from the list in the right combo box 12 24 Advanced User s 8 The subroutine header is automatically inserted into the current module Insert
155. ferences Copy Application Preferences to Display Properties Save Display Properties as Application Preferences Reset Default Application Preferences and Display Properties Define a Configuration Mode Password Follow These Steps Right click Start and select Open Double click on the Programs folder Double click on the Johnson Controls folder Right click the M Graphics icon and select Properties Click the Shortcut tab and enter the appropriate command line options at the end of the Target field From the View menu select Select Language Define parameters Click OK On the Format menu select Application Preferences Select the General tab Modify the fields and click OK On the Format menu select Application Preferences Select the Window tab Modify the fields and click OK On the Format menu select Application Preferences Select the Runtime tab Modify the fields and click OK On the Format menu select Application Preferences Select the Grid tab Modify the fields and click OK On the Format menu select Application Preferences Select the Load Tabs tab Modify the fields and click OK On the Format menu select Application Preferences Select the ToolTips tab Modify the fields and click OK On the Format menu select Apply Preferences to Properties Select preference categories Click OK On the Format menu select Save Properties as Preferences Select properties categories Click OK On
156. for drag and drop operation Opens Expression Editor Aliases Local Variables or Simulation Variables dialog box Adds the string currently in the data source edit control to the list of data sources Changes existing data connections The currently selected item in the data source list box is changed to the string currently in the data source edit control Removes existing data connections from the data source list box Varies depending on which source string is selected Changes the object s fill color Changes the object s border line color Changes the object s shadow color Changes the object s color when the connected data point is true logical 1 or false logical 0 Deletes this dynamic Identifies the object for OLE automation Describes the object and determines the ToolTips displayed Allows user to enter data 11 22 Advanced User s Adding an Analog Color Dynamic To add an analog color dynamic 1 Select the object 2 On the Dynamics menu select Actions gt Analog Color The Property Inspector dialog box appears with the Analog Color tab Figure 11 8 Property Inspector gt Ellipse Rotation Analog Color DataSource f Drag Drop Data Source UPC Tage Tagg Menu W Fill Start Color B End Color D hd Line Start Color a End Color Shadow Start Color E End alo E Default Color wer Range Override TC Above Range Lavy ope f T Below Range Hirt pel Delete
157. g usually a short name to represent another string usually part or all of a Tag name Aliases are helpful when a symbol appears in several displays with different Tags When including an Alias name in a data connection the Alias name should be surrounded by the special tokens lt lt and gt gt These tokens are used to identify the beginning and end of the Alias name For example lt lt tank gt gt out In this case tank is the Alias name If JC CFOPC SupplyFan is used to replace the Alias the tag becomes JC CFOPC SupplyFan out Object Level Aliases Objects that utilize data connections can maintain their own Alias table Each Dynamic object can have an Alias table This Alias table is automatically created when you enter a data source string containing Alias names The table is automatically populated with entries for each Alias name used in the data connections of the Dynamic object By default the Alias replacement string is set equal to the Alias name If the Alias name is equal to the Alias replacement string the Alias will not be resolved You are only allowed to change the replacement strings in object level Alias tables The Alias names in the table are controlled by the Alias names used in the data source strings 10 10 Advanced User s To edit object level Aliases in M Graphics select one or more visible objects prior to executing the edit Alias table functionality All the Alias tables for the dyna
158. g name dataSource See GwxPoint for possible values of GWXDATATY PE A 10 Appendix 57 IDispatch CreateSizeDynamic BSTR visibleObjectName BSTR dynamicObjectName GWXSIZEDYNTYPE sizeType Boolean clip float startSize float endSize Creates a GwxSize object with the specified attributes and attaches it to the visible object with the specified object name The parameters startSize and endSize are percentage values in the range of 0 0 to 1 0 Valid values for GWXSIZEDYNTYPE are e SizeLeft 0 e SizeRight e SizeUp 2 e SizeDown 3 e SizeUpLett 4 e SizeUpRight 5 e SizeDownLeft 6 e SizeDownRight 7 e SizeLeftRight 8 e SizeUpDown 9 e SizeLeftRightBias 10 e SizeUpDownBias 11 e SizeAllFour 12 e SizeLeftRightUp 13 e SizeLeftRightDown 14 e SizeUpDownLeft 15 e SizeUpDownRight 16 Returns the newly created GwxSize object on success Null if the operation failed See also GwxSize and GwxDynamic Available only in Configure mode 58 59 60 6l OLE Automation Reference A 11 IDispatch CreateLocationDynamic BSTR visibleObjectName BSTR dynamicObjectName float offsetX float offsetY Boolean slider Boolean tracking short numberOfDetents Boolean continuousUpdate Creates a GwxLocation object with the specified attributes and attaches it to the visible object with the specified object name The parameters offsetX and offsetY refer to the distance the object will travel from its current location
159. g to M Graphics Release 3 0 Files produced at M Graphics Release 3 0 do not have this problem Metasys Is a registered trademark of Johnson Controls Inc All other marks herein are the marks of their respective owners 2004 Johnson Controls Inc M Graphics User s Manual 13 1 Chapter 13 M Graphics ActiveX Control Introduction This chapter describes how to e insert M Graphics ActiveX control e configure M Graphics ActiveX control May 23 2003 Johnson Controls Inc Code No LIT 6440130 13 2 Controls Key Concepts M Graphics ActiveX Control M Graphics ActiveX control GWXview32 OCX is capable of running M Graphics displays The advantage of ActiveX controls like M Graphics is that they can be embedded into any control container 1 e Visual Basic forms Internet Explorer HyperText Markup Language HTML pages M Graphics displays M Graphics ActiveX control is essentially a Runtime only component with some minimal configuration capability the Runtime only design allows the ActiveX to conserve memory An M Graphics ActiveX control executes displays created by gwx32 exe M Graphics Runtime Window Properties Mode This feature of M Graphics makes it possible to see what a display looks like in Runtime mode without actually entering Runtime Pressing Ctrl R toggles the display window between Configure and Runtime modes When the action toolbars are hidden the configuration functions can be fou
160. ging the Maximum Update Rate ccee G 7 M Graphics User s Manual 1 1 Chapter 1 Using This Manual Introduction M Graphics Release 4 0 1s a fully compliant OLE Object Linking and Embedding for Process Control OPC software package featuring ActiveX and OLE technologies Your creativity is the cornerstone to the dynamic visual impact that is provided with M Graphics M Graphics encourages system utilization enhances productivity and lowers overall operating costs Note M Graphics Release 4 0 files are not backward compatible with Release 3 0 or older revisions January 2001 Johnson Controls Inc Code No LIT 6440010 1 2 Introduction Key Concepts Chapter Organization Online Help Each chapter in the M Graphics User s Manuals divided into five main sections Table 1 1 Chapter Organization Section Description Introduction Briefly outlines the contents of the chapter Key Concepts Describes background information necessary to perform or understand specific tasks Procedure Overview Describes general steps for performing the tasks which are described in detail in the Detailed Procedures section This section is geared toward users already experienced in using M Graphics who only need a reference Detailed Procedures Describes in detail the steps needed to complete specific tasks described within the chapter This section is geared toward users who are new to M Graphics Troubles
161. gure mode and Runtime mode Starts with the window initially maximized Starts with the window initially minimized Hides shows the Main menu bar in Runtime mode only Determines if the M Graphics window is always on top and not obscured by other open windows in Runtime mode only Loads window properties for a given display when the display is loaded in Runtime mode If unchecked window properties are loaded only when M Graphics is initially launched into Runtime mode and subsequent display loads retain the window properties of the previously loaded display Specifies styles for the inner and outer edges of the Main window s border Defining Runtime Application Preferences M Graphics application preferences apply only to new displays To define Runtime application preferences 1 On the Format menu select Application Preferences The Application Preferences dialog box appears 2 Select the Runtime tab Figure 4 7 Customizing M Graphics 4 11 Application Preferences Medium z i Medium Figure 4 7 Application Preferences Runtime Tab 3 Modify the fields using Table 4 6 4 Click OK Operator s Guide Table 4 6 Runtime Application Preferences Field Runtime Focus Highlights Point Fail Options Disabled Object Colors Disable Input Controls When Maximum Update Rate Suppress Save Changes Message in Runtime Start Application in Runtime Mode Keyboard Number Pad Descripti
162. h the specified object name Returns the newly created GwxProcessPoint object on success Null if the operation failed See also GwxProcessPoint GwxText Gwx Visible and GwxDynamic Available only in Configure mode IDispatch CreateAnimator BSTR symbolName BSTR dynamicObjectName Boolean animateWhenTrue Boolean visibleWhenOff Boolean currentFrameWhenOff Creates a GwxAnimator object with the specified attributes and attaches it to the GwxSymbol object with the specified object name Returns the newly created GwxAnimator object on success Null if the operation failed See also GwxAnimator GwxSymbol GwxVisible and GwxDynamic Available only in Configure mode OLE Automation Reference A 15 69 Dispatch CreateAnalogSelector BSTR symbolName BSTR dynamicObjectName Boolean hiddenWhenAbove Boolean hiddenWhenBelow Creates a GwxAnalogSelector object with the specified attributes and attaches it to the GwxSymbol object with the specified object name Returns the newly created GwxAnalogSelector object on success Null if the operation failed See also GwxAnalogSelector GwxSymbol Gwx Visible and GwxDynamic Available only in Configure mode 70 IDispatch CreateDigitalSelector BSTR symbolName BSTR dynamicObjectName Creates a GwxDigitalSelector object with the specified attributes and attaches it to the GwxSymbol object with the specified object name Returns the newly created GwxDigitalSelector object on success Null if
163. hbutton The pushbutton dynamic creates a pushbutton in a display The pushbutton object behaves similarly to the pick dynamic However the pushbuttons also animate the up down state when selected in Runtime mode Checkbox The checkbox dynamic creates a checkbox in the display Checkboxes look and act like standard Windows checkbox controls When selected in Runtime mode the checkbox remains selected until it 1s selected again Radio Button The radio button dynamic creates a radio button like a pushbutton Radio buttons look and act like standard Windows operating system radio button controls When selected in Runtime mode the radio button automatically deselects all other radio buttons that belong to the same group De the radio buttons in a given group are mutually exclusive 11 10 Advanced User s Display Button A display button once configured through a wizard can do one of four things load a new display open a display in an embedded M Graphics window display a pop up window or serve as a drag drop object that can be placed in an M Graphics ActiveX container to load a display This feature reduces clutter in a display as embedded and pop up windows are shown only when needed by the push of a button Adding Dynamics 11 11 Procedure Overview Table 11 3 Adding Dynamic Connections To Do This Add a Size Dynamic Add a Location Dynamic Add a Rotation Dynamic Add a Hide Dynamic Add a Color Dynamic
164. he OPC server Tag Name Displays the full Tag name in Item ID box if you double click or highlight Tag Names list Refresh Displays updated network information Details Displays information about specific item Add Branch Allows an additional branch to be added to the tree diagram Add Item Allows an additional item to be added Remove Allows selected item to be removed Remove All Allows everything in the Tag Name to be deleted Debug Debugs selected Tag when checked Tags All non numeric data connection strings which do not include the special tokens as described later in this section are interpreted as Tags Any Tags that are not defined in the system at Runtime fail to connect i e JC CFOPC 1 ACM B17 required PresentValue If a Tag happens to be a string that is a number a rare situation and you don t want the Tag to be auto detected as a constant value use the following syntax Tag name Constant Values M Graphics automatically recognizes if an entered data connection string is a number and interprets that data connection as a constant value If you want to enter a constant string value a non number constant use the following syntax constant_string_value 1 e 1 75 This syntax prevents the string from being auto detected as a Tag name 10 6 Advanced User s Local M Graphics Variables To indicate that a data connection is a local variable use the following syntax local_ variable nam
165. he Tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a Tag Specifies if the Data Source is eligible for drag and drop operation Opens Expression Editor Aliases Local Variables or Simulation Variables dialog box Lists the frequency of the flash in milliseconds The minimum is 50 ms Flashes when the value is true logical 1 Flashes when the data point value is false logical 0 Determines the alternate state is hidden object Determines the alternate state is a color change Selects the object s fill color Selects the object s line color Selects the object s shadow color Shows the object in the specified alternate color or the object is hidden Deletes this dynamic Identifies the object for OLE automation Describes the object and determines the ToolTips displayed Allows user to enter data 11 26 Advanced User s Adding a Pick Dynamic To add a pick dynamic 1 Select the object 2 On the Dynamics menu select Actions gt Pick The Property Inspector dialog box appears with the Pick tab Figure 11 10 Note The appearance of this dialog box varies depending upon which action is selected Property Inspector Ellipse Flotation Flash Pick Acton Mouse Left Button bi Filename Browse Set Alazes Kep Shortcut one Delete Object Mame Description Custom Data m Custom Cancel Apply Help Figure 11 10 Pr
166. he display Properties 1 VARIANT Value Current data value of this point object This property gets updated with new values during Runtime mode 2 VARIANT HighRange High range value associated with this point object 3 VARIANT LowRange Low range value associated with this point object 4 GWXDATATYPE DataType Data type of this point object Valid values for GWXDATATYPE are e DataTypeShort 2 e DataTypeLong 3 e DataTypeFloat 4 e DataTypeDouble 5 e DataTypeString 8 e DataTypeBool 11 e DataTypeByte 17 Methods BSTR GetPointName Gets the point name data source string of this point object A 26 Appendix GWxXview32 GW Xview32 is the object type for the M Graphics ActiveX control GW Xview32 ocx and for M Graphics popup windows Properties 1 short BorderStyle Border style of the window Valid values are e No border 0 e Normal Border 1 short Appearance Appearance of the window border Valid values are e Flat 0 e 3 D BSTR DisplayName File name of the M Graphics display loaded in this object control Setting this property to a new file name will cause the new display to be loaded Boolean UseAmbientBackColor When True the background color of the object control will automatically be set to match the background color of the container in which this object is embedded This property only works if the container supports the AmbientBackColor property Boolean AutoStartRunt
167. he parameters Double click on the GWXSlider control Select the Value tab Modify the parameters Double click on the GWXSlider control Select the Fonts tab Modify the parameters Double click on the GWXSlider control Select the General tab Select the About button GWXSlider ActiveX Control 17 5 Detailed Procedures Inserting a GWXSlider ActiveX Control To insert a GW XSlider ActiveX control 1 In M Graphics on the Edit menu select Insert New Object The Insert Object dialog box appears Figure 17 2 Insert Object iste Create New ICONICS AWA eps Activex E IC ONT AWA lead Cancel E Create fram File ILONICS GWG auge Actives HCONICS DGAWsbder Actyves ICONICS Gwis Swich Actes ICONICS Ge Vessel Achyer ICONICS GWeviews Actives D Add Control Inserts a new ICONICS GY Slider Actives object into your document f Create Control Result Figure 17 2 Insert Object Dialog Box 2 Select Create Control and ICONICS GWXS Slider ActiveX for the object type 3 Click OK A GWXSlider ActiveX control is added to the display Figure 17 3 Note As a shortcut insert a GWXSlider ActiveX control by clicking on the D icon in the M Graphics ActiveX toolbar 17 6 Controls Ka Display M Graphics by Johnzon Controls ete ee Ee KEE CONICS Slider az e A a 0 299 i CeCe ee Dot or ke S Sl a Te fe et a le ET Ee le x 225 yA 100 L E Figure 17 3
168. hnson Controls M Trend Control Johnson Controls M View Control MH Client Control Add Control Cancel Inserts a new Johngon Controls M Graphics mes Control object into your document Figure 13 1 Insert Object Dialog Box 2 Select the item Johnson Controls M Graphics Control 3 Click OK The M Graphics ActiveX control appears in the center of the display Note An M Graphics ActiveX control may also be inserted by clicking on the icon in the ActiveX toolbar Figure 13 2 m HOER Figure 13 2 ActiveX Toolbar M Graphics ActiveX Control 13 5 Configuring M Graphics ActiveX Control To configure M Graphics ActiveX control 1 Double click the M Graphics ActiveX to display the Property page shown in Figure 13 3 2 Fill in the parameters described in Table 13 2 3 Click OK GWXviewS2 ActiveX Properties General Display Name C Program Files Johnson Controls M Graphics bin exa Browse Border Style Fixed Singe J_ Override Scrollbar Settings IS Horizontal Scrollbar See ere E S Vertical Scrollbar Use Containers Background Color V Auto Start Runtime Mode Properties Figure 13 3 M Graphics Property Page Table 13 2 M Graphics ActiveX Property Page Parameter Display Name Border Style Border Appearance Use Container s Background Color Auto Start Runtime Mode Override Scrollbar Settings Horizontal Scrollbar Vertical Scrollbar
169. hooting Provides information on potential problems as well as methods for solving them If a section 1s not necessary for a particular chapter it is omitted For example this chapter Using This Manual does not contain a Troubleshooting section M Graphics software includes online help The Help screens may be accessed by selecting Help from the menu bar by pressing the F1 key or by pressing Alt H Help describes the basic procedures for performing functions within the M Graphics software The online help system follows the basic conventions of Windows 98 and Windows NT help systems Manual Conventions As in most Windows based programs sometimes there are multiple ways to perform the same tasks This manual does not describe how to use both the mouse and the keyboard to perform the same step In general Microsoft conventions are used to describe software features M Graphics User s Manual 2 1 Chapter 2 Introduction to M Graphics Introduction M Graphics allows monitoring control and analysis of facilities using dynamic color graphic displays M Graphics also provides graphical navigation of a facility and launching of other Microsoft ActivexX applications This chapter describes e M Graphics hardware and software requirements e M Graphics features e M Graphics file name extensions June 18 2004 Johnson Controls Inc 2 2 Introduction Key Concepts M Graphics Hardware and Software Requirements
170. ick on the symbol in Design mode Try the example code as shown in Figure 12 7 Using Visual Basic for Applications VBA 12 21 eo Display1 ThisDisplay Code Option Explicit Public o Excel_Apo As Excel Application Public g Excel Book As Excel Workbook Public g Excel Sheet As Excel Worksheet This Display Code1 Figure 12 7 Test Subroutine 6 Return to M Graphics and double click the symbol A beep sounds and a message appears Editing a Macro To edit a macro 1 Select a macro object in the display 2 On the Tools menu select Macros gt Edit Macro The VBA Editor appears with the cursor in the body of the macro Stepping a Macro To step a macro 1 Select a macro object in the display 2 On the Tools menu select Macros gt Step Macro The VBA Editor appears with the cursor on the first line of the macro 12 22 Advanced User s Running a Macro To run a macro 1 Select a macro object in the display 2 On the Tools menu select Macros gt Run Macro Cleaning VBA Unused Modules To clean VBA unused modules On the Tools menu select Macros gt Clean VBA Unused Modules Examples The following section provides several examples for reference Adding Event Handlers Example Write code to pop up a message box that displays the message Runtime started when you Runtime your display 1 Open a display 2 Onthe Tools menu select Macros gt Visual Basic Editor The M Graphics VBA Project loads by de
171. ill Color Text Color Format Description Displays current Tag Describes current Tag Displays current units Enables disables following options showing the pen using a stair plot showing samples using pen marker Determines line style line width and color Lists alarm low limit Lists alarm high limit Lists another alarm low limit Lists another alarm high limit Shows hides alarm lines Displays low range Displays high range Determines range fill and text color Determines range format Enables disables range autoscale Determines fill color Determines text color Determines format 14 32 Controls Editing Trend in Runtime To edit trend in Runtime 1 In Runtime double click in the display to open the TWX View32 Runtime toolbar 2 Click on the Edit Trend button KW The Edit Window dialog box appears Figure 14 18 3 Edit the parameters Refer to Table 14 22 for details Figure 14 18 Edit Window Dialog Box Table 14 22 Edit Window Parameters Parameter Description Global High Low Display ranges assigned in the Ranges tab If global ranges Ranges was unchecked this option is unavailable Grids Determines number of grids displayed Language Determines language TWxXView32 ActiveX Control 14 33 Editing Period in Runtime To edit period in Runtime 1 In Runtime double click in the display to open the TWX View32 Runtime toolbar 2 Click on the Edit Period button Gl The Trend Edit
172. ime When True the object control will automatically enter Runtime mode when the object s container enters Runtime mode This property only works if the container supports the AmbientUserMode property Boolean OverrideScrollbarSettings When True this property indicates the object control will override the scroll bar visibility settings of the display currently loaded in the control When False the object control will use the scroll bar settings defined in the currently loaded display Boolean VerticalScrollbar When True the vertical scroll bar of the control s window is visible when False the vertical scroll bar is hidden This property is ignored if OverrideScrollbarSettings is False Boolean HorizontalScrollbar When True the horizontal scroll bar of the control s window is visible when False the horizontal scroll bar is hidden This property is ignored if OverrideScrollbarSettings is False OLE Automation Reference A 27 Methods 1 void StartRuntime Puts this object control into Runtime mode 2 void StopRuntime Takes this object control out of Runtime mode 3 Dispatch GetDisplay Returns the GwxDisplay object for the display currently loaded in this object control You can then use this object to access all of the properties and methods of all the object types described in this chapter A 28 Appendix M Graphic s Users Manual B 1 Appendix B DIN Symbol Library Introduction This ch
173. iner Configures the caption for the slider and the text for the ToolTip Configures the format and style of the text box of the slider Determines the font font style size effects of selected text Note Specific parameters are discussed in Detailed Procedures 17 4 Controls Procedure Overview Table 17 2 GWXSlider ActiveX Control To Do This Insert a GWXSlider ActiveX Control Edit General Parameters Edit Slider Parameters Edit Slow Spin Buttons Parameters Edit Fast Spin Buttons Parameters Edit Scale Parameters Edit Background Parameters Edit Caption Parameters Edit Value Parameters Edit Fonts Parameters View About Information Follow These Steps In M Graphics on the Edit menu select Insert New Object Select Create Control and ICONICS GWXSlider ActiveX for the object type Click OK Double click on the GWXSlider control Select the General tab Modify the parameters Double click on the GWXSlider control Select the Slider tab Modify the parameters Double click on the GWXSlider control Select the Slow Spin Buttons tab Modify the parameters Double click on the GWXSlider control Select the Fast Spin Buttons tab Modify the parameters Double click on the GWXSlider control Select the Scale tab Modify the parameters Double click on the GWXSlider control Select the Background tab Modify the parameters Double click on the GWXSlider control Select the Caption tab Modify t
174. ing preference for restoring range values 3 16 Operator s Guide Runtime Menus The following menus are available in Runtime Table 3 13 Runtime File Menu File Menu Options Open Print Print Preview Print Setup Recently Used File List Exit Description Opens a display Prints current display Displays file before printing Opens Print Setup dialog box with printer options Lists last four files opened in M Graphics Closes M Graphics Table 3 14 Runtime View Menu View Menu Options Display Back Display Forward Home Unzoom Zoom Box Zoom Fit to Window Show Whole Display Decluttering Zoom Hide Layers Horizontal Scroll Bar Vertical Scroll Bar Toggle Both Scroll Bars ToolTips Data Statistics Select Language Description Displays previously shown graphic Shortcut is Ctrl Pg Up Displays next graphic Shortcut is Ctrl Pg Dn Returns display to last saved view of the document Acts as an undo for zoom Provides 50 75 100 150 250 and custom zoom options Allows user to drag a box around an area to zoom Sizes the display so all objects in the display fit into the window Allows user to see the entire work area Provides zoom function for specific layer Allows user to hide layers on graphic Hides shows horizontal scroll bar Hides shows vertical scroll bar Hides shows both horizontal and vertical scroll bars Hides shows ToolTips Opens the OLE Expre
175. ints is similar to the page used to edit static text objects Adding Dynamics 11 37 Creating a Pushbutton To create a pushbutton 1 On the Dynamics menu select Intrinsics gt Pushbutton 2 Click in the work area The Property Inspector appears with tabs for Pick same tab as the pick dynamic and Button Figure 11 16 Property Inspector Left Button 2 Figure 11 16 Property Inspector for Pushbutton Dynamic 3 Fill in the parameters 4 Click OK 11 38 Advanced User s Creating a Checkbox To create a checkbox 1 2 On the Dynamics menu select Intrinsics gt Checkbox Click in the work area The Property Inspector appears with tabs for Pick same tab as the pick dynamic and Checkbox Figure 11 17 Property Inspector x Checkbox Pick Execution Trigger M On Down While Down pteslimsl IER W OnUp Action Eea me MEI Mouse Left Button Type Check Button Initial State Up M Data Source Tags Meru Value On Down oc Value On Up orc Key Shortcut Hone Delete Object Name Description Custom Data Custom E Cancel Apply Help Figure 11 17 Property Inspector for Checkbox Dynamic 3 Fill in the parameters using Table 11 16 Adding Dynamics 11 39 Table 11 16 Pick Parameters Field Action Mouse Type Execution Trigger Initial State Data Source Tags Menu Value On Down OPC Value O
176. ion The location is controlled by the container and defaults to the location of the saved m3w file If you are using Metasys Telephone Interface MTT and M Graphics and you reboot the M Series Workstation make sure MTI fully initializes before starting M Graphics Chapter A M Graphics User s Manual 4 1 Customizing M Graphics Introduction This chapter explains the different ways of configuring and customizing your system This chapter describes how to customize the launch of M Graphics and Windows select a language define general application preferences define window application preferences define Runtime application preferences define grid application preferences define load tabs application preferences define ToolTips application preferences copy application preferences to display properties save display properties as application preferences reset default application preferences and display properties define a Configuration mode password set up the alarm icon path for ActiveX Control September 30 2003 Johnson Controls Inc Code No LIT 6440040 4 2 Operator s Guide Key Concepts M Graphics Custom Settings Customize M Graphics system using e Command line options e M Graphics Preference dialog box e Display Properties dialog box Command Line Options The command line feature allows the user to start M Graphics with a specified display and launch M Graphics directly in Runtime mode Ap
177. ion Preferences Field Description Grid Style Specifies if grid lines are dots or lines If Lines field is selected determines vertical and horizontal line style Grid Size Specifies the grid spacing in terms of width and height Grid Color Specifies color for the lines dots of the grid Show Grid Hides shows grid Snap to Grid Enables disables snap to grid 4 14 Operator s Guide Defining Load Tabs Application Preferences M Graphics application preferences apply only to new displays To define load tabs application preferences 1 On the Format menu select Application Preferences Application Preferences dialog box appears 2 Select the Load Tabs tab Figure 4 9 Application Preferences General window Runtime Grid Load Tabs ToolTips Tab Configuration Label ee Filename Set Aliases Browse Tab Bar Position Bottom of Display el Change Tab Order 4 d Delete Font conc tony __ pridtabs Figure 4 9 Display Properties Load Tabs Tab 3 Modify the fields using Table 4 8 4 Click OK Customizing M Graphics 4 15 Table 4 8 Load Tabs Application Preferences Field Description Tab Configuration Specifies label and filename for tab Label Lists name of tab Filename Determines the display file loaded in tab Tab Bar Position Determines the tab bar position at the top or bottom of the display Set Aliases Sets aliases for the loaded display file Browse B
178. isplay a uniform height and width 3 12 Operator s Guide Table 3 7 Draw Menu Draw Menu Options Select Mode Straight Line Rectangle Square Ellipse Circle Arc Segmented Line Text Import Export im e gt H o Description Allows selection of objects Draws a straight line Draws a rectangle or square Draws an ellipse or circle Draws an arc Draws a segmented line Inserts text Inserts a bitmap Inserts a metafile Opens the Symbol Library Exports objects as a metafile Table 3 8 Dynamics Menu Dynamics Menu Options Actions Selectors Intrinsics Set Pick Tab Order Edit Local Variables Edit Aliases Toolbar Button Getting Started 3 13 Description Adds a Size dynamic Adds a Locator Slider dynamic Adds a Rotation Dial dynamic Adds a Hide dynamic Adds a Color dynamic Adds an Analog Color dynamic Adds a Flash dynamic Adds a Pick dynamic Adds a Digital Selector dynamic Adds an Analog Selector dynamic Adds an Animator dynamic Creates a Process Point dynamic Creates a Time Date dynamic Creates a Pushbutton dynamic Creates a Checkbox dynamic Creates a Radio Button dynamic Activates the Button Wizard to build a Custom button Determines order for Pick actions if multiple objects overlap each other Opens the Local Variables dialog box so user can edit current local va
179. k OK On the View menu select a zoom option On the View menu select the options you want to view on the display Options include toolbars status bar horizontal scroll bar and vertical scroll bar On the File menu select Summary Info Select the Summary tab Fill in the fields Click OK On the File menu select Summary Info Select the Statistics tab which provides general information about the currently displayed file From the View menu select Object Count Click OK to return to the display In M Graphics select Runtime on the menu bar On the File menu select Open Select a display file and click on the OK button On the File menu select Print Fill in the required fields and click OK On the File menu select Exit Getting Started 3 19 Detailed Procedures Starting M Graphics To start M Graphics On the Windows Start menu select Programs gt Johnson Controls gt M Graphics Creating a New Display To create a new display On the File menu select New Opening a Display To open a display 1 On the File menu select Open The Open dialog box appears 2 Select a display file 3 Click OK Saving a Display To save a display 1 On the File menu select Save or Save As The Save dialog box appears 2 Enter a file name and file type File types include gdf for graphic displays tdf for templates and gdf without VBA code Printing a Display To print a display 1 On the File menu se
180. l or On Off Displays the current data source Allows user to browse and select a tag Determines how fast the system will update the data being displayed through the switch in milliseconds Allows the user to reverse the values of the associated tag depending on whether the switch is on or off If checked automatically starts processing data when display is put in Runtime mode If checked maintains switch ratio when the user changes its dimensions Determines if the switch appears to be light sourced If checked allows user to select colors for the switch instead of using the default colors Displays the About information GWXSwitch ActiveX Control 16 9 Editing Background Parameters To edit background parameters 1 Double click on the GWXSwitch ActiveX control The GW xXSwitch ActiveX Properties dialog box appears 2 Select the Background tab Figure 16 5 ICONICS GW Switch Actives Properties General Background ee s H H Caption Labels Fonts W Use Containers Background Color Hackaiaund Ealar M Show Back Face Fill Color Edge Style Hatzed Cancel Apply Help Figure 16 5 GWXSwitch Active X Properties Dialog Box Background Tab 3 Modify the parameters using Table 16 4 Table 16 4 Background Tab Parameters Parameter Description Use Container s If checked the background color of the switch Background Color matches the background color of th
181. l tab 3 Select the About button The Iconics About Box appears Figure 15 16 GWxXGauge ActiveX Control 15 21 Iconics About Box I Figure 15 16 Iconics About Box 4 Select the General tab The information listed includes version copyright etc 15 22 Controls M Graphics User s Manual 16 1 Chapter 16 GWxXSwitch ActiveX Control Introduction The GWXSwitch is an ActiveX control that can be inserted into the M Graphics application to display and modify binary output This chapter describes how to e insert a GWXSwitch ActiveX control e edit general parameters e edit background parameters e edit caption parameters e edit labels parameters e edit fonts parameters e view about information January 2001 Johnson Controls Inc Code No LIT 6440160 16 2 Controls Key Concepts GWxXSwitch ActiveX Control Insert the GWXSwitch ActiveX control into the M Graphics application The GWXSwitch ActiveX displays and modifies data in a virtual instrument panel format on graphics Use the GWXSwitch ActiveX to output binary changes such as start and stop to field devices The GWXSwitch Active X supports connection to OPC compliant servers and provides excellent capabilities for managing data GWxXSwitch ActiveX Properties The GWXSwitch ActiveX Properties dialog box is the configuration interface to the GWXSwitch ActiveX Double clicking anywhere in the GW XSwitch ActiveX client during Configure m
182. lect Print 2 Specify the range of pages to be printed the number of copies the destination printer and other printer setup options 3 Click OK 3 20 Operator s Guide Using Zoom To use zoom On the View menu select a zoom option described in Table 3 4 Managing the Display Area To manage the display area On the View menu select the options you want to view on the display Options include toolbars status bar horizontal scroll bar and vertical scroll bar and properties Defining Summary Information To define summary information 1 On the File menu select Summary Info The Summary Information dialog box appears 2 Select the Summary tab 3 Fill in the fields 4 Click OK Viewing Statistics To view statistics 1 On the File menu select Summary Info The Summary Information dialog box appears 2 Select the Statistics tab which provides general information about the currently displayed file Summary Information of a display can also be viewed in Windows Explorer In Windows Explorer select the desired display file right click and choose the Properties menu item The Summary and Statistics tabs appear in the resulting dialog box Getting Started 3 21 Viewing Object Count Statistics To view object count statistics 1 From the View menu select Object Count The Object Count dialog box appears Figure 3 11 Object Count Static Objects Dynamic Objects Rectangle Ellipse Line Arc
183. lider is visible If checked the current value is tracked If checked the data is updated continuously Allows user to set the increments that the slider knob will move Determines the color of the bar the slider moves on Displays a wide slider track Determines the color of the edge of the slider track Determines the style of the edge of the slider track thin line medium line thick line etched bump raised sunken or no edge Determines the behavior when user clicks on the slider track move to next detent move to detent nearest the mouse pointer move to mouse pointer position move by fast spin increment move by slow spin increment or no action Determines how often the track control action is repeated when the user holds down the mouse button Determines the color of the slider knob Determines the color of the edge of the slider knob Determines the style of the edge of the slider knob thin line medium line thick line etched bump raised sunken or no edge GWXSlider ActiveX Control 17 11 Editing Slow Spin Buttons Parameters To edit slow spin buttons parameters 1 Double click on the GWXSlider ActiveX control The GWXSlider ActiveX Properties dialog box appears 2 Select Slow Spin Buttons tab Figure 17 6 ICONICS GW Slider Actives Properties Scale Background Caption Value Fonts General Slider 9 alow Spin Buttons Fast Spin Buttons h Show Spin Button
184. lt in buffering system support for custom imported data multilingual support interface to OPC realtime servers easy Visual Basic integration extensive realtime signal information including signal quality expression handling realtime statistical information with CSV file support user configured alarm levels for signals user defined global or relative signal ranges fixed location or scrolling grids embedded signal simulator multiple plotting type support Time plot X Y plot logarithmic plot strip chart bar plot TWXView32 ActiveX Control 14 3 TWXView32 ActiveX in M Graphics Connections The TWXView32 ActiveX integrates easily within Visual C or Visual Basic container applications Containers such as M Graphics provide toolbar support for inserting the TWX View32 control Once inserted into a document or a form the component can be resized and configured The TWXView32 ActiveX saves almost all of its configuration data within its own streamed file format with extensions v32 The user must give a valid file name before the data are serialized and saved The TWX View32 uses a working directory defined in containers such as M Graphics This represents the working directory where project files and configurations files are stored TWX View32 utilizes this directory as a starting point for saving and loading its configuration files Graphics built with Iconics TWX View32 control running within a container such as M3 Wo
185. menu for analog floating point process points Define a scientific notation format using the predefined formats or create a user defined format Lists the same formats as Float Defines 2 state display formats Offers default formats such as 0 1 Off On No Yes False True Auto Manual Disable Enable and Stop Run Lists ten default formats for integers such as Xxxx Lists the same formats as Byte Lists the same formats as Byte Lists the same formats as Byte Lists the same formats as Byte Lists the same formats as Byte Defines String text display formats 10 20 30 40 50 60 70 80 as the number of characters Define the number of text characters before you place this object in the display Use the predefined format or create your own Defines native format for the data type Defines the initial startup value to which the data entry object is initialized when the display is launched in Runtime mode Specifies a low and high range in the boxes provided This range applies to data entries only In Runtime mode M Graphics will not allow you to enter a value outside this range Opens the State Field Configuration dialog box to associate text with a numeric input value Available data types for OPC Request Type and Client Display Type Available for only the OPC Request Type Additional properties relating to the visual appearance of the PPT DE can be made by selecting the Text tab The text page for Process Po
186. mics attached to the selected objects are merged and displayed in a single Edit Aliases dialog box If the selected objects have object names defined those names identify which Alias names belong to which objects If no objects are selected when you choose to edit Aliases all the Aliases in the display appear in the Edit Aliases dialog box Sorting is supported in the Edit Aliases dialog box The Alias replacement strings are modifiable during Runtime via OLE automation Runtime Alias Runtime Aliasing encompasses a variety of ways to change a display s Aliases during Runtime The user can specify a collection of Aliases to be set as part of a given command For example when using a pick action to load a display the user can specify Aliases to be set in the display that is about to be loaded These Aliases are set before any Tags in the new display are requested The Aliases to be set can be specified directly in M Graphics or can come from an external tab delimited text file Such files can be exported from Excel created in Notepad or created using M Graphics Alias File Editor Commands that Alias can be associated with include e Pick action Load display e Pick action Drag drop load display e Pick action Popup window e Pick action Embedded window e Pick action Set Aliases e Pick action Alias e Tab Load Display e Launch M Graphics from the command line and specify an Alias file as one of the command line parameters Proc
187. n Runtime double click in the display to open the TWXView32 Runtime toolbar Click on the Edit Pen button Edit the parameters In Runtime double click in the display to open the TWXView32 Runtime toolbar Click on the Edit Trend button Edit the parameters In Runtime double click in the display to open the TWXView32 Runtime toolbar Click on the Edit Period button Edit the parameters In Runtime double click in the display to open the TWXView32 Runtime toolbar Click on the Freeze button to toggle between freeze and unfreeze In Runtime double click in the display to open the TWXView32 Runtime toolbar Click on the Statistics button In Runtime double click in the display to open the TWXView32 Runtime toolbar Click on the Focus Pen button Edit the options In Runtime double click in the display to open the TWXView32 Runtime toolbar Click on one of the following buttons Page Left Cursor Left Cursor Right or Page Right 14 16 Controls Detailed Procedures Inserting a TWXView32 Control To insert a TWX View32 control 1 In M Graphics on the Edit menu select Insert New Object The Insert Object dialog box appears Figure 14 4 Create New Acrobat Control for ActiveX ICONICS TWXView82 C EEN Johnson Controls M Graphics Control Johnson Controls M Trend Control Smart Help OLE Control O Create Control Result Inserts a new Acrobat Control for ActiveX object into zi your document insert
188. n Up Key Shortcut Delete Object Name Description Custom Data Description Lists all the Pick action options load display drag drop load display back display forward pop up window embedded window close window launch application download value toggle value set aliases alias dialog run VBA Script and custom command Lists the mouse button activating the pick left middle or right Lists all the Pick action options Displays when the value returns on down while down or on up Displays current state of action item Displays the name of the current file Opens the Expression Editor Aliases Local Variables or Simulation Variables dialog box Displays the return value when down Opens the OPC Universal Tag Browser Displays the return value when up Defines a key shortcut for this action Deletes the dynamic Identifies the object for OLE Automation Describes the object and determines the ToolTips displayed Allows user to enter data 4 Click OK 11 40 Advanced User s Creating a Radio Button To create a radio button 1 Onthe Dynamics menu select Intrinsics gt Radio Button 2 Click in the work area The Property Inspector appears with tabs for Pick same tab as the pick dynamic and Radio Button Figure 11 18 Property Inspector Radio Button Fick d Execution Trigger h On Down While Down Acton Mouse Left Button Type Radio Button intemal ime 1 n00
189. n labels Allows user to determine how the label is displayed from 21 formats such as xxxx Determines the color of the text Determines the unit text for the labels Determines the number of ticks between major divisions Determines the number of ticks between minor divisions Determines the color of the ticks Determines the style of the ticks thin line medium line thick line etched bump raised sunken or no edge 15 16 Controls Editing Fonts Parameters To edit fonts parameters 1 Double click on the GWXGauge ActiveX control The GW xXGauge ActiveX Properties dialog box appears 2 Select the Fonts tab Figure 15 12 ICONICS GWAG auge Activex Properties CG General Background Caption l Bar Needle Value Scale Property Name Font Fonts Slider Dial Warning ones Curent alueF ont Font Style Size arial Regular EN 2D Fp Arial Black Fp Arial Marrow Tp Bookman Old Style Tp Comic Sans MS Courier Effects T Strikeout T Underline Sample z AaBbY yZZ Cancel Ampy Hep Figure 15 12 GWXGauge ActiveX Properties Dialog Box Fonts Tab 3 Modify the parameters using Table 15 11 Table 15 11 Fonts Tab Parameters Parameter Property Name Font Font Style Size Effects Sample Description Allows user to choose which text to change the font of CurrentValueFont MainCaptionFont ScaleOneLabelFont or ScaleTwoLabelFont
190. n the GWXSwitch ActiveX control The GW xXSwitch ActiveX Properties dialog box appears 2 Select the Fonts tab Figure 16 8 ICONICS GW Switch Activex Properties Property Name LabelsFont Font Font Style Size arial Bald sl 21 75 Effects Fp Arial Black IT Strikeout T Underline Fp Arial Narrow Sample Fp Bookman Old Style AaBbYyZz Fp Comic Sans MS Courier Figure 16 8 GWXSwitch ActiveX Properties Dialog Box Fonts Tab 3 Modify the parameters using Table 16 7 Table 16 7 Fonts Tab Parameters Parameter Description Property Name Allows user to choose which text to change the font of LabelsFonts or MainCaptionFont Font Displays the current font and a scrolling list of fonts available Font Style Determines the style of the font regular bold italic or bold italic Size Allows user to select the size of the font from a drop down menu Effects Allows strikeouts and underlining of the text chosen Sample Displays a real size example of the font style and size chosen GWxXSwitch ActiveX Control 16 13 Viewing the About Information To view the about information 1 Double click on the GWXSwitch ActiveX control The GWxXSwitch ActiveX Properties dialog box appears Figure 16 9 ICONICS GW Switch Activex Properties EJ Switch Style Vertical Rocker Switch 1 sl Data Source local bt Tags Update Hate E milliseconds Overide Default Switch Colors Re
191. n the Value field of the Property Inspector To display system names using the alias feature enter lt lt system gt gt in the Value field of the Property Inspector where system is an alias name Adding Dynamics 11 7 Table 11 2 Pick Action Options Pick Action Load Display Drag Drop Load Display Back Display Forward Popup Window Embedded Window Close Window Launch Application Download Value Toggle Value Set Aliases Alias Dialog Run VBA Script Custom Command Description Loads a display Allows you to drag drop a display to another M Graphics window Navigates backward through the display history M Graphics maintains a history of the last 50 displays Navigates forward through the display history M Graphics maintains a history of the last 50 displays Opens a popup window Opens an embedded window which is a child window of the display that launched the embedded window The embedded window can move scroll and scale with the parent display Closes the window Launches the application specified in the Filename field Downloads values when you click on the pick object Toggles between two specified values Sets aliases for data connections in Runtime Opens the Set Aliases Configuration interface to configure aliases Runs the specified VBA Script Runs a custom function This function is an executable file exe or a dll 11 8 Advanced User s Selector Dy
192. namics Selectors display specific objects based on the value of a data connection There are three types of selectors e digital selector e analog selector e animator Digital Selector The digital selector connects individual objects to corresponding digital data points During Runtime mode when the connected data point goes true logical 1 or optionally false the connected object appears on the screen The digital selector displays one of a number of objects based on the state of digital signals One signal is connected to each object The highest priority signal determined by position in the list displays the corresponding object when true or optionally false Generally no objects appear when all signals are false logical 0 The digital selector allows a point value to be true or false to determine which selected group of objects to view Analog Selector The analog selector defines a group of objects attached to an analog data point During Runtime mode the value of the analog data point determines which assigned object is shown The analog selector displays one of a number of objects based on the value of the analog signal This object displays when the signal falls within the range of values specified for the object The analog selector allows a percentage value from an analog point value to determine which selected group of symbols to view Animator The animator allows selected objects to be displayed seque
193. nction is useful for iterating through all the dynamic objects attached to this visible object long GetNumberOfDynamics Returns the number of dynamic objects attached to this visible object GwxText has all the properties and methods of Gwx Visible plus the additional properties described below Properties 1 BSTR Text This string is the text that is displayed by the text object 2 Boolean StretchText True if the font size should be resized when the text object 1s stretched False if the font size should remain the same when the object is stretched 3 GWXTEXTALIGNMENT Alignment The alignment of the text left center right This property is only significant for multiline text strings Valid values for GWXTEXTALIGNMENT are e TextAlignLeft e TextAlignCenter e TextAlignRight 4 IFontDisp Font Gets sets font of the text object A 20 Appendix GwxRectangle GwxArc GwxRectangle has all the properties and methods of GwxVisible plus the additional properties described below Properties l Boolean Rounded When getting this property 1f the value is True the rectangle has rounded corners When setting this property to True the rectangle is given rounded corners with the default rounding settings long RoundingX Gets sets the amount of horizontal rounding of the rectangle s corners long RoundingY Gets sets the amount of vertical rounding of the rectangle s corners GwxArc has all the pro
194. nd Release 4 0 when using the addition operator in which the adds numbers but combines strings Graphics created prior to M Graphics Release 3 0 that use the addition operator may require application of a workaround Workaround Multiply the tag by one to force a conversion to a numeric variable type Like Function The Expression Editor supports the Like function This function performs a wildcard string compare which searches a given string for a certain pattern string Table 10 4 is an overview of the Like function Table 10 4 Like Function Symbol Description Example Like Wildcard string compare Like string pattern case sensitive String is the string to search pattern is the string to search for includes wildcards case sensitive is nonzero for case sensitive search and zero for case sensitive search The string syntax is string Establishing Data Source Connections 10 9 Table 10 5 Expression Examples Expression Example Description X A Local Variable Syntax x lt lt tag gt gt Alias Syntax X A B Calculates remainder after division x max A B Returns greater of two local variables X A lt B Returns 0 if false or 1 if true X A amp amp B Returns 1 if both are true O if both are false x if A gt B c d Returns c if true and d if false x pow A B Returns value A to the power of B Data Source Aliases An Alias is a strin
195. nd in the main menu or in the right click pop up menu Note Pressing Ctrl M toggles between Configuration and Runtime modes Procedure Overview M Graphics ActiveX Control 13 3 Table 13 1 M Graphics ActiveX Control To Do This Insert M Graphics ActiveX Control Configure M Graphics ActiveX Control Follow These Steps From the Edit menu select Insert New Object Select the item Johnson Controls M Graphics Control Click OK Double click the M Graphics ActiveX control to display the control s Property page Fill in the parameters Click OK 13 4 Controls Detailed Procedures Inserting M Graphics ActiveX Control Techniques for inserting an ActiveX control may vary slightly among different control containers however the basics are the same Note If you are using the M Graphics numeric keypad function to work with an M Graphics ActiveX control you must run the M Graphics gwx32 exe as a standalone application on the M Series Workstation The numeric keypad function may not work within M Graphics ActiveX controls To insert M Graphics ActiveX control 1 From the Edit menu select Insert New Object The Insert Object dialog box appears Figure 13 1 Insert Object Ei Ei C Create New C Create from File Ce Create Control A esult Object Type InstallE nginelt Object Johnson Controls BACnetCalendar Cc Johnson Controls BACnetS chedule C Johnson Controls M Graphics Control Jo
196. ndow settings are only active in Runtime mode 3 Modify the fields using Table 4 5 4 Click OK Operator s Guide Table 4 5 Window Application Preferences Field Window Dimensions Pixels Current Screen Resolution Runtime Titlebar Options Horizontal Scrollbar Vertical Scrollbar Start Maximized Start Minimized Show Runtime Menubar Always on top Set Window Properties On Runtime Load Runtime Frame Style Description Resizes the window to exact dimensions when in Runtime mode Determines screen resolution If scale window dimensions based on current screen resolution check box is set the window dimensions are automatically scaled based on the current screen resolution For example if the current screen resolution is 640 x 480 and the M Graphics window size is 640 x 480 and if you switch the resolution to 800 x 600 the next time your display is loaded its dimensions are scaled up to 800 x 600 If you want the window to always be 640 x 480 no matter what the resolution is leave this check box unchecked If the screen resolution is changed the window dimensions remain the same way they were originally set up Hides shows the title bar by checking the relevant box Either override the caption or minimize and maximize the System menu by checking the check boxes Hides shows the horizontal scroll bars in Configure mode and Runtime mode Hides shows the vertical scroll bars in Confi
197. ns Font dialog box to specify font style point size effects and script TWxXView32 ActiveX Control 14 21 Editing Workspace Parameters To edit workspace parameters 1 Double click on the TWX View32 control The TWX View32 ActiveX Properties dialog box appears 2 Select the Workspace tab Figure 14 8 PHY ewg Activex Properties NI Details General Colors Display Cancel Foreground E Background E Time Rates Pens Settings Fonts Workspace Grids Ranges Trend Border Style Show Title J Sunken sl M Show Ranges A MW Show Time Trend Border Options Rectangle Y M Border W 3D Edge W Show Details Help GD Figure 14 8 TWXView32 ActiveX Properties Dialog Box Workspace Tab 3 Modify the parameters using Table 14 13 Table 14 13 Workspace Tab Parameters Parameter Colors Trend Border Style Trend Border Options Border 3D Edge Show Title Show Ranges Show Time Show Details Description Determines background foreground and display color Determines the type of border bumped etched raised or sunken Determines border placement bottom bottom left bottom right left rectangle right top top left or top right Toggles between invisible and visible border Toggles between invisible and visible 3D edge Show hide title of graphic Show hide ranges of graphic Show hide time Show hide detail
198. nstead of C ProgramFiles M Graphics VohnsonControls MyProject gdf Use Set Working Directory to establish a common location for file storage To make updates easier when working with a group of developers have everyone point to a common location on the network Use Shared Object Name property for objects in more than one place on more than one screen This property allows all the files to be globally updated at the same time Use Object Name property for every object This property allows easier identification of objects when performing search replace Alias lists and Find reports Drag the file out of the M Graphics display directly to the desktop of your computer when sharing one object with someone else This property creates a scrap file which can be shipped over networks or copied to a floppy Afterwards drag the scrap file back into another M Graphics display Duplicate and place objects in one step by holding down the CTRL key while dragging Open up multiple instances of M Graphics to copy objects between different displays Select two objects first instead of using two separate Hide dynamics to toggle the visibility Then apply the Digital Selector dynamic For more information refer to the Gen32Demo Use a sunken 3D Edge and fill color for Process Points white if it permits data entry gray if it is read only This property allows operators to see whether a field is writable Copy the master object and right cli
199. ntially based on a value s being true or false The animator allows a group of objects to be displayed sequentially based on the state of a digital variable to which they are connected When that digital variable goes to its true state logical 1 or optionally false during Runtime mode the assigned objects appear on screen in the sequence in which they are ordered The sequence repeats until the connected process variable returns to a false state logical 0 or optionally true The rate of animation is selectable Adding Dynamics 11 9 Intrinsic Dynamics Intrinsic dynamics creates operator controls in display files Intrinsics make dynamic connections to control objects such as data entry objects and sliders and pushbuttons that display realtime data during Runtime mode Process Point Data Entry The Process Point Data Entry PPT DE dynamic creates an object used to display and enter data in an alphanumeric format A PPT is an object that displays the realtime value of a connected data point during Runtime mode This value is updated when the server informs M Graphics of a change in the data point value A DE behaves the same way as a process point and also allows you to manually enter new values to be downloaded to the system Time Date The time and date dynamic adds the current time and date to the display This functionality supports dates beyond the year 2000 The time and date fields have Free Format capabilities Pus
200. nu Advanced Options Show Sel Properties Report to Notepad Description Allows you to specify a type of string where the Find Replace works All the strings can be modified for every object dynamic action Allows you to find replace tags dynamics points Allows you to find replace labels of text objects Allows you to find replace names of objects dynamic actions Allows you to find replace global keywords used in shared objects Determines the operating space for the operation Works in current selection if there are no objects selected option is disabled Works in subsymbol see menu item Edit Symbol and Subsymbol Editing capability if there is no subsymbol edited this option is disabled Works in whole display any subsymbol editing is left and replaced by a root edit level Works in a group of file displays any subsymbol editing is left and replaced by root level If there are changes made you are prompted to save the document If selected the function finds replaces text strings that match the case of the characters Otherwise the command finds replaces strings with either uppercase or lowercase If checked the function finds replaces the whole text strings Otherwise Find Replace selects any string Specifies the search text A drop down menu lists possible strings Wildcards are allowed Note if the type is Object Name and the Find What string Ise the tree view displays all object hierarchy from curren
201. o 1 0 18 19 20 Di 22 23 24 25 26 2T 28 29 OLE Automation Reference A 5 void GetWindowDimensionsPercent float left float top float width float height Gets the M Graphics main window size and location as a percentage of the total screen size Retrieved parameters will have values in the range of 0 0 to 1 0 void GetDisplayDimensions long width long height Retrieves the display dimensions work area world bounds of the currently loaded display void SetDisplayDimensions long width long height Sets the display dimensions work area world bounds of the currently loaded display void SetViewDimensions long left long top long width long height Sets the M Graphics view rectangle s size and location The view dimensions define what portion of the work area whole display is visible Setting the view dimensions can be used to zoom and pan the view of a display void GetViewDimensions long left long top long width long height Gets the M Graphics view rectangle s size and location void GetClientDimensionsPixels long left long top long width long height Gets the M Graphics client rectangle s size and location in pixels The client rectangle is the area of the main window not including the borders title bar and menu bar IDispatch OpenPopupWindow BSTR filename Boolean modal Boolean center Boolean hidden Opens an M Graphics popup win
202. o edit background parameters 1 Double click on the GWXGauge ActiveX control The GW xXGauge ActiveX Properties dialog box appears 2 Select the Background tab Figure 15 5 ICONICS GWAG auge Actives Properties Scale Scale Fonts Slider Dial Warning ones POC ee ee General Background Caption Bar Needle Value M Use Containers Background Color HeGlomoumpjolor T M Show Back Face M Fill Color Edge Color E Edge Style Fiaised sl Cancel Figure 15 5 GWXGauge ActiveX Properties Dialog Box Background Tab 3 Modify the parameters using Table 15 4 Table 15 4 Background Tab Parameters Parameter Description Use Container s If checked the background color of the gauge Background Color matches the background color of the container If unchecked allows user to select a color for the background of the gauge which has a border around it Show Back Face If checked the gauge has an edge border Fill Color Allows user to select a color for the gauge Default is gray Edge Color Allows user to select a color for the edge of the gauge Edge Style Allows user to select a style for the edge of the gauge thin line medium line thick line etched bump raised sunken or no edge Default is raised 15 10 Controls Editing Caption Parameters To edit caption parameters 1 Double click on the GWXGauge ActiveX control The GW xXGauge ActiveX Properties dialog box a
203. ode opens the GWxXSwitch ActiveX Properties dialog box Figure 16 1 The dialog box fields are described in Table 16 1 ICONICS GW Switch Activex Properties Switch Style Vertical Rocker Switch 1 sl Data Source local bt Tags Update Hate E milliseconds Override Default Switch Colors Reverse On Off Values py mefe If Auto Start Runtime Mode Fie Eck ES kW Preserve Aspect Hat M Gradients Cancel etal Help Figure 16 1 GWXSwitch ActiveX Properties Dialog Box GWxXSwitch ActiveX Control 16 3 Table 16 1 GWXSwitch ActiveX Properties Dialog Box Properties Page Description General Allows user to select the tag used as the data source for the switch Background Configures the appearance of the switch within a container Caption Configures the caption for the switch and the text for the ToolTip Labels Allows user to configure labels for the switch Fonts Determines the font font style size and effects of selected text Note Specific parameters are discussed in Detailed Procedures 16 4 Controls Procedure Overview Table 16 2 GWXSwitch ActiveX Control To Do This Insert a GWXSwitch ActiveX Control Edit General Parameters Edit Background Parameters Edit Caption Parameters Edit Labels Parameters Edit Fonts Parameters View About Information Follow These Steps In M Graphics on the Edit menu select Insert New Object Select Create Control and ICONICS GWXSwitch Acti
204. older frames which are later replaced by a desired object There are currently three types of template objects bitmaps metafiles and OLE objects When a template object is added to a display it shows a text message like Double click Here to Add Bitmap When you double click on the object you are prompted for a bitmap file to replace the template object at its current size and location This feature can be used to lay out generic displays which can be specialized later by filling in the placeholders for bitmaps metafiles and OLE objects The Set Original Dimensions feature restores a bitmap to its actual dimensions after it has been stretched to another size Using Templates 8 3 Procedure Overview Table 8 1 Using Templates To Do This Create a Template Insert Template Objects Apply a Template Remove an Applied Template Edit an Applied Template Update Template Displays Follow These Steps On the File menu select New Modify file as desired On the File menu select Save Enter file name and choose template display tdf as the file type On the Format menu select Template gt Insert Template Object Select bitmap metafile or OLE object Click OK On the Format menu select Template gt Apply Template Select a template file tdf extension and click Open Any current Template is replaced The template is placed behind any object currently on the screen On the Format menu select Template gt Rem
205. on Hides shows a hand cursor indicating you can pick the object Hides shows a frame or focus rectangle around the object able to be picked and specifies a frame fill color and border color Determines colors displayed when data points fail By default the point fail character shown for process points and data entries is an asterisk Specifies alternate colors shown when the object is disabled Note you cannot pick disabled objects Disables data input controls automatically when the associated data connection is read only or when security write access is denied for the associated data connection Specifies how fast Runtime updates can occur with a maximum update rate of 50 milliseconds Note that OPC server implementations may further restrict the update rate Allows the changes Notification Dialog to be suppressed in Runtime mode Allows application to start in Runtime mode Allows the keyboard and Number Pad parameters to be set Defining Grid Application Preferences M Graphics application preferences apply only to new displays To define grid application preferences 1 On the Format menu select Application Preferences The Application Preferences dialog box appears 2 Select the Grid tab Figure 4 8 Customizing M Graphics 4 13 Application Preferences di veea ite ste Figure 4 8 Application Preferences Grid Tab 3 Modify the fields using Table 4 7 4 Click OK Table 4 7 Grid Applicat
206. operty Inspector Dialog Box Pick Tab 3 Establish a data connection 4 Fill in the pick dynamic parameters using Table 11 11 Note Additional parameters appear depending on the type of pick action Adding Dynamics 11 27 Table 11 11 Pick Parameters Parameter Action Mouse Filename Set Aliases Key Shortcut Delete Object Name Description Custom Data Description Lists all the Pick action options load display drag drop load display back display forward popup window embedded window close window launch application download value toggle value set aliases alias dialog run VBA Script and custom command Lists the mouse button that activates the Pick action left middle or right Displays the name of the current file Opens the Alias Configuration dialog box Defines a shortcut for this Pick action Deletes this dynamic Identifies the object for OLE automation Describes the object and determines the ToolTips displayed Allows user to enter data 11 28 Advanced User s Adding a Digital Selector Dynamic To add a digital selector dynamic 1 2 oF Select two or more objects On the Dynamics menu select Selectors gt Digital Selector The Property Inspector dialog box appears with the Digital Selector tab Figure 11 11 Property Inspector Symbal mia sadede LI Rt mre Ell El Ei Ei E DataSource Drag Drop Data Source OPC Lag Tags Menu Change Remove Change Object O
207. options of choosing low and or high range Sets default color when above or below the specified range Deletes this dynamic Identifies the object for OLE automation Describes the object and determines the ToolTips displayed Allows user to enter data 11 24 Advanced User s Adding a Flash Dynamic To add a flash dynamic 1 Select the object 2 On the Dynamics menu select Actions gt Flash The Property Inspector dialog box appears with the Flash tab Figure 11 9 Property Inspector Fa Ellipse Rotation Flash C Source Drag Drop Data Source OPC Tags Tags Menu Tags Menu Alternate State Flash Rate ms 1000 Ge Hide Object Ce Flash When True Change Color C Flash When False SES ES T Show Alternate State pa irre Ealar a When Hot Flashing M Shadove Eola LJ Delete Object Name Descriptor Custom Data Custom E Cancel Apply Help Figure 11 9 Property Inspector Dialog Box Flash Tab 3 Establish a data connection 4 Fill in the flash parameters using Table 11 10 5 Click OK Adding Dynamics 11 25 Table 11 10 Flashing Action Parameters Parameter Data Source OPC Tags Drag Drop Data Source Tags Menu Flash Rate Flash When True Flash When False Hide Object Change Color Fill Color Line Color Shadow Color Show Alternate State When Not Flashing Delete Object Name Description Custom Data Description Lists t
208. ormat menu select Layers gt Edit Layer Properties The Edit Layer Properties dialog box appears Figure 7 5 Edit Layer Properties High Zoom Layerl FUL 1000 Layers FUL 1000 Layers T 1000 Layerd T 1000 Lauer T 1000 T 1000 Lauer Name Change Lauer Order 4 d Runtime Data Layer T Request data when layer is initially hidden oom visibility Range Declutter Low oom Threshold zt fo High Zoom Threshold St f UO IW Release data when layer becomes hidden Hide Laver When Data Source is FALSE zero ae T Explicitly Hide Layer Cancel Help Figure 7 5 Edit Layers Properties Dialog Box 2 Select desired layer 3 Edit layer properties using Table 7 2 4 Click OK when finished Arranging Objects 7 11 Setting Currently Active Layer To set currently active layer 1 On the Format menu select Layers gt Set Currently Active Layer The Set Currently Active Layer dialog box appears Figure 7 6 Set Currently Active Layer Primary Layer Chrl Alt U Laver Crl Alt 1 Chrl Alt e Cancel Help Figure 7 6 Set Currently Active Layer Dialog Box 2 Select desired layer 3 Click OK Note Table 7 3 describes options available after setting the current active layer Table 7 3 Setting Currently Active Layer Options Option Description Set Active Layer Next Sets the active layer after the currently selected layer Set Active Layer Previous Sets the active layer before
209. ove Applied Template On the Format menu select Template gt Edit Applied Template After modifications to the template are finished on the Format menu select Template gt Cancel Edit Applied Template to exit Edit Applied Template mode and return to Normal mode On the Format menu select Template gt Update Template Displays Enter the files for updating Click OK 8 4 Operator s Guide Detailed Procedures Creating a Template To create a template 1 On the File menu select New 2 Modify file as desired 3 On the File menu select Save The Save dialog box appears 4 Enter file name and choose template display tdf as the file type Inserting Template Objects To insert template objects 1 On the Format menu select Template gt Insert Template Object The Choose Template Object Type dialog box appears 2 Select bitmap metafile or OLE object Click OK A placeholder for the selected object type is placed in the template Applying a Template To apply a template 1 On the Format menu select Template gt Apply Template The Open dialog box appears 2 Select a template file tdf extension and click Open Any current Template is replaced The template is placed behind any object currently on the screen Note Open the Summary window to determine if a template is attached Removing an Applied Template To remove an applied template On the Format menu select Template gt Remove Applied Template
210. ows you to configure OPC data points and lists current connected Tags Tree View The tree view presents a hierarchical display of information The view includes information on network location server name and group hierarchy The view allows you to create a point name based on server location and group names This allows points from the OPC data servers to be configured from a remote client PC Outside of network connections a special setup is not required to support remote browsing 10 4 Advanced User s OPC Universal Tag Browser Dialog Box Figure 10 2 is an example of the OPC Universal Tag Browser Table 10 1 describes the areas of the OPC Universal Tag Browser OPC Universal Tag Browser ltem Id Filter Cancel I Kai CS My Computer a Retresh ERM Data Access Zu Description i Sp JE BNOPC 2 F Display Details Ef JCNTURC TU el hy DISPLAY SE SN Add Hanen EE FINI DISPLAY OV AO Se up POBJECT e AO AQ Object Type AO oa ZO Present Value Hemar o HFAA L SS GE HAMM 2 Quality femal alm LT S Pa Send Command b aie PHT UNITS Help Item ID Name Debug Figure 10 2 OPC Universal Tag Browser Dialog Box Establishing Data Source Connections 10 5 Table 10 1 Areas of the OPC Universal Tag Browser Areas of the Description OPC Universal Tag Browser Item ID Shows the full Tag name A list of previously selected points is available in the drop down list Filter Sends a filter to t
211. pect Ratio heuer Length Factor Do cs Slider Type Horizontal About Cancel Apply Help Figure 17 13 GWXSlider ActiveX Properties Dialog Box General Tab 2 Select the General tab 3 Select the About button The Iconics About Box appears Figure 17 14 17 20 Controls Iconics About Box Geen Cold Figure 17 14 Iconics About Box 4 Select the General tab The information listed includes version copyright etc M Graphics User s Manual 18 1 Chapter 18 AWXView32 ActiveX Control Introduction The M Alarm Current Events Viewer is an ActiveX control Insert the M Alarm Current Events Viewer into any ActiveX container including M Graphics and M3 Workstation The AWX View32 ActiveX control provides real time alarm detection sorting filtering viewing and reporting from OLE for Process Controls OPC Alarm and Event AE Servers It is an M Alarm Current Events Viewer which means it only displays active alarms and current operator messages Note Use the paste special function when copying the AlarmView32 ActiveX control The River of Time ocx files are designed for use with only River of Time products Refer to M Alarm User s Guide for more information October 7 2003 Johnson Controls Inc www johnsoncontrols com Code No LIT 6440180 Software Release 5 0 18 2 Controls JQRHNSON CONTR amp LS Controls Group 507 E Michigan Street P O Box 423 www johnsoncontrols
212. perties and methods of GwxVisible plus the additional properties described below Properties l GWXARCTYPE ArcType Gets sets the arc type of the arc Valid values for GWXARCTYPE are e ArcArc 0 e Arche e ArcChord 2 float StartAngle Gets sets the start angle of the arc in degrees float EndAngle Gets sets the end angle of the arc in degrees GwxSymbol GwxOleObject GwxEllipse GwxLine GwxBitmap GwxMetafile OLE Automation Reference A 21 GwxSymbol has all the properties and methods of GwxVisible plus the additional methods described below Methods 1 Boolean PushCurrentSymbol Pushes this symbol object onto the symbol edit stack This essentially makes the objects grouped in this symbol top level visible objects Some operations like Gwx Visible SetObjectDimensions are only allowed on top level objects 2 IDispatch GetVisibleObjectFromName BSTR nameSubstring Gets the visible object with the specified name or portion of a name which is an immediate child of this symbol 3 I Dispatch GetVisibleObjectFromIndex long index Gets the visible object with the specified zero based index which 1s an immediate child of this symbol Index zero is the first child object This function is useful for iterating through all the immediate child objects grouped in this symbol 4 long GetNumberOfChildVisibles Returns the number of immediate child objects grouped m this symbol GwxOleO
213. play 2 Select fonts from the Format menu The Font dialog box appears 3 Define the font parameters and click OK The text appears with the font parameters you defined Drawing an Arc To draw an arc 1 On the Draw menu select Arc 2 Left click and drag the pointer away from the start point and release Defining Line Style To define line style 1 Select the object line rectangle segmented line ellipse or arc 2 On the Format menu select line style 3 Select a line type Note Line styles only exist for line widths of 0 Defining Line Width To define the line width 1 Select the object line rectangle segmented line ellipse or arc 2 On the Format menu select line width 3 Select a line width Filling an Object with Color To fill an object with color 1 Select the object 2 On the Format menu select Toggle Fill Note Lines bitmaps and metafile images cannot be filled or unfilled with color 5 8 Operator s Guide Importing Bitmaps To import bitmaps 1 On the Draw menu select Import gt Bitmap bmp 2 Select a bitmap and click Open Importing Metafiles To import metafiles 1 On the Draw menu select Import gt Metafile emt wmf 2 Select a metafile and click Open Importing Symbols To import symbols 1 On the Draw menu select the Import gt Symbol 2 Select a symbol and drag it on the work area 3 Close the Symbol Library Exporting a Metafile To export a metafile 1
214. plication Preferences Application preferences define default operating parameters for the display editing environment These parameters apply to the environment for new displays created in M Graphics When an existing graphic needs to have the new standards applied the preferences can be copied to the current display properties General Tab The General tab of the application preferences allows the user to define line color font and general display features of the new display Window Tab The Window tab of the application preferences allows the user to define the dimensions resolution scroll bar and Runtime menu bar title bar and frame features of the new display Runtime Tab The Runtime tab of the application preferences allows the user to define Runtime features of the new display Grid Tab The Grid tab of the application preferences allows the user to define grid features of the new display Load Tabs Tab The Load Tabs tab of the application preferences allows the user to construct a row of tabs in which each tab will load a display file This feature allows the user to easily navigate through numerous display files Customizing M Graphics 4 3 ToolTips Tab The ToolTips tab of the application preferences allows the user to define which text messages will pop up when the cursor is moved over an object in the new display Display Properties Display properties define default operating parameters for the display e
215. point desired is in the Tree list box Double click on the Tag Name in the Tag name list box or highlight the name in the Tag Name list Notes Alternatively select a point previously configured in the drop down list or type in the entire name in the following format node name server name item id For local server type in server name item id 3 Click OK to finish point configuration Enter a string in the filter field to send a filter to the OPC Data server only available on OPC Data servers that support filtering 10 16 Advanced User s Adding a Simulated Variable To add a simulated variable 1 From any Property Inspector dialog box click the Tags menu button Figure 10 1 2 Select Simulation Variable The Simulated Values dialog box appears Figure 10 7 gfwsimramp long gfwsimramp float gofwsim random long gfwsim random bool ofwsim toggle bool gofwsimsine double Lox simulval Figure 10 7 M Graphics Simulated Values Dialog Box 3 Select a simulated value and click OK Establishing Data Source Connections 10 17 Editing Expressions To edit expressions 1 Inthe Property Inspector click Tags menu to open the Edit Expression dialog box Figure 10 8 2 Create or edit expressions An example is lt lt cctagl gt gt lt lt cctag2 gt gt 2 0 is the average of two analog values 3 Click OK Edit Expression ES E vptessior Arithmetic Relational Logical Bit
216. ppears 2 Select the Caption tab Figure 15 6 ICONICS GWAG auge Actives Properties Scale Scale Fonts Slider Dial Warming ones General Background Caption l Bar Needle Value M Show Main Caption ICH Gauge Text Color h Shadow Color Tooltip IHC Gauge Cancel eon He Figure 15 6 GWXGauge ActiveX Properties Dialog Box Caption Tab 3 Modify the parameters using Table 15 5 Table 15 5 Caption Tab Parameters Parameter Description Show Main Caption If checked the text entered underneath appears as the title of the gauge Text Color Allows user to select a color for the text of the gauge Shadow Color If checked allows user to select a color for the shadow of the caption text ToolTip Allows user to enter a word phrase or message to appear as a ToolTip to the user GWxXGauge ActiveX Control 15 11 Editing Bar Parameters Note The bar parameters apply only to a horizontal or vertical gauge To edit bar parameters l Scale Scale Fonts Slider Dial Warning ones General Background Caption Bar M Show Bar horizontal vertical gauge only Double click on the GWXGauge ActiveX control The GWXGauge ActiveX Properties dialog box appears Select the Bar tab Figure 15 7 ICONICS GWG auge Actives Properties Needle Value Fill Color W Bar Back Color a Edge Color E Edge Style Sunken M Bias Bar
217. presents the overridden high range for this dynamic HighRange is a string which represents an OPC tag name an expression a constant value or an M Graphics local variable This property is only used for dynamics based on an analog data source it 1s ignored for dynamics that are based on digital connections 4 BSTR LowRange Represents the overridden low range for this dynamic LowRange is a string which represents an OPC tag name an expression a constant value or an M Graphics local variable This property is only used for dynamics based on an analog data source it 1s ignored for dynamics that are based on digital connections 5 long TimerRate Frequency update rate for timer based dynamic types This property is ignored for dynamics that are not timer based Timer based dynamics include GwxFlash GwxAnimator and GwxPick OLE Automation Reference A 23 6 BSTR ObjectName Gets Sets the object name of a dynamic object The object name is used to identify the object when using certain OLE Automation methods for instance GwxDisplay GetDynamicObjectFromName M Graphics will ensure that object names are unique If you assign an object name that already exists for another dynamic object in a display M Graphics will append a number to the object name for example size would become sizel sizel would become size2 etc 7 BSTR UserDescription A description string for the dynamic object Typically
218. r dynamics to shift between more than two colors Use analog color for showing approximate measurement such as temperature Flash The flash dynamic causes an object with a digital connection to blink on and off or to flash between two colors during Runtime mode when the connected digital value goes true logical 1 or false logical 0 The default operation is for the object to flash between configured colors The Property Inspector shows the default as on off When the data point value is false logical 0 the object displays in the normally on normally off setting When the value is true logical 1 the object blinks between the colors or between visible and hidden The rate at which the object blinks is determined by the Flash Rate value Pick The pick action dynamic makes an object perform an action when clicked on during Runtime mode The pick action options are listed in Table 11 2 To update the present value of a command for an object enter the desired numeric value such as 70 2 in the Value field of the Property Inspector To enter a string command use the following syntax string Examples of sending string commands for a download value pick action To release an override command for N1 objects using the nl_display_ov attribute enter Auto in the Value field of the Property Inspector To command a Binary Data BD object at Priority 2 using a JC BASIC TELL statement enter SSET_BD 1 2 i
219. rameter Select OK Select OK and save file Paste slider bar onto graphic Right click slider bar Select Edit Symbol Right click Slider tab Select Property Inspector Select Location tab Enter High and Low Range Override limits Select Edit Aliases Select Tag Browser box Select Object gt Present_Value Select OK and save From the Command menu select Dynamics gt Intrinsics gt Pushbutton Left click on the graphic screen From the Pick tab select Action gt Download Value Select Tags Pick Object gt Present_Value Select OK From the Pick tab enter 1 or 0 into tags entry box From the Button tab replace the highlighted button text with the state1 or stateO action From the Command menu select Dynamics gt Intrinsics gt Pushbutton Left click on graphic screen From the Pick tab select Action gt Download Value Select Tags Pick Object gt N1_Display_OV Select OK From the Pick tab enter 1 or 0 into tags entry box Select OK From the Command menu select Dynamics gt Intrinsics gt Pushbutton Left click on the graphic screen From the Pick tab select Action gt Download Value Select Tags Pick Object gt N1_Display_OV Select OK From the Pick tab enter Auto into tags entry box From the Button tab replace the highlighted button text with AUTO Select OK Applies only to M5 Workstation F 8 Appendix Detailed Procedures Adding Graphic Hot Links to Other Screens To add graphic Hot
220. raphics a First graphic takes the longest to create b Duplicate a graphic for similar applications c Check library for pre drawn graphics Provide a minimum standard to follow a Standards prevent guessing about fonts and styles b Saves time c Supports corporate standards F 4 Appendix 8 Decipher and use standard symbols and files a Symbols library create rename delete categories and folders b Examples library c Drag and drop feature to create new standard symbols d Naming of objects and shared key words e Use templates to reduce duplications 9 Decide what graphic types to use a 2D 3D or Line b DIN French Johnson Controls symbols or other types 10 Provide navigational schemes a System Map could follow the Operator Workstation OWS Network Map b Menu bar buttons c Penetrate from building to floor plans to system types d Capable to link to the Internet sites 11 Allow data density on a graphic a Various view areas b Quantity of objects on the display 12 Choose fonts color palette control buttons and display standards 13 Discuss appearance style organization navigation controls display and templates 14 Provide general rules and standards Note To ensure stability and provide steady performance to N1 devices make sure the items included in the graphics are bound and connected The total number of invalid unbound and unconnected offline items should be le
221. rder 4 di S mmm Object Number 1 e Show Object On True C Show Object On False Object Name Description SS Custom Data Custom Cancel Apply Help Figure 11 11 Property Inspector Dialog Box Digital Selector Tab Establish a data connection 4 Fill in the digital selector dynamic parameters using Table 11 12 Adding Dynamics 11 29 Table 11 12 Digital Selector Parameters Parameter Data Source OPC Tags Drag Drop Data Source Tags Menu Change Button Remove Button Object Number Change Object Order Show Object On True Show Object On False Description Lists the Tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a Tag Specifies if the Data Source is eligible for drag and drop operation Opens the Expression Editor Aliases Local Variables or Simulation Variables dialog box Changes existing data connections The selected item in the data source list box is changed to the string in the data source edit control Removes currently selected data connections from the data source list box Shows the objects in the order created and their data point connections assigning priorities to the objects Changes the object order allowing you to assign new priorities for the data connections Shows the object when the connected data point goes true logical 1 Shows the object when the connected data point goes false logical
222. re Grp Fl Color RE Er FID il ote Cancel Ampy Help Figure 15 14 GWXGauge ActiveX Properties Dialog Box Warning Zones Tab 3 Modify the parameters using Table 15 13 Table 15 13 Warning Zones Tab Parameters Parameter Description Show With Scale If checked the selected warning zones display on scale Show With Scale2 lf checked the selected warning zones display on scalez2 Zone Zonez2 etc Allows user to configure up to five zones for warnings on the gauge Start Allows user to define the start value of the zone in percentages End Allows user to define the end value of the zone in percentages Fill Color Determines the color of the warning for the selected zone 15 20 Controls Viewing the About Information To view the about information 1 Double click on the GWXGauge ActiveX control The GWxXGauge ActiveX Properties dialog box appears Figure 15 15 ICONICS GWAG auge Actives Properties Scale Scale Fonts SliderDial Warming ones RK General Background Caption Dar Needle Value Data Source afwsim ramp float Tage Range Override Lov Range Ze High Range Ze h Auto Gtart Runtime Mode a tere E Update Rate g milliseconds Gauge Type Vertical ll Senge 225 If Gradients Length Factor Dm End Shale BE About Cancel Appi Help Figure 15 15 GWXGauge ActiveX Properties Dialog Box General Tab 2 Select the Genera
223. reeate 6 6 Fe ONG EO EE 6 7 FRO DIAC ING AN OI CC EE 6 9 FRED OFM i E 6 10 Chapter7 Arranging ODje CtS cccccccssecesecenseceneeeeseceeeeeneeseeesenees 7 1 TO OU CUO isis toa sess tunienn Ennni annn ne snmaesse secon seeaedeuspaensaaeuessosssueunsanssaecsnaveds deus 7 1 EEN 7 2 KU 7 2 PIOCCOUIE Hee 7 4 Detailed Procedures ssssnssnnsnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnnn 7 5 EREECHEN tege 7 5 Uae eo 8 NO 8 216 ER 7 5 Repositioning OD LE 7 5 RNT OD ee nennee mt ee neem ee ee ne eee ee 7 5 FIDON gie 7 5 Aligning Objects ccccceeccccseecccceececceeeccaueeeeseucecseeeessuecessaeeeseaeeesseeessaesessaueeesageeeeas 7 6 Spacing eise TE 7 6 Making Objects the Same Gre 7 6 PROG MAY EE 7 7 Rule large 7 8 POMC AUN t 7 9 Editing Layer elen 7 10 Setting Currently Active Layer 7 11 Chapter8 USING Templates cccsccesceeseesceesseessnseeneeeseoeseeseeeeeees 8 1 POT OCU COI EE 8 1 TOY ee TE 8 2 TG nie 8 2 WTS OD E 8 2 EE 8 3 RTE Proceduro S oiire EEEE EEEREN ERRER 8 4 Creating a Template eee eee eee neers en EEEE E EE EEEE 8 4 inserting Template ODJEC S eegent Aessen 8 4 elei leie RTR 8 4 Removing an Applied Template cccccccseccccseseecseeeecceeseeceeseessegeeesseeeessensessageeeeas 8 4 Editing an Applied Template ccccccscccccsseeeeseeeeeseeeesseeseeseeeeeseaeeesseeeesseeesseeeeess 8 5 Updating Template Displays cccccc
224. rences cccccseeececeeeeeceeeeeeseeeeeseeeeesseeeeesaeeeesaaeees 4 12 Defining Load Tabs Application Preferences ccccccseeeeeceeeeeeeeeeeneeeeeseeeeesaaeess 4 14 Defining ToolTips Application Preferences ccccceceeeceeeeeeeeeeeeeeeeeeeeeeeaaeeeeeaaeeeees 4 15 Copying Application Preferences to Display Properties 000n000n00nnnnnnnnnnnnnnnnnnnni 4 17 Saving Display Properties as Application Preferences cccccceececeeeeeseeeeeeeeeees 4 17 Resetting Default Application Preferences and Display Properties 00008 4 17 Defining a Configuration Mode Password 4 17 Setting Up the Alarm Icon Path for ActiveX Control 4 19 Chapter5 Creating Objects ccccccseeeeeeeneeeeeeeneeenseenseenseenseenesenes 5 1 MOGUC e ae EEEE RE EEEE EEEE AEAEE 5 1 Key ee Te 5 2 C nig re WO E 5 2 Rea NN CUO aae E E EE d unde E E E 5 2 W Tun Lee EE 5 2 Jeng e 5 2 Table of Contents 3 ie el EE 5 2 KONO DAOC BOK EE 5 3 Wildcards in Find Dialog BOX cccsccccccceeeeeeeseeeeeeeeaeeeeeeaaeeeeesaaeeeeeseaeeeeeseaeeeessaaeeees 5 4 select Handle Color Definitions sicccsivieiesriistsevreisiiiaticeasdvereonlisscatnaniarinienivareetubawets 5 4 TOC TROL MOM E 5 4 Proced re OV ON VIGW eegeietenge eege eege 5 5 D tailed Procedures siaschexcteneterevexetenstnreierstensdeneierstersieieedonssexebossieseeecsieeioeits 5 6 DIELO E Ee 5 6 Drawing a Segmented me 5 6 Drawing a Rectangle
225. riables Opens the Edit Aliases dialog box so user can edit current aliases 3 14 Operator s Guide Table 3 9 Tools Menu Tools Menu Options Macros Set Working Directory Alias File Editor Export to HTML Windows CE Description Opens following macro options Create Macro Edit Macro Step Macro Run Macro Clean VBA Unused Modules Visual Basic Editor Specifies current directory for saving graphics and templates Opens Alias File Editor dialog box to edit Runtime aliases Exports the graphic to HyperText Markup Language HTML As of M Graphics Release 4 0 this feature can be used only with Iconics WebHMI Specifies Windows CE preferences or Configuration for Windows Table 3 10 Mode Menu Runtime Menu Options Configure Runtime Description Switches to Configure mode Switches to Runtime mode The Mode menu only appears when M Graphics is in a container If M Graphics is running standalone Configure or Runtime appears on the menu bar Table 3 11 Help Menu Help Menu Options Help Topics About Application Description Opens online help Opens About dialog box with copyright and version information Getting Started 3 15 Mouse Functions Runtime Mode Table 3 12 describes mouse functions used in M Graphics Table 3 12 Mouse Functions Mouse Function Description Left click Selects static objects Right click Opens the Format menu Double click Opens the Prop
226. rite current file Browse Opens a dialog box to search for specific files Language Specifies language 14 30 Controls Viewing About Information To view about information 1 Double click on the TWX View32 control The Iconics About Box dialog box appears Figure 14 16 conics About Box EJ TS VIBWIET Genesis Version 5 20 54 0 Product Version 2 30 56 0 File Version 5 30 56 0 Copyright 1999 Available Disk Space 651392 KB Physical Memory 130480 KD cancel ze _ Figure 14 16 Iconics About Box Dialog Box 2 Select the General tab Editing Pens in Runtime To edit pens parameters in Runtime 1 In Runtime double click in the display to open the TWX View32 Runtime toolbar 2 Click on the Edit Pen button A Select a pen and click Edit The Edit Trend Pen dialog box appears Figure 14 17 4 Edit the parameters Refer to Table 14 21 for details TWxXView32 ActiveX Control 14 31 General Alarms Ranges Details Tag Desc gfwsim sine double Units Not Assigned Type Real Time Options Lo Visible Stair Plot Show Samples E Pen Maker Background Group in SC Not Assigned Edit Pen General Figure 14 17 Edit Trend Pen in Runtime General Tab Table 14 21 Edit Trend Pen Parameters Tab General Alarms Ranges Details Parameter Tag Description Units Options Style Low High LowLow HighHigh Alarm Lines Low High Color Format Autoscale F
227. rkstation or Internet Explorer may cause frequent crashing while switching from Configure mode to Runtime mode While in Runtime mode double clicking on the control and switching to Configure mode crashes M Graphics As a workaround we recommend while updating the graphics with TWX View32 control run M Graphics application standalone The crash only occurs when M Graphics is running within another container such as M3 Workstation or Internet Explorer TWX View32 can display data from realtime signals connected to OPC servers calculated variables using expressions simulated data and custom data through OLE automation Signal connections can be done in various ways e in Configuration mode through the pens property page e in Runtime mode through the real pens button of the toolbar e using OLE methods such as AddRealTimePen and VB Script VBA e using drag and drop text format in Runtime mode only Once a signal is connected to a TWX View32 pen the TWX View32 adds the pen to its buffering system manipulation and starts data collection and data display Use the Tags button to connect pens to realtime OPC server signals 14 4 Controls TWXView32 in Configure and Runtime Modes Within the M Graphics container and in Visual Basic forms the component is initially placed in Configure mode the user can configure the TWX View32 ActiveX through the property pages Once the application is committed to Runtime the TWX View32 is activat
228. rmance with Integrated N1 Networks Note Set the Maximum Update Rate in all newly created M Graphics files JBHNSON CONTRELS Controls Group 507 E Michigan Street P O Box 423 www johnsoncontrols com Milwaukee WI 53201 Printed in U S A
229. rmines the ToolTips displayed Allows user to enter data 11 18 Advanced User s Adding a Hide Dynamic To add a hide dynamic 1 Ss GE AE E Select the object On the Dynamics menu select Actions gt Hide The Property Inspector appears with the Hide tab Figure 11 6 Property Inspector Ellipse Rotation Hide Data Source TI Drag Drop Data Source OPC Tags Tags Menu Hide or Disable Ge Hide Object Disable Object Ce Hide Disable when False C Hide Disable when True Delete Object Hame Description Custom D ata Custom Cancel Apply Help Figure 11 6 Property Inspector Dialog Box Hide Tab Establish a data connection Select Hide Object or Disable Object Select the Hide Disable when False or Hide Disable when True Click OK Adding Dynamics 11 19 Table 11 7 Hide Parameters Parameter Data Source OPC Tags Drag Drop Data Source Tags Menu Hide or Disable Hide Disable when False Hide Disable when True Delete Object Name Description Custom Data Description Lists the tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a tag Specifies if the Data Source is eligible for drag and drop operation Opens Expression Editor Aliases Local Variables or Simulation Variables dialog box Specifies whether to hide or disable object Status of Data Source is False when object is hidden or disabled Stat
230. rowses displays available to load Add Adds a tab for a file you select Note you change an existing tab s settings by double clicking on it Delete Deletes a display tab Font Determines the font for the tab Defining ToolTips Application Preferences M Graphics application preferences apply only to new displays To define ToolTips application preferences 1 On the Format menu select Application Preferences The Application Preferences dialog box appears 2 Select the ToolTips tab Figure 4 10 4 16 Operators Guide Application Preferences Figure 4 10 Display Properties ToolTips Tab 3 Modify the fields using Table 4 9 4 Click OK Table 4 9 ToolTips Display Properties Field Show ToolTips for Dynamics Show ToolTips for Statics Description Hides shows ToolTips for dynamics Options include object name object description data source name data source value Hides shows ToolTips for statics Options include object name and object description Customizing M Graphics 4 17 Copying Application Preferences to Display Properties To copy settings from application preferences to display properties 1 On the Format menu select Apply Preferences to Properties The Choose Settings dialog box appears Figure 4 11 Choose Settings EJ which PropertiesPreferences OK I Window Cancel Help xl T I Funtime W Grid M Load Tabs MW Tooltips Apply To Ge Curent Display
231. rted to string St a Mid Str x 2 1 St2 ee LL St on Set Point ThisDisplay GetPointObjectFromName St2 If Co 1 Then Write to Excel ThisDisplay g Excel Sheet Range St Point Value Else Read From Excel Point Value ThisDisplay g Excel Sheet Range St End If Next X End Sub Return to the display and create two radio buttons Name one of them Read from Excel and the other Write to Excel Configure both of them to run a VBA Script Keep the execute Create a new macro for each of the two radio buttons Call one macro Rd and call the other Wr Both of these two macros will call the Read_Write procedure The Code for each macro Should look like this Sub Wr o As GwxPick Call ThisDisplay Read Write 1 End Sub Sub Rd o As GwxPick Call ThisDisplay Read Write 0 End Sub Go back to the display and go into Runtime Notice Excel starts up automatically with the value 0 in the Al and A2 cells If you click on the Write to Excel button and change the value of one of the process points in M Graphics you will notice the value in one of the cells in Excel changes If you click on the Read from Excel button and change one of the two values in Excel the process point will then update to match the value in Excel Troubleshooting Using Visual Basic for Applications VBA 12 29 Table 12 5 Troubleshooting Problem An Error Parsing Data Source message appears after left or right mouse click on a point data
232. rty Inspector Toolbar Button fake ia a F Description Reverses last editing action Repeats last editing action Cuts selected object to the clipboard Copies selected object to the clipboard Pastes object from clipboard Deletes selected object Opens Paste Special dialog box with paste options Pastes a copy of an object on work area Selects all objects Selects all dynamics Deletes selected dynamics Deletes all dynamics Opens Find dialog box which searches for objects properties Opens Replace dialog box which replaces specified objects properties Opens Report dialog box which generates a listing of specified objects Updates specified property on all shared objects Adds a new ActiveX object to display Displays current links for an object Opens Property Inspector for selected ActiveX object Opens Property Inspector for selected graphic object Table 3 4 View Menu View Menu Options Home Unzoom Zoom Box Zoom Zoom Selection Fit to Window Show Whole Display Decluttering Zoom Summary Info Object Count Hide Layers Toolbars Toggle Toolbars Status Bar Horizontal Scroll Bar Vertical Scroll Bar Toggle Both Scroll Bars Grid Runtime Windows Properties Mode Property Window Select Language Toolbar Button Getting Started 3 9 Description Returns display to last saved view of the document Acts as an undo for zoom
233. s Cancel Help Figure G 1 Application Preferences Dialog Box Runtime Tab 3 Change the Maximum Update Rate to the new value in milliseconds Note Depending on the graphic type changing the value affects the dynamics of the graphic 4 Click OK M Graphics User s Manual G 7 Selecting Multiple Files and Changing the Maximum Update Rate To select multiple files and change the Maximum Update Rate 1 On the Format menu select Apply Preferences to Properties The Choose Settings Dialog Box appears Figure G 2 Choose Settings ES Which Properties Preferences aw OF IT General Cancel F window Hel MW Runtime Dk T Grid IT Load Tabs Tooltips Apply To Current Display Figure G 2 Choose Settings Dialog Box Note Uncheck all properties except Runtime to reduce the risk of applying properties to all files 2 Select Multiple Files 3 Click the l button to add desired gdf files The Select Files Dialog Box appears Figure G 3 Select Files File List C Documents and Setting All Userzk pplcaton Datasdlohnson Controls C Documents and SettingstAll Users4pplication Dataohnson Controls h Cancel Help ddi D pelete Delete All Figure G 3 Select Files Dialog Box 4 Click Add and browse to desired files Click OK to add the desired files The Select Files Dialog Box closes 6 Click OK G 8 Guidelines and Recommendations for Better Graphics Perfo
234. s Increment Repeat Fate W Acceleration Delay Increment Foston Surround Cancel Ampy Help 0 Fill Color 200 m Arrow Color o ZU rms AU HEL Figure 17 6 GWXSlider ActiveX Properties Dialog Box Slow Spin Buttons Tab 3 Modify the parameters using Table 17 5 Table 17 5 Slow S Parameter Show Spin Buttons Increment Repeat Rate Fill Color Arrow Color Acceleration Delay Increment Position pin Buttons Tab Parameters Description If checked the slider has spin buttons Determines the increment or decrement value when clicking on a spin button Determines how often the increment action repeats when the user holds down the mouse on a spin button Determines the color of the spin buttons Determines the color of the arrow Allows user to keep holding down a spin button to accelerate the increment Determines when the acceleration begins after spin buttons are pressed Determines the increment or decrement value for the acceleration option Determines the position of the spin buttons relative to the slider group left or bottom group right or top or surround 17 12 Controls Editing Fast Spin Buttons Parameters To edit fast spin buttons parameters 1 Double click on the GWXSlider ActiveX control The GWXSlider ActiveX Properties dialog box appears 2 Select Fast Spin Buttons tab Figure 17 7 ICONICS GW Slider Activex Properties Sc
235. s of graphic 14 22 Controls Editing Grids Parameters The Grids tab allows the user to configure the type style size and color of the display grid The Show grid box makes the grid visible and the Snap To Grid button makes all borders of the display objects align with the grid lines To edit grids parameters 1 Double click on the TWX View32 control The TWX View32 ActiveX Properties dialog box appears 2 Select the Grids tab Figure 14 9 TWXView32 ActiveX Properties Details Time Rates Pens Settings About Info General Fonts Workspace Grids Ranges X Grids Show Lo Number WE Width E Ee Style Solid Color tw properties grid Figure 14 9 TWXView32 ActiveX Properties Dialog Box Grids Tab 3 Modify the parameters using Table 14 14 Table 14 14 Grids Tab Parameters Parameter Description Show Shows hides grid Number Specifies number of lines for each axis Width Determines line width Style Determines line style dashed dotted dotted dashed or solid Color Specifies grid color Editing Ranges Parameters To edit ranges parameters TWxXView32 ActiveX Control 14 23 1 Double click on the TWXView32 control The TWX View32 ActiveX Properties dialog box appears 2 Select the Ranges tab Figure 14 10 TWXViewS32 ActiveX Properties Style Border Sunken Position Left Format xXxxx xx Size Normal Low Toj High Tag XY
236. s on the expressions Persistent Allows a trend to be maintained when the graphic containing the trend is not active History Opens the Persistent Trend dialog box listing previously used tags Edit Refer to the Editing Pens in Runtime section in this chapter for a description of the options Delete Deletes current Tag Replace Opens the Search and Replace dialog box Refer to the Editing Objects chapter for details on the searching and replacing TWxXView32 ActiveX Control 14 29 Editing Settings Parameters To edit settings parameters 1 Double click on the TWX View32 control The TWX View32 ActiveX Properties dialog box appears 2 Select the Settings tab Figure 14 15 TWXView32 ActiveX Properties General Fonts Workspace Grids Details Time Rates Pens Preferences Statistics File IY Autostart Filename Z Main Toolbar ees JV Shift Grids Append Browse Location o tw properties settings Figure 14 15 TWXView32 ActiveX Properties Dialog Box Settings Tab 3 Modify the parameters using Table 14 20 Table 14 20 Settings Tab Parameters Parameter Description Preferences Preferences include e Autostart Automatically places TWXView32 in Runtime e Main Toolbar Show hide main toolbar e Shift Grids Enable Disable shifting of Grids Filename Specifies CSV file for saving statistical information during Runtime Append Determines if you add information to current file or overw
237. s selected False if the object is not selected Selected objects are objects that have resize grips around them This property can only be changed in Configure mode float Angle Gets sets the rotation angle of the object The angle is specified in degrees BSTR ObjectName Gets sets the object name of a visible object The object name is used to identify the object when using certain OLE Automation methods for instance GwxDisplay GetVisibleObjectFromName M Graphics will ensure that object names are unique If you assign an object name that already exists for another visible object in a display M Graphics will append a number to the object name for example tank would become tank1 tank1 would become tank2 etc BSTR UserDescription A description string for the visible object Typically this string is displayed as informational text in a ToolTip BSTR UserCustomData This string is used to store custom data Use this property to associate any additional data with the visible object Methods l void MoveObject float offsetx float offsety Moves the object by the specified offset This method only works for objects that are top level visible objects void RefreshObject Caused the visible object to be redrawn void SetObjectDimensions float left float top float width float height Sets the object s size and location This method only works for objects that are top level visible
238. s the contents of the clipboard into your document so that you may activate it using Paint Paste special Figure 6 1 Paste Special Dialog Box 2 Select the format for the object paste or paste link and decide if you want to display the object as an icon 3 Click OK Duplicating an Object To duplicate an object 1 Select an object A box with square handles surrounds the object 2 On the Edit menu select Duplicate Editing Objects 6 7 Finding an Object To find an object 1 On the Edit menu select Find The Find dialog box appears Figure 6 2 The Advance window displays the tree with the results of the Find inquiry Click Apply instead OK to see that information in the Advance Window Find Type Scope Dynamic Tag sl E Selector E Subsymibal Match case Ge hole Display T Match whole word only Multiple Files ES OF Cancel Apply Help Find what ii Advanced lt lt Dh Options Epetes Show cel etait Report to Notepad Figure 6 2 Find Dialog Box 2 Fill in the fields using Table 6 2 3 Click OK Note The Find dialog box is the same as the Report dialog box 6 8 Operator s Guide Table 6 2 Find Replace Report Dialog Box Fields Parameter Type Dynamic Tag Text Label Object Name Keyword Scope Selection Subsymbol Whole Display Multiple Files Match case Match whole word only Find what Replace with Tags Me
239. se Translations Only 3 Click OK Defining General Application Preferences M Graphics application preferences apply only to new displays To define general application preferences 1 On the Format menu select Application Preferences The Application Preferences dialog box appears 2 Select the General tab Figure 4 5 Application Preferences General window Runtime Grid Load Tabs ToolTips Line Color ine wian fo Fill Color ES esy M Shadow Color Ei Shadow Offset E E Background Color a S Y Gradient Fill Es Font Arial Size 10 Font M Scale Font When Stretching Text Display Dimensions Width J200 Height o M Quen OPC data type and ranges during configuration Display Scaling Ge Fixed Scale Display C Scaleable Display E Bessere Sepeti Hate Make backup when saving displays Cancel Help Figure 4 5 Application Preferences Dialog Box General Tab 4 8 Operator s Guide 3 Modify the fields and click OK Refer to Table 4 4 Table 4 4 General Application Preferences Field Line Color Fill Color Shadow Color Background Color Gradient Fill Line Width Line Style Shadow Offset Font Display Scaling Display Dimensions Query OPC Data Type and Ranges During Configuration Make Backup When Saving Displays Description Displays the default line color Displays the default fill color Displays the d
240. sert Format Debug Run Tools Window Help a 0 os gt II slk S SS SS 2 Lhe colt 2 Display1 ThisDisplay Code EF Bs Project Display1 GwxDisplay H DisplayUnload be Gwx32 Objects Af ThisDisplay GwxDispla Option Explicit Private Sub GwxDisplay_DisplayLoad End Sub Private Sub GwxDisplay_DisplayUnload Properties ThisDisplay ThisDisplay GwxDisplay End Sub Alphabetic Categorized BackgroundColor _ amp HOOCOCOC0 amp Redraw ScaleMode Fi Visual Basic Editor Figure 12 4 Visual Basic Editor 2 Add code forms etc to accomplish desired task Adding Event Handlers To add event handlers 1 Open a display 2 On the Tools menu select Macros gt Visual Basic Editor The M Graphics VBA Project loads by default Open the ThisDisplay module from the VBA Editor 4 Select the GwxDisplay module in left combo box of ThisDisplay module 5 Select the desired event from the list in the right combo box Note The subroutine header is automatically inserted to current module Insert your VBA code to the body of the subroutine 12 18 Advanced User s 6 On the File menu select Save Display 1 7 On the File menu select Close and Return to M Graphics Displaying the ThisDisplay Module Code To display the ThisDisplay module code 1 On the View menu of the VBA Editor select Project Explorer 2 Expand the M Graphics Objects group and double click the ThisDispl
241. ss than five percent preferably none of all included items in all graphics Tips and Hints F 5 Keyboard Shortcuts Table F 1 Keyboard Shortcuts Menu Command Shortcut Edit Undo Ctrl Z Cut Ctrl X Copy Ctrl C Paste Ctrl V Delete Del Duplicate Ctrl D VBA Properties Window F4 Space Evenly Across Ctrl Shift A Down Ctrl Shift D Make Same Size Height Ctrl Shift H Width Ctrl Shift W Both Height and Width Ctrl Shift O View Home Ctrl H Zoom 50 Ctrl 1 Zoom 75 Ctrl 2 Zoom 100 Ctrl 3 Zoom 150 Ctrl 4 Zoom 250 Ctrl 5 Custom Ctrl 0 Unzoom Ctrl Shift U Zoom Selection Ctrl Shift S Fit to Window Ctrl F Show Whole Display Ctrl W Toggle Toolbars Ctrl T Status Bar Ctrl B Toggle Both Scroll Bars Ctrl L Grid Ctrl Shift G Arrange Group Into Symbol Ctrl G Ungroup Symbol Ctrl U Bring To Front Ctrl Shift PgUp Send To Back Ctrl Shift PgDn Bring Forward Ctrl PgUp Send Backward Ctrl PgDn Align Tops Ctrl Shift T Bottoms Ctrl Shift B Middles Ctrl Shift M Lefts Ctrl Shift L Rights Ctrl Shift R Center Ctrl Shift C Configure Runtime Mode Ctrl M F 6 Appendix Additional M Graphics Shortcuts and Features The following are all additional M Graphics Shortcuts and Features that help in creating and maintaining displays Arrow Key Resize While in the Configuration mode change the size and shape of the object using the arrow keys shift key and control key Holding down the Control and Shift keys while pressing the arrow keys adjusts th
242. ss Statistics dialog box which provides M Graphics Runtime information Allows user to select a language Table 3 15 Tools Menu Tool Menu Options Set Working Directory Description Allows user to set up working directory Getting Started 3 17 Table 3 16 Runtime Mode Menu View Menu Options Description Configure Switches to Configure mode If M Graphics is not running in a container the Configure option is menu available Table 3 17 Runtime Help Menu Help Menu Options Description Help Topics Opens online help About Application Opens About dialog box with copyright and version information 3 18 Operator s Guide Procedure Overview Table 3 18 Getting Started To Do This Start M Graphics Create a New Display Open a Display Save a Display Print a Display Use Zoom Manage Display Area Define Summary Information View Statistics View Object Count Statistics Start Runtime Load a Display in Runtime Print the Full Screen in Runtime Exit M Graphics Follow These Steps On the Windows Start menu select Programs gt Johnson Controls gt M Graphics On the File menu select New On the File menu select Open Select a display file Click OK On the File menu select Save or Save As Enter a file name and file type On the File menu select Print Specify the range of pages to be printed the number of copies the destination printer and other printer setup options Clic
243. ssaeeeeseaeeeesaaaes F 2 ISAC e ee F 3 SV OO Eege F 5 Additional M Graphics Shortcuts and Features ccccccecceeseeeeeeeeeeeeeeeeeeaeeeeeaseeeees F 6 EI eiweg F 6 le Re F 7 Detailed PI OCC E F 8 Adding Graphic Hot Links to Other Screens nssnnsnsnnnneereeerrrererrrrrssrrrrssnrrresrrreene F 8 Adding Fan Rotation to a Gl A DING sere ceesnttsendetce lec ccassecusbhiwebadcarssnusdehadndecdiabdoesecmbammen F 8 Adding Command Operation Box to Object when Clicking Left or Right Mouse Button F 9 Adding Focus Window Screen to Object when Clicking Left or Right Mouse Button F 9 Creating a Slider Bar F 10 Adding On Off Binary Commands to PushbuttonS eee cece ee eeeeeeeeeeeeeeeeeeeeeeaeeees F 10 Adding Override Binary Commands to Rusbbuttons reee F 11 Adding the Auto Binary Command to a Pushbutton ce cceeeseeeeeeeeeeeeeeeseeeeeenaeees F 11 Appendix G Guidelines and Recommendations for Better Graphics Performance with Integrated N1 Networks c cssecssseeeseeeees G 1 edel e EE G 1 EEN G 2 Guidelines and Recommendations for Better Graphics Performance Overview G 2 Modifiable mare Lis E G 3 Maximum Update Rate Default Value nnnnnennnnnennenseneeesrrrresrrrrnsrrrrrsrrrrnsrrrresrrreene G 4 Pororm aneo HDS E G 4 RTE FTOCOOUTOS sra aene EE EEEE EEEE E EEEE EEE G 6 Changing the Maximum Update Rate ccccccceccssseeeeeeeseeeeeeeeeeaeeseeeeeeeeeeeeeeeenaas G 6 Selecting Multiple Files and Chan
244. ssceheicescctaRaacariabaniiadeseueds Glen hedsvnaleniesssPeisenidaneieentvees 16 13 Chapter 17 GWXSlider ActiveX Control cccsssecseseessceenseeeseesseens 17 1 BET OOO CHOU eiin IEEE 17 1 EEN 17 2 GW Slider ACTING XCOM e EE 17 2 GWX Slider ActiveX PROD CMOS suspina EEE EE EE 17 2 Proc dure QVC VIOW eege 17 4 Detailed e 17 5 Inserting a GWXSlider ActiveX Control 17 5 Editing General Parameters issursscirrisiniiniiann enrian n Eia aeeai 17 7 EANG IOF e E E eee 17 9 Editing Slow Spin Buttons Harameierg 17 11 Editing Fast Spin Buttons Parameters 2 lt lt c 0 c 0cccsseceeeseeeeccesceseecsseeeesenscceeesescese 17 12 Editing Scale E 17 13 Editing Background Parameters cccccccceeecceeeeeeeeeeseeeeseeeesseeeeaueeeseeeeeeeeseeseeaaees 17 15 Editing Caption Parameters cccccccccssseccceececcenececsueeeeceuseesaueeessaeeeesauseessueeessaeees 17 16 Editing Value Parameters EE 17 17 Editing Fonts TE 17 18 Viewing the About Information 2225 e2cdshenessee lt dncsndsse headend saniaiuadauandndahvnesseacasataabenunpoers 17 19 Chapter 18 AWXView32 ActiveX Control ccccsscessecssneessseesssens 18 1 le de e UC OM E 18 1 Appendix A OLE Automation Reference csceecsceesececeeeeceseeceeeesens A 1 SVT OU COD oars dances sanganay A E AE E A 1 Key ee Te A 2 Properties ANd Methods A A 2 CUSTOM b iel ale te A A 2 Custom Command EXECUIOM eeben Ate ee de Seege A 3 E RTE A 3 EE A 17 EE EEN A 19 EU e e Te UE A 2
245. sssccccsseccceseeecsensecseueeeseeueesseeeesseesesseeseeseeeenas 8 5 Chapter9 Using the Property INSPe CtOF ccccseeseeeeeeeeeeeeeeneeeenees 9 1 Table of Contents 5 BEE OCU CHOON aa EEEE REE EERE EEEE 9 1 Key ee e Te 9 2 Property TNS OCC OK E 9 2 Update Shared ObDje CIS cccccccscecescsseseesccsceeescceeeeescsseecenceseeeeseseeeeescaseeenscceseeeses 9 3 Proced re OVEIVICW eeeegesegegegeged see gegeee dees dE ENEE EES EEN SEENEN 9 4 RTE FE OCC e TE 9 5 Editing Object Parameters in the Property Inspector n nnnnnnnneennnennnnnnnnnennnnnnnnennee 9 5 Updating Shared Objects ractccespacaececnntrseieremsatiactdaunaiepnevensunecsieieaeiosseimocsemetaunctocedennias 9 5 Chapter 10 Establishing Data Source Connections 0008 10 1 edel e OI EE 10 1 EE 10 2 Data Source Connections soeanneseninenennnenennrensrnrrrrnrrrrnnrerrrrrnrrennnresnnrennnnrrnnnnnen 10 2 OPC Universal Tag Browser 10 3 RE e CC 10 5 KEE EE 10 5 Local M Graphics Variables EE 10 6 E EE 10 6 MVNO VAUS siese E E 10 7 Beie anrr anenun nenun nrn nne nenne 10 8 Procedure QV E 10 11 RTE FIOCC GUN CS EET A E I I 10 12 Seine aere EE Rer 10 12 Operating the OPC Universal Tag Browser 10 14 Adding a Simulated Variable sssisarceisoneu sseni pin Ea iiaia 10 16 Editing Sale EE 10 17 Editing Beer 10 18 Creating an E a ize aetetsesacsenneettoseteie seamielstasetexooctauentyeirsmantecwenleeeabes tau oaarancoecieseabactennede 10 19
246. symbo Rotation Angle Cancel Whole Display Text Label Help Multiple Files Dynamic Tag Updated shared Figure 9 2 Update Shared Objects Dialog Box 2 Fill in the fields using Table 9 2 Table 9 2 User Interface for Update Shared Objects Parameter Description Scope Determines the operating space for the operation Selection Works in current selection if there are no objects selected this option is disabled Subsymbol Works in subsymbol if there is no subsymbol edited this option is disabled Whole Works in whole display any subsymbol editing is left and replaced Display by a root edit level Multiple Works in a group of file displays any subsymbol editing is left and Files replaced by root level If there are changes in the current document a dialog appears to save the changes or cancel the operation Preserve Preserve not update any of the following attributes by checking the appropriate check boxes Object Dimensions Rotation Angle Text Label and Dynamic Tag 9 6 Operator s Guide Chapter 10 Establishing Data Source M Graphics User s Manual 10 1 Connections Introduction Dynamic animation is achieved by transforming visible objects based on specified data source connections This chapter describes how to connect to a data source operate the OPC Universal Tag Browser add a simulated variable edit expressions edit local variables create an Alias edit an Alias
247. t E duct ducta ducta duch duch D 4 Appendix Table D 1 Johnson Controls Symbols Examples Cont Ka lel Return Far Supply Fan HeatE kilowatt temp volt Pitot Temp ZAM Ou 2 Way sy ay Humid tot Pitot Press Press Presb U E L 3 Temps Temp Temp Templo Templ Tempe M Graphics User s Manual Ei Appendix E Other Symbol Library Introduction This chapter provides examples of the Other symbols included with M Graphics Symbols are continually added refer to the software for a complete set January 2001 Johnson Controls Inc Code No LIT 6440230 E 2 Appendix Key Concepts Symbol Library The symbol libraries with prebound tags provided with M Graphics aid in the creation of facility drawings Users can just modify the alias name to change the binding reference There are four categories of symbols DIN French Johnson Controls and other To import a symbol in M Graphics click the Import Symbol icon EI or on the Draw menu select Import and click on Symbol Other Symbol Library E 3 Other Symbols Examples Table E 1 Other Symbols Examples U d d Ai LS de oD Zaau 3D Sway valve 3D Away 0 Angle 3 D Adsorption 3 0 Adsorption solenoid valve solenoid valve Blowdown valve Column dryer with reset nen 3 D Delt conveyor 3 0 Bag filter 3 D Ball valve OD Belt dryer 3 D Circuit 3 D Blowdown breaker 30 Cone root valve tank valve with hand actuator
248. t a certain percentage of the full range Displays the percentage for each object Changes the percentage chosen if you type a new value in the percentage field Resets the percentages chosen for the items to the default values the default values are an even distribution within the available range based on the number of objects selected Change the order of the objects belonging to this analog selector Activates an operating range other than the default range for the data point when this box is checked Allows you to specify a High Range and a Low Range Provides the Tags and Expression button to help you do so Shows the objects in the order they were created Hides all the associated objects when the value of the connected data point is below the specified range Hides all the associated objects when the value of the connected data point is above the specified range 11 32 Advanced User s Adding an Animator Dynamic To add an animator dynamic 1 Select two or more objects 2 On the Dynamics menu select Actions gt Animator The Property Inspector dialog box appears with the Animator tab Figure 11 13 Property Inspector Symbol Animator Data Source Drag Drop Data Source OPC Tags Tags Menu Tags Menu Change Frame Order 4 d Frame Rate ma Do P 8 fe Animate When True C Animate When False visible When Off Visible When Off _ Curent Frame when Off Frame Number 1 Ge First Fr
249. t call different attributes have less impact on performance than tags that each reference a unique object Note M Web does not support most of the M Graphics animation features including the layering features See the Commissioning Metasys M Web Technical Bulletin LIT 643210 for more information Target Maximum of 300 Object Tags per Network Control Module NCM for a Starfield Display On a single NCM limit the number of object tags to 300 object tags per Starfield Display Note If tags displayed in a Starfield Display are divided among multiple NCMs the maximum is 1 000 object tags M Graphics User s Manual G 3 Target Maximum of 300 Objects Attributes Tags Accessed per NCM at Any One Time Across All Display Features and All Display Devices This maximum includes logs trends graphics and Metasys Data Visualization MDV features Since this limit can be difficult to determine consider adding diagnostic data points with alarm limits to detect if NCM idle time is consistently less than 50 For more information on the Analog Data AD Object refer to the Reference section of the DDL Programmer s Manual LIT 630040 Each operator device requesting data has its own instance for data signup and loads the NCM more heavily even if each device requests the same points A single device requesting multiple instances of the same type of data does not load the NCM as heavily because data requests are coordinated within the
250. t scope including multiple files scope Specifies the string to replace the characters found A drop down menu lists possible strings This set of strings is determined by the Scope and by the Type radios Wildcards do not work here Opens the Expression Editor Local Variables or Simulation Variables dialog box Toggles between a big dialog box when the tree view and the Show button are visible and a small dialog box Opens Report Options dialog box and provides the following options for inclusion in report tree object name keyword dimensions user description custom data dynamic actions and dynamic tags The Report Options dialog box determines how the items are enclosed double quote quote or nothing Highlights the item selection found in the list Displays Property dialog box for highlighted item Displays results of query in Notepad Editing Objects 6 9 Replacing an Object To replace an object 1 On the Edit menu select Replace The Replace dialog box appears Figure 6 3 Replace Find what ii Advanced lt lt Replace with sl Tage Menu Type Scope e Subsombal Cancel Match case Ge hole Display Apply Match whole word only Multiple Files CS Help Options Epetes Show Zapopchon Report to Notepad Figure 6 3 Replace Dialog Box 2 Fill in the fields using Table 6 2 3 Click OK 6 10 Operator s Guide Reporting an Object To report an object 1 On the E
251. tails tab Figure 14 11 THAY ew Actives Properties General Fonts Workspace Grids Ranges ou Stas Time TI Rates Pens Settings M Signal Name if Den Description Den Units Hi Lo Values Hi Lo Alarms T HH LL Alarm Quality Filter Test Color Back Color Spacing Style Border Sunken sl Lann a MMDD r oF MW Show Header MW Show Tooltips Number of Entries E hg Pen Value W Time Stamp value MW Date Stamp Format Date Format IT Saus Cancel CDD Help Figure 14 11 TWXView32 ActiveX Properties Dialog Box Details Tab 3 Modify the parameters using Table 14 16 Table 14 16 Details Tab Parameters Parameter Entries Text Color Back Color Description Determines what entries appear in Runtime mode Determines the color of the text Determines the color the background appears Style Border Determines the style of object Determines the type of border bumped etched raised or Value Format sunken Determines details placement bottom bottom left bottom Date Format right left rectangle right top top left or top right Determines the appearance of the month date and year Show Header Shows hides the header Shows hides the ToolTips Show ToolTips Number of Entries Determines how many entries appear on graphic 14 26 Controls Editing Time Parameters To edit time parameters l Dou
252. tandard function of ActiveX objects that allows the conversion of ActiveX objects to metafiles bitmaps icons etc However this function has no purpose in M Graphics ActiveX objects Chapter 14 M Graphics User s Manual 14 1 TWXView32 ActiveX Control Introduction The TWX View32 is an OPC Client application and provides realtime trending within the M Graphics product family This chapter describes how to insert a TWX View32 control edit general parameters edit fonts parameters edit workspace parameters edit grids parameters edit ranges parameters edit details parameters edit time parameters edit rate parameters edit pens parameters edit settings parameters view about information edit pens in Runtime edit trend in Runtime edit period in Runtime toggle freeze unfreeze in Runtime view Statistics in Runtime edit the focus pen in Runtime move between samples in Runtime January 2001 Johnson Controls Inc Code No LIT 6440140 14 2 Controls Key Concepts TWXView32 ActiveX Control TWX View32 ActiveX can be used with third party OPC server applications to provide excellent trending features Some of TrendWorX32 Viewer features include displaying realtime data managing a sophisticated multi threaded data buffering to guarantee data integrity with support for customer configurable data collection rates independent data collection screen refresh mechanism extensive Runtime configuration bui
253. ted Alias Alias Name Alas Definition lt lt OPC Tags Double click list tems to select ei Tags Meru duplicate alias names Dbject Name J Mame L tze Definition FAMSFEED lt lt FANSPEED gt Petmanentl Resolve Aliases On Ok Cancel Help Figure 10 10 Edit Aliases Dialog Box 10 20 Advanced User s 3 Fill in the fields following Table 10 9 Table 10 9 Edit Aliases Preferences Field Description Alias Name Displays the name of the current object selected Alias Definition Changes the definition for all selected Alias names OPC Tags Displays the OPC Universal Tag Browser dialog box Tags Menu Opens the Expression Editor Alias Local Variables or Simulation Variables dialog box Permanently Resolved Resolves Aliases when the OK button is clicked Aliases On Ok Aliases are normally resolved when entering Runtime mode Resolves the Aliases in Configuration mode 4 Repeat Step 3 for all Aliases 5 Click OK Setting Runtime Alias To set Runtime Alias 1 Click the Set Aliases button on the Pick tab of the Property Inspector The Set Aliases Configuration dialog box appears Figure 10 11 Note This interface may vary slightly depending upon the action being configured 2 Fill in parameters using Table 10 10 Establishing Data Source Connections 10 21 E et Aliases Configuration Frc rt o Add Gees chans ren Loes Tenuen Figure 10 11 Set Aliases
254. ted properties can be manipulated directly through C clients which support OLE containment or Visual Basic applications TWXView32 Object Capability This section describes the objects exposed through OLE automation used in TWX View32 These are easily viewed in the Visual Basic Object Browser 14 6 Controls Project1 Microsoft Visual Basic design Object Browser Je File Edit View Project Format Debug Run Tools Addins Window Help SS Project1 Project T N Fom TWwxForm AboutBox V AddRealTimePen Appearance Z BackColor po E ZA BorderEdge Gd BorderOptions Form Form1 BorderStyle Alphabetic Categorized ComputeStat A Container KU e Appearance 1 2 CursorStep Ai taARaedrans Falea 7 DatabaseChanged Name il i 7 ame GT DataBindings Returns the name used in DeletePen code to identify an object Class TWXViewer Member of TWXVIEWERLib A Start Cl twxv320cx WordPad Q Exploring DAGFW32bit is Project Microsoft V 12 56 PM object browser Figure 14 2 Object Browser TWXView32 Properties The TWXView32 ActiveX Properties dialog box is the configuration user interface to the ActiveX Double clicking anywhere in the ActiveX client during Configure mode opens the TWX View32 Properties dialog box Figure 14 3 The
255. temper ups Humid clocks e buzzalm C 4 Appendix Table C 1 French Symbols Examples Cont UELS E Ea detectr doorace musl light airtlo dtherm A T n f f gaine hum pipe pressured press stherm Al W ZG d H 1 o d elec swcont swpoz valved valvech valede Is Wa a VH vivpos valves EI videol M Graphic s Users Manual D 1 Appendix D Johnson Controls Symbol Library Introduction This chapter provides examples of the Johnson Controls symbols included with M Graphics Symbols are continually added refer to the software for a complete set January 2001 Johnson Controls Inc Code No LIT 6440220 D 2 Appendix Key Concepts Symbol Library The symbol libraries with prebound tags provided with M Graphics aid in the creation of facility drawings Users can just modify the alias name to change the binding reference There are four categories of symbols DIN French Johnson Controls and other To import a symbol in M Graphics click the Import Symbol icon EI or on the Draw menu select Import and click on Symbol Johnson Controls Symbol Library D 3 Johnson Controls Symbols Examples Table D 1 Johnson Controls Symbols Examples Chill Chill l l hw coil r cw coil lectrtic adjusts lider start stop snitch Towers Char wl Rm diw pias dampi 19100 actuator damp5 dampb Ah Airflow Arrow Arrow duct duct 3 i S JEg duc
256. template cancel edit applied template insert template object and update template displays Opens submenu with the following options add layer remove layer duplicate layer edit layer properties set current active layer set active layer next set active layer previous hide layers above current layer and hide layers below current layer Allows a password to be set for graphic configuration Opens Color Palette for selecting a background color Opens Color Palette for selecting a fill color Opens Color Palette for selecting a line color Opens submenu for selecting one of ten line widths Opens submenu for selecting one of five line styles Toggles between fill and unfill Toggles between freeze and unfreeze The Freeze function disables the movement or stretching of objects in the work area Opens Font dialog box for selecting font font style size effects and script Shows display properties Saves display properties as application preferences Resets display properties to factory default Shows application preferences Saves application preferences as display properties Resets application preferences to factory default Table 3 6 Arrange Menu Arrange Menu Options Group into Symbol Ungroup Symbol Bring to Front Send to Back Bring Forward Send Backward Rotate Flip Free Rotate Align Space Evenly Make Same Size
257. the button From the Draw menu select Segmented Line Left click and release the mouse from point to point From the Draw menu select Rectangle Square Left click and drag to form the box Pressing Shift while you draw forms a perfectly square box From the Draw menu select Ellipse Circle Left click and drag the pointer anywhere in the work area to form an ellipse From the Draw menu select Text Left click on the work area Type the text and left click outside the text to insert Select the text objects in your display Select fonts from the Format menu Define the font parameters and click OK On the Draw menu select Arc Left click and drag the pointer away from the start point and release Select the object On the Format menu select line style Select a line type Select the object On the Format menu select line width Select a line width Select the object On the Format menu select Toggle Fill On the Draw menu select Import gt Bitmap Select a bitmap and click Open On the Draw menu select Import gt Metafile Select a metafile and click Open On the Draw menu select the Import gt Symbol Select a symbol and drag it on the work area Close the Symbol Library On the Draw menu select Export gt Metafile Select a file and click OK Select the object On the Format menu select Toggle Freeze On the Edit menu select Insert New Object Choose either Create New Create from File or
258. the currently selected layer Hide Layers Above Hides all layers above the currently active layer Current Layer Hide Layers Below Current Hides all layers below the currently active layer Layer 7 12 Operator s Guide M Graphics Users Manual 8 1 Chapter 8 Using Templates Introduction Templates allow users to create a framework that saves time when creating new display files This chapter describes how to e create a template e insert template objects e apply a template e remove an applied template e edit an applied template e update template displays January 2001 Johnson Controls Inc Code No LIT 6440080 8 2 Operator s Guide Key Concepts Templates Templates are created by saving a display with a template file extension tdf Templates can contain anything a standard display contains including static dynamics objects standard color and shapes Templates save time by allowing you to create a framework that can be applied to all your display files Templates are essentially backgrounds useful for implementing a consistent and standard look in graphic files Update Template Displays The update template displays function 1s used to globally update displays that have the same template file applied to them as the template file currently being updated Changes made while editing a tdf file will be applied to displays based on that tdf file Template Object Template objects are essentially placeh
259. the display Elements of each layer Declutter automatically hide or show depending on the current zoom percent The default Zoom Threshold is 0 1000 Runtime Data Set how data should be retrieved from the OPC Server during Runtime To retrieve data when the layer is hidden Check Request data when layer is initially hidden To release data when layer becomes hidden check Release data when layer becomes hidden Explicitly Hide Layer When checked forces the layer to remain hidden even if the zoom threshold indicates the layer is visible Layer remains hidden until this option is turned off unchecked Note Ifa check appears to the left of the layer name that layer is hidden during runtime 7 8 Operator s Guide Removing Layers To remove a layer 1 On the Format menu select Layer gt Remove Layer The Remove Layer dialog box appears Figure 7 3 Remove Layer Laver Hame Layerl Layers Layers Cancel Help Figure 7 3 Remove Layer Dialog Box 2 Select the layer to remove 3 Click OK Arranging Objects 7 9 Duplicating Layers To duplicate a layer 1 On the Format menu select Layer gt Duplicate Layer The Duplicate Layer dialog box appears Figure 7 4 Duplicate Layer Laver Hame Layerl Laver Layers Figure 7 4 Duplicate Layer Dialog Box 2 Select the layer to duplicate 3 Click OK 7 10 Operator s Guide Editing Layer Properties To edit layer properties 1 On the F
260. thods and properties Descriptions of classes are stored in type libraries and can be viewed with object browsers Objects Objects are encapsulated which means they contain both their code and their data This makes them easier to maintain than traditional code Visual Basic objects have properties methods and events Methods and Properties Properties are data that describe an object Methods are object actions Events are actions the object performs Development Using Visual Basic for Applications VBA uses an event driven model approach for development Visual Basic interprets the code as you write it Write compile and test code during the development 12 4 Advanced User s VBA Editor VBA Editor is an Integrated Development Environment IDE and 1s integrated into M Graphics It can be opened from the M Graphics menu bar Create edit debug and run Visual Basic code using the Visual Basic Editor The custom code 1s stored in modules class modules and forms The VBA Editor supports project management Create projects using the Editor Projects can contain M Graphics objects VB modules forms windows etc Projects can be opened or closed from the View menu VBA Editor Menu Bar The menu bar displays the commands used with VBA It consists of several menus File Edit View Window Help Project Format and Debug VBA Editor Context Menus The context menus can be invoked by right clicking an object The
261. ting Workspace EE 14 21 Editing Elle A En E 14 22 Editing Ranges Parameters cccceecccseeecceeeeeeeeeceeeeeaeeeeceueeseueeseueessaeeeseeeesaeeeeaaess 14 23 Editing Details Parameters EE 14 25 Editing Time Parameters AE 14 26 Editing Rate eut 14 27 8 M Graphics User s Manual Editing PENS Parameters AE 14 28 Editing Settings Harameiers 14 29 Viewing About Information ccccceceeeeceeeeeeeeeeseeeeseeeesaueeseueeesaeeeseeeeseueeeseeeeseeeesees 14 30 Editing Pens IN RUNUMO E 14 30 Seille giele Ta lun CN 14 32 PARO OO TERA UNUN ee ter eecree rie gecesi at ones aman bean N E E 14 33 Toggling Freeze Unfreeze in Runtime cccccssececeeeeeeceeseeceeeeesseeseeseeeesaeeessaes 14 33 VIEWING Statistics IN RUNTIME cccceeccccseeeeceeeeeeseeeeeceeeeeseeeeeeseeeeseeeeesaeeeessaeeeesaes 14 34 Editing the FOCUS Pen in Runtime saennnennnennnennnnnnsnnnsnnnsnrnrnrnrrrnnnrrnnrerrrsrrrseernne 14 34 Moving Between Samples in Huntme 14 35 Chapter 15 GWXGauge ActiveX Control ccccceeeeeeeeeeeeeseeeeeesees 15 1 NET OO UC HOW PPIP PE T EE PEE E E EA AN AAE 15 1 TROY CONC CS eege 15 2 GWX Gauge AGIVeX C ONINO E 15 2 GW XGauge ActiveX een EE 15 2 Procede OU CIVIC gsc re ese eee ae 15 4 RTE FR OCCO TE 15 5 Inserting a GWXGauge ActiveX Control 15 5 Editing General Parameters na0nnnn0annnnnannnonennnonnnnnerrrrrennnrrenrnrrennnrrrnnnrrrnnnrreneneeee 15 7 Editing Background Parameters
262. tion Tab 3 Establish a data connection 4 Fill in the rotation dynamic parameters using Table 11 6 5 Click OK Adding Dynamics 11 17 Table 11 6 Rotation Parameters Parameter Data Source OPC Tags Drag Drop Data Source Tags Menu Start End Set Angles and Pivot Rotation Direction Dial Tracking Continuous Update Detents Range Override Delete Object Name Description Custom Data Description Lists the tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a tag Specifies if the Data Source is eligible for drag and drop operation Opens Expression Editor Aliases Local Variables or Simulation Variables dialog box Defines the angle to start the rotation Defines the angle to end the rotation Allows graphically setting the angle of rotation and defines the coordinates of the pivot point of the object Defines a rotation direction clockwise or counterclockwise Allows you to manually rotate the object If checked moves the object based on the connected data value If unchecked the object remains stationary unless manually moved by you This is part of the dial action Toggles if the dynamic is continuously updated Moves the object in steps at specific intervals This is part of the dial action Activates an operating range other than the default range for the data point Deletes this dynamic Identifies the object for OLE automation Describes the object and dete
263. track left or bottom right or top or both GWXSlider ActiveX Control 17 15 Editing Background Parameters To edit background parameters 1 Double click on the GWXSlider ActiveX control The GWXSlider ActiveX Properties dialog box appears 2 Select the Background tab Figure 17 9 ICONICS GWA Slider Actives Properties General Slider Slow Spin Buttons Fast Spin Buttons Scale Background Caption Value Fonts l MW Use Containers Background Color Eackaaunad Ealar E W Show Back Face W Fill Color E dge Color E Edge Style Fiaised ll Cancel pli Help Figure 17 9 GWXSlider ActiveX Properties Dialog Box Background Tab 3 Modify the parameters using Table 17 8 Table 17 8 Background Tab Parameters Parameter Description Use Container s If checked the background color of the slider matches Background Color the background color of the container If unchecked allows user to select a color for the background of the slider which has a border around it Show Back Face If checked the slider has an edge border Fill Color Allows user to select a color for the slider Default is gray Edge Color Allows user to select a color for the edge of the slider Edge Style Allows user to select a style for the edge of the slider thin line medium line thick line etched bump raised sunken or no edge Default is raised 17 16 Controls Editing Caption Parameters To edit
264. trol During Runtime mode move the slider knob to change the value of the connected data point Use the location slider dynamic for arrows slider bars and motion through pipes Adding Dynamics 11 5 Rotation Dial The rotation dial dynamic rotates an object based on the connected data point value You define the rotation pivot coordinates This function is useful when graphically displaying information on dials or meters in the display Use the rotation dial dynamic for dampers meters gauges and levers Hide Disable The hide disable dynamic causes objects to hide when the value of the digital data point is connected to goes either true logical 1 or false logical 0 Use the hide disable dynamic for displaying information when a Boolean tag becomes true or false Color The color dynamic changes the color of the object based on an event The color connections are prioritized in the order in which they are created Therefore if two data points are true at the same time the higher priority color connection takes precedence If none of the connected data points is true the object displays in its original color The color dynamic is useful for indicating such states as alarm conditions and temperature changes or for notifying operators of the flow in a pipe 11 6 Advanced User s Analog Color The analog color dynamic changes the start color and end color based on an analog signal Attach multiple analog colo
265. untime mode Value Format Allows user to determine how the data is displayed from 21 numeric formats such as xxxx Text Edge Color Determines the color of the text Fill Color Determines the color of the box that displays the values Edge Style Determines the style of the edge of the box 15 14 Controls Editing Scale1 Parameters To edit scalel parameters 1 Double click on the GWXGauge ActiveX control The GW xXGauge ActiveX Properties dialog box appears 2 Select the Scalel tab Figure 15 10 ICONICS GW Gauge Actives Properties E4 General Background Caption Bar Needle Value W Show Scale Low A ange High Range Label Every Label Format Text Color Units Label Scale Fonts _ f 00 Tag WW Major Ticks WW Inte Slider Dial l Warming Zones Major Tick Divisions E Minor Tick Divisions H Tick Color Tick Style ThinLine sl Cancel Analy Help Figure 15 10 GWXGauge ActiveX Properties Dialog Box Scale1 Tab 3 Modify the parameters using Table 15 9 Table 15 9 Scale1 Tab Parameters Parameter Show Scale Low High Range Label Every Label Format Text Color Units Label Major Tick Divisions Minor Tick Divisions Tick Color Tick Style Description If checked the gauge has a scale Determines the low and high numbers for the scale Determines the number of major ticks between labels Allows user to determine how the label is displayed from 21 form
266. urce is eligible for drag and drop operation Opens Expression Editor Aliases Local Variables or Simulation Variables dialog box Determines object direction side to side up and down back and forth diagonally or free form Activates an operating range other than the default for the data point Allows range of motion limits to be defined graphically Allows you to hold an object with the mouse and move it Toggles if the object moves based on the connected data value or remains stationary Toggles if the dynamic is continuously updated Moves the object at specific intervals Identifies the object for OLE automation Describes the object and determines the ToolTips displayed Allows user to enter data Deletes this dynamic 11 16 Advanced User s Adding a Rotation Dynamic To add a rotation dynamic 1 Select the object 2 On the Dynamics menu select Actions gt Rotation The Property Inspector dialog box appears with the Rotation tab Figure 11 5 Property Inspector Ea Ellipse Rotation Data Source D Drag Drop Data Source UPL Tags Tags Menu Angles degrees Start fz60 End fo Set Angl d Fi iA wel Angles and Frvot F Tracing fence E fentueus Update Det Ir EES p Delete Object Hame Description Custom Data Custom Rotation Direction Ce Clockwise C Counterclockwise Cancel Apply Help Figure 11 5 Property Inspector Dialog Box Rota
267. us of Data Source is True when object is hidden or disabled Deletes this dynamic Identifies the object for OLE automation Describes the object and determines the ToolTips displayed Allows user to enter data 11 20 Advanced User s Adding a Color Dynamic To add a color dynamic 1 Select the object 2 On the Dynamics menu select Actions gt Color The Property Inspector dialog box appears with the Color tab Figure 11 7 Property Inspector Fa Ellipse Rotation Color Data Source TT Drag Drop Data Source OFC Tags Tags Menu Add Change Remove Change Order aie E E hange olor Om fine F Lre Color E i henge tolar On Falke M Shadan olor E Delete Object Name Description Custom Data Custom Apple Color Change To B ill ator Cancel Apply Help Figure 11 7 Property Inspector Dialog Box Color Tab Establish a data connection 4 Fill in the color dynamic parameters using Table 11 8 Click OK Adding Dynamics 11 21 Table 11 8 Color Connection Parameters Parameter Data Source OPC Tags Drag Drop Data Source Tags Menu Add Change Remove Apply Color Change To Fill Color Line Color Shadow Color Change Color On True False Delete Object Name Description Custom Data Description Lists the tag that drives this dynamic Opens the OPC Universal Tag Browser to search for a Tag Specifies if the Data Source is eligible
268. vanced User s Detailed Procedures Connecting to a Data Source To connect to a data source 1 Select an object in the display 2 On the Dynamics menu select a dynamic to add The Property Inspector appears for the type of dynamic specified Figure 10 5 1s an example of a Rotation dynamic Property Inspector EJ Elipse Rotation DataSource Drag Drop Data Source UPC Tags Tags Menu Rotation Direction Ge Clockwise C Counterclockwise T Dial Set Angles and Pivot F traetine T Range Override E continuous Update out ee Deterits fe wa orc Delete Description Custom Data Custom Cancel Apply Help Figure 10 5 Property Inspector for a Rotation Dynamic Establishing Data Source Connections 10 13 3 Enter the data source in the field or click on the OPC Tags button to open the OPC Universal Tag Browser Refer to the Operating the OPC Universal Tag Browser section 1n this chapter for details Note Clicking on the Tags Menu button to open the Edit Expressions or Simulated Variables is another way to perform step three Refer to the Editing Expressions section in this chapter for details 4 Fill in the remaining dynamic fields Refer to the Adding Dynamics chapter of this manual 10 14 Advanced User s Operating the OPC Universal Tag Browser To operate the OPC Universal Tag Browser 1 Click on My Computer in the OPC Universal Tag Browser an
269. veX for the object type Click OK Double click on the GWXSwitch control Select the General tab Modify the parameters Double click on the GWXSwitch control Select the Background tab Modify the parameters Double click on the GWXSwitch control Select the Caption tab Modify the parameters Double click on the GWXSwitch control Select the Labels tab Modify the parameters Double click on the GWXSwitch control Select the Fonts tab Modify the parameters Double click on the GWXSwitch control Select the General tab Select the About button GWxXSwitch ActiveX Control 16 5 Detailed Procedures Inserting a GWXSwitch ActiveX Control To insert aGWXSwitch ActiveX control 1 In M Graphics on the Edit menu select Insert New Object The Insert Object dialog box appears Figure 16 2 Insert Object Ei jst pe ICONICS AWA eps2 Activex ICONICS Aa iewi ICONICS GWG auge Activer ICONICS DWailder Activex CONICS Gwis Swich Actves ICONICS Dwaeszel Activen ICONICS D Waawdlew id Actverx Add Control Inserts a new ICONICS Gis Gwich Activer object into your document C Create New Create from File f Create Control Result Figure 16 2 Insert Object Dialog Box 2 Select Create Control and ICONICS GWxXSwitch ActiveX for the object type 3 Click OK A GWXSwitch ActiveX control is added to the display Figure 16 3 Note As a shortcut insert a GWXSwitch ActiveX control by clicking
270. verse On Off Values Bipi Kelar M Auto Start Runtime Mode aler E hd Preserve Aspect Ratio W Gradients Gbout Cancel Ampy Help Figure 16 9 GWXSwitch ActiveX Properties Dialog Box General Tab 2 Select the General tab 3 Select the About button The Iconics About Box appears Figure 16 10 16 14 Controls lcomes About Box Figure 16 10 Iconics About Box 4 Select the General tab The information listed includes version copyright etc M Graphics User s Manual 17 1 Chapter 17 GWxXSlider ActiveX Control Introduction The GWXSlider ia an ActiveX control that can be inserted into the M Graphics application to display and modify analog data This chapter describes how to e insert a GWXSlider ActiveX control e edit general parameters e edit slider parameters e edit slow spin buttons parameters e edit fast spin buttons parameters e edit scale parameters e edit background parameters e edit caption parameters e edit value parameters e edit fonts parameters e view about information January 2001 Johnson Controls Inc Code No LIT 6440170 17 2 Controls Key Concepts GWxXSlider ActiveX Control GWXSlider ActiveX is an ActiveX control that can be inserted in the M Graphics application The GWXSlider ActiveX displays and modifies data in a virtual instrument panel format on graphics The GWXSlider ActiveX supports connection to OPC compliant servers and provides excellent c
271. vironment using any language ActiveX is based on Microsoft Object Linking and Embedding OLE and the Component Object Model COM Using Visual Basic for Applications VBA 12 7 ActiveX Control ActiveX is a type of control and is an extension to the Visual Basic Toolbox When adding an ActiveX control to a program it becomes part of the development and Runtime environment and provides new functionality for your application ActiveX Used with M Graphics ActiveX control is used to embed documents from other applications into M Graphics displays Applications supporting ActiveX include Iconics TWX View32 or other Windows applications Conversely you could open and run M Graphics displays from other applications such as Microsoft Internet Explorer Modules Code in VBA is stored in modules There are three kinds of modules form standard and class By default the VBA modules are stored in gdf files They can be exported to files and imported back Standard Module Usually the code associated with a form resides in that form module If you have forms or other modules that could use a common code create a separate module containing a procedure that implements the common code This separate module should be a standard module Each standard module can contain declarations such as type variable and procedures such as Function functions or Sub subroutines The standard module file has an extension bas Form Modules Form
272. vity However the use of 1 000 milliseconds is too slow for Simulated Values The Maximum Update Rate is specified in two locations for graphic files gdf and template files tdf e for current display Format gt Display Properties e for new displays Format gt Application Preferences To reduce CPU activity raise the Maximum Update Rate from 50 to 1 000 on all existing graphic and template files Important Symbols that utilize Simulation Values for animation no longer function properly when the maximum update rate is increased These symbols may be replaced with symbols that use the Animator dynamic which has its own update timer The NA Standard Symbol Library has been revised to remove all Simulation Values Refer to Changing the Maximum Update Rate in this chapter for more information Performance Tips Special consideration is needed when using the Animator Dynamic When developing graphic displays ask yourself How many animations are required Would consolidation help What rate are the graphics going to animate The answers to questions such as these improve the performance of the graphic displays M Graphics User s Manual G 5 General Tips The following tips help the users with displays Do not use full path names for file references This property enables accessibility from other machines without the files being in the same directory For example in the M Graphics Load action use MyDisplay gdf i
273. w The code editor window serves as an editor for entering application code A separate code editor window is created for each form or code module in an application Form Layout Window The form layout window positions the forms in an application using a small graphical representation of the screen Immediate Locals and Watch Windows These additional windows are provided for use in debugging an application They are only available when running an application within the editor Forms and Controls Forms are user interfaces which are the visual part with which the user interacts Forms and controls are the basic building blocks used to create the interface Forms are objects that expose properties defining their appearance methods defining their behavior and events defining their interaction with the user By setting the properties of the form and writing Visual Basic code to respond to its events you customize the object to meet your requirements Controls are objects contained within form objects Each type of control has its own set of properties methods and events that make it suitable for a particular purpose Examples of controls are fields for entering or displaying text Controls can also be used for accessing other applications and process data as 1f the remote application was part of your code ActiveX ActiveX is a set of integration technologies that enables software components to interoperate in a networked en
274. when an object is double clicked in Design mode a Property Inspector is launched However if there is a special keyword in the first line of the Custom Data field of Property Inspector a macro can be run The format of the key word for a macro MacroName 1s OnDoubleClick lt GwxMacroName_Main MacroName gt Parameters lt gt There must exist a macro MacroName in the module GwxMacroName_Main in VBA to successfully run the macro The user is allowed to put any string between angle brackets of a Parameters lt gt section Any data worth sending to the macro would be put between the angle brackets These data are then available when the macro runs The name of a macro cannot contain spaces Runtime Mode M Graphics can launch the VBA Wizard macro in Runtime mode by clicking an M Graphics button or a pick action configured to run a macro The Action field must be configured to Run VBA Macro The Macro Name field must contain a macro name in its format GwxMacroName_Main MacroName 12 14 Advanced User s Button Pick Action ip VaaVste ee M Mouse Left Button Type Normal Button Object Name Description Custom Data Custom Prop vba Figure 12 3 VBA Wizard in Button Custom Data can contain any string keeping custom data as desired between angle brackets VBA Wizard Rules M Graphics takes care of code behind the VBA Wizard Due to the special naming convention of all modules belonging to
275. window has focus void KeyUp long KeyCode long Shift This event is fired when a keyboard key is released GwxVisible OLE Automation Reference A 17 GwxVisible is the object type from which visible M Graphics objects ellipses rectangles etc are derived In other words all visible M Graphics objects have the properties and methods of Gwx Visible Properties l Boolean Visible True if the object is visible False if the object is hidden OLE COLOR FillColor Gets sets the visible object s fill color Boolean IsFilled True if the object is filled False if the object is not filled OLE COLOR LineColor Gets sets the visible object s line border color OLE COLOR ShadowColor Gets sets the visible object s shadow color Boolean HasShadow True if the object has a shadow False if the object does not have a shadow long LineWidth The width of an object s line border This value must be in the range of 0 to 10 GWXLINESTYLE LineStyle The style of the object s line border Valid values for GWXLINESTYLE are e LineSolid 0 e LineDash e LineDot e LineDashDot 3 e LineDashDotDot 4 e LineNone 5 GWX3DEDGESTYLE EdgeStyle The 3 D edge style of the object s border Valid values for GWX3DEDGESTYLE are e EdgeNone 0 e EdgeRaised e EdgeEtched 6 e EdgeBump 9 e EdgeSunken 10 A 18 Appendix 10 11 12 13 14 Boolean Selected True if the object i
276. wise Functions Tage UK Cancel Help Figure 10 8 Edit Expression Dialog Box aet a ZE 10 18 Advanced User s Editing Local Variables To edit local variables 1 On the Dynamic menu select Edit Local Variables The Edit Local Variables dialog box appears Figure 10 9 Edit Local Variables Data Type Double Initial Value O Low Range 1000000 High Range 4000000 Coa oe ten editvari Figure 10 9 Edit Local Variables Dialog Box 2 Edit the fields using Table 10 8 3 Click OK Table 10 8 Edit Local Variables Parameters Parameter Description Data Type Specifies the data type of the local variable Initial Value Sets the initial value of the local variable High Range and Low Sets a range of values for the local variable Range Establishing Data Source Connections 10 19 Creating an Alias To create an Alias 1 Select an object 2 On the Dynamics menu select a dynamic to apply 3 Inthe Data Source field enter an Alias using the following syntax lt lt FANSPEED gt gt 4 Edit the Alias Refer to the Editing an Alias section Note In M Graphics Release 4 0 an Alias can be used to refer to another Alias Editing an Alias To edit an Alias 1 Select an object If no objects are selected all the Aliases for the display appear 2 On the Dynamics menu select Edit Aliases The Edit Aliases dialog box appears Figure 10 10 Edit Aliases E4 r Selec
277. x 10 11 12 13 14 15 16 void PreDeanimateDisplay This event is fired just before M Graphics deanimates a display deanimating a display is the process of releasing the tags previously requested from the OPC servers void PostDeanimateDisplay This event is fired after M Graphics has finished deanimating a display void MouseDown long Button long Shift float X float Y This event is fired when a mouse button is clicked within the M Graphics window Values for Button are e Left button is pressed e Right button is pressed 2 e Middle button is pressed 4 Values for Shift are e No Key is pressed 0 e Shift key is pressed e Ctrl key is pressed 2 e Alt key is pressed 4 The parameters X and Y indicate where the mouse was clicked These coordinates are relative to the upper left corner of the window void MouseUp long Button long Shift float X float Y This event is fired when a mouse button is released void DbIClick long Button long Shift float X float Y This event is fired when a mouse button is double clicked within the M Graphics window void MouseMove long Button long Shift float X float Y This event is fired when the mouse is moved within the M Graphics window The parameter Button 1s zero 1f no mouse buttons are currently pressed during the move void KeyDown long KeyCode long Shift This event is fired when a keyboard key is pressed while the M Graphics
278. y with one layer the primary or system layer This first layer 1s the only layer to which a template can be applied When dealing with a display that has several layers the attribute picked for the primary layer appears in all layer views While the objects placed in the system layer can be seen in the configuration of all other layers it is not possible to edit these components while editing other layers Layer names indicate what the layer contains and why it is a separate layer Figure 7 1 is an example of the Edit Layer Properties dialog box Edit Layer Properties EI Layer Mame tS er Name F Jig 0 1000 Laver Name Change Layer Order d Runtime Data Layer Zoom Visibility Range Declutter Low oom Threshold 72 ja High Zoom Threshold CG f UU Request data when layer is initially hidden M Release data when layer becomes hidden Hide Layer When Data Source i FALSE zero f Tags Menu T Explicit Hide Layer E Help Figure 7 1 Edit Layers Properties Dialog Box Arranging Objects 7 3 Zoom Visibility Range By assigning each layer a different zoom threshold decluttering occurs Decluttering 1s automatically showing hiding elements depending on the current zoom status Zoom thresholds cannot be applied to the primary system layer The default values for zoom threshold are 0 1000 which makes the layer always visible By changing this threshold for specific layers the zoomed out

M-Graphics User`s Manual - Johnson Controls

Contents

Download Pdf Manuals

Related Search

Related Contents