Brief Index      Full Index      Events Index      I.M. Reference

Show_NURBS_Curve

Functions

void Show_NURBS_Curve (HC_KEY key, int *degree, int *cp_count, HC_POINT *points, float *weights, float *knots, float *start_u, float *end_u)
void Show_NURBS_Curve_Size (HC_KEY key, int *degree, int *cp_count, int *weight_count, int *knot_count)
void DShow_NURBS_Curve (HC_KEY key, int *degree, int *cp_count, HC_DPOINT *points, float *weights, float *knots, float *start_u, float *end_u)

Function Documentation

void Show_NURBS_Curve ( HC_KEY  key,
int *  degree,
int *  cp_count,
HC_POINT *  points,
float *  weights,
float *  knots,
float *  start_u,
float *  end_u 
)

Returns the previous definition of a NURBS curve, as referenced by a key.

Parameters:
key- Unique numeric identifier pointing to a NURBS curve in the database.
degree- Degree of the curve. Returned to caller. Passed by reference always. Can be NULL if not interested.
cp_count- Number of valid points in points. Returned to caller. Passed by reference always. Can be NULL if not interested.
points- Vector of x-y-z triplets for the coordinates of the control . (A simple N x 3 array may also be used.) Returned to caller Passed by reference always. Can be NULL if not interested.
weights- Control point weights. Returned to caller. Passed by reference always. Can be NULL if not interested.
knots- Knot sequence. Returned to caller. Passed by reference always. Can be NULL if not interested.
start_u- Start parameter. Returned to caller. Passed by reference always. Can be NULL if not interested.
end_u- End parameter. Returned to caller. Passed by reference always. Can be NULL if not interested.

DETAILS

Show_NURBS_Curve() reads back the values currently stored in a NURBS curve. The key for the NURBS curve might come from Show_Selection_Element() or Find_Contents() , or it might have been saved by your program when the NURBS curve was created (via Insert_NURBS_Curve() ).

Use Show_NURBS_Curve_Size() to determine how large the points, weights and knots arrays are going to be, before you actually call Show_NURBS_Curve() .

The size of the weights array will always be equal to cp_count

NOTES

RESTRICTIONS

Flagging enabled events causes confusion when a window with events enabled becomes invisible. The work around is to disable events before setting the visibility to off.

See also:
Edit_NURBS_Curve, Show_Selection_Element, Insert_NURBS_Curve, Get_Selection, Begin_Contents_Search, Compute_Coordinates.
void Show_NURBS_Curve_Size ( HC_KEY  key,
int *  degree,
int *  cp_count,
int *  weight_count,
int *  knot_count 
)

Finds the size of a given NURBS curve. This is useful in determining the size of the data structure that must hold points

Parameters:
key- Unique numeric identifier pointing to a NURBS curve in the database.
degree- Degree of the curve. Returned to caller. Passed by reference always. Can be NULL if not interested.
cp_count- Number of valid points in points. Returned to caller. Passed by reference always. Can be NULL if not interested.
weight_count- Number of weights in the NURBS curve. Returned to caller. Passed by reference always.
knot_count- Number of knots in the NURBS curve. Returned to caller. Passed by reference always.

DETAILS

No additional details. See Show_NURBS_Curve()

void DShow_NURBS_Curve ( HC_KEY  key,
int *  degree,
int *  cp_count,
HC_DPOINT *  points,
float *  weights,
float *  knots,
float *  start_u,
float *  end_u 
)

Similar to Show_NURBS_Curve, but operates on double-precision values.

Parameters:
key- Unique numeric identifier pointing to a NURBS curve in the database.
degree- Degree of the curve. Returned to caller. Passed by reference always. Can be NULL if not interested.
cp_count- Number of valid points in points. Returned to caller. Passed by reference always. Can be NULL if not interested.
points- Vector of x-y-z triplets for the coordinates of the control . (A simple N x 3 array may also be used.) Returned to caller Passed by reference always. Can be NULL if not interested.
weights- Control point weights. Returned to caller. Passed by reference always. Can be NULL if not interested.
knots- Knot sequence. Returned to caller. Passed by reference always. Can be NULL if not interested.
start_u- Start parameter. Returned to caller. Passed by reference always. Can be NULL if not interested.
end_u- End parameter. Returned to caller. Passed by reference always. Can be NULL if not interested.

DETAILS

No additional details. See Show_NURBS_Curve().

Brief Index      Full Index      Events Index      I.M. Reference