NAME

       SoVertexShape — abstract base class for all vertex-based shape nodes

INHERITS FROM

       SoBase > SoFieldContainer > SoNode > SoShape > SoVertexShape

SYNOPSIS

       #include <Inventor/nodes/SoVertexShape.h>

          Fields from class SoVertexShape:

     SoSFNode            vertexProperty

          Methods from class SoVertexShape:

     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  node  is  the  abstract  base  class  for  all vertex-based shape (geometry) nodes. It is used as a
       repository for convenience functions for subclasses and to provide a type identifier to make it  easy  to
       determine whether a shape is vertex-based. It contains one public field, the SoVertexProperty field.

       All  subclasses  of this node draw objects constructed from vertices. If the vertexProperty field is non-
       null and there are coordinates in the associated vertex property node, then those coordinates  are  used.
       Otherwise  the objects are drawn using the current coordinates in the state. The coordinates of the shape
       are transformed by the current transformation matrix and are drawn  with  the  current  light  model  and
       drawing style.

       Subclasses  that  construct  polygons  from  vertices  may  not  render or pick correctly if any of their
       polygons are self-intersecting or non-planar.

       All vertex shape subclasses use the bounding box of the shape to determine default  texture  coordinates.
       The  longest  dimension of the bounding box defines the S coordinates, and the next longest defines the T
       coordinates. The value of the S coordinate ranges from 0 to 1, from one end of the bounding  box  to  the
       other.  The  T coordinate ranges between 0 and the ratio of the second greatest dimension of the bounding
       box to the greatest dimension.

       When a vertex-based shape is picked with an SoRayPickAction, a detail is always returned. If the shape is
       composed of faces (such as SoFaceSet or SoTriangleStripSet), an SoFaceDetail is returned.  If  the  shape
       is  composed  of line segments (such as SoLineSet), an SoLineDetail is returned. If the shape is composed
       of points (such as SoPointSet), an SoPointDetail is returned. Note that the type of  detail  returned  is
       not affected by the current drawing style.

       Similarly,  each  class  of  vertex-based  shape  invokes  appropriate  callbacks  if those callbacks are
       registered with the SoCallbackAction. Shapes made of faces invoke triangle callbacks for  each  generated
       triangle.   (Faces  may  be  triangulated to create these triangles.) Shapes made of line segments invoke
       line segment callbacks for each segment, and shapes made of points invoke point callbacks.

       The subclass SoIndexedShape is a base class for vertex-based shapes that index into the  current  set  of
       coordinates.  The subclass SoNonIndexedShape is a base class for vertex-based shapes that use the current
       coordinates in order.

FIELDS

     SoSFNode            vertexProperty
          vertex property node.

METHODS

     static SoType       getClassTypeId()
          Returns type identifier for this class.

FILE FORMAT/DEFAULTS

       This is an abstract class. See the reference page of a derived class for the format and default values.

SEE ALSO

       SoIndexedShape, SoNonIndexedShape, SoVertexProperty

                                                                                            SoVertexShape(3IV)()