SoGLPointSizeElement(3)

💖 SoGLPointSizeElement 💖

okay bestie, welcome to section 3 of the Library Functions Manual — yes we're in manpage territory and yes it's lowkey iconic. buckle up. 🎀

---

🌸 NAME 🌸

SoGLPointSizeElement — the class that changes the pointsize setting of the OpenGL render state. that's it, that's the whole job, and it does it flawlessly. 💅

---

✨ SYNOPSIS ✨

#include <Inventor/elements/SoGLPointSizeElement.h>

Inherits SoPointSizeElement. so it's giving family lineage, it's giving legacy. 👑

🫶 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 pointsize setting of the OpenGL render state. (yes we said that in NAME, no we will not be apologizing, it's a manpage thing fr fr.)

When the scenegraph wants to change the pointsize while rendering point primitives, that request comes through this element, and the element forwards it straight to the appropriate native OpenGL call. middle management, but make it glamorous. ✨

Coin itself does not put any bounds on pointsize values — but heads up bestie, the range and granularity of what counts as a valid pointsize is entirely up to the underlying OpenGL implementation. so if you're an application programmer using point primitives (typically via the SoPointSet node), you need to respect those boundary values. 🚨

You can grab them by running this code from inside 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 ngl — to get the OpenGL implementation limits for pointsizes is to call the So*GLWidget::getPointSizeLimits() method in whichever GUI "glue" interface library you're using (SoQt, SoXt, SoGtk, SoWin, ...). pick your fighter. 💖

---

🌟 Constructor & Destructor Documentation 🌟

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

The destructor. it destroys. respectfully. 💀

---

👑 Member Function Documentation 👑

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. (translation: not for you, bestie, it's giving internal affairs 🕵️)

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

This function initializes the element type in the given SoState. It gets called for the first element of each enabled element type inside SoState objects.

Reimplemented from SoPointSizeElement.

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

This method is called every single time a new element is required in one of the stacks. That happens when a writable element is requested — either via SoState::getElement() or indirectly through 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. push() gets called on the new element, and you can find the previous element using SoElement::getNextInStack().

Reimplemented from SoElement.

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

This method is callled when the state is popped, and the depth of the element is bigger than the current state depth. (yes, "callled" — that's the original typo, we keep the lore 🫶) pop() gets called on the new top of stack, and a pointer to the previous top of stack is handed to you 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. again: internal. not your problem. 💅

Reimplemented from SoFloatElement.

---

🦋 Author 🦋

Generated automatically by Doxygen for Coin from the source code. so no, a human did not handcraft this, it's Doxygen doing its little thing and honestly? ate. 🔥

---

and that's a wrap on this page, bestie!! this was Coin, Version 3.1.3 — shoutout to the source/version footer that lives at the bottom of every manpage and never gets appreciated. 🌸✨ stay pointy, stay slay 💖