ptSetPenEx() function

The ptSetPenEx() function can be used in a script to assign a tag to a specific trend pen and override the tag’s configuration values specified in the Tagname Dictionary.

Category

Pen trend

Syntax

ptSetPenEx(TrendName, PenNum, TagName, minEu, maxEU, minPercent, maxPercent, Decimal, EU);

Arguments

TrendName

The name of the trend object. Must be either a string constant or message tag.

PenNum

Number of the pen assigned as the current trend pen.

TagName

Name of the tag assigned to the trend pen.

minEU

The minimum engineering units value for the specified tag.

maxEU

The maximum engineering units value for the specified tag.

minPercent

The percentage to use initially in run time to calculate the minimum pen axis grid for the respective EU scale.

maxPercent

The percentage to use initially in run time to calculate the maximum pen axis grid for the respective EU scale.

Decimal

Decimal precision of a tag’s value in the trend.

EU

The label for the tag's engineering units.

Example

The ptSetPenEx() function assigns the PumpInP tag to pen 2 of the PumpPress trend. The tag’s engineering units range is set between 0 to 1500 and its units are PSI. The percentages for the grid are 0 to 1, and the decimal precision is set to 2.

ptSetPenEx ("PumpPress", 2, "PumpInP", 0, 1500, 0, 1, 2, "PSI");