Wonderware FactorySuite

Transcription

1 Wonderware FactorySuite InTouch Supplementary Components User s Guide Revision 2.0 Last Revision: 2005 Invensys Systems, Inc.

2 All rights reserved. No part of this documentation shall be reproduced, stored in a retrieval system, or transmitted by any means, electronic, mechanical, photocopying, recording, or otherwise, without the prior written permission of Invensys Systems, Inc. No copyright or patent liability is assumed with respect to the use of the information contained herein. Although every precaution has been taken in the preparation of this documentation, the publisher and the author assume no responsibility for errors or omissions. Neither is any liability assumed for damages resulting from the use of the information contained herein. The information in this documentation is subject to change without notice and does not represent a commitment on the part of Invensys Systems, Inc. The software described in this documentation is furnished under a license or nondisclosure agreement. This software may be used or copied only in accordance with the terms of these agreements Invensys Systems, Inc. All Rights Reserved. Invensys Systems, Inc Rancho Parkway South Lake Forest, CA U.S.A. (949) Trademarks All terms mentioned in this documentation that are known to be trademarks or service marks have been appropriately capitalized. Invensys Systems, Inc. cannot attest to the accuracy of this information. Use of a term in this documentation should not be regarded as affecting the validity of any trademark or service mark. Alarm Logger, ActiveFactory, ArchestrA, Avantis, DBDump, DBLoad, DT Analyst, FactoryFocus, FactoryOffice, FactorySuite, FactorySuite A 2, InBatch, InControl, IndustrialRAD, IndustrialSQL Server, InTouch, InTrack, MaintenanceSuite, MuniSuite, QI Analyst, SCADAlarm, SCADASuite, SuiteLink, SuiteVoyager, WindowMaker, WindowViewer, Wonderware, and Wonderware Logger are trademarks of Invensys plc, its subsidiaries and affiliates. All other brands may be trademarks of their respective owners.

3 Contents 3 Contents CHAPTER 1: Getting Started...5 System Requirements... 5 Installing InTouch Supplementary Components... 5 InTouch Supplementary Components Contents... 6 Uninstalling InTouch Supplementary Components... 6 Adding a Wizard to InTouch... 6 Removing a Wizard from InTouch... 8 Placing a Wizard in a Window Adding Wizards to the Toolbar...11 Removing Wizards from the Toolbar...11 CHAPTER 2: Symbol Factory...13 Symbol Types Picture Wizard Bitmap Wizard Texture Wizard InTouch Object Using Symbol Factory Placing a Symbol Factory Wizard in a Window Configuring Picture Wizard Options Configuring Bitmap or Texture Wizard Options Animating a Wizard Editing a Symbol Working with Categories Configuring Symbol Factory Adding InTouch Objects to Symbol Factory Pasting Graphics from the Windows Clipboard Importing Graphic Files Troubleshooting CHAPTER 3: 16-Pen Trend Wizard...35 Using the 16-Pen Trend Wizard Configuring the 16-Pen Trend Wizard Pasting the 16-Pen Trend Scooter Wizard in WindowMaker Configuring the 16-Pen Trend Scooter Wizard The 16-Pen Trend in Runtime Configuring a Real-Time 16-Pen Trend During Runtime Configuring a Historical 16-Pen Trend During Runtime The 16-Pen Trend QuickScript Functions ptgettrendtype() ptloadtrendcfg() ptpancurrentpen()... 47

4 4 Contents ptpantime()...48 ptpausetrend()...48 ptsavetrendcfg()...49 ptsetpen()...49 ptsetpenex()...50 ptsetcurrentpen()...50 ptsettrend()...51 ptsettimeaxis()...51 ptsettimeaxistocurrent()...52 ptsettrendtype()...52 ptzoomcurrentpen()...53 ptzoomtime()...54 Index...55

5 Getting Started 5 CHAPTER 1 Getting Started Wonderware InTouch Supplementary Components include Wonderware and third-party wizards that you can add to InTouch. By using wizards, you can often save yourself a considerable amount of time during application development. They are easy to use and easy to configure. Wonderware provides no warranty of any kind for third-party products, like Symbol Factory. You are free to use third-party products and to report any problems you may encounter to Wonderware Technical Support. We highly recommend that you always back-up your application and data before you install, or use any new utility or application. Contents System Requirements Installing InTouch Supplementary Components InTouch Supplementary Components Contents Uninstalling InTouch Supplementary Components Adding a Wizard to InTouch Removing a Wizard from InTouch System Requirements There are minimum system requirements to run InTouch and its add-on products. See the ReadMe file for InTouch system requirements. Installing InTouch Supplementary Components The Wonderware InTouch installation program is used to install InTouch and its add-on products, including the Supplementary Components. The installation program creates directories as needed and copies files from the compact disk to your hard drive. Note For complete InTouch installation instructions, see the InTouch Installation Guide.

6 6 Chapter 1 InTouch Supplementary Components Contents The InTouch Supplementary Components include the following tools that you can use to enhance your InTouch applications: Tool Description Symbol Factory A collection of wizards and bitmaps. 16-Pen Trend Plots real time or historical data for 16 different variables (pens). Uninstalling InTouch Supplementary Components Uninstall the InTouch Supplementary Component wizards from your hard drive using the Windows Installer. The wizards included in the Supplementary Components cannot be uninstalled from your hard drive through WindowMaker. Note Close both WindowMaker and WindowViewer before you uninstall any of the Supplementary Component wizards. To uninstall the Supplementary Component wizards 1. Back-up your InTouch application and your InTouch Directory. 2. Open Add/Remove Programs from the Windows Control Panel. 3. Select Wonderware InTouch from the Add/Remove Programs dialog box and click Change. 4. From the Application Maintenance dialog box, select Modify and then click Next. 5. From the Select Features dialog box, select the Supplementary Component wizard you want to uninstall and then click Next. 6. From the Ready to Modify Wonderware InTouch dialog box, verify the wizards that you want to uninstall and then click Next. 7. From the Wonderware InTouch Setup dialog box, click Finish. The selected wizards and all associated files are uninstalled from your hard drive. You can also uninstall InTouch Supplementary Components when you uninstall InTouch from your hard drive. Adding a Wizard to InTouch Wizards are added to InTouch, by default, if you include them during the initial InTouch installation. If you remove the wizard so that it is no longer available through InTouch, then you must add it to the list of installed wizards before using them.

7 Getting Started 7 Installing a wizard to InTouch 1. On the Windows Taskbar, click Start. Point to Programs, then point to InTouch for Windows and then, click WindowMaker. 2. On the WindowMaker Special menu, point to Configure and then, click Wizard/ActiveX Installation, or in the Application Explorer, doubleclick Wizard/ActiveX Installation. The Wizard/ActiveX Installation dialog box appears with the Wizard Installation property sheet active. Tip In the Application Explorer, you can also right-click Wizard/ActiveX Installation and then, click Open. 3. In the List of Uninstalled Wizards, select the wizards that you want to install and then, click Install. Note The Install button is active only when wizards are displayed in the List of Uninstalled Wizards list. 4. To select a group of wizards, click the first wizard in the list, hold down the SHIFT key and click the last wizard that you want to select. All wizards in the list between your first and last selection will be selected. To select multiple wizards that are not consecutively listed, click the first wizard, hold down the CTRL key and then, click the next wizard. Repeat this for all wizards that you want to select.

8 8 Chapter 1 5. Click Search if you want to install wizards from another directory. The Search for Wizard files dialog box appears. 6. Locate the directory containing the wizards that you want to install and then, click OK. The wizard installation dialog box reappears. 7. Any wizards that were found appears in the List of Uninstalled Wizards list and you can now install them as previously described. Removing a Wizard from InTouch Supplementary Component wizards are removed from InTouch through WindowMaker. 1. In WindowMaker, on the Special menu, point to Configure, and then click Wizard/ActiveX Installation, or in the Application Explorer, double-click Wizard/ActiveX Installation. The Wizard/ActiveX Installation dialog box appears with the Wizard Installation property sheet active. Tip In the Application Explorer, you can also right-click Wizard/ActiveX Installation, and then click Open.

9 Getting Started 9 2. In the Installed Wizards list, select the wizard(s) that you want to remove from your application, and then click Remove. A message box appears asking you to confirm the deletion. Note The Remove button is active only when wizards are displayed in the Installed Wizards list. Tip To select a group of wizards, click the first wizard in the list, hold down the SHIFT key and click the last wizard that you want to remove. All wizards in the list between your first and last selection will be selected. To select multiple wizards that are not consecutively listed, click the first wizard, hold down the CTRL key, and then click the next wizard. 3. Click Yes to remove the wizard. The removed wizard(s) is moved to the List of Uninstalled Wizards list. Note When you remove wizards through WindowMaker using the Remove button, they are not deleted from your hard drive. However, they are no longer loaded into memory and are not accessible from InTouch.

10 10 Chapter 1 Placing a Wizard in a Window To place a wizard in a window 1. Click the Wizard Dialog tool on the Wizards/ActiveX Toolbar. The Wizard Selection dialog box appears. 2. In the list of wizards, click the category of wizards that you want to use. Note All available wizards in that category will be shown in the display area. For example, if you select Buttons, all available button wizards will be shown in the display area. 3. Select the wizard that you want to use and then click OK or double-click the wizard. The dialog box closes and your window reappears. 4. The cursor will change to a corner symbol when you return to the window. Click the location in the window where you want to paste the wizard. 5. Double-click the wizard to configure it (if applicable). Note Some toolbar functions may be used to modify applicable wizards directly. For example, the Reduce Font tool, Line Color tool, Fill Color tool, and so on.

11 Getting Started 11 Adding Wizards to the Toolbar To add wizards to the toolbar 1. Click the Wizard Dialog tool on the Wizards/ActiveX Toolbar. The Wizard Selection dialog box appears. 2. In the list of wizards, click the category of wizards that you want to use. 3. Select the wizard that you want to use and then click Add to toolbar. The selected wizard is added to your Wizards/ActiveX Toolbar. Tip Once you add a wizard to the Wizards/ActiveX Toolbar, you can select it and paste it into an open window at any time. Note The number of wizards that you can add to the toolbar is limited to your system resources. For more information on WindowMaker toolbars, see your InTouch User s Guide. Removing Wizards from the Toolbar To remove wizards from the toolbar 1. Click the Wizard Dialog tool in the Wizard/ActiveX Toolbar. The Wizard Selection dialog box appears.

12 12 Chapter 1 2. Click Remove from toolbar. The Remove Wizard from Toolbar dialog box appears. 3. Select the wizard(s) that you want to remove from the toolbar. 4. Click OK.

