SoFaceDetail(3IV)

NAME
     SoFaceDetail (SoFaceDtl) - stores detail information about vertex-based
     shapes made of faces

INHERITS FROM
     SoDetail > SoFaceDetail

SYNOPSIS
     #include <Inventor_c/details/SoFaceDetail.h>

     typedef SoFaceDetail  SoFaceDtl

          Functions from class SoFaceDetail:

     SoFaceDetail *         SoFaceDtlCreate()
     void                   SoFaceDtlDelete(SoFaceDtl *this)
     long                   SoFaceDtlGetNumPts(const SoFaceDtl *this)
     const SoPointDetail *  SoFaceDtlGetPt(const SoFaceDtl *this, int i)
     int32_t                SoFaceDtlGetFaceInd(const SoFaceDtl *this)
     int32_t                SoFaceDtlGetPartInd(const SoFaceDtl *this)
     SoType                 SoFaceDtlGetClassTypeId()

          Functions from class SoDetail:

     SoDetail *          SoFaceDtlVirtual(const SoFaceDtl *this)
     SoType              SoFaceDtlGetTypeId(const SoFaceDtl *this)
     SbBool              SoFaceDtlIsOfType(const SoFaceDtl *this, SoType type)


DESCRIPTION
     This class contains detail information about a point on a face in a
     vertex-based shape made of faces. The information includes the number of
     points in the face, the points forming the vertices of the face, and the
     index of the face within the shape.

     Note that when an SoFaceDetail is returned from picking (in an
     SoPickedPoint), it will contain details for all points defining the face
     that was intersected. However, when an SoFaceDetail is created for a
     triangle produced during primitive generation (in an SoPrimitiveVertex),
     it will contain details for only the three vertices of the triangle.

FUNCTIONS
     SoFaceDetail *         SoFaceDtlCreate()
     void                   SoFaceDtlDelete(SoFaceDtl *this)
          Constructor and destructor.

     long                   SoFaceDtlGetNumPts(const SoFaceDtl *this)
          Returns the number of points in the face.

     const SoPointDetail *  SoFaceDtlGetPt(const SoFaceDtl *this, int i)
          Returns information about the point forming the i'th vertex of the
          face, represented as an SoPointDetail.
     int32_t                SoFaceDtlGetFaceInd(const SoFaceDtl *this)
          Returns the index of the face within the shape.

     int32_t                SoFaceDtlGetPartInd(const SoFaceDtl *this)
          Returns the index of the part containing the face within the shape.

     SoType                 SoFaceDtlGetClassTypeId()
          Returns type identifier for this class.


SEE ALSO
     SoDetail, SoPickedPoint, SoPrimitiveVertex, SoVertexShape