SoPickedPointList(3IV)

NAME
     SoPickedPointList (SoPickPtList) - maintains a list of pointers to
     SoPickedPoint instances

INHERITS FROM
     SbPList > SoPickedPointList

SYNOPSIS
     #include <Inventor_c/SoLists.h>

     typedef SoPickedPointList  SoPickPtList

          Functions from class SoPickedPointList:

     SoPickedPointList *  SoPickPtListCreate()
     SoPickedPointList *  SoPickPtListCreateSize(int size)
     void                 SoPickPtListDelete(SoPickPtList *this)
     void                 SoPickPtListAppend(SoPickPtList *this, SoPickedPoint
                               *ptr)
     void                 SoPickPtListInsert(SoPickPtList *this, SoPickedPoint
                               *ptr, int addBefore)
     void                 SoPickPtListTruncate(SoPickPtList *this, int start)
     SoPickedPoint *      SoPickPtListUnknownOperator(const SoPickPtList
                               *this, int i)
     void                 SoPickPtListSet(SoPickPtList *this, int i,
                               SoPickedPoint *pickedPoint)

          Functions from class SbPList:

     int                 SoPickPtListFind(const SoPickPtList *this, const void
                              *ptr)
     void                SoPickPtListRemove(SoPickPtList *this, int which)
     int                 SoPickPtListGetLen(const SoPickPtList *this)
     void                SoPickPtListCopy(SoPickPtList *this, const SbPList
                              *pl)
     int                 SoPickPtListIsEq(const SoPickPtList *this, const
                              SbPList *pl)
     int                 SoPickPtListIsNEq(const SoPickPtList *this, const
                              SbPList *pl)


DESCRIPTION
     This subclass of SbPList holds lists of pointers to instances of classes
     derived from SoPickedPoint. It is used primarily to return information
     from picking with the SoRayPickAction class.

FUNCTIONS
     SoPickedPointList *  SoPickPtListCreate()
          Constructor.

     SoPickedPointList *  SoPickPtListCreateSize(int size)
          Constructor that pre-allocates storage for size pointers.
     void                 SoPickPtListDelete(SoPickPtList *this)
          Destructor.

     void                 SoPickPtListAppend(SoPickPtList *this, SoPickedPoint
                               *ptr)
          Adds a pointer to the end of the list.

     void                 SoPickPtListInsert(SoPickPtList *this, SoPickedPoint
                               *ptr, int addBefore)
          Inserts given pointer in list before pointer with given index.

     void                 SoPickPtListTruncate(SoPickPtList *this, int start)
          Removes all pointers after one with given index, inclusive, deleting
          all instances removed from the list.

     SoPickedPoint *      SoPickPtListUnknownOperator(const SoPickPtList
                               *this, int i)
          Accesses an element of a list.

     void                 SoPickPtListSet(SoPickPtList *this, int i,
                               SoPickedPoint *pickedPoint)
          Sets an element of a list.


SEE ALSO
     SoPickedPoint, SoRayPickAction