13 Symbol Factory 13 CHAPTER 2 Symbol Factory Symbol Factory is a collection of over 4,000 industrial automation wizards and symbols for use in InTouch. The Symbol Factory can also store any third-party wizard, Wonderware wizard, or InTouch object. This provides you with convenient access to your wizards and graphic objects. When you store wizards in the Symbol Factory, the wizard's.dll must be present in the InTouch program directory for the wizards to function properly. If you add an InTouch object that has animation links associated with it to Symbol Factory, the links are also stored with the object. Any tagnames associated with the object are automatically converted to placeholder tagnames. Since tagnames can be up to 32 characters long, you can include long descriptions for each placeholder tagname to aid other users of this symbol. For more information on placeholder tagnames, see your InTouch User's Guide. Note The Symbol Factory is a third-party product. Wonderware provides no warranty of any kind for any of this product. You are free to use this product and to report any problems you may encounter to Wonderware Technical Support. We highly recommend that you always back-up your application and data before you install, or use any new utility or application. Contents Symbol Types Using Symbol Factory Configuring Symbol Factory Troubleshooting Symbol Types The Symbol Factory includes four types of symbols: Picture Wizard

14 14 Chapter 2 Bitmap Wizard Texture Wizard InTouch Object Picture Wizard Bitmap Wizard A vector-based picture that can be stretched without distortion. If the picture wizard has one color, that color can be changed by using the WindowMaker color tools on the Format Toolbar. If the picture wizard is multicolored, the colors can only be changed only by breaking the wizard (cell). A picture wizard can be animated, stretched, flipped horizontally, flipped vertically, filled, unfilled, or rotated to any angle using the Symbol Options dialog box, or using the respective WindowMaker tools. Breaking a Wizard Any wizard may be broken using the Break Cell tool. Once broken, the individual pieces of the wizard may be individually edited. However, once a wizard has been broken, it loses its wizard properties and is no longer a wizard. If you accidentally break a wizard, you can undo it by using the Undo tool. To break a selected wizard, on the WindowMaker Arrange menu, click Break Cell, or click the Break Cell tool on the Arrange Toolbar. A bitmap wizard is a bitmap that can be stretched, flipped horizontally, flipped vertically, or rotated to right angles. You can also add a border or shadow, and you can change the colors of the pixels. WindowMaker sees a bitmap as a single object. Therefore, you cannot animate the individual elements of a bitmap, nor can you include bitmaps in symbols. WindowMaker allows you to define a bitmap with a transparent color, so that you can float it over other objects. When you define a bitmap with a transparent color, the window background color or any objects behind the bitmap will show through it everywhere the transparent color is used. (Only one transparent color may be used per bitmap.) For more information on transparent bitmaps, see your InTouch User's Guide. Texture Wizard InTouch Object A texture wizard is similar to a bitmap wizard, except that it tiles when you stretch it to form a never-ending pattern. An InTouch object is an InTouch cell or symbol that is stored as is in the Symbol Factory. You can add your own InTouch objects (with animation links attached) to the Symbol Factory.

15 Symbol Factory 15 Once an InTouch object is pasted from the Symbol Factory into WindowMaker, it cannot be edited by the Symbol Factory. When you doubleclick the object in WindowMaker, the Substitute Tagnames dialog box appears if the object is a cell, or the animation link selection dialog box appears for an individual graphic object. InTouch objects are automatically scaled to the resolution you are using if it is different from the resolution in which it was added to the Symbol Factory. This conversion process may take a while for complex InTouch objects. This conversion may also result in objects that are a little distorted due to pixel rounding. All the objects included in the Symbol Factory are stored in 640x480 resolution. Using Symbol Factory To get started quickly with the Symbol Factory, click Quick Start. The Symbol Factory Help file appears, displaying the basic instructions for working with the Symbol Factory symbols. Install the Symbol Factory wizard. For more information on installing wizards, see the "Adding a Wizard to InTouch" section. Placing a Symbol Factory Wizard in a Window To place a Symbol Factory wizard in a window 1. Create a new window, or open the window into which you want to paste the wizard.

16 16 Chapter 2 2. Click the Wizard Dialog tool in the Wizards/ActiveX Toolbar. The Wizard Selection dialog box appears. 3. Select the Symbol Factory in the list of wizards, and then double-click the Symbol Factory wizard in the display area, or select it, and then click OK. Tip You can also click Add to toolbar to add the wizard to the Wizard/ActiveX Toolbar, and then click OK. 4. The Symbol Factory by Reichard Software dialog box appears.

17 Symbol Factory In the Categories list, select the category of symbols that you want to use. The Symbols window will display the available symbols for the selected category. Tip If the Enable ToolTips option is selected in the Configure Symbol Factory dialog box, then when you pass the cursor over a symbol, a box displaying a description of the symbol appears.

18 18 Chapter 2 6. Select the symbol that you want to use, and then click Options, or doubleclick the symbol to automatically paste it into your window in WindowMaker. For example: 7. Double-click the symbol to access the Symbol Options dialog box displaying the configuration options available for the type of symbol you selected. Note No symbol options are available for InTouch objects. If you doubleclick a pasted InTouch object, or click Options when an InTouch object category is displayed, a message box appears informing you that InTouch objects cannot be modified in the Symbol Factory. They can only be stored in the Symbol Factory. Configuring Picture Wizard Options The Symbol Options dialog box is dynamic. The configuration options it displays depend upon the type of symbol selected. When you right-click a picture wizard, the Symbol Options dialog box appears.

