SoNurbsCurve(3IV)

NAME
     SoNurbsCurve - NURBS curve shape node

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoShape > SoNurbsCurve

SYNOPSIS
     #include <Inventor/nodes/SoNurbsCurve.h>

          Fields from class SoNurbsCurve:

     SoSFInt32           numControlPoints
     SoMFFloat           knotVector

          Methods from class SoNurbsCurve:

                         SoNurbsCurve()
     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 curve will use the first numControlPoints values in the
     current coordinates as control points.

     If you specify n knots, you can specify up to n-8 control points.  The
     number of knots minus the number of control points is known as the order
     of the curve. A NURBS curve can have an order of up to 8.

     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.

     SoMFFloat           knotVector
          The knot vector.


METHODS
                         SoNurbsCurve()
          Creates a 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
     NurbsCurve {
          numControlPoints  0
          knotVector        0
     }

SEE ALSO
     SoIndexedNurbsCurve, SoNurbsSurface