MC-Basic:pls.PLSPOSITION

Sets or queries individual PLS position values. When a PLS is defined, no PLS positions exist. A PLS position data structure must be created, using the CREATEPLSDATA command. This PPOS property is used to define PLS position values.

PLS positions units are depend in the plssource type.
For example - In case plssource is PCMD the units are given in user units and are affected by the axis displacement and position factor properties. In this case positions are absolute values (not incremental values).
In case of plssource from type PlsPercentage the units are % , and in case of PlsTime the units are msec.

The PLS position data must be monotonic or the PLS is not enabled.

Short form

<pls>.Ppos

Syntax

<pls>.PlsPosition[<index>] = <PLS position>

Availability

All versions

Type

Double

Range

<index>: 1 to the size of PLS data structure
<PLS position>: +/- MaxDouble

Units

User axis position units, as given by <axis>.POSITIONFACTOR

Default

0 (after the PLS data structure has been created)

Scope

Configuration, Task or Terminal

Limitations

The PLS position may be set only when the PLS is disabled.

Examples

PLS1.PlsPosition[5] = 2076.56

See Also

• COMMON SHARED ... AS PLS
• CREATEPLSDATA