​.ScooterPosRight Dotfield

The read/write .ScooterPosRight dotfield dynamically controls the position of the right scooter.

Category

Historical.

Usage

HistTrendTag.ScooterPosRight

Parameter

HistTrendTag

HistTrend tag assigned the name of the trend.

Remarks

This read/write dotfield dynamically controls the position of the right scooter. You can use this dotfield in a QuickScript function to retrieve the current position of the right scooter. You can also assign a value to this dotfield to move the right scooter to another location on the trend.

This dotfield is most often used in conjunction with the HTGetValue() functions. These functions must specify which historical trend is being queried, as well as the current position of the trend's scooters.

Data Type

Real (read/write)

Valid Values

0.0 to 1.0; where 0.0 is the extreme left of the historical trend chart, and 1.0 is at the extreme right the historical trend chart.

Examples

The following statement specifies a new location for the right scooter. The right scooter moves to a location 34 percent of the chart's total length from the left side of the Historical Trend chart associated with the MyHistTrendTag tag.

MyHistTrendTag.ScooterPosRight=.34;

The following statement uses the HTGetValueAtScooter() QuickScript function to retrieve the value of pen 1 at the right scooter's new position. A change to any variable within a function's parameter list causes the function to be re-evaluated. Each time the position of the right scooter changes, this statement is re-evaluated.

MyRealTag=HTGetValueAtScooter(MyHistTrendTag, MyHistTrendTag.UpdateCount, 2, MyHistTrendTag.ScooterPosRight, 1, "PenValue");

See Also

.ScooterPosLeft,. ScooterLockLeft, .ScooterLockRight