SoGLPointSizeElement(3)

💖 SoGLPointSizeElement 💖

okay bestie, buckle up, because this is SoGLPointSizeElement from section 3 of the manual (you know, the library-functions corner of the man universe) and it's lowkey iconic. It's the class that changes the point size setting of the OpenGL render state. periodt.

---

✨ NAME ✨

SoGLPointSizeElement — the class that changes the point size setting of the OpenGL render state.

🌸 SYNOPSIS 🌸

#include <Inventor/elements/SoGLPointSizeElement.h>

Inherits SoPointSizeElement.

🎀 Public Member Functions 🎀

• virtual void init (SoState *state)
• virtual void push (SoState *state)
• virtual void pop (SoState *state, const SoElement *prevTopElement)

🦋 Public Member Functions inherited from SoFloatElement 🦋

• virtual SbBool matches (const SoElement *element) const
• virtual SoElement * copyMatchInfo (void) const
• virtual void print (FILE *file) const

💜 Public Member Functions inherited from SoElement 💜

• const SoType getTypeId (void) const
• int getStackIndex (void) const
• void setDepth (const int depth)
• int getDepth (void) const
• virtual ~SoElement ()

⭐ Static Public Member Functions ⭐

• static SoType getClassTypeId (void)
• static int getClassStackIndex (void)
• static void * createInstance (void)
• static void initClass (void)

🌈 Static Public Member Functions inherited from SoPointSizeElement 🌈

• static SoType getClassTypeId (void)
• static int getClassStackIndex (void)
• static void * createInstance (void)
• static void initClass (void)
• static void set (SoState *const state, SoNode *const node, const float pointSize)
• static void set (SoState *const state, const float pointSize)
• static float get (SoState *const state)
• static float getDefault ()

🍓 Static Public Member Functions inherited from SoFloatElement 🍓

• static SoType getClassTypeId (void)
• static int getClassStackIndex (void)
• static void initClass (void)
• static void set (const int stackIndex, SoState *const state, SoNode *const node, const float value)
• static void set (const int stackIndex, SoState *const state, const float value)
• static float get (const int stackIndex, SoState *const state)

🧚 Static Public Member Functions inherited from SoElement 🧚

• static void initClass (void)
• static SoType getClassTypeId (void)
• static int getClassStackIndex (void)
• static void initElements (void)
• static int getNumStackIndices (void)
• static SoType getIdFromStackIndex (const int stackIndex)

💅 Protected Member Functions 💅

• virtual ~SoGLPointSizeElement ()
• virtual void setElt (float size)

🫶 Protected Member Functions inherited from SoPointSizeElement 🫶

• virtual ~SoPointSizeElement ()

🫶 Protected Member Functions inherited from SoFloatElement 🫶

• virtual ~SoFloatElement ()

🫶 Protected Member Functions inherited from SoElement 🫶

• SoElement (void)
• void capture (SoState *const state) const
• virtual void captureThis (SoState *state) const
• void setTypeId (const SoType typeId)
• void setStackIndex (const int index)
• SoElement * getNextInStack (void) const
• SoElement * getNextFree (void) const

🌟 Additional Inherited Members 🌟

Static Protected Member Functions inherited from SoElement:

• static SoElement * getElement (SoState *const state, const int stackIndex)
• static const SoElement * getConstElement (SoState *const state, const int stackIndex)
• static int createStackIndex (const SoType id)

Protected Attributes inherited from SoFloatElement:

• float data

Protected Attributes inherited from SoElement:

• SoType typeId
• int stackIndex
• int depth

Static Protected Attributes inherited from SoElement:

• static int classStackIndex
• static SoTypeList * stackToType

---

👑 Detailed Description 👑

The SoGLPointSizeElement class changes the point size setting of the OpenGL render state. like, that's literally its whole job and it does it flawlessly 💖

So when the scene graph wants to change the point size while rendering point primitives, the request comes through this element, and the element forwards it to the appropriate native OpenGL call. slay, delegation, we love to see it ✨

The Coin library does not place any bounds on the values of the point size. but bestie, listen — the range and granularity of what is a valid point size depends on the underlying OpenGL implementation. so if you're an application programmer using point primitives (typically through the SoPointSet node), please consider these boundary values. 🫶 You can get them by running the following code from within a valid OpenGL context:

GLfloat bounds[2];
glGetFloatv(GL_POINT_SIZE_RANGE, bounds);
GLfloat granularity[1];
glGetFloatv(GL_POINT_SIZE_GRANULARITY, granularity);

Another way — maybe even more convenient tbh — to get the OpenGL implementation limits for point sizes is to use the So@Gui@GLWidget::getPointSizeLimits() method in the GUI "glue" interface library you're using (SoQt, SoXt, SoGtk, SoWin, ...). pick your fave, they all ate 💅

---

🎀 Constructor & Destructor Documentation 🎀

💀 SoGLPointSizeElement::~SoGLPointSizeElement (void ) [protected], [virtual]

Destructor. it's giving "goodbye, cleanup era". ✨

---

🦋 Member Function Documentation 🦋

⭐ SoType SoGLPointSizeElement::getClassTypeId (void ) [static]

This static method returns the SoType object associated with objects of this class.

⭐ int SoGLPointSizeElement::getClassStackIndex (void ) [static]

This static method returns the state stack index for the class.

⭐ void * SoGLPointSizeElement::createInstance (void ) [static]

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

Creates a new instance of the class type corresponding to the SoType object.

⭐ void SoGLPointSizeElement::initClass (void ) [static]

Initialize relevant common data for all instances, like the type system.

⭐ void SoGLPointSizeElement::init (SoState * state) [virtual]

Initializes the element to its default value. The default value for point size is 0.0.

Reimplemented from SoPointSizeElement.

⭐ void SoGLPointSizeElement::push (SoState * state) [virtual]

This method is called every time a new element is required in one of the stacks. This happens when a writable element is requested, using SoState::getElement() or indirectly SoElement::getElement(), and the depth of the current element is less than the state depth.

Override this method if your element needs to copy data from the previous top of stack. The push() method is called on the new element, and the previous element can be found using SoElement::getNextInStack().

Reimplemented from SoElement.

⭐ void SoGLPointSizeElement::pop (SoState * state, const SoElement * prevTopElement) [virtual]

This method is called when the state is popped, and the depth of the element is bigger than the current state depth. pop() is called on the new top of stack, and a pointer to the previous top of stack is passed in prevTopElement.

Override this method if you need to copy some state information from the previous top of stack.

Reimplemented from SoElement.

⭐ void SoGLPointSizeElement::setElt (float val) [protected], [virtual]

This API member is considered internal to the library, as it is not likely to be of interest to the application programmer.

Reimplemented from SoFloatElement.

---

💜 Author 💜

Generated automatically by Doxygen for Coin from the source code.

---

and that's the whole page bestie, no cap 🫶 this was Version 4.0.10, dated Thu Jun 25 2026 00:00:00, and yeah it really does say SoGLPointSizeElement(3) at the bottom too — go off, little manual page, you ate 💅✨🎀