kernelv_ch_set_cont_visu_rel_curvature_error()

Prototype

KERNELV_RETURN

kernelv_ch_set_cont_visu_rel_curvature_error
                 (unsigned long int chanIndex,
                  unsigned long int   rel_error);

Description

Sets the relative curvature error of the command contour visualisation for curved contours (circle segments and polynomials).

The relative curvature error indicates the permitted secant error for tracing the curved contour as a percentage of the curve radius.

Example: For a circle, the curve radius is identical to the circle radius; for a circle radius of 100 mm and a relative curvatures error of 1%, the permitted secant error is 100 mm * 1% = 1 mm.

The effective secant error to trace a contour element is determined by the minimum value between the absolute and relative secant errors.

Parameter

Name

Type

Meaning

chanIndex

unsigned long

Channel index of the channel from which the variable is to be read.

rel_error

unsigned long

Relative curvature error in 0.1%

Return values

Symbol

Value

Meaning

RET_FINISHED

0

The function was executed without error.

ERR_INVALID_CHAN

-1

The transferred channel index is higher than the number of configured channels –1

ERR_CNC_NOT_INIT

-3

The simulation CNC kernel was not yet initialised.