TargetLift() Function

<< Click to Display Table of Contents >>

Navigation:  Support > Reconfigurable Rulebook > String Formatting >

TargetLift() Function

TargetLift() is a function that allows giving the athlete fine grain control over the height of the target. This value may be included in the "AthleteHasControl" attribute within a SegmentGroupSegment. When TargetLift() is included the attribute "TargetHeight", also a member of SegmentGroupSegment, is ignored.

Note that the height of the target is always specified in mm and must be in increments of 100.

TargetLift() may take one of four forms.

TargetLift()

TargetLift() gives the athlete full control over the height of the target. The value "TargetLift" will have the same meaning as "TargetLift()"

TargetLift(default)

On a segment change, "TargetLift(default)" first sets the height of the target to the value specified by default. The athlete then has complete control after the 'default' value is set.

TargetLift(min, max)

On a segment change, if the current height of the target is within the range (min, max) then the target lift does not change. If the current height is outside of the range (min, max) then the target moves to the height (min+max) / 2, rounded to 100mm.

After the target height change, if any, the athlete may adjust the value of the target lift within the range (min, max).

TargetLift(A(height), B(height), C(height), D(height))

Where A, B, C, D are all named values, usually corresponding to a position, such as Kneeling, Prone, Standing. And height is the height of the target for that named height. The user may specify up one to four named values. More than four are ignored.

With this option the athlete may select which height to set the target to based on the named values.

Precedence

Only one TargetLift() function is allowed within AthleteHasControl. If multiple variations are included only the first one listed is honored.