Ubuntu Manpage: SoIndexedNurbsCurve — indexed NURBS curve shape node

Provided by: inventor-doc_2.1.5-10-18_all

NAME

       SoIndexedNurbsCurve — indexed NURBS curve shape node

INHERITS FROM

       SoBase > SoFieldContainer > SoNode > SoShape > SoIndexedNurbsCurve

SYNOPSIS

       #include <Inventor/nodes/SoIndexedNurbsCurve.h>

          Fields from class SoIndexedNurbsCurve:

     SoSFInt32           numControlPoints
     SoMFInt32           coordIndex
     SoMFFloat           knotVector

          Methods from class SoIndexedNurbsCurve:

                         SoIndexedNurbsCurve()
     static SoType       getClassTypeId()

          Methods from class SoNode:

     void                setOverride(SbBool state)
     SbBool              isOverride() const
     SoNode *            copy(SbBool copyConnections = FALSE) const
     virtual SbBool      affectsState() const
     static SoNode *     getByName(const SbName &name)
     static int          getByName(const SbName &name, SoNodeList &list)

          Methods from class SoFieldContainer:

     void                setToDefaults()
     SbBool              hasDefaultValues() const
     SbBool              fieldsAreEqual(const SoFieldContainer *fc) const
     void                copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)
     SbBool              set(const char *fieldDataString)
     void                get(SbString &fieldDataString)
     virtual int         getFields(SoFieldList &resultList) const
     virtual SoField *   getField(const SbName &fieldName) const
     SbBool              getFieldName(const SoField *field, SbName &fieldName) const
     SbBool              isNotifyEnabled() const
     SbBool              enableNotify(SbBool flag)

          Methods from class SoBase:

     void                ref()
     void                unref() const
     void                unrefNoDelete() const
     void                touch()
     virtual SoType      getTypeId() const
     SbBool              isOfType(SoType type) const
     virtual void        setName(const SbName &name)
     virtual SbName      getName() const

DESCRIPTION

This class represents a NURBS curve based on the knot vector and the control points that you specify. The
knotVector field specifies a floating-point array of values; the values are the coordinates of the knot
points in the curve, and you must enter them in non-decreasing order. The numControlPoints field
specifies the number of control points the curve will have and will use the current coordinates that are
indexed from the coordIndex field.

You can get a curve of minimum order (2) by specifying two more knots than control points and having at
least two control points. This curve would be a set of line segments connecting the control points
together.

You can get a curve of maximum order (8) by specifying 8 more knots than control points and having at
least 8 control points. In this curve, each control point would have influence on a larger portion of the
curve than with curves of lesser order.

The control points of the curve are transformed by the current transformation matrix. The curve is drawn
with the current lighting model and drawing style (drawing style FILLED is treated as LINES). The
coordinates, normals, and texture coordinates of a NURBS curve are generated, so you cannot bind explicit
normals or texture coordinates to a NURBS curve.

The approximation of the curve by line segments is affected by the current complexity value.

FIELDS

     SoSFInt32           numControlPoints
          Number of control points for the curve.

     SoMFInt32           coordIndex
          Coordinate indices for the control points.

     SoMFFloat           knotVector
          The knot vector for the curve. Values must be in non-decreasing order.

METHODS

                         SoIndexedNurbsCurve()
          Creates an indexed NURBS curve node with default settings.

     static SoType       getClassTypeId()
          Returns type identifier for this class.

ACTION BEHAVIOR

       SoGLRenderAction
          Draws the curve based on the current coordinates, material, and so on.

     SoRayPickAction
          Picks the curve based on the current coordinates and transformation.

     SoGetBoundingBoxAction
          Computes  the  bounding  box  that  encloses  all  control  points  of  the  curve  with  the  current
          transformation applied to them. Sets the center to the average of the control points.

     SoCallbackAction
          If any line segment callbacks are registered with the action, they will be invoked for each successive
          segment approximating the curve.

FILE FORMAT/DEFAULTS

       IndexedNurbsCurve {
          numControlPoints  0
          coordIndex        0
          knotVector        0
     }