19 Symbol Factory 19 Tip If the Enable alternatives to right mouse button option is selected in the Configure Symbol Factory dialog box, the Edit Symbol button will be displayed and you can click it to configure the selected symbol. 1. In the Size and Rotation group, select the options that you want applied to the selected symbol as follows: Size and Rotation Option Keep Original XY Proportions Flip Horizontal Flip Vertical Description Retains the original aspect ratio of the symbol. Flips the symbol horizontally. Shortcut is the Italic tool in the WindowMaker Format Toolbar. Flips the symbol vertically. Shortcut is the Underline tool in the WindowMaker Format Toolbar.

20 20 Chapter 2 Size and Rotation Option Rotation Description Type the number of degrees that you want to rotate a wizard. Picture wizards can be rotated to any angle; bitmap and texture wizards can only be rotated in 90 degree increments. (0, 90, 180, or 270). Click to automatically increment the Rotation angle by 90 degrees. 2. In the Line and Fill group, select the color options that you want applied to the selected symbol as follows: Option Filled Override Built In Colors Line Color Line Style Fill Color Description Select to fill a picture wizard. Shortcut is the Bold tool in the WindowMaker Format Toolbar. If not selected, polygons will be drawn as polylines. Controls the fill color of a picture wizard using the Symbol Options dialog box, or the WindowMaker color tools. This option is only available for multicolored picture wizards. Controls the line color of picture wizards with overridden colors. Shortcut is the line tool in the WindowMaker Format Toolbar. Controls the line style of picture wizards with overridden colors. Controls the fill color of picture wizards with overridden colors. Shortcut is the fill tool in the WindowMaker Format Toolbar. 3. Click OK, or click Configure to configure the Symbol Factory For more information, see "Configuring Symbol Factory." Configuring Bitmap or Texture Wizard Options The Symbol Options dialog box is dynamic. The configuration options it displays depend upon the type of symbol selected. When you right-click a bitmap or texture wizard, the Symbol Options dialog box appears.

21 Symbol Factory 21 Tip If the Enable alternatives to right mouse button option is selected in the Configure Symbol Factory dialog box, the Edit Symbol button will be displayed and you can click it to configure the selected symbol. 1. In the Effects group, select the options that you want applied to the selected bitmap or texture symbol as follows: Effects Option Include Border Include Shadow Description Select to create a black border around a bitmap or texture wizard. Select to create a dark gray shadow behind a bitmap or texture wizard. 2. In the Change Colors group, click each color box to display the WindowMaker color palette to change the colors in a bitmap or texture wizard. Up to three colors may be changed to another color. Note Changing colors will impact the drawing speed of the bitmaps and textures since each pixel must be scanned and possibly changed. 3. Click OK.

22 22 Chapter 2 Animating a Wizard Tip You can configure the options for the symbol after you have pasted it in your window by double-clicking it. For more information, see "Configuring Symbol Factory." Any Symbol Factory symbol (wizard) can be animated. The Symbol Factory provides you with access to the most common animation links. If another type of animation link is required, you must break the wizard, and then animated it using the standard InTouch animation links. For more information, see "Breaking a Wizard." To animate a wizard 1. Select a wizard in the Symbol Factory, or double-click it if you have already pasted it into your window. The Symbol Factory by Reichard Software dialog box appears. 2. Click Animation. The Animation Links dialog box appears. 3. Click the button for each type of animation link that you want to apply to the selected wizard. A respective dialog box appears for you to configure the required details for the link. For example:

23 Symbol Factory 23 Tip If you double-click a blank Tagname or Expression input box the InTouch Tag Browser appears and you can select a tagname in the current tag source, or define a new tag source to use a remote tagname reference. Tip To select a tagname in the Tag Browser, double-click it, or select it, and then click OK. The tagname will automatically be inserted into the Tagname or Expression input box. If you type a tagname in the Tagname or Expression input box and then double-click it, the Tagname Dictionary appears, displaying that tagname's definition (assuming the tagname is already defined in the Tagname Dictionary). If you type a tagname that is not currently defined, you will be prompted to define it. Editing a Symbol You can change the description used in a symbol's tool tip, delete a symbol or copy a symbol to the Windows clipboard. To edit a symbol 1. In the Symbol Factory by Reichard Software dialog box, select the category containing the symbol that you want to edit. 2. Right-click the symbol. The Edit Symbol dialog box appears.

24 24 Chapter 2 Tip If the Enable alternatives to right mouse button option is selected in the Configure Symbol Factory dialog box, the Edit Symbol button will be displayed and you can click it to configure the selected symbol. 3. To change the symbol's tool tip description, type the new description in the Symbol Description input box. The maximum description is 80 characters. 4. Click Delete Symbol to delete the symbol from the category. 5. Click Copy to Clipboard to copy the symbol to the Windows Clipboard. If the symbol is a Picture Wizard, it will be copied as a Windows metafile. If the symbol is a Bitmap Wizard or Texture Wizard, it will be copied as a Windows bitmap. The following appears in the Symbol Information area: Symbol Information Data Bytes Type Description The amount of space, in kilobytes, that this symbol occupies on the hard drive. The symbol type. 6. Click OK. Working with Categories You can create a new category of symbols, edit the category's description that appears in the Categories list, or delete a category. New categories are created in WindowMaker. Once a category is created, it is edited in the Symbol Factory.

