SoCube(3IV)

NAME
     SoCube (SoCube) - cube shape node

INHERITS FROM
     SoBase > SoFieldContainer > SoNode > SoShape > SoCube

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

          Fields from class SoCube:

     SoSFFloat           width
     SoSFFloat           height
     SoSFFloat           depth

          Functions from class SoCube:

     SoCube *            SoCubeCreate()
     SoType              SoCubeGetClassTypeId()

          Functions from class SoNode:

     void                SoCubeSetOverride(SoCube *this, SbBool state)
     SbBool              SoCubeIsOverride(const SoCube *this)
     SoNode *            SoCubeCopy(const SoCube *this, SbBool copyConnections
                              = FALSE)
     SbBool              SoCubeAffectsState(const SoCube *this)
     SoNode *            SoCubeGetByName(const char *name)
     int                 SoCubeGetByNameList(const char *name, SoNodeList
                              *list)

          Functions from class SoFieldContainer:

     void                SoCubeSetToDflts(SoCube *this)
     SbBool              SoCubeHasDfltVals(const SoCube *this)
     SbBool              SoCubeFldsAreEq(const SoCube *this, const
                              SoFieldContainer *fc)
     void                SoCubeCopyFieldVals(SoCube *this, const
                              SoFieldContainer *fc, SbBool copyConnections =
                              FALSE)
     SbBool              SoCubeSet(SoCube *this, const char *fieldDataString)
     void                SoCubeGet(SoCube *this, SbString *fieldDataString)
     int                 SoCubeGetFields(const SoCube *this, SoFieldList
                              *resultList)
     SoField *           SoCubeGetField(const SoCube *this, const char
                              *fieldName)
     SbBool              SoCubeGetFieldName(const SoCube *this, const SoField
                              *field, SbName *fieldName)
     SbBool              SoCubeIsNotifyEnabled(const SoCube *this)
     SbBool              SoCubeEnableNotify(SoCube *this, SbBool flag)

          Functions from class SoBase:
     void                SoCubeRef(SoCube *this)
     void                SoCubeUnref(const SoCube *this)
     void                SoCubeUnrefNoDelete(const SoCube *this)
     void                SoCubeTouch(SoCube *this)
     SoType              SoCubeGetTypeId(const SoCube *this)
     SbBool              SoCubeIsOfType(const SoCube *this, SoType type)
     void                SoCubeSetName(SoCube *this, const char *name)
     SbName              SoCubeGetName(const SoCube *this)


DESCRIPTION
     This node represents a cuboid aligned with the coordinate axes. By
     default, the cube is centered at (0,0,0) and measures 2 units in each
     dimension, from -1 to +1. The cube is transformed by the current
     cumulative transformation and is drawn with the current lighting model,
     drawing style, material, and geometric complexity.

     If the current material binding is PER_PART, PER_PART_INDEXED, PER_FACE,
     or PER_FACE_INDEXED, materials will be bound to the faces of the cube in
     this order: front, back, left, right, top, and bottom.

     Textures are applied individually to each face of the cube; the entire
     texture goes on each face. On the front, back, right, and left sides of
     the cube, the texture is applied right side up. On the top, the texture
     appears right side up when the top of the cube is tilted toward the
     camera. On the bottom, the texture appears right side up when the top of
     the cube is tilted away from the camera.

FIELDS
     SoSFFloat           width
     SoSFFloat           height
     SoSFFloat           depth
          Sizes in the x, y, and z dimensions, respectively.


FUNCTIONS
     SoCube *            SoCubeCreate()
          Creates a cube node with default settings.

     SoType              SoCubeGetClassTypeId()
          Returns type identifier for this class.


ACTION BEHAVIOR
     SoGLRenderAction
          Draws cube based on the current coordinates, materials, drawing
          style, and so on.

     SoRayPickAction
          Intersects the ray with the cube. The face of the cube that was
          picked is available from the SoCubeDetail.

     SoGetBoundingBoxAction
          Computes the bounding box that encloses the cube.

     SoCallbackAction
          If any triangle callbacks are registered with the action, they will
          be invoked for each successive triangle that approximates the cube.


FILE FORMAT/DEFAULTS
     Cube {
          width   2
          height  2
          depth   2
     }

SEE ALSO
     SoCone, SoCubeDetail, SoCylinder, SoSphere