FC_CSplineFromArray - General Information

Overview

Type:

Function

Available as of:

SystemInterface_1.32.6.0

Versions:

Current version

Task

Calculate the coefficients for a curve from a supporting point table.

Description

The function is an improvement of FC_CSplineFromFile():

  • It obtains its supporting points from arrays and creates a profile on its own and returns the ProfilId. The necessary, time-consuming file operations for FC_CSplineFromFile() are omitted completely, which makes the function FC_CSplineFromArray() faster.

  • The restriction to equidistant supporting points was removed.

Interface

Input

Data type

Description

diSplineType

DINT

  • 0 -> natural spline

  • 1 -> spline with preset boundary derivatives

  • 2 -> periodic spline

i_diNumOfPoints

DINT

Number of cam points (>= 3, <= 10000)

i_lrStartSlope

LREAL

Left boundary slope (only relevant for diSplineType = 1)

i_lrEndSlope

LREAL

Right boundary slope (only relevant for diSplineType = 1)

i_plrXList

POINTER TO LREAL

Pointer to array of X coordinates. If i_plrXList = 0, the function assumes that you are using equidistant cam points that are evenly distributed over the [0,1] interval.

i_plrYList

POINTER TO LREAL

Pointer to array of Y coordinates

Return Value

Data type

Description

DINT

>0: ProfilId of the profile

-1: i_diNumOfPoints is outside the permitted range 3 ... 10000

-2: CSpline equation system singular

-4: Invalid spline type

-9: Not enough memory available

-10: List of X values is not in ascending order

-11: No valid list of Y values (for example, pointer = ZERO)

-12: Profile table is full

Examples 

 diProfileId := FC_CSplineFromArray(
   i_diSplineType := 1, 
   i_diNumOfPoints := 10, 
   i_lrStartSlope := 0.0, 
   i_lrEndSlope := 0.0, 
   i_plrXList := ADR(X[0]), 
   i_plrYList:=ADR(Y[0]) );