wonderware factorysuite intouch supplementary …ftp.ruigongye.com/200807/itsupplementary.pdf ·...

Wonderware® FactorySuite™InTouch® Supplementary Components User’s Guide

Revision 2.0

Last Revision: 2005

Invensys Systems, Inc.

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.

© 2005 Invensys Systems, Inc. All Rights Reserved.

Invensys Systems, Inc.

26561 Rancho Parkway South

Lake Forest, CA 92630 U.S.A.

(949) 727-3200

http://www.wonderware.com

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 A2, 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.

Contents 3

Contents
CHAPTER 1: Getting Started.............................5
System Requirements............................................................................. 5Installing InTouch Supplementary Components .................................... 5InTouch Supplementary Components Contents ..................................... 6Uninstalling InTouch Supplementary Components ............................... 6Adding a Wizard to InTouch .................................................................. 6Removing a Wizard from InTouch......................................................... 8

Placing a Wizard in a Window ......................................................... 10Adding Wizards to the Toolbar..........................................................11Removing Wizards from the Toolbar ................................................11

CHAPTER 2: Symbol Factory..........................13Symbol Types....................................................................................... 13

Picture Wizard .................................................................................. 14Bitmap Wizard.................................................................................. 14Texture Wizard ................................................................................. 14InTouch Object ................................................................................. 14

Using Symbol Factory.......................................................................... 15Placing a Symbol Factory Wizard in a Window............................... 15Configuring Picture Wizard Options ................................................ 18Configuring Bitmap or Texture Wizard Options .............................. 20Animating a Wizard.......................................................................... 22Editing a Symbol .............................................................................. 23Working with Categories .................................................................. 24

Configuring Symbol Factory................................................................ 28Adding InTouch Objects to Symbol Factory .................................... 29Pasting Graphics from the Windows Clipboard ............................... 31Importing Graphic Files.................................................................... 33

Troubleshooting.................................................................................... 33

CHAPTER 3: 16-Pen Trend Wizard .................35Using the 16-Pen Trend Wizard ........................................................... 35

Configuring the 16-Pen Trend Wizard ............................................. 38Pasting the 16-Pen Trend Scooter Wizard in WindowMaker .............. 41

Configuring the 16-Pen Trend Scooter Wizard ................................ 42The 16-Pen Trend in Runtime .............................................................. 43

Configuring a Real-Time 16-Pen Trend During Runtime ................ 44Configuring a Historical 16-Pen Trend During Runtime ................. 45

The 16-Pen Trend QuickScript Functions............................................ 46ptGetTrendType() ............................................................................. 46ptLoadTrendCfg()............................................................................. 46ptPanCurrentPen() ............................................................................ 47

InTouch Supplementary Components User’s Guide

4 Contents

ptPanTime() .......................................................................................48ptPauseTrend()...................................................................................48ptSaveTrendCfg() ..............................................................................49ptSetPen() ..........................................................................................49ptSetPenEx()......................................................................................50ptSetCurrentPen() ..............................................................................50ptSetTrend().......................................................................................51ptSetTimeAxis() ................................................................................51ptSetTimeAxisToCurrent() ................................................................52ptSetTrendType()...............................................................................52ptZoomCurrentPen()..........................................................................53ptZoomTime() ...................................................................................54

Index ..................................................................55


Getting Started 5

C H A P T E R 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 RequirementsThere are minimum system requirements to run InTouch and its add-on products. See the ReadMe file for InTouch system requirements.

Installing InTouch Supplementary ComponentsThe 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 Chapter 1

InTouch Supplementary Components ContentsThe InTouch Supplementary Components include the following tools that you can use to enhance your InTouch applications:

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

Tool DescriptionSymbol Factory A collection of wizards and bitmaps.16-Pen Trend Plots real time or historical data for 16

different variables (pens).


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

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


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 Chapter 1

Placing a Wizard in a WindowTo 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.


Getting Started 11

Adding Wizards to the ToolbarTo 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 ToolbarTo remove wizards from the toolbar

1. Click the Wizard Dialog tool in the Wizard/ActiveX Toolbar. The Wizard Selection dialog box appears.


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.


Symbol Factory 13