25 Symbol Factory 25 A category can contain up to 32,767 symbols. There is no set limit on the number of categories that you can have. However, a large number of categories will impact performance when the Symbol Factory by Reichard Software dialog box is displayed. Creating a New Category To create a new category 1. On the Edit menu in WindowMaker, point to Symbol Factory, and then click Create new category. The Create New Category dialog box appears. 2. In the Category Description box, type a description for your new category (40 characters maximum). 3. In the DOS Filename box, type a valid filename for the category file (8 characters maximum plus.cat extension). Tip The category (.cat) file will store all of the data for the symbols that are added to this category. Category files can be copied to other nodes, or they can be shared on a network, and they can be made read-only. 4. Click OK. Note If all entries are valid, the new category is created. The Create New Category dialog box clears and you can create another new category. To close the dialog box, click Cancel. Sharing a Category of Symbols on a Network To share a category of symbols on a network You can configure the Symbol Factory to allow multiple developers across a network to use and contribute to the category file of symbols. 1. Move the category file to a network directory. 2. Click Options in the Symbol Factory by Reichard Software dialog box. The Symbol Options dialog box appears.

26 26 Chapter 2 3. Click Configure. The Configure Symbol Factory dialog box appears. 4. In the Category File Path type the full path to the network directory where the category file now resides. 5. Click OK. Making a Category Read-Only To make a category read-only When placing symbols on a network, you may want to make the category readonly by setting the read-only file attribute for the category file. When a category is set as read-only, you cannot delete, move, rename, or add to its symbols. To verify the filename of a category, right-click the category name in the Categories list in the Symbol Factory by Reichard Software dialog box. The Edit Category dialog box appears displaying the filename in the Category Information section. Editing an Existing Category To edit an existing category 1. In the Symbol Factory by Reichard Software dialog box, right-click the category in the Categories list. The Edit Category dialog box appears.

27 Symbol Factory 27 Tip If the Enable alternatives to right mouse button option is selected in the Configure Symbol Factory dialog box, the Edit Category button will be displayed and you can click it to configure the selected category. 2. In the Category Description box, type the new description for the category, and then click OK. The maximum length of the description is 40 characters. 3. The Category Information group displays: Category Information Filename File Size Number of Symbols Description The category (.CAT) file path displayed here determines where the Symbol Factory looks for its category (.CAT) files. By default, this path points to C:\PROGRAM FILES\WONDERWARE\INTOUCH\SYMFAC. Size of the category file, in kilobytes. Total number of symbols contained in the category. Maximum is 32,767. Deleting a Category To delete a category Use Windows Explorer and delete the category (.CAT) file by specifying the filename for the category. Tip You can verify the category file's filename in the Edit Category dialog box.

28 28 Chapter 2 Configuring Symbol Factory When you configure the Symbol Factory, you specify the location for your category (.CAT) files, whether tool tips are displayed when symbols are selected, and whether the right mouse button enables alternatives. To configure the Symbol Factory 1. Click Options in the Symbol Factory by Reichard Software dialog box. The Symbol Options dialog box appears. 2. Click Configure in the Symbol Options dialog box. The Configure Symbol Factory dialog box appears. 3. In the Category File Path box, type the location where you want to save your Symbol Factory category (.CAT) files. Tip All the data for the symbols in a particular category is stored in one category file. For performance reasons, it is recommended that this path contain only *.CAT files. We recommend against keeping the category files in your InTouch application directory. The recommended path is C:\PROGRAM FILES\WONDERWARE\INTOUCH\SYMFAC. If you want to share symbols with other developers on a network, you can set this path to a network drive (see the procedure "To share a category of symbols on a network"). 4. Select Enable ToolTips if you want the tool tip box to appear when you pass your mouse over a symbol's thumbnail in the Symbol Factory by Reichard Software dialog box. To turn off tool tips, clear this option.

29 Symbol Factory Select Enable alternatives to right mouse button if you want buttons added to the Symbol Factory by Reichard Software dialog box to use instead of the right mouse button for editing categories and symbols. The following buttons are added: Button Description Displays the Edit Category dialog box for a selected category. Displays the Edit Symbol dialog box for a selected symbol. Tip By default, to edit category and symbol descriptions and to delete symbols, you must right-click the item. 6. Click OK. Adding InTouch Objects to Symbol Factory You can add InTouch objects to Symbol Factory. If you add an InTouch object that has animation links associated with it, the links are also stored with the object. Any tagnames associated with the object are automatically converted to placeholder tagnames. Since tagnames can be up to 32 characters long, you can include long descriptions for each placeholder tagname to aid other users of the object. Note There is no set limit on the size (in bytes) of a symbol that Symbol Factory can contain. However, the larger the symbol, the slower Symbol Factory will respond when re-sizing, deleting, or moving that symbol. To add an InTouch object 1. Select the InTouch object in the WindowMaker window.

30 30 Chapter 2 2. On the Edit menu, point to Symbol Factory, and then click Add selected InTouch object. The Add to Symbol Factory dialog box appears. A thumbnail is automatically created for the InTouch object. 3. In the Symbol Description box, type the description for the symbol (80 characters maximum). 4. In the Add symbol to this category list, select the category that you want the InTouch object to be stored in, or click Create New Category to create a new category for the symbol. For more information, see "Working with Categories."

31 Symbol Factory Click OK. The symbol is added to the end of the selected category. For example: Pasting Graphics from the Windows Clipboard You can copy graphic objects in other Windows programs to the Windows Clipboard, and then add them to the Symbol Factory as a wizard. To paste a graphic from the Windows Clipboard 1. Copy a graphic object to the Windows Clipboard. 2. If it is not running, start WindowMaker.

