SoGLPointSizeElement(3)

💅 SoGLPointSizeElement — NAME

okay so bestie, this is the manual for SoGLPointSizeElement, and it lives in the Library Functions Manual (that's the section 3 energy, iykyk). What does it do? It changes the pointsize setting of the OpenGL render state. that's the whole job. iconic, focused, no notes. 💖

---

✨ SYNOPSIS ✨

#include <InheritsSoPointSizeElement.elements/SoGLPointSizeElement.h>

wait no, bestie, don't copy that, that's me being chaotic. the real one is:

#include <Inventor/elements/SoGLPointSizeElement.h>

Inherits SoPointSizeElement. yes queen, it's a whole family tree. 🌳

🌸 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 it in the NAME section, we're saying it again, it's called emphasis. 💅

So the scenegraph will slide in and request a pointsize change when it's rendering point primitives — and it does that through this element, which then forwards it straight to the appropriate native OpenGL call. middleman but make it useful. 🧚

Now listen bestie, this part matters: the Coin library does not place any bounds on the values of the pointsize. like, zero. none. it will simply let you do whatever. but be aware that the range and granularity of what is valid pointsizes depends on the underlying OpenGL implementation. so your mileage varies by driver, fr fr. application programmers using point primitives (typically through the SoPointSet node) should heed these boundary values. 👀

You can acquire 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, perhaps more convenient, way of acquiring the OpenGL implementation limits with regard to pointsizes is to use the So*GLWidget::getPointSizeLimits() method in the GUI "glue" interface library you are using (SoQt, SoXt, SoGtk, SoWin, ...). pick your fave, they all ate. 🍓

---

💀 Constructor & Destructor Documentation 💀

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

The destructor. that's it. that's the sentence. she's brief, she's protected, she's virtual. 😭

---

🧚 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. not for you bestie, sorry, it's giving backstage pass only. 🙈

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

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

Reimplemented from SoPointSizeElement.

References SoPointSizeElement::init().

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(). slay, inheritance. 🌈

Reimplemented from SoElement.

References SoElement::capture(), SoFloatElement::data, and SoElement::getNextInStack().

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. pop() is called on the new top of stack, and a pointer to the previous top of stack is passed in prevTopElement. 🎀

(and yes, "callled" is spelled like that in the original, no cap, we don't fix typos around here, we preserve them like little fossils 💖)

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

Reimplemented from SoElement.

References SoFloatElement::data, and SoElement::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: not your business bestie, respectfully. 💅

Reimplemented from SoFloatElement.

References SoFloatElement::data.

---

🌟 Author 🌟

Generated automatically by Doxygen for Coin from the source code. the robots wrote this one, and honestly? they understood the assignment. 🤖✨

---

okay that's the whole page, you're fully caught up, go forth and set your pointsizes responsibly (or don't, Coin won't stop you, remember — no bounds 😭). mwah 💖

this little love letter came to you from Coin, Version 2.5.0, dated right there in the footer as SoGLPointSizeElement(3) — take care of her, she's a classic. 🎀