C H A P T E R 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 TypesThe Symbol Factory includes four types of symbols:

• Picture Wizard


14 Chapter 2

• Bitmap Wizard

• Texture Wizard

• InTouch Object

Picture WizardA 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 WizardAny 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.

Bitmap WizardA 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 WizardA texture wizard is similar to a bitmap wizard, except that it tiles when you stretch it to form a never-ending pattern.

InTouch ObjectAn 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.


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 double-click 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 FactoryTo 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 WindowTo 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 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.


Symbol Factory 17

5. 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 Chapter 2

6. Select the symbol that you want to use, and then click Options, or double-click 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 double-click 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 OptionsThe 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.


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 DescriptionKeep Original XY Proportions Retains the original aspect ratio of the

symbol.Flip Horizontal Flips the symbol horizontally.

Shortcut is the Italic tool in the WindowMaker Format Toolbar.

Flip Vertical Flips the symbol vertically.Shortcut is the Underline tool in the WindowMaker Format Toolbar.


20 Chapter 2

2. In the Line and Fill group, select the color options that you want applied to the selected symbol as follows:

3. Click OK, or click Configure to configure the Symbol Factory

For more information, see "Configuring Symbol Factory."

Configuring Bitmap or Texture Wizard OptionsThe 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.

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

Option DescriptionFilled 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.

Override Built In Colors 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 multi-colored picture wizards.

Line Color Controls the line color of picture wizards with overridden colors.Shortcut is the line tool in the WindowMaker Format Toolbar.

Line Style Controls the line style of picture wizards with overridden colors.

Fill Color Controls the fill color of picture wizards with overridden colors.Shortcut is the fill tool in the WindowMaker Format Toolbar.

Size and Rotation Option Description


Symbol Factory 21


1. In the Effects group, select the options that you want applied to the selected bitmap or texture symbol as follows:

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.

Effects Option DescriptionInclude Border Select to create a black border around a

bitmap or texture wizard.Include Shadow Select to create a dark gray shadow

behind a bitmap or texture wizard.


22 Chapter 2

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

Animating a WizardAny 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:


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 SymbolYou 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 Chapter 2


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:

6. Click OK.

Working with CategoriesYou 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.

Symbol Information Data DescriptionBytes The amount of space, in kilobytes, that

this symbol occupies on the hard drive.Type The symbol type.


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 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 read-only 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.


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:

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.

Category Information DescriptionFilename 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.

File Size Size of the category file, in kilobytes.Number of Symbols Total number of symbols contained in the

category. Maximum is 32,767.


28 Chapter 2

Configuring Symbol FactoryWhen 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.


Symbol Factory 29

5. 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:

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

Button DescriptionDisplays the Edit Category dialog box for a selected category.

Displays the Edit Symbol dialog box for a selected symbol.


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


Symbol Factory 31

5. Click OK. The symbol is added to the end of the selected category. For example:

Pasting Graphics from the Windows ClipboardYou 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 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 DescriptionPicture Wizard (use built-in colors)

Vector-based image that can be stretched without distortion. The wizard will use its original built-in colors.

Picture Wizard (use toolbox for colors)

The wizard will use the WindowMaker color tools or the Symbol Options dialog box for its fill color and line color.


Symbol Factory 33

7. Click OK. The symbol will be added to the end of the selected category.

Importing Graphic FilesYou 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.

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

Bitmap Wizard Bitmap that can be rotated or color-changed using the Symbol Options dialog box. When this wizard is stretched, it will become somewhat distorted like all other bitmaps.

Texture Wizard (tiled bitmap) 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.

Symbol Type Description


34 Chapter 2

3. If the above step did not work, hold down the CTRL key while you right-click 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.


16-Pen Trend Wizard 35

C H A P T E R 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 WizardTo 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 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.


6. The cursor will change to the paste symbol.



7. Click in the window to paste the wizard. For example:


38 Chapter 3

Configuring the 16-Pen Trend WizardTo 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.)



5. 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 PMor,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 Chapter 3

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



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


4. The cursor will change to the paste symbol.

5. Click in the window to paste the wizard. For example:


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



3. In the Pen Options group, type a Memory Real type tagname in the respective input box for each of the following:

4. In the Time Options group, type a Memory Real type tagname in the respective input box for each of the following:

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

Pen Options DescriptionZoom % Determines the percentage of the

respective axis that is zoomed in or out.Pan Minor Units Moves the respective axis by the

tagname's initial value times the minor units division.

Pan Major Units Moves the respective axis by the tagname's initial value times the major units division.

Time Options DescriptionZoom % Determines the percentage of the

respective axis that is zoomed in or out.Pan Minor Units Moves the respective axis by the

tagname's initial value times the minor units division.

Pan Major Units Moves the respective axis by the tagname's initial value times the major units division.


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 real-time 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.



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

SyntaxptGetTrendType(TrendObjName);

Parameter

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

ExampleptGetTrendType (GroupTrendObjName);

ptGetTrendType (�PenTrend_1�);

ptLoadTrendCfg()This function loads the currently saved configuration file.

SyntaxptLoadTrendCfg(TrendObjName, Filename,Cfgnum);



Parameter


FilenameName of the configuration file (may include path).

CfgnumInteger 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


majorUnitsmajorunits will be added to minorUnits\ minor division.

minorUnitsUsing minorUnits will divide the given panning value by the value of minor divisions specified in the PenTrend Control configuration dialog box during development.

PanningValueUser 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

ExampleptPanCurrentPen(GroupTrendObjName,

PanPenMajorUnits, 0);(major down)

ptPanCurrentPen(GroupTrendObjName, 0, PanPenMinorUnits);(minor down)

ptPanCurrentPen(GroupTrendObjName, 0, -PanPenMinorUnits);(minor up)

ptPanCurrentPen(GroupTrendObjName, -PanPenMajorUnits, 0);(major up)


48 Chapter 3

ptPanTime()This function will scroll a specific 16-Pen Trend’s time axis based on provided values. Include the trend’s name and a value for either minor or major panning.

Syntax

ptPanTime (TrendObjName, majorUnits, PanningValue);ptPanTime(TrendObjName, PanningValue, minorUnits);

Parameter


majorUnitsmajorunits will be added to minorUnits\ minor division.

minorUnitsUsing minorUnits will divide the given panning value by the value of minor divisions specified in the PenTrend Control configuration dialog box during development.

PanningValueUser 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

ExampleptPanTime(GroupTrendObjName, -PanTimeMajorUnits, 0);

(major left)

ptPanTime(GroupTrendObjName, 0, -PanTimeMinorUnits);(minor left)

ptPanTime(GroupTrendObjName, 0, PanTimeMinorUnits);(minor right)

ptPanTime(GroupTrendObjName, PanTimeMajorUnits, 0);(major right)

ptPauseTrend()This function will momentarily stop a 16-Pen Trend from updating its display window. The updating will be paused when the value is true (1).

SyntaxptPauseTrend(TrendObjName, Value,);

Parameter

Value0 resume update and 1 to pause

Return Value

None



ExampleptPauseTrend (GroupTrendObjName, 1);

ptSaveTrendCfg()This function creates or opens a configuration file.

SyntaxptSaveTrendCfg(TrendObjName, Filename,Cfgnum);

Parameter


FilenameName of the configuration file (may include path).

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

ptSetPen()This function sets the tagname for a specific pen number.

SyntaxptSetPen(TrendObjName, penNum, Tagname, minEU, maxEU, minPercent, maxPercent, Decimal, EU);

Parameter


PenNumSpecifies the pen number to use as the current pen.

TagnameName of the tagname to be set for the specified penNum.

minEUThe minimum Engineering Units value for the specified tagname.

maxEUThe maximum Engineering Units value for the specified tagname.

minPercentThe minimum percentage the tagname can deviate from its deviation target value.

maxPercentThe maximum percentage the tagname can deviate from its deviation target value.


50 Chapter 3

Decimal

EUThe label for the tagname's Engineering units.

ptSetPenEx()This function sets the tagname and configuration information for a specific pen number.

SyntaxptSetPenEx(TrendObjName, penNum, Tagname, minEU, maxEU, minPercent, maxPercent, Decimal, EU);

Parameter



TagnameName of the tagname to be set for the specified penNum.

minEUThe minimum Engineering Units value for the specified tagname.