32 32 Chapter 2 3. On the Edit menu, point to Symbol Factory, and then click Paste from clipboard. The Add to Symbol Factory dialog box appears. A thumbnail is automatically created for the InTouch object. 4. In the Symbol Description box, type the description for the symbol (80 characters maximum). This description appears in the tool tip box for the symbol. 5. In the Add symbol to this category list, select the category in which you want to save the symbol. 6. In the Symbol Type group, select an available symbol type for the object as follows: Symbol Type Picture Wizard (use built-in colors) Picture Wizard (use toolbox for colors) Description Vector-based image that can be stretched without distortion. The wizard will use its original built-in colors. The wizard will use the WindowMaker color tools or the Symbol Options dialog box for its fill color and line color.

33 Symbol Factory 33 Symbol Type Bitmap Wizard Texture Wizard (tiled bitmap) Description Bitmap that can be rotated or colorchanged using the Symbol Options dialog box. When this wizard is stretched, it will become somewhat distorted like all other bitmaps. Special type of bitmap that repeats (tiles) over and over to form a never-ending pattern. When a texture wizard is stretched, it tiles to fill the dimensions of the new wizard. 7. Click OK. The symbol will be added to the end of the selected category. Importing Graphic Files You can import Picture files (.WMF) or bitmap files (.BMP) into the Symbol Factory. When you import a.wmf or.bmp file, it is automatically converted into a wizard. Most Windows graphics programs can export one or both of these formats. Note To import graphic files into Symbol Factory, follow the "Pasting Graphics from the Windows Clipboard" procedure. The only difference is you need to choose the file to be imported. Troubleshooting I installed the software, but I can't find the wizard in WindowMaker. Installing a wizard is actually a two-step process. 1. The library must be copied to your hard drive by running the setup program on the installation disk. 2. You must install the Symbol Factory wizard in WindowMaker. For more information on installing wizards, see the "Adding a Wizard to InTouch" section, or "Using WindowMaker" in your InTouch User's Guide. I accidentally deleted a symbol that I want back. To retrieve a deleted symbol from a category: 1. Rename the file ~CAT.BAK to TEMP.CAT. 2. Run Symbol Factory and see if the deleted symbol is back. If it is, move it to its original category, then delete TEMP.CAT.

34 34 Chapter 2 3. If the above step did not work, hold down the CTRL key while you rightclick the category with the deleted symbol. This will compact the category file and create a fresh backup ~CAT.BAK. 4. Perform the previous steps once more until you find your deleted symbol. The thumbnail is blurry when I add an InTouch object. With some video drivers, the thumbnail created when adding an InTouch object is blurry. It appears to be split down the middle and offset horizontally. Click on the thumbnail to select an alternative black-and-white thumbnail.

35 16-Pen Trend Wizard 35 CHAPTER 3 16-Pen Trend Wizard The 16-Pen trend wizard can be used to display either real time or historical data. It is a DLL file with the same interface standards of other InTouch wizards. The 16-Pen trend wizard allows you to configure the following items: 16 pens Pen color Tagname for each pen Tagname's Engineering Units text Tagname's minimum and maximum Engineering Units Minimum and maximum percentage of Engineering Units scale Decimal points allowed on the pen axis grid Line thickness Modify tagname values and line thickness in both development and runtime Real time or historical events can be selected in both development and runtime Contents Using the 16-Pen Trend Wizard Pasting the 16-Pen Trend Scooter Wizard in WindowMaker The 16-Pen Trend in Runtime The 16-Pen Trend QuickScript Functions Using the 16-Pen Trend Wizard To use the 16-Pen Trend wizard 1. Start WindowMaker and create a new window. 2. Add the 16-Pen Trend wizard to InTouch if it is not installed. For more information on installing wizards, see "Adding a Wizard to InTouch" in the Getting Started chapter.

36 36 Chapter 3 3. Start WindowMaker and create a new window, or open the window into which you want to paste the wizard. 4. Click the Wizard tool on the WindowMaker Wizard/ActiveX Toolbar. The Wizard Selection dialog box appears. 5. Select Trends in the list of wizards. In the display area, double-click the 16-Pen Trends wizard or select it and then click OK. Tip You can also click Add to toolbar to add the wizard to the Wizard/ActiveX Toolbar, and then click OK. 6. The cursor will change to the paste symbol.

37 16-Pen Trend Wizard Click in the window to paste the wizard. For example:

38 38 Chapter 3 Configuring the 16-Pen Trend Wizard To configure the 16-pen trend wizard 1. Double-click the Pen Trend wizard. The PenTrend Control dialog box appears. Note The behavior of the 16-Pen Trend dialog box is not standard. Pressing the Esc key is the same as clicking OK. Pressing the Enter key is the same as clicking Cancel. The best work-around for this problem is to use the mouse to click the appropriate button. Pressing the Enter key (which is the same as clicking Cancel) will close the dialog box without saving your changes. 2. In the Object Name box, type a unique name for the trend, or use the default PenTrend_# name. The wizard will automatically increment this name each time a new trend is created. 3. In the Time Axis Format group, in the Major Divisions box, type the number of major time divisions that you want to be visible within each major time division. 4. Click the color box to access the color palette. Click the color that you want to use for the major time division lines. (The palette will automatically close.)

