ST_CalcSplineExtendedConfiguration

 

ST_CalcSplineExtendedConfiguration - General Information

Overview

Type:

Data structure

Available as of:

V2.5.0.0

Inherits from:

-

Description

Structure with additional configuration parameters for the elliptic spline which can be calculated with FB_EllipticSpline.CalcSplineExtended(…) as well as feedback data of a successful calculation.

Structure Elements

Variable

Data type

Description

diStartNumberOfVerticalPoints

DINT

Number of spline points to force a vertical distance at the start position.

This is only effective in combination with an obstacle at the start position.

Default value: 1

diTargetNumberOfVerticalPoints

DINT

Number of spline points to force a vertical distance at the target position.

This is only effective in combination with an obstacle at the target position.

Default value: 1

xUserApex

BOOL

The automatic calculation of the apex for a constant curvature is deactivated and lrApexScalingFactor is used for the calculation of the apex.

Default value: FALSE

lrApexScalingFactor

LREAL

Parameter for shifting the apex in the direction of the start position (negative value) or target position (positive value). From this value, a percentage value is calculated. This works on the half branch of the spline, see examples. For, lrApexScalingFactor = 0 the apex is located centrally between start position and target position.

Default value: 0.0

lrApexSmoothZone

LREAL

All spline points which are located within this zone around the apex are removed in favor of a softer path course.

Default value: 0.0

lrStartObstacleDistance

LREAL

Horizontal distance of an obstacle from the start position.

Default value: 0.0

lrStartObstacleHeight

LREAL

Height of the obstacle regarding the start position.

The parameter is automatically set to 0 if lrApexScalingFactor = -1.0 and xUserApex = TRUE.

Default value: 0.0

lrStartObstacleWidth

LREAL

Width of the obstacle regarding the start position.

Default value: 0.0

lrTargetObstacleDistance

LREAL

Horizontal distance of an obstacle from the target position.

Default value: 0.0

lrTargetObstacleHeight

LREAL

Height of the obstacle regarding the target position.

The parameter is automatically set to 0 if lrApexScalingFactor = 1.0 and xUserApex = TRUE.

Default value: 0.0

lrTargetObstacleWidth

LREAL

Width of obstacle regarding the target position.

Default value: 0.0

diStartSmoothPoints

DINT

Number of points which are removed at the start position in favor of a smoother path run.

This is only effective in combination with an obstacle at the start position.

Default value: 0

diTargetSmoothPoints

DINT

Number of points which are removed at the target position in favor of a smoother path run.

This is only effective in combination with an obstacle at the target position.

Default value: 0

lrStartMinVerticalDistance

LREAL

Minimum vertical distance at the start position if lrStartObstacleHeight is greater than 0. The value is limited to the value of lrStartObstacleHeight.

This is only effective in combination with an obstacle at the start position.

Default value: 0.0

lrTargetMinVerticalDistance

LREAL

Minimum vertical distance to the target position if lrTargetObstacleHeight is greater than 0. The value is limited to the value of lrTargetObstacleHeight.

This is only effective in combination with an obstacle at the target position.

Default value: 0.0

lrStartVerticalPointsDistance

LREAL

Distance between the spline points for the vertical distance at the start position. Reduces the specified number of spline points defined by diStartNumberOfVerticalPoints, if necessary.

Default value: 0.0

lrTargetVerticalicalPointsDistance

LREAL

Distance between the spline points for the vertical distance at the target position. Reduces the specified number of spline points defined by diTargetNumberOfVerticalPoints, if necessary

Default value: 0.0

xEquidistantSplinePoints

BOOL

FALSE: Spline points are set closer in areas with a strong curve than in areas with a light curve.

TRUE: Spline points are set in equidistant intervals.

Default value: FALSE