maxEUThe maximum Engineering Units value for the specified tagname.

minPercentThe minimum percentage the tagname can deviate from its deviation target value.

maxPercentThe maximum percentage the tagname can deviate from its deviation target value.

Decimal

EUThe label for the tagname's Engineering units.

ptSetCurrentPen()Call this function to select a pen as the current pen. Current pen is the pen that controls the pen axis.

SyntaxptCurrentPen(TrendObjName, PenNum,);



Parameter



Return Value

None

ExampleptSetCurrentPen (GroupTrendObjName, 2);

This will set the current pen to pen 2.

ptSetTrend()This function will stop or start updating a specific 16-Pen Trend’s display window.

SyntaxptSetTrend(TrendObjName, EnableUpdates);

Parameter


EnableUpdates0 to stop updating or 1 to start updating.

Return Value

None

ExampleptSetTrend(�PenTrend_1�, 1);

This will start the updating of the trend object named PenTrend_1.ptSetTrend(GroupTrendObjName , 0);

This will stop the updating of the tagname, GroupTrendObjName.

ptSetTimeAxis()This function sets the start and end date and times for the chart's time axis.

SyntaxptSetTimeAxis(TrendObjName, StartDateTime, EndDateTime);

Parameter



52 Chapter 3

StartDateTimeThe date and time the chart starts. The valid format is: 11/11/2000 12:33:00.

EndDateTimeThe date and time the chart ends. The valid format is: 12/11/2000 12:33:00

ExamplePtSetTimeAxis(MyTrend, "11/11/2000 12:33:00");

ptSetTimeAxisToCurrent()This function is used to calculate the current chart span and the chart's ending time.

SyntaxPtSetTimeAxisToCurrent(TrendObjName, "CurrentSpan");

Parameter


CurrentSpanIf the word "CurrentSpan" is used, the function will calculate the current span and then the ending time

A string in the format "11/11/2000 12:33:00" can be used instead of "CurrentSpan". In this case, the string becomes the ending date and time.

ExamplePtSetTimeAxisToCurrent(MyTrend, "CurrentSpan");

PtSetTimeAxisToCurrent(MyTrend, "11/11/2000 12:33:00");

ptSetTrendType()This function sets the type of trend to be displayed.

SyntaxptSetTrendType(TrendObjName, "trendType");

Parameter


trendTypeAnalog value to set the trend type:

0 for a Historical trend

1 or 2 for a Realtime trend

ExampleptSetTrendType(MyTrend, "2");



ptZoomCurrentPen()This function zooms in or zoom out the 16-Pen Trend’s current pen’s Y-axis by the specified ratio.

SyntaxptZoomCurrentPen(TrendObjName, ZoomTimeRatioe);

Parameter


ZoomTimeRatioUse numbers larger than 1.0 for zooming out (increasing range of Y-axis) and fractions less than 1.0 (positive) for zooming in (decreasing range of Y-axis). Can be a fixed value or an analog or real tagname.

Return Value

None

ExamplesptZoomCurrentPen (“PenTrend_1”, 2.0);

This zooms out the pen axis of the trend object named PenTrend_1 by 2 times. For example, if the current pens’ Y-axis ranges from –100 to +100, and you use a ratio of 2.0, then the Y-axis for the current pen will be modified and scaled from –200 to 200. This is assuming the min scale and max scale values for the pen have not been adjusted.

ptZoomCurrentPen (“PenTrend_1”, 0.5);

This zooms in the pen axis of the trend object named PenTrend_1 by one-half. For example, if the current pens’ Y-axis ranges from –100 to +100, and you use a ratio of 0.5, then the Y-axis for the current pen will be modified and scaled from –50 to 50. This is assuming the min scale and max scale values for the pen have not been adjusted.

Additional Notes

1. The zoom ratio is applied to the existing span of the current pen’s Y-Axis range. For example, if the trend starts with a Y-axis range of –100 to 100 and then you zoom a ratio of 2.0, then the new range is –200 to 200. If you then zoom a ratio of 2.0 again, then the new range is –400 to 400. The zoom ratio does not apply to the ORIGINAL Y-axis range, but rather to the range currently in effect. This is assuming the min scale and max scale values for the pen have not been adjusted.