39 16-Pen Trend Wizard In the Time Axis Format group, in the Minor Divisions box, type the number of minor time divisions that you want to be visible within each major time division. 6. Click the color box to access the color palette. Click the color that you want to use for the minor time division lines. (The palette will automatically close.) 7. In the Start Time and End Time boxes, type the starting date and time and the ending date and time respectively for a historical trend in the format: MM/DD/YY HH:MM:SS PM or, MM/DD/YY HH:MM:SS AM 8. In the Update Rate box, type the rate at which the real time event scrolls. Tip In runtime, there is also an option to set the spanning for the trend when Real-time is selected for the Trend Type. 9. In the Value Axis Format group, in the Major Divisions box, type the number of major divisions that you want to be visible for the trend's value axis. 10. Click the color box to access the color palette. Click the color that you want to use for the major value axis division lines. (The palette will automatically close.) 11. In the Value Axis Format group, in the Minor Divisions box, type the number of minor divisions that you want to be visible for the trend's value axis. 12. Click the color box to access the color palette. Click the color that you want to use for the minor value axis division lines. (The palette will automatically close.) Tip Although all pens are drawn, only the current pen is used as the designated pen for zooming and scrolling. In WindowMaker, the current pen may be set as the initial current pen when WindowViewer starts. In runtime, the operator can select another pen for the current pen. 13. Click the Width box or arrow and select the line width that you want to use for the pen. Note Selecting a pen width greater than 1 significantly reduces performance in trend updating and printing of the trend. 14. Select the Trend Type that you want the trend to initially be displayed as in runtime. In runtime, if the operator changes the Trend Type, the wizard will automatically display the appropriate configuration options. 15. In the Pen Configuration Grid, in the Color column, click each color box to select the color that each pen will use to plot its tagname in the trend.

40 40 Chapter In the Pen Configuration Grid, in each cell in the Tagname column, type the tagname that you want the respective pen to plot. Note In the Pen Configuration Grid, press ENTER to accept each entry. To delete an entry, click the cell to select it, and then press the SPACEBAR. Tip You can also double-click the tagname's cell to access the InTouch Tag Browser to select a tagname in the local application's Tagname Dictionary. To select a tagname in the Tag Browser, double-click it, or select it, and then click OK. The tagname will automatically be inserted into the cell that you originally clicked. Note If Historical is selected for the Trend Type, only the tagnames that are defined with the Log Data option selected will be displayed in the Tag Browser. For more information on the Tag Browser, see your InTouch User's Guide. 17. In the Pen Configuration Grid, in each cell in EU Text column, type the text that you want to initially use in runtime for the header text for the pen axis for each respective pen. This text is displayed as the axis text when a pen is set to active. 18. In the Pen Configuration Grid, in each cell in the Min EU column, type the minimum Engineering Units that you want to use initially in runtime for the start of the pen axis for each respective pen. 19. In the Pen Configuration Grid, in each cell in the Max EU column, type the maximum Engineering Units that you want to use initially in runtime for the end of the pen axis for each respective pen. Note The Min/Max Engineering Units are very important for displaying historical trend data. The historical trend displays from 0-100% of EU scale. 20. In the Pen Configuration Grid, in each cell in the Min % column, type the percentage that you want to use initially in runtime to calculate the minimum pen axis grid for the respective EU scale. 21. In the Pen Configuration Grid, in each cell in the Max % column, type the percentage that you want to use initially in runtime to calculate the maximum pen axis grid for the respective EU scale. 22. In the Pen Configuration Grid, in each cell in the Dec.Pos. column, type the number of decimal points that you want to use initially in runtime when labeling the pen axis grid. 23. In the Pen Configuration Grid, in each cell in the Width column, click the arrow to select the width the respective pen will use for the line when plotting the tagname in the trend. Note Pen widths are based on pixels. The maximum thickness is 10 pixels while the minimum is 1 pixel. Selecting a pen width greater than 1 significantly reduces performance in trend updating and printing of the trend.

41 16-Pen Trend Wizard Click Done to accept the configuration and close the dialog box. Pasting the 16-Pen Trend Scooter Wizard in WindowMaker To paste the 16-Pen Trend Scooter wizard in WindowMaker 1. Start WindowMaker and create a new window, or open the window into which you want to paste the wizard. 2. Click the Wizard tool on the WindowMaker Wizard/ActiveX Toolbar. The Wizard Selection dialog box appears. 3. Select Trends in the list of wizards. In the display area, double-click the 16-Pen Trend Scooter wizard or select it and then click OK. Tip You can also click Add to toolbar to add the wizard to the Wizard/ActiveX Toolbar, and then click OK. 4. The cursor will change to the paste symbol. 5. Click in the window to paste the wizard. For example:

42 42 Chapter 3 Note The available scooter controls depend upon the Trend Type that you selected earlier for the 16-Pen Trend wizard. For example, if you selected Real-time as the Trend Type, only the Zoom In and Zoom Out controls will function. Configuring the 16-Pen Trend Scooter Wizard To configure the 16-pen trend scooter wizard 1. Double-click the 16-Pen Trend Scooter wizard. The 16-Pen Trend Scooter Wizard dialog box appears. 2. In the Pen Trend Name box, type the same name that you specified for the 16-Pen Trend wizard's Object Name. Note If these names are not exactly the same, the zoom and scooter controls will not work properly.

