SoPrimitiveVertex(3IV)

SoPrimitiveVertex (SoPrimVtx) - represents a vertex of a generated primitive

Showing IRIX 6.5.30 (default release). Added in IRIX 6.5.22.

NAME
     SoPrimitiveVertex (SoPrimVtx) - represents a vertex of a generated
     primitive

INHERITS FROM
     SoPrimitiveVertex

SYNOPSIS
     #include <Inventor_c/SoPrimitiveVertex.h>

     typedef SoPrimitiveVertex  SoPrimVtx

          Functions from class SoPrimitiveVertex:

     SoPrimitiveVertex *  SoPrimVtxCreate()
     SoPrimitiveVertex *  SoPrimVtxCreateCopy(const SoPrimitiveVertex *pv)
     void                 SoPrimVtxDelete(SoPrimVtx *this)
     const SbVec3f *      SoPrimVtxGetPt(const SoPrimVtx *this)
     const SbVec3f *      SoPrimVtxGetNorm(const SoPrimVtx *this)
     const SbVec4f *      SoPrimVtxGetTexCoords(const SoPrimVtx *this)
     int                  SoPrimVtxGetMtlInd(const SoPrimVtx *this)
     const SoDetail *     SoPrimVtxGetDtl(const SoPrimVtx *this)
     SoPrimitiveVertex *  SoPrimVtxCopy(SoPrimVtx *this, const
                               SoPrimitiveVertex *pv)


DESCRIPTION
     An SoPrimitiveVertex represents a vertex of a primitive (triangle, line
     segment, or point) that is being generated by an SoCallbackAction. It
     contains an object-space point, normal, texture coordinates, material
     index, and a pointer to an instance of an SoDetail subclass. This detail
     may contain more information about the vertex, or may be a NULL pointer
     if there is no such info.

     Instances of SoPrimitiveVertex are typically created on the stack by
     shape classes while they are generating primitives. Anyone who wants to
     save them as return values from SoCallbackAction should probably make
     copies of them.

FUNCTIONS
     SoPrimitiveVertex *  SoPrimVtxCreate()
     SoPrimitiveVertex *  SoPrimVtxCreateCopy(const SoPrimitiveVertex *pv)
     void                 SoPrimVtxDelete(SoPrimVtx *this)
          Constructors and destructor. Note that copying a primitive vertex
          copies the detail pointer, and not the detail itself.

     const SbVec3f *      SoPrimVtxGetPt(const SoPrimVtx *this)
     const SbVec3f *      SoPrimVtxGetNorm(const SoPrimVtx *this)
     const SbVec4f *      SoPrimVtxGetTexCoords(const SoPrimVtx *this)
          These return the surface point, normal, and texture coordinates in
          object space.
     int                  SoPrimVtxGetMtlInd(const SoPrimVtx *this)
          Returns the index into the current set of materials of the material
          active at the vertex.

     const SoDetail *     SoPrimVtxGetDtl(const SoPrimVtx *this)
          Returns the detail giving more information about the vertex. Note
          that this pointer may be NULL if there is no more info.

     SoPrimitiveVertex *  SoPrimVtxCopy(SoPrimVtx *this, const
                               SoPrimitiveVertex *pv)
          Copies the given vertex. Note that just the pointer to the detail is
          copied, and not the detail itself.