SoCoordinate4(3IV)

NAME
     SoCoordinate4 (SoCoord4) - rational coordinate point node

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoCoordinate4

SYNOPSIS
     #include <Inventor_c/nodes/SoCoordinate4.h>

     typedef SoCoordinate4  SoCoord4

          Fields from class SoCoordinate4:

     SoMFVec4f           point

          Functions from class SoCoordinate4:

     SoCoordinate4 *     SoCoord4Create()
     SoType              SoCoord4GetClassTypeId()

          Functions from class SoNode:

     void                SoCoord4SetOverride(SoCoord4 *this, SbBool state)
     SbBool              SoCoord4IsOverride(const SoCoord4 *this)
     SoNode *            SoCoord4Copy(const SoCoord4 *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoCoord4AffectsState(const SoCoord4 *this)
     SoNode *            SoCoord4GetByName(const char *name)
     int                 SoCoord4GetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoCoord4SetToDflts(SoCoord4 *this)
     SbBool              SoCoord4HasDfltVals(const SoCoord4 *this)
     SbBool              SoCoord4FldsAreEq(const SoCoord4 *this, const
                              SoFieldContainer *fc)
     void                SoCoord4CopyFieldVals(SoCoord4 *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoCoord4Set(SoCoord4 *this, const char
                              *fieldDataString)
     void                SoCoord4Get(SoCoord4 *this, SbString
                              *fieldDataString)
     int                 SoCoord4GetFields(const SoCoord4 *this, SoFieldList
                              *resultList)
     SoField *           SoCoord4GetField(const SoCoord4 *this, const char
                              *fieldName)
     SbBool              SoCoord4GetFieldName(const SoCoord4 *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoCoord4IsNotifyEnabled(const SoCoord4 *this)
     SbBool              SoCoord4EnableNotify(SoCoord4 *this, SbBool flag)

          Functions from class SoBase:

     void                SoCoord4Ref(SoCoord4 *this)
     void                SoCoord4Unref(const SoCoord4 *this)
     void                SoCoord4UnrefNoDelete(const SoCoord4 *this)
     void                SoCoord4Touch(SoCoord4 *this)
     SoType              SoCoord4GetTypeId(const SoCoord4 *this)
     SbBool              SoCoord4IsOfType(const SoCoord4 *this, SoType type)
     void                SoCoord4SetName(SoCoord4 *this, const char *name)
     SbName              SoCoord4GetName(const SoCoord4 *this)


DESCRIPTION
     This node defines a set of 3D coordinates to be used by subsequent
     vertex-based shape nodes (those derived from SoVertexShape) or shape
     nodes that use them as control points (such as NURBS curves and
     surfaces). Coordinates are specifed as rational 4-vectors; the
     corresponding 3D point is computed by dividing the first three components
     by the fourth. This node does not produce a visible result during
     rendering; it simply replaces the current coordinates in the rendering
     state for subsequent nodes to use.

     This node exists primarily for use with NURBS curves and surfaces.
     However, it can be used to define coordinates for any vertex-based shape.

FIELDS
     SoMFVec4f           point
          Coordinate point(s).


FUNCTIONS
     SoCoordinate4 *     SoCoord4Create()
          Creates a coordinate node with default settings.

     SoType              SoCoord4GetClassTypeId()
          Returns type identifier for this class.


ACTION BEHAVIOR
     SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction,
     SoRayPickAction
          Sets coordinates in current traversal state.


FILE FORMAT/DEFAULTS
     Coordinate4 {
          point  0 0 0 1
     }

SEE ALSO
     SoCoordinate4, SoIndexedNurbsCurve, SoIndexedNurbsSurface, SoNurbsCurve,
     SoNurbsProfile, SoNurbsSurface, SoVertexShape