HALCON Reference Manual 10.0.2
Table of Contents / XLD / Creation ClassesClassesClasses | | | Operators

gen_nurbs_interpT_gen_nurbs_interpgen_nurbs_interpGenNurbsInterpGenNurbsInterp (Operator)

Name

gen_nurbs_interpT_gen_nurbs_interpgen_nurbs_interpGenNurbsInterpGenNurbsInterp — Create control data of a NURBS curve that interpolates given points.

Signature

gen_nurbs_interp( : : Rows, Cols, Tangents, Degree : CtrlRows, CtrlCols, Knots)

Herror T_gen_nurbs_interp(const Htuple Rows, const Htuple Cols, const Htuple Tangents, const Htuple Degree, Htuple* CtrlRows, Htuple* CtrlCols, Htuple* Knots)

Herror gen_nurbs_interp(const HTuple& Rows, const HTuple& Cols, const HTuple& Tangents, const HTuple& Degree, HTuple* CtrlRows, HTuple* CtrlCols, HTuple* Knots)

void HOperatorSetX.GenNurbsInterp(
[in] VARIANT Rows, [in] VARIANT Cols, [in] VARIANT Tangents, [in] VARIANT Degree, [out] VARIANT* CtrlRows, [out] VARIANT* CtrlCols, [out] VARIANT* Knots)

static void HOperatorSet.GenNurbsInterp(HTuple rows, HTuple cols, HTuple tangents, HTuple degree, out HTuple ctrlRows, out HTuple ctrlCols, out HTuple knots)

Description

gen_nurbs_interpgen_nurbs_interpgen_nurbs_interpGenNurbsInterpGenNurbsInterp creates the NURBS control data CtrlRowsCtrlRowsCtrlRowsCtrlRowsctrlRows, CtrlColsCtrlColsCtrlColsCtrlColsctrlCols, and KnotsKnotsKnotsKnotsknots of a NURBS curve that interpolates the input points (RowsRowsRowsRowsrows, ColsColsColsColscols). If the input point list is not closed (i.e., the first point is identic to the last point), the tangents of the first and last point must be given in TangentsTangentsTangentsTangentstangents in the order [drow_0,dcol_0,drow_n-1,dcol_n-1] (for closed point lists, TangentsTangentsTangentsTangentstangents must be an empty tuple). Furthermore the DegreeDegreeDegreeDegreedegree of the NURBS curve must be specified.

The output of gen_nurbs_interpgen_nurbs_interpgen_nurbs_interpGenNurbsInterpGenNurbsInterp can be used directly with gen_contour_nurbs_xldgen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXld with the weights vector set to 'auto'"auto""auto""auto""auto".

See the documentation of gen_contour_nurbs_xldgen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXld for more information on NURBS curves.

Parallelization

Parameters

RowsRowsRowsRowsrows (input_control)  coordinates.y-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row coordinates of input point list.

Number of elements: Rows == Cols

ColsColsColsColscols (input_control)  coordinates.x-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column coordinates of input point list.

Number of elements: Cols == Rows

TangentsTangentsTangentsTangentstangents (input_control)  real-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Tangents at first and last point.

Default value: []

DegreeDegreeDegreeDegreedegree (input_control)  integer → HTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong)

Order of the output curve.

Default value: 3

Suggested values: 2, 3, 4, 5

Restriction: Degree >= 2

CtrlRowsCtrlRowsCtrlRowsCtrlRowsctrlRows (output_control)  coordinates.y-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row coordinates of the control polygon.

CtrlColsCtrlColsCtrlColsCtrlColsctrlCols (output_control)  coordinates.x-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column coordinates of the control polygon.

Number of elements: Cols == Rows

KnotsKnotsKnotsKnotsknots (output_control)  real-array → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

The knot vector of the output curve.

Result

If all input parameters are correct gen_nurbs_interpgen_nurbs_interpgen_nurbs_interpGenNurbsInterpGenNurbsInterp returns the value 2 (H_MSG_TRUE).

Possible Successors

gen_contour_nurbs_xldgen_contour_nurbs_xldgen_contour_nurbs_xldGenContourNurbsXldGenContourNurbsXld

See also

draw_nurbs_interpdraw_nurbs_interpdraw_nurbs_interpDrawNurbsInterpDrawNurbsInterp, draw_nurbs_interp_moddraw_nurbs_interp_moddraw_nurbs_interp_modDrawNurbsInterpModDrawNurbsInterpMod

References

L. Piegl, W. Tiller: ”The NURBS Book”, 2nd Edition, Springer, 1997.

Module

Foundation

Table of Contents / XLD / Creation ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH