SoSFNode(3IV)

NAME
     SoSFNode (SoSNode) - field containing a pointer to a node

INHERITS FROM
     SoField > SoSField > SoSFNode

SYNOPSIS
     #include <Inventor_c/fields/SoSFNode.h>

     typedef SoSFNode    SoSNode

          Functions from class SoSFNode:

     SoType              SoSNodeGetClassTypeId()
     void                SoSNodeGetTypeId(const SoSNode *this)
     SoNode *            SoSNodeGet(const SoSNode *this)
     void                SoSNodeSet(SoSNode *this, SoNode * newValue)
     int                 SoSNodeIsEq(const SoSNode *this, const SoSFNode *f)
     int                 SoSNodeIsNEq(const SoSNode *this, const SoSFNode *f)

          Functions from class SoField:

     void                SoSNodeSetIgnored(SoSNode *this, SbBool ignore)
     SbBool              SoSNodeIsIgnored(const SoSNode *this)
     SbBool              SoSNodeIsDflt(const SoSNode *this)
     SbBool              SoSNodeIsOfType(const SoSNode *this, SoType type)
     SbBool              SoSNodeSetFromStr(SoSNode *this, const char
                              *valueString)
     void                SoSNodeGetIntoStr(SoSNode *this, SbString
                              *valueString)
     void                SoSNodeTouch(SoSNode *this)
     SbBool              SoSNodeConnFromField(SoSNode *this, SoField
                              *fromField)
     SbBool              SoSNodeConnFrom(SoSNode *this, SoEngineOutput
                              *fromEngine)
     void                SoSNodeDisconn(SoSNode *this)
     SbBool              SoSNodeIsConn(const SoSNode *this)
     SbBool              SoSNodeIsConnFromField(const SoSNode *this)
     SbBool              SoSNodeGetConnField(const SoSNode *this, SoField
                              **writingField)
     SbBool              SoSNodeIsConnFromEngine(const SoSNode *this)
     SbBool              SoSNodeGetConnEngine(const SoSNode *this,
                              SoEngineOutput **engineOutput)
     void                SoSNodeEnableConn(SoSNode *this, SbBool flag)
     SbBool              SoSNodeIsConnEnabled(const SoSNode *this)
     int                 SoSNodeGetForwardConn(const SoSNode *this,
                              SoFieldList *list)
     SoFieldContainer *  SoSNodeGetContainer(const SoSNode *this)
DESCRIPTION
     This field maintains a pointer to an SoNode instance, correctly
     maintaining its reference count.

     SoSFNodes are written to file as the node they are pointing to. For
     example:

          mySoSFNodeField Cube {}

     is an SoSFNode field named 'mySoSFNodeField', pointing to an SoCube node.
     If the node is used elsewhere, the regular DEF/USE instancing mechanism
     applies:

          anotherSoSFNodeField USE topSeparator

     is an SoSFNode field that points to a node named 'topSeparator' that was
     DEF'ed earlier in the scene.

FUNCTIONS
     SoType              SoSNodeGetClassTypeId()
     void                SoSNodeGetTypeId(const SoSNode *this)
          Returns the type for this class or a particular object of this
          class.

     SoNode *            SoSNodeGet(const SoSNode *this)
          Returns this field's value.

     void                SoSNodeSet(SoSNode *this, SoNode * newValue)
          Sets this field to newValue.

     int                 SoSNodeIsEq(const SoSNode *this, const SoSFNode *f)
     int                 SoSNodeIsNEq(const SoSNode *this, const SoSFNode *f)
          Returns TRUE if f is of the same type and has the same value as this
          field.


SEE ALSO
     SoField, SoSField, SoMFNode, SoNode