SoTransformSeparator(3IV)

NAME
     SoTransformSeparator (SoXfSep) - group node that saves and restores
     transformation state

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoGroup > SoTransformSeparator

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

     typedef SoTransformSeparator
                         SoXfSep

          Functions from class SoTransformSeparator:

     SoTransformSeparator *  SoXfSepCreate()
     SoTransformSeparator *  SoXfSepCreateN(int nChildren)
     SoType                  SoXfSepGetClassTypeId()

          Functions from class SoGroup:

     void                SoXfSepAddChild(SoXfSep *this, SoNode *child)
     void                SoXfSepInsertChild(SoXfSep *this, SoNode *child, int
                              newChildIndex)
     SoNode *            SoXfSepGetChild(const SoXfSep *this, int index)
     int                 SoXfSepFindChild(const SoXfSep *this, const SoNode
                              *child)
     int                 SoXfSepGetNumChildren(const SoXfSep *this)
     void                SoXfSepRemoveChild(SoXfSep *this, int index)
     void                SoXfSepRemoveChildNode(SoXfSep *this, SoNode *child)
     void                SoXfSepRemoveAllChildren(SoXfSep *this)
     void                SoXfSepReplaceChild(SoXfSep *this, int index, SoNode
                              *newChild)
     void                SoXfSepReplaceChildNode(SoXfSep *this, SoNode
                              *oldChild, SoNode *newChild)

          Functions from class SoNode:

     void                SoXfSepSetOverride(SoXfSep *this, SbBool state)
     SbBool              SoXfSepIsOverride(const SoXfSep *this)
     SoNode *            SoXfSepCopy(const SoXfSep *this, SbBool
                              copyConnections = FALSE)
     SbBool              SoXfSepAffectsState(const SoXfSep *this)
     SoNode *            SoXfSepGetByName(const char *name)
     int                 SoXfSepGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoXfSepSetToDflts(SoXfSep *this)
     SbBool              SoXfSepHasDfltVals(const SoXfSep *this)

     SbBool              SoXfSepFldsAreEq(const SoXfSep *this, const
                              SoFieldContainer *fc)
     void                SoXfSepCopyFieldVals(SoXfSep *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoXfSepSet(SoXfSep *this, const char
                              *fieldDataString)
     void                SoXfSepGet(SoXfSep *this, SbString *fieldDataString)
     int                 SoXfSepGetFields(const SoXfSep *this, SoFieldList
                              *resultList)
     SoField *           SoXfSepGetField(const SoXfSep *this, const char
                              *fieldName)
     SbBool              SoXfSepGetFieldName(const SoXfSep *this, const
                              SoField *field, SbName *fieldName)
     SbBool              SoXfSepIsNotifyEnabled(const SoXfSep *this)
     SbBool              SoXfSepEnableNotify(SoXfSep *this, SbBool flag)

          Functions from class SoBase:

     void                SoXfSepRef(SoXfSep *this)
     void                SoXfSepUnref(const SoXfSep *this)
     void                SoXfSepUnrefNoDelete(const SoXfSep *this)
     void                SoXfSepTouch(SoXfSep *this)
     SoType              SoXfSepGetTypeId(const SoXfSep *this)
     SbBool              SoXfSepIsOfType(const SoXfSep *this, SoType type)
     void                SoXfSepSetName(SoXfSep *this, const char *name)
     SbName              SoXfSepGetName(const SoXfSep *this)


DESCRIPTION
     This group node is similar to the SoSeparator node in that it saves state
     before traversing its children and restores it afterwards. However, it
     saves only the current transformation; all other state is left as is.
     This node can be useful for positioning a camera, since the
     transformations to the camera will not affect the rest of the scene, even
     through the camera will view the scene. Similarly, this node can be used
     to isolate transformations to light sources or other objects.

FUNCTIONS
     SoTransformSeparator *  SoXfSepCreate()
          Creates a transform separator node with default settings.

     SoTransformSeparator *  SoXfSepCreateN(int nChildren)
          Constructor that takes approximate number of children.

     SoType                  SoXfSepGetClassTypeId()
          Returns type identifier for this class.


ACTION BEHAVIOR
     SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction,
     SoGetMatrixAction, SoRayPickAction
          Saves the current transformation state, traverses all children, and
          restores the previous transformation state.


FILE FORMAT/DEFAULTS
     TransformSeparator {
     }

SEE ALSO
     SoResetTransform, SoTransformation