formZ SDK | 5.0 API Reference | Project | Modeling | Objects | Control Objects | Nurbz Object

fz_objt_cnstr_nrbz_from_cpts

Description

Creates a nurbz object from the given control points. The control points must be arranged in a grid format. Weights, knots, u and v degrees, closure information can also be specified.

The control points are contained in an array of fz_xyz_td. The v index varies first. That is, a row of v control points for the first u value is found first. Then, the row of v control points for the next u value. If the surface is rational in either parameter, it is considered a rational surface and the associated weights are in the array of doubles. The values in this array are in the same sequential order as the control points.

U degree must be greater than zero and must be less than the number of U control points. V degree must be greater than zero and must be less than the number of V control points.

Plugin Prototype

fzrt_error_td fz_objt_cnstr_nrbz_from_cpts(

fzrt_int

windex,

fz_xyz_td *

cpts,

double *

weights,

fzrt_int

u_npts,

fzrt_int

u_degree,

fzrt_boolean

u_closed,

double *

u_knots,

fzrt_int

v_npts,

fzrt_int

v_degree,

fzrt_boolean

v_closed,

double *

v_knots,

fz_objt_nrbz_cnstr_opts_ptr

nrbz_opts,

fz_attr_refn_ptr

refn_opts,

fz_objt_ptr *

obj )

Parameters

windex [Input]

project window index

cpts [Input]

array of control points

weights [Input, Optional]

array of weights

u_npts [Input]

# of pts in the u direction

u_degree [Input]

degree in the u direction

u_closed [Input]

is the surface closed in the u direction

u_knots [Input, Optional]

knots in the u direction
If specified, this array must contain (u_npts+u_degree+1) values

v_npts [Input]

# of pts in the v direction

v_degree [Input]

degree in the v direction

v_closed [Input]

is the surface closed in the v direction

v_knots [Input, Optional]

knots in the v direction
If specified, this array must contain (v_npts+v_degree+1) values

nrbz_opts [Input, Optional]

capping and rounding options

refn_opts [Input, Optional]

refinement options

obj [Result]

nurbz object

Returns

Error codes

Availability

5.0.0.0

Example Files

util_objt_cnstr_nrbz.fsl

See Also

, fz_objt_cnstr_nrbz_through_curves, fz_objt_cnstr_nrbz_from_uv_curves, fz_objt_cnstr_nrbz_through_points,

Function Set

fz_model_fset


Defined in

fz_objt_nrbz_api.h