Advanced

Run Mode Options

Update trigger

When the tag configured in this field changes value, the trend object is updated (refreshed).

Update interval

When the update trigger is issued and the X Axis if of type numeric, the value on this field will be added to the minimum and maximum values of the X Axis.

Load indicator

Type the name of a project tag. While the trend control is loading external data, the tag receives a value of 1, and when the trend control has finished loading the data, the tag receives a value of 0.

Move to current time on run

When this box is checked, X axis shifts to the current time automatically when the object is triggered to Play mode, during runtime.

Retrieve bounding samples

When this box is checked, the object retrieve the data outbound the object (first points only). Uncheck this option can improve the performance, since the points outbound the object will not be retrieved from the history. On the other hand, the object will not draw lines linking the first and last samples to the extremities of the object.

Run-Time Config

Save trigger

You can modify a Trend Control object's configuration using on-screen tools, then save and reload it later. This allows you to do things like:

• Preserves the configuration when screens are closed, reopened, or the project is restarted; or

• Create standard configurations and load them at run time based on conditions or user selection..

  Not available on Mobile Access.

  When the Save trigger tag is toggled, the current Trend Control configuration is saved to the specified file. The following settings are saved:

• Points: Color, Tag/Field (when using indirect tags), Min Scale, Max Scale, Hide

• Axes: Period (start time, end time, etc.), Grid Divisions, Number of Labels, Enable Cursor, and the current zoom

• Toolbar: Show/hide state of commands without activation tags configured

• Legend: Visible columns with widths, Maximum Size, Number of Items, Selected Item

Load trigger

When the Load trigger tag is toggled, the saved configuration is loaded from the specified file and applied to the Trend Control object.

File Name

External file used to save and load the configuration. The default extension is .stmp and the default file name is <screen name><object ID>TrendControl.stmp.

File name changes during run time are not supported on thin clients.

For the local Viewer on the project runtime server, the file is saved in the project's Web folder. For example, <project name>\Web\MyScreen10TrendControl.stmp.

For Thin Clients on all other stations, the file is saved in the standard Temp directory. For example, C:\Users\<current user>\AppData\Local\Temp\MyScreen10TrendControl.stmp

To change the file name during run time, type a tag/expression enclosed in curly brackets (for example, {UserName}TrendControl). The tag/expression value is used when Save trigger or Load trigger is activated.

Only .stmp files are converted during upgrades.Change to .stmp before upgrading, then restore the original extension.

Auto Save

If this option is selected, the current configuration of the Trend Control object is automatically saved when the project screen is closed. If this option is cleared, the configuration is saved only when Save trigger is activated.

Custom Point Selection

Screen

This interface allows you to create your custom dialog to modify or insert pens to the object.

Name of the screen which must be launched when the user triggers a command to modify or insert a new pen to the object during runtime.

Point Number

Point number (from the Points dialog), indicating the point associated to the pen that will be inserted or modified during runtime.

Add Indicator

Flag that indicates that the user triggered an action to insert a new pen (value 1) instead of modifying a pen that is already been visualized (value 0).

Export to File

Trigger

When the project tag specified in this box changes value (that is, toggles), the current state of the trend control is exported to an image file. In other words, a screen shot is taken, but only of the trend control. The toolbar, scroll bar, legend and time display are not included.

File Name

The file path and name of the exported file.

If no path is specified, the file is saved in the Web sub-folder of the project folder. If no extension is specified, it is determined by Format (see below).

To programmatically change the file name during run time, specify a project tag or expression enclosed in curly brackets (for example, {MyFileName}). The value of the specified tag/expression is used.

Status

The project tag specified in this box receives a status code that indicates the success or failure of the most recent export.

The status code can be one of the following possible values:

Format

The graphic format of the exported image file.

If you select Auto, the format is determined by the file extension specified in File Name (see above). If you select Auto but do not specify a file extension, the default format is BMP.

Size

The image file is exported at full size by default. However, you can specify the Width and Height (in pixels).

Decimation

Enable

When this option is selected, the trends in the Trend Control object that are configured to show historical data will have their data decimated before the trends are drawn. This means that for each trend, the X axis is divided into a number of intervals (determined by Max Points) and all of the data points within each interval are averaged together to be drawn as a single point. This can improve runtime performance when there is a large amount of historical data to display, and it can make the trends easier to read.

Decimation only works when the trend control is in Stop Mode (also known as Historical Mode).

Please note that when this option selected, decimation is done for all trends that are configured to show historical data. To do it for only for a single trend, use Draw Mode in the Points – Options settings.

Note: If decimation is enabled and the X axis is set to be numeric rather than date/time, then the data used in the X axis must be properly sorted. For more information, see the Data Sources settings.

Note: If the data sources for one or more points are tags from a Trend worksheet that has been configured to save to a Historian database, decimation must be enabled at least for those points.

Max Points

The maximum number of data points used to draw each trend. Default is 2048.

Options

VK (Virtual Keyboard)

Virtual Keyboard type used for this object.

Ignore X Filter

When this box is checked, the X Filter is ignored to avoid adding the WHERE or querying clause to the Data Sources.

Enable translation

Enable the external translation for the text displayed by this object.

Auto Format

When checked, decimal values in the Current, Cursor, Max, Min and Scale columns will be formatted according to the virtual table created by the function SetDecimalPoints.

Note: For the Auto Format to work, decimals formatting on the X axis must be disabled — that is, the Decimals box in the Axes settings must be left empty.