2. The zoom ratio is persisted during runtime for each of the trend’s pens. As you switch from one pen to another using the ptSetCurrentPen function, the Y-axis will reflect the current scaling for the selected pen.

3. In order to conserve drawing time and additional calculations, the Y-axis will only be labeled up to and perhaps one line beyond the maximum EGU and minimum EGU of the current pen. If you zoom out far enough, then it is possible that not all major lines of the Y-axis will be labeled.


54 Chapter 3

4. The Y-axis labeling represents the scaling and values for the current pen. All other pens are drawn with their respective EGU scaling, the drawing also taking into account the last zoom ratio applied for each specific pen.

5. If no zooming has been applied to a specific pen, then the bottom of the chart represents the pen’s minimum EGU value and the top of the chart represents that pen’s maximum EGU value as set in the chart configuration. This is assuming the min scale and max scale values for the pen have not been adjusted.

ptZoomTime()This function will zoom in or zoom out a specific 16-Pen Trend’s time axis by the specified percentage.

SyntaxptZoomTime(TrendObjName, ZoomTimePercentage);

Parameter


ZoomTimePercentageUse numbers larger than 1.0 for zooming in and fractions less than 1.0 (positive) for zooming out.

Return Value

None

ExampleptZoomTime (�PenTrend_1�, .25);

This will zoom out the time axis of the trend named PenTrend_1 by .25%.ptZoomTime(GroupTrendObjName,1.0/(1+ZoomTimePercentage));

This will zoom in the time axis of the tagname, GroupTrendObjName. The 1.0/(1+ZoomTimePercentage) assures that regardless of the tagname, GroupTrendObjName's value, the result is less than zero (positive).


Index 55

Index
Numerics16-Pen Trend Wizard
Configuring 42Historical trend at Runtime 45Real-time trend at Runtime 43

QuickScript FunctionsptGetTrendType() 46ptLoadTrendCfg() 46ptPanCurrentPen() 47ptPanTime() 48ptPauseTrend() 48ptSaveTrendCfg() 49ptSetCurrentPen() 50ptSetPen() 49ptSetPenEx() 50ptSetTimeAxis() 51ptSetTimeAxisToCurrent() 52ptSetTrend 51ptSetTrendTypet() 52ptZoomTime() 54

Scooter wizard 41Using 35

AAdding a wizard to the toolbar 11Animating a symbol 22

BBitmap wizard 14

Configuring 20

CConfiguring

16-Pen Trend scooter wizard 42Bitmap wizard 20Historical 16-Pen Trend Wizard at Runtime 45Picture wizard 18Real-time 16-Pen Trend Wizard at Runtime 43Symbol Factory 28Texture wizard 20

CreatingSymbol Factory Categories 25

EEditing

Symbol Factory Categories 26Symbol Factory symbols 23

HHistorical 16-pen Trend 45

IImporting graphic files 33Installation 5

Installing16-Pen Trend wizard in WindowMaker 35Wizards in WindowMaker 7

InTouch objects 15Adding to Symbol Factory 29

PPasting

16-Pen Trend Wizard in WindowMaker 41Graphics in a window a symbol category 31Wizard in a window 10

Picture wizard 14Configuring 18

RReal-time 16-pen Trend 44Removing a wizard from the toolbar 11Right mouse button alternatives 29

SSymbol Factory 13

Adding InTouch objects 29Animating a symbol 22Categories 25Configuring 28

Bitmap wizard 20Picture wizard 18Texture wizard 20

Editing a category 26Editing a symbol 23Importing graphic files 33Options 19Pasting graphics 31Sharing categories on a network 25Troubleshooting 33Types

Bitmap wizard 14InTouch object 15Picture wizard 13Texture wizard 14

Uninstalling 8

TTexture wizard 14

Configuring 20Troubleshooting

Symbol Factory 33

UUninstalling

Symbol Factory 8

WWizards

Adding to the toolbar 11


56 Index

Installing 7Pasting in a window 10, 15Removing from the toolbar 11


wonderware factorysuite intouch supplementary …ftp.ruigongye.com/200807/itsupplementary.pdf ·...

Documents