Region Location Codes

Note: The Range Source Set Point With Attribute or  Range Source Set Variable With Attribute function block can be used to store the region and region location of the selected item to virtual points, or as RCO, variables that can be referenced by the output logic controlling how an item moves.

Ranges can be made up of multiple regions or specific locations within those regions. When a dialog box field supports entry of a subset of locations within a range, use the following codes to specify the locations you want:

Location
Code

 
Returns Items From

>0

Location that corresponds to the entered value.

=-1

LAST location in the region.

=-2

FIRST location in the region.

=-3

ALL locations in the region.

 

StartLocation

EndLocation

Returns Items From

=0

=-3

=-3

All locations in the region.

 

=-2

=-2

FIRST location in the region.

 

=-1

=-1

LAST location in the region.

 

=-1

>0

Currently undefined. This will return an empty set.

 

>0

=-1

A StartLocation that is >0  to the end of the region.

 

>0

<n

Between StartLocation and EndLocation.

Note: StartLocation should be less than or equal to the EndLocation.

 

=1

=-1

All locations in the region.

More information

About the range of sources.

RSA function blocks list.

Range source architecture overview.