43 16-Pen Trend Wizard In the Pen Options group, type a Memory Real type tagname in the respective input box for each of the following: Pen Options Zoom % Pan Minor Units Pan Major Units Description Determines the percentage of the respective axis that is zoomed in or out. Moves the respective axis by the tagname's initial value times the minor units division. Moves the respective axis by the tagname's initial value times the major units division. 4. In the Time Options group, type a Memory Real type tagname in the respective input box for each of the following: Time Options Zoom % Pan Minor Units Pan Major Units Description Determines the percentage of the respective axis that is zoomed in or out. Moves the respective axis by the tagname's initial value times the minor units division. Moves the respective axis by the tagname's initial value times the major units division. Tip You can also double-click a blank input box to access the InTouch Tag Browser to select a tagname in the tag source currently selected in the Tag Browser. To select a tagname in the Tag Browser, double-click it, or select it, and then click OK. The tagname will automatically be inserted into the input box that you originally clicked. 5. If you type a tagname in the input box and then double-click it, the Tagname Dictionary will appear displaying the tagname's definition (assuming the tagname is already defined in the Tagname Dictionary). If you type a tagname that is not currently defined, you will be prompted to define it. 6. Click Suggest if you want the wizard to automatically enter suggested tagnames in the input boxes. You will be prompted to define the suggested tagnames after you click OK. The 16-Pen Trend in Runtime Many of the 16-Pen Trend's parameters can be configured in runtime. However, the changes made in runtime are not saved with the trend. Therefore, if you close WindowViewer and then start it again, the 16-Pen Trend will display its default configuration as defined in WindowMaker.

44 44 Chapter 3 Note The runtime PenTrend Control configuration dialog box is dynamic. The configuration options that it displays in runtime are based on the selected Trend Type when you double-click it. Configuring a Real-Time 16-Pen Trend During Runtime To configure a real-time 16-Pen Trend during runtime 1. Double-click the Trend. The PenTrend Control dialog box appears. 2. The Object Name box displays the name configured in development for the trend. 3. In the Update Rate box, type the rate (in seconds) that you want the realtime events to scroll. 4. In the Span box, type the number of seconds from the starting point to the ending point of the time span. 5. In the Current Pen group, in the Pen box, type the number for the pen that you want to use to set the pen axis on the trend, or click the arrow and select the pen number in the list. 6. Although all pens are drawn, only the current pen is used as the designated pen for zooming and scrolling. 7. Click the Width box or arrow and select the line width that you want to use for the current pen.

45 16-Pen Trend Wizard 45 Note Selecting a pen width greater than 1 significantly reduces performance in trend updating and printing of the trend. 8. Select the Trend Type that you want displayed in runtime. 9. For details on configuring the items in the pen configuration grid, see "Using the 16-Pen Trend Wizard." 10. Click Done. Configuring a Historical 16-Pen Trend During Runtime To configure a historical 16-Pen Trend during runtime 1. Double-click the Trend. The PenTrend Control dialog box appears. 2. The Object Name box displays the name configured in development for the trend. 3. In the Time Axis Format group, type the starting date and time and the end date and time respectively for the historical trend in the format: MM/DD/YY HH:MM:SS PM (or AM) 4. In the Current Pen group, in the Pen box, type the number for the pen that you want to use to set the pen axis on the trend, or click the arrow and select the pen number in the list. Note Although all pens are drawn, only the current pen is used as the designated pen for zooming and scrolling.

46 46 Chapter 3 5. Click the Width box or arrow and select the line width that you want to use for the current pen. Tip Selecting a pen width greater than 1 significantly reduces performance in trend updating and printing of the trend. 6. Select the Trend Type that you want displayed in runtime. For details on configuring the items in the pen configuration grid, see "Using the 16-Pen Trend Wizard." 7. Click Done. The 16-Pen Trend QuickScript Functions There are several QuickScript functions you can link to objects, or use in InTouch QuickScripts or animation link expressions to control your 16-Pen Trend object in runtime. For example, the functions allow you to connect pens to the chart, add new events to the chart, remove or replot the grid, and remove or replot the scooters. ptgettrendtype() This function will display a value to indicate the current mode of a specified 16-Pen Trend. Syntax ptgettrendtype(trendobjname); Parameter TrendObjName Name of the trend object. Must be either a string constant or Message tagname. Return Value Returns the trend type: 0 for historical, (1 for real-time noscroll not used with this version) and 2 for real-time. Example ptgettrendtype (GroupTrendObjName); ptgettrendtype ( PenTrend_1 ); ptloadtrendcfg() This function loads the currently saved configuration file. Syntax ptloadtrendcfg(trendobjname, Filename,Cfgnum);

47 16-Pen Trend Wizard 47 Parameter TrendObjName Name of the trend object. Must be either a string constant or Message tagname. Filename Name of the configuration file (may include path). Cfgnum Integer value assigned to the configuration. You can include multiple configurations under the same filename by specifying their Cfgnum. You can create a filename that contains only one configuration. In which case, Cfgnum's value will always be 1. ptpancurrentpen() This function will scroll a specific 16-Pen Trend s pen axis based on provided values. Include the trend s name and a value for either minor or major panning. Syntax ptpancurrentpen (TrendObjName, majorunits, PanningValue); ptpancurrentpen(trendobjname, PanningValue, minorunits); Parameter TrendObjName Name of the trend object. Must be either a string constant or Message tagname. majorunits majorunits will be added to minorunits\ minor division. minorunits Using minorunits will divide the given panning value by the value of minor divisions specified in the PenTrend Control configuration dialog box during development. PanningValue User defined value which is contingent upon the major or minor divisions which indicate the amount of screen (16-Pen Trend) movement in a history object. Return Value None Example ptpancurrentpen(grouptrendobjname, PanPenMajorUnits, 0);(major down) ptpancurrentpen(grouptrendobjname, 0, PanPenMinorUnits);(minor down) ptpancurrentpen(grouptrendobjname, 0, -PanPenMinorUnits);(minor up) ptpancurrentpen(grouptrendobjname, -PanPenMajorUnits, 0);(major up)