SoPickedPointList(3)

💖 SoPickedPointList — from the Coin manual (section 3) 💖

okay bestie, sit down, hydrate, because we're about to talk about a container class and honestly? she's kind of a lot. this is SoPickedPointList(3), straight out of Coin, and she holds pointers to SoPickedPoint objects. that's the whole vibe. 🎀

---

✨ NAME ✨

SoPickedPointList — the class that is a container for pointers to SoPickedPoint objects. yes that's literally it, she's a list, she contains, she slays. 💅

---

🌸 SYNOPSIS 🌸

#include <Inventor/lists/SoPickedPointList.h>

Inherits SbPList. (so all the parent energy comes free, iykyk 🦋)

Public Member Functions

SoPickedPointList (void)
SoPickedPointList (const int sizehint)
SoPickedPointList (const SoPickedPointList &l)
void append (SoPickedPoint *pp)
void insert (SoPickedPoint *pp, const int insertbefore)
SoPickedPoint * operator[] (const int idx) const
void truncate (const int start, const int fit=0)
void set (const int idx, SoPickedPoint *pp)

Public Member Functions inherited from SbPList

like, she got it from her mama 💜

SbPList (const int sizehint=DEFAULTSIZE)
SbPList (const SbPList &l)
~SbPList ()
void copy (const SbPList &l)
SbPList & operator= (const SbPList &l)
void fit (void)
void append (void *item)
int find (const void *item) const
void insert (void *item, const int insertbefore)
void removeItem (void *item)
void remove (const int index)
void removeFast (const int index)
int getLength (void) const
void truncate (const int length, const int fit=0)
void ** getArrayPtr (const int start=0) const
void *& operator[] (const int index) const
int operator== (const SbPList &l) const
int operator!= (const SbPList &l) const
void * get (const int index) const
void set (const int index, void *item)

Additional Inherited Members

Protected Member Functions inherited from SbPList

the backstage passes, not for the general public 🎟️

void expand (const int size)
int getArraySize (void) const

---

🦋 Detailed Description 🦋

The SoPickedPointList class is a container for pointers to SoPickedPoint objects.

okay here's the part you actually need to hear, and I need you to listen: this list class will delete the picked points when destructed/truncated, or when a picked point in the list is replaced by another picked point. the caller is responsible for allocating the picked points passed to the list, but should not deallocate them, because this will be handled by the list.

bestie. do NOT free those picked points yourself. she owns them now. she is the main character of their little lives. 😭

See also

• SbPList

---

🎀 Constructor & Destructor Documentation 🎀

SoPickedPointList::SoPickedPointList (void ) [inline]

Default constructor. no thoughts, head empty, list empty, iconic. ✨

SoPickedPointList::SoPickedPointList (const int sizehint) [inline]

This constructor initializes the internal allocated size for the list to sizehint. Note that the list will still initially contain zero items. so like, she's reserved space in the group chat but nobody's said anything yet. 🙈

See also

• SbPList::SbPList(const int sizehint)

SoPickedPointList::SoPickedPointList (const SoPickedPointList & l)

Copy constructor. Will copy picked points, not just pointers. so it's a deep copy situation, she's not just tagging along, she's bringing her own whole personality. 👑

See also

• SbList::SbList(const SbList<Type> & l)

---

🌈 Member Function Documentation 🌈

void SoPickedPointList::append (SoPickedPoint * pp) [inline]

Append item to the end of the list.

Automatically allocates more items internally if needed. she grows. she adapts. she's flexible like that. 💅

Overloaded from parent to accept an SoPickedPoint pointer argument.

See also

• SbPList::append()

---

void SoPickedPointList::insert (SoPickedPoint * pp, const int insertbefore) [inline]

Insert item at index insertbefore.

insertbefore should not be larger than the current number of items in the list. that's not a suggestion bestie, that's the rule. 🚫

Overloaded from parent to accept an SoPickedPoint pointer argument.

See also

• SbPList::insert()

---

SoPickedPoint * SoPickedPointList::operator[] (const int idx) const [inline]

Returns element at index.

Will automatically expand the size of the internal array if index is outside the current bounds of the list. The values of any additional pointers are then set to NULL. so yes she'll just make room and leave lil empty spots. generous of her honestly. 🌸

Overloaded from parent to return an SoPickedPoint pointer.

See also

• SbPList::operator[]()

---

void SoPickedPointList::truncate (const int start, const int fit = 0)

Shorten the list to contain length elements, removing items from index length and onwards.

If fit is non-zero, will also shrink the internal size of the allocated array. Note that this is much less efficient than not re-fitting the array size. so like, cute if you need the memory back, but she's gonna be tired after. 😮‍💨

Overloaded from parent to delete truncated items.

See also

• SbPList::truncate()

---

void SoPickedPointList::set (const int idx, SoPickedPoint * pp)

Index operator to set element at index. Does not expand array bounds if index is outside the list. she will not make room for you here, sorry, no growth mindset in this function. 💀

Overloaded from parent to destruct the replaced item.

See also

• SbPList::set()

---

💜 Author 💜

Generated automatically by Doxygen for Coin from the source code. no human wrote this, a robot did, and honestly? the robot ate. 🔥

---

and that's the whole page bestie, go forth and manage your picked points responsibly 🫶

Version 4.0.10 · Thu Jun 25 2026 00:00:00 · SoPickedPointList(3) · made with love for Coin ⭐🍓🧚