SoPointSet(3)

📦
version 4.0.10 · 4 versions
, in fedora 43, fedora 44

SoPointSet(3) — Coin 💖

okay bestie, welcome to the SoPointSet(3) manpage from Coin 💅 this is part 1 of 3, so buckle up ✨

NAME

SoPointSet — the SoPointSet class is used to display a set of 3D points. she's literally the point queen 👑💖

SYNOPSIS

#include <Inventor/nodes/SoPointSet.h>

Inherits SoNonIndexedShape.

Inherited by SoMarkerSet.

💖 Public Member Functions 💖

  • virtual SoType getTypeId (void) const — she's virtual, she's iconic 💅
  • SoPointSet (void) — the constructor, she's here to build your point set ✨
  • virtual void GLRender (SoGLRenderAction *action) — does the GL render thing, slay 💖
  • virtual void getBoundingBox (SoGetBoundingBoxAction *action) — gets that bounding box, periodt 📦
  • virtual void getPrimitiveCount (SoGetPrimitiveCountAction *action) — counts primitives, no cap 🔢

Public Member Functions inherited from SoVertexShape

  • virtual void notify (SoNotList *nl) — notifies, she's a communicator 💬
  • virtual void write (SoWriteAction *action) — writes, iconic ✍️

Public Member Functions inherited from SoShape

  • virtual SbBool affectsState (void) const — does it affect state? maybe 🤔
  • virtual void rayPick (SoRayPickAction *action) — ray picking, so cool 🔦
  • virtual void callback (SoCallbackAction *action) — callback time 🎀
  • const SoBoundingBoxCache * getBoundingBoxCache (void) const — returns the bounding box cache, periodt 💅

Public Member Functions inherited from SoNode

  • void setOverride (const SbBool state) — sets override, she's over it 🙅‍♀️
  • SbBool isOverride (void) const — is it override? 👀
  • void setNodeType (const NodeType type) — sets node type, slay 🎀
  • NodeType getNodeType (void) const — gets node type, iconic ✨
  • virtual SoNode * copy (SbBool copyconnections=FALSE) const — copies, with copyconnections=FALSE by default 💖
  • virtual void doAction (SoAction *action) — does the action, periodt 💅
  • virtual void GLRenderBelowPath (SoGLRenderAction *action) — GL render below path, she's on a journey 🛣️
  • virtual void GLRenderInPath (SoGLRenderAction *action) — GL render in path, iconic 🛤️
  • virtual void GLRenderOffPath (SoGLRenderAction *action) — GL render off path, she's off the beaten track 🌿
  • virtual void getMatrix (SoGetMatrixAction *action) — gets the matrix, wake up bestie 🕶️
  • virtual void handleEvent (SoHandleEventAction *action) — handles events, she's a handler 💁‍♀️
  • virtual void pick (SoPickAction *action) — pick, pick, pick 🎯
  • virtual void search (SoSearchAction *action) — search, she's looking 🔍
  • virtual void audioRender (SoAudioRenderAction *action) — audio render, sound on 🔊
  • virtual void grabEventsSetup (void) — grabs events setup, iconic 👑
  • virtual void grabEventsCleanup (void) — grabs events cleanup, she cleans up nice 🧹
  • virtual void startNotify (void) — starts notify, here we go 💖
  • SbUniqueId getNodeId (void) const — gets node ID, she has an identity 💅
  • virtual SoChildList * getChildren (void) const — gets children, she's a mom 🍼
  • virtual void writeInstance (SoOutput *out) — writes instance, periodt ✍️
  • virtual SoNode * addToCopyDict (void) const — adds to copy dict, slay 📖
  • virtual void copyContents (const SoFieldContainer *from, SbBool copyconnections) — copies contents, so thorough 💖
  • virtual SoFieldContainer * copyThroughConnection (void) const — copies through connection, iconic 🔗

Public Member Functions inherited from SoFieldContainer

  • void setToDefaults (void) — sets to defaults, back to basics ✨
  • SbBool hasDefaultValues (void) const — has default values? 🤔
  • SbBool fieldsAreEqual (const SoFieldContainer *container) const — fields are equal? check bestie 👯‍♀️
  • void copyFieldValues (const SoFieldContainer *container, SbBool copyconnections=FALSE) — copies field values, with copyconnections=FALSE default 💅
  • SbBool set (const char *const fielddata) — sets from fielddata, slay 📝
  • void get (SbString &fielddata) — gets into fielddata, iconic 📤
  • virtual int getFields (SoFieldList &l) const — gets fields, so many 💖
  • virtual int getAllFields (SoFieldList &l) const — gets all fields, she's greedy 😈
  • virtual SoField * getField (const SbName &name) const — gets a field by name, periodt 🔍
  • virtual SoField * getEventIn (const SbName &name) const — gets event in, she's in 📥
  • virtual SoField * getEventOut (const SbName &name) const — gets event out, she's out 📤
  • SbBool getFieldName (const SoField *const field, SbName &name) const — gets field name, name drop 💅
  • SbBool enableNotify (const SbBool flag) — enables notify, flag it 🚩
  • SbBool isNotifyEnabled (void) const — is notify enabled? 👀
  • SbBool set (const char *fielddata, SoInput *input) — sets from fielddata with input, slay 🎀
  • void get (SbString &fielddata, SoOutput *out) — gets into fielddata with out, iconic 📤
  • virtual SbBool validateNewFieldValue (SoField *field, void *newval) — validates new field value, she's checking ✅
  • virtual void addWriteReference (SoOutput *out, SbBool isfromfield=FALSE) — adds write reference, isfromfield=FALSE default 💖
  • SbBool getIsBuiltIn (void) const — is it built in? 🏠
  • virtual void getFieldsMemorySize (size_t &managed, size_t &unmanaged) const — gets fields memory size, so technical 💾
  • void setUserData (void *userdata) const — sets user data, she's got your data 💾
  • void * getUserData (void) const — gets user data, periodt 🔑

Public Member Functions inherited from SoBase

  • void ref (void) const — ref, she's referencing 💅
  • void unref (void) const — unref, she's done 👋
  • void unrefNoDelete (void) const — unref no delete, she's gentle 🕊️
  • int32_t getRefCount (void) const — gets ref count, numbers don't lie 🔢
  • void touch (void) — touch, she's tactile ✋
  • SbBool isOfType (SoType type) const — returns TRUE if the type of this object is either of the same type or inherited from type. periodt. 💅
  • virtual SbName getName (void) const — gets name, what's her name? 👑
  • virtual void setName (const SbName &newname) — sets name to newname, name change slay 💖
  • void addAuditor (void *const auditor, const SoNotRec::Type type) — adds auditor, she's listening 👂
  • void removeAuditor (void *const auditor, const SoNotRec::Type type) — removes auditor, she's over it 🙉
  • const SoAuditorList & getAuditors (void) const — gets auditors, the whole list 💅
  • SbBool shouldWrite (void) — should write? maybe ✍️
  • void assertAlive (void) const — assert alive, she's alive and thriving 🌱

💖 Static Public Member Functions 💖

  • static SoType getClassTypeId (void) — gets class type ID, iconic 💅
  • static void initClass (void) — sets up initialization for data common to all instances of this class, like submitting necessary info to the Coin type system. she's the setup queen 👑

Static Public Member Functions inherited from SoNonIndexedShape

  • static SoType getClassTypeId (void) — gets class type ID, again 💖
  • static void initClass (void) — init class, slay ✨

Static Public Member Functions inherited from SoVertexShape

  • static SoType getClassTypeId (void) — gets class type ID, periodt 💅
  • static void initClass (void) — init class, iconic 🎀

Static Public Member Functions inherited from SoShape

  • static SoType getClassTypeId (void) — gets class type ID, she's back 💖
  • static void initClass (void) — sets up initialization for data common to all instances of this class, like submitting necessary info to the Coin type system. 👑
  • static void getScreenSize (SoState *const state, const SbBox3f &boundingbox, SbVec2s &rectsize) — gets screen size, so handy 📏
  • static float getDecimatedComplexity (SoState *state, float complexity) — gets decimated complexity, complex but she's got it 🧠

Static Public Member Functions inherited from SoNode

  • static uint32_t getCompatibilityTypes (const SoType &nodetype) — gets compatibility types, matching vibes 💞
  • static SoType getClassTypeId (void) — gets class type ID, again and again 💅
  • static SoNode * getByName (const SbName &name) — gets by name, name search 🔍
  • static int getByName (const SbName &name, SoNodeList &l) — gets by name into list, so many 📋
  • static void initClass (void) — sets up initialization for data common to all instances of this class, like submitting necessary info to the Coin type system. ✨
  • static void initClasses (void) — init classes, plural slay 💖
  • static SbUniqueId getNextNodeId (void) — gets next node ID, next up 🔢
  • static int getActionMethodIndex (const SoType type) — gets action method index, indexing 📇
  • static void getBoundingBoxS (SoAction *action, SoNode *node) — gets bounding box S, static style 📦
  • static void GLRenderS (SoAction *action, SoNode *node) — GL render S, static render 🎨
  • static void callbackS (SoAction *action, SoNode *node) — callback S, static callback 📞
  • static void getMatrixS (SoAction *action, SoNode *node) — get matrix S, static matrix 🧮
  • static void handleEventS (SoAction *action, SoNode *node) — handle event S, static handle 💁‍♀️
  • static void pickS (SoAction *action, SoNode *node) — pick S, static pick 🎯
  • static void rayPickS (SoAction *action, SoNode *node) — ray pick S, static ray 🔦
  • static void searchS (SoAction *action, SoNode *node) — search S, static search 🔍
  • static void writeS (SoAction *action, SoNode *node) — write S, static write ✍️
  • static void audioRenderS (SoAction *action, SoNode *node) — audio render S, static sound 🔊
  • static void getPrimitiveCountS (SoAction *action, SoNode *node) — get primitive count S, static count 🔢

Static Public Member Functions inherited from SoFieldContainer

  • static void initClass (void) — sets up initialization for data common to all instances of this class, like submitting necessary info to the Coin type system. 💅
  • static SoType getClassTypeId (void) — this static method returns the SoType object associated with objects of this class. iconic. 💖
  • static void cleanupClass (void) — cleanup class, she cleans up 🧹
  • static void initCopyDict (void) — init copy dict, copy time 📖
  • static void addCopy (const SoFieldContainer *orig, const SoFieldContainer *copy) — adds a copy, so meta 👯‍♀️
  • static SoFieldContainer * checkCopy (const SoFieldContainer *orig) — checks copy, verifying ✅
  • static SoFieldContainer * findCopy (const SoFieldContainer *orig, const SbBool copyconnections) — finds copy, with copyconnections 💅
  • static void copyDone (void) — copy done, finished 🏁

Static Public Member Functions inherited from SoBase

  • static void initClass (void) — sets up initialization for data common to all instances of this class, like submitting necessary info to the Coin type system. 👑
  • static SoType getClassTypeId (void) — this static method returns the SoType object associated with objects of this class. periodt. 💅
  • static void addName (SoBase *const base, const char *const name) — adds name, name tag 🏷️
  • static void removeName (SoBase *const base, const char *const name) — removes name, bye name 👋
  • static void incrementCurrentWriteCounter (void) — increments current write counter, plus one ➕
  • static void decrementCurrentWriteCounter (void) — decrements current write counter, minus one ➖
  • static SoBase * getNamedBase (const SbName &name, SoType type) — gets named base, base search 🔍
  • static int getNamedBases (const SbName &name, SoBaseList &baselist, SoType type) — gets named bases into list, so many 📋
  • static SbBool read (SoInput *input, SoBase *&base, SoType expectedtype) — reads, input time 📥
  • static void setInstancePrefix (const SbString &c) — sets instance prefix, prefix slay 💅
  • static void setTraceRefs (SbBool trace) — sets trace refs, tracing 🕵️‍♀️
  • static SbBool getTraceRefs (void) — gets trace refs, periodt 🔍
  • static SbBool connectRoute (SoInput *input, const SbName &fromnodename, const SbName &fromfieldname, const SbName &tonodename, const SbName &tofieldname) — connects route, so many names 🛣️
  • static SbBool readRoute (SoInput *input) — reads route, reading the route 📖

💖 Public Attributes 💖

  • SoSFInt32 numPoints — number of points, iconic 🔢

Public Attributes inherited from SoNonIndexedShape

  • SoSFInt32 startIndex — start index, where it begins 🏁

Public Attributes inherited from SoVertexShape

  • SoSFNode vertexProperty — vertex property, property of the vertex 💎

💖 Protected Member Functions 💖

  • virtual const SoFieldData * getFieldData (void) const — gets field data, protected but powerful 💪
  • virtual ~SoPointSet () — the destructor, she's breaking down 💔
  • virtual void generatePrimitives (SoAction *action) — generates primitives, so generative ✨
  • virtual void computeBBox (SoAction *action, SbBox3f &box, SbVec3f &center) — computes bounding box, math queen 📐
  • virtual SbBool generateDefaultNormals (SoState *, SoNormalCache *nc) — generates default normals, normal but iconic 💅
  • virtual SbBool generateDefaultNormals (SoState *state, SoNormalBundle *bundle) — generates default normals with bundle, bundle up 🧣

Protected Member Functions inherited from SoNonIndexedShape

  • SoNonIndexedShape (void) — constructor, she's building 🏗️
  • virtual ~SoNonIndexedShape () — destructor, she's breaking down 💔
  • void computeCoordBBox (SoAction *action, int numVertices, SbBox3f &box, SbVec3f &center) — computes coord bounding box, coordinates and boxes 📦
  • void fixNumVerticesPointers (SoState *state, const int32_t *&start, const int32_t *&end, int32_t *dummyarray) const — fixes num vertices pointers, fixing things 🔧

Protected Member Functions inherited from SoVertexShape

  • SoVertexShape (void) — constructor, vertex shape building 🏗️
  • virtual ~SoVertexShape () — destructor, breaking down 💔
  • virtual SbBool shouldGLRender (SoGLRenderAction *action) — should GL render? maybe 🎨
  • void setNormalCache (SoState *const state, const int num, const SbVec3f *normals) — sets normal cache, caching normals 💾
  • SoNormalCache * getNormalCache (void) const — gets normal cache, cache retrieval 🔍
  • SoNormalCache * generateAndReadLockNormalCache (SoState *const state) — generates and read locks normal cache, locking it 🔒
  • void getVertexData (SoState *state, const SoCoordinateElement *&coords, const SbVec3f *&normals, const SbBool neednormals) — gets vertex data, data time 📊
  • void readLockNormalCache (void) — read locks normal cache, read lock 🔐
  • void readUnlockNormalCache (void) — read unlocks normal cache, unlock 🔓

to be continued in part 2... 💖

🎀 Protected Member Functions inherited from SoShape

okay so these are the protected goodies SoPointSet inherits from its parent SoShape — not stuff you call from the outside, but the family tree is real and we respect it 💅

  • SoShape (void) — the constructor, handed down.
  • virtual ~SoShape () — the destructor, and yes it's virtual.
  • float getComplexityValue (SoAction *action) — pulls out the complexity value for the action in question.
  • void beginSolidShape (SoGLRenderAction *action) — kicks off solid-shape rendering.
  • void endSolidShape (SoGLRenderAction *action) — wraps that solid-shape rendering back up.
  • void GLRenderBoundingBox (SoGLRenderAction *action) — renders the bounding box, GL-style.
  • SbBool shouldPrimitiveCount (SoGetPrimitiveCountAction *action) — decides if the primitive count should actually be counted.
  • SbBool shouldRayPick (SoRayPickAction *const action) — decides whether this is doing ray pick or not.
  • void computeObjectSpaceRay (SoRayPickAction *const action) — works out the object-space ray, no matrix version.
  • void computeObjectSpaceRay (SoRayPickAction *const action, const SbMatrix &matrix) — same thing but you hand it a matrix too.
  • virtual SoDetail * createTriangleDetail (SoRayPickAction *action, const SoPrimitiveVertex *v1, const SoPrimitiveVertex *v2, const SoPrimitiveVertex *v3, SoPickedPoint *pp) — makes the triangle detail for picking, virtual.
  • virtual SoDetail * createLineSegmentDetail (SoRayPickAction *action, const SoPrimitiveVertex *v1, const SoPrimitiveVertex *v2, SoPickedPoint *pp) — makes the line-segment detail, also virtual.
  • virtual SoDetail * createPointDetail (SoRayPickAction *action, const SoPrimitiveVertex *v, SoPickedPoint *pp) — and here's the point version ✨
  • void invokeTriangleCallbacks (SoAction *const action, const SoPrimitiveVertex *const v1, const SoPrimitiveVertex *const v2, const SoPrimitiveVertex *const v3) — fires off the triangle callbacks.
  • void invokeLineSegmentCallbacks (SoAction *const action, const SoPrimitiveVertex *const v1, const SoPrimitiveVertex *const v2) — fires off the line-segment callbacks.
  • void invokePointCallbacks (SoAction *const action, const SoPrimitiveVertex *const v) — fires off the point callbacks.
  • void beginShape (SoAction *const action, const TriangleShape shapetype, SoDetail *const detail=NULL) — opens a shape with a given TriangleShape, detail defaults to NULL.
  • void shapeVertex (const SoPrimitiveVertex *const v) — feeds a vertex into the shape.
  • void endShape (void) — closes the shape.
  • void generateVertex (SoPrimitiveVertex *const pv, const SbVec3f &point, const SbBool useTexFunc, const SoMultiTextureCoordinateElement *const tce, const float s, const float t, const SbVec3f &normal) — builds a vertex from a point, texture coords s/t, and a normal.
  • void generateVertex (SoPrimitiveVertex *const pv, const SbVec3f &point, const SbBool useTexFunc, const SoMultiTextureCoordinateElement *const tce, const float s, const float t, const float r, const SbVec3f &normal) — the 3-coord version, adds that r 🦋
  • SbBool startVertexArray (SoGLRenderAction *action, const SoCoordinateElement *coords, const SbVec3f *pervertexnormals, const SbBool texpervertex, const SbBool colorpervertex) — spins up the vertex array.
  • void finishVertexArray (SoGLRenderAction *action, const SbBool vbo, const SbBool normpervertex, const SbBool texpervertex, const SbBool colorpervertex) — and tears it back down.

💜 Protected Member Functions inherited from SoNode

  • SoNode (void) — constructor, inherited.
  • virtual ~SoNode () — virtual destructor.
  • virtual SbBool readInstance (SoInput *in, unsigned short flags) — reads an instance, virtual, takes an SoInput * and unsigned short flags.

🩷 Protected Member Functions inherited from SoFieldContainer

  • SoFieldContainer (void) — constructor.
  • virtual ~SoFieldContainer () — destructor, virtual as always.

💖 Protected Member Functions inherited from SoBase

  • SoBase (void) — constructor.
  • virtual ~SoBase () — destructor, virtual.
  • virtual void destroy (void) — the destroy hook, virtual.
  • SbBool hasMultipleWriteRefs (void) const — checks for multiple write refs, const.
  • SbBool writeHeader (SoOutput *out, SbBool isgroup, SbBool isengine) const — writes the header, const.
  • void writeFooter (SoOutput *out) const — writes the footer, also const.
  • virtual const char * getFileFormatName (void) const — hands back the file format name, const, virtual.
  • virtual SoNotRec createNotRec (void) — builds a SoNotRec, virtual.

🌸 Static Protected Member Functions

  • static const SoFieldData ** getFieldDataPtr (void) — grabs the field data pointer.

💐 Static Protected Member Functions inherited from SoNonIndexedShape

  • static const SoFieldData ** getFieldDataPtr (void) — same deal, inherited.

🌷 Static Protected Member Functions inherited from SoVertexShape

  • static const SoFieldData ** getFieldDataPtr (void) — yep, this one too.

🌺 Static Protected Member Functions inherited from SoShape

  • static const SoFieldData ** getFieldDataPtr (void) — inherited again, no cap.

🦋 Static Protected Member Functions inherited from SoNode

  • static const SoFieldData ** getFieldDataPtr (void) — the pointer getter.
  • static void setNextActionMethodIndex (int index) — sets the next action method index.
  • static int getNextActionMethodIndex (void) — gets the next action method index.
  • static void incNextActionMethodIndex (void) — increments that index, one at a time bestie.
  • static void setCompatibilityTypes (const SoType &nodetype, const uint32_t bitmask) — sets compatibility types from a nodetype and a uint32_t bitmask.

🎀 Static Protected Member Functions inherited from SoBase

  • static uint32_t getCurrentWriteCounter (void) — grabs the current write counter.
  • static void staticDataLock (void) — locks the static data.
  • static void staticDataUnlock (void) — unlocks it. balance, periodt.

✨ Additional Inherited Members ✨

👑 Public Types inherited from SoShape

enum TriangleShape { TRIANGLE_STRIP, TRIANGLE_FAN, TRIANGLES, POLYGON,
    QUADS, QUAD_STRIP, POINTS, LINES, LINE_STRIP }

💎 Public Types inherited from SoNode

enum NodeType { INVENTOR = 0x0000, VRML1 = 0x0001, VRML2 = 0x0002,
    INVENTOR_1 = 0x0004, INVENTOR_2_0 = 0x0008, INVENTOR_2_1 = 0x0010,
    INVENTOR_2_5 = 0x0020, INVENTOR_2_6 = 0x0040, COIN_1_0 = 0x0080,
    COIN_2_0 = 0x0100, EXTENSION = 0x0200, COIN_2_2 = 0x0400, COIN_2_3 =
    0x0800, COIN_2_4 = 0x1000, INVENTOR_5_0 = 0x2000, COIN_2_5 = 0x4000,
    COIN_3_0 = 0x8000, INVENTOR_6_0 = 0x10000, COIN_4_0 = 0x20000 }

🔐 Protected Types inherited from SoBase

enum BaseFlags { IS_ENGINE = 0x01, IS_GROUP = 0x02 }

🧚 Protected Attributes inherited from SoNode

  • SbUniqueId uniqueId — the unique id, protected.

💜 Protected Attributes inherited from SoFieldContainer

  • SbBool isBuiltIn — whether it's built in, protected.

⭐ Static Protected Attributes inherited from SoNode

  • static SbUniqueId nextUniqueId = 1 — starts at 1, iconic.
  • static int nextActionMethodIndex = 0 — starts at 0.

🌈 Detailed Description 🌈

The SoPointSet class is used to display a set of 3D points. yes bestie, that's literally the whole job and it eats 💅

This node either uses the coordinates currently on the state (typically set up by a leading SoCoordinate3 node in the scene graph) or from a SoVertexProperty node attached to this node to render a set of 3D points.

The SoPointSet::numPoints field specifies the number of points in the coordinate set which should be rendered (or otherwise handled by traversal actions).

Here's a simple usage example of SoPointSet in a scene graph:

#Inventor V2.1 ascii

Separator {
   Material {
      diffuseColor [
       1 0 0, 0 1 0, 0 0 1, 1 1 0, 1 0 1, 1 1 1, 1 0.8 0.6, 0.6 0.8 1
      ]
   }
   MaterialBinding { value PER_PART }

   Coordinate3 {
      point [
       -1 1 0, -1 -1 0, 1 -1 0, 1 1 0, 0 2 -1, -2 0 -1, 0 -2 -1, 2 0 -1
      ]
   }

   DrawStyle { pointSize 3 }

   PointSet { }
}

FILE FORMAT/DEFAULTS:

PointSet {
    vertexProperty NULL
    startIndex 0
    numPoints -1
}

🎀 Constructor & Destructor Documentation 🎀

💖 SoPointSet::SoPointSet (void )

Constructor.

🦋 SoPointSet::~SoPointSet () [protected], [virtual]

Destructor.

💅 Member Function Documentation 💅

okay bestie, this is the part where we meet the actual methods — the little functions that do the work. every single one, no skipping, i promise. let's get into it 🫶

✨ SoType SoPointSet::getClassTypeId(void) [static]

it's giving "who am i" but for classes. this static method hands you back the SoType object that's associated with objects of this class. that's it, that's the whole vibe. ✨

🦋 SoType SoPointSet::getTypeId(void) const [virtual]

returns the type identification of an object derived from a class inheriting SoBase. literally its whole job is runtime type checking and doing that "downward" casting thing. iykyk 👑

  • Reimplemented from SoNonIndexedShape.
  • Reimplemented in SoMarkerSet.

🔒 const SoFieldData ** SoPointSet::getFieldDataPtr(void) [static], [protected]

internal library business, bestie. this API member is considered internal to the library, since it's not likely to be of interest to the application programmer. no cap.

returns the SoFieldData class which holds info about the fields in this node. 📋

🎀 const SoFieldData * SoPointSet::getFieldData(void) const [protected], [virtual]

returns a pointer to the class-wide field data storage object for this instance. and if there are no fields present? it returns NULL. that's the whole tea. 🍵

  • Reimplemented from SoNonIndexedShape.
  • Reimplemented in SoMarkerSet.

🌸 void SoPointSet::initClass(void) [static]

no description on this one, bestie — the manpage just leaves it standing there looking iconic. that's the whole entry. 💅

🔥 void SoPointSet::GLRender(SoGLRenderAction * action) [virtual]

this is the action method for SoGLRenderAction, and it gets called during rendering traversals. any node that influences the rendering state in any way — or that just wants to hurl geometry primitives at OpenGL — overrides this method. main character behavior fr fr. 🔥

  • Reimplemented from SoShape.
  • Reimplemented in SoMarkerSet.

🌈 void SoPointSet::getBoundingBox(SoGetBoundingBoxAction * action) [virtual]

action method for SoGetBoundingBoxAction, periodt.

it calculates the bounding box and center coordinates for the node, then modifies the values of the action so they encompass the bounding box for this node — and shifts the center point for the scene more towards the one for this node. very "make it about me" of it, and honestly? valid. ✨

nodes that influence how geometry nodes calculate their bounding box also override this method to change the relevant state variables.

  • Reimplemented from SoShape.

🍓 void SoPointSet::getPrimitiveCount(SoGetPrimitiveCountAction * action) [virtual]

action method for SoGetPrimitiveCountAction.

calculates the number of triangle, line segment and point primitives for the node, and adds these to the counters of the action. it's a headcount but for geometry. 🧮

nodes influencing how geometry nodes calculate their primitive count also override this method to change the relevant state variables.

  • Reimplemented from SoShape.
  • Reimplemented in SoMarkerSet.

🧚 void SoPointSet::generatePrimitives(SoAction * action) [protected], [virtual]

this method implements action behavior for shape nodes for SoCallbackAction. it gets invoked from SoShape::callback().

heads up, bestie: subclasses should not override SoNode::callback(). don't do it. 💀

the subclass implementations use the convenience methods SoShape::beginShape(), SoShape::shapeVertex(), and SoShape::endShape(), with SoDetail instances, to pass the primitives making up the shape back to the caller.

  • Implements SoShape.

💜 void SoPointSet::computeBBox(SoAction * action, SbBox3f & box, SbVec3f & center) [protected], [virtual]

this one is implemented by SoShape subclasses to let the SoShape superclass know the exact size and weighted center point of the shape's bounding box.

the bounding box and center point should be calculated and returned in the local coordinate system.

this method implements action behavior for shape nodes for SoGetBoundingBoxAction. it gets invoked from SoShape::getBoundingBox().

again with the warning, and it matters: subclasses should not override SoNode::getBoundingBox().

and here's the fine print: the box parameter sent in is guaranteed to be an empty box, while center is undefined upon function entry. so don't come for it before it's been filled in. 🫶

  • Implements SoShape.

🎀 SbBool SoPointSet::generateDefaultNormals(SoState * state, SoNormalCache * cache) [protected], [virtual]

internal API alert 💅 this API member is considered internal to the library, since it's not likely to be of interest to the application programmer.

subclasses should override this method to generate default normals using the SoNormalCache class. this is more effective than using SoNormalGenerator. return TRUE if normals were generated, FALSE otherwise.

the default method just returns FALSE. lowkey lazy of it but okay. 🙈

📌 this function is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API.
  • Reimplemented from SoVertexShape.

🌸 SbBool SoPointSet::generateDefaultNormals(SoState * state, SoNormalBundle * bundle) [protected], [virtual]

also internal API, bestie 💅 this API member is considered internal to the library, since it's not likely to be of interest to the application programmer.

subclasses should override this method to generate default normals using the SoNormalBundle class. TRUE should be returned if normals were generated, FALSE otherwise.

the default method returns FALSE. (yes, again. the default is not the moment. 😭)

📌 this function is an extension for Coin, and it is not available in the original SGI Open Inventor v2.1 API.
  • Reimplemented from SoVertexShape.

🌟 Member Data Documentation 🌟

💖 SoSFInt32 SoPointSet::numPoints

used to specify the number of points in the point set. the coordinates for those points get taken from the state stack's set of 3D coordinates — typically set up by a leading SoCoordinate3 node. 🎯

if this field is equal to -1 (the default value) all coordinates currently on the state will be rendered or otherwise handled by traversal actions.

also, so you know: SoPointSet inherits the field SoNonIndexedShape::startIndex, which specifies the start index for points from the current state set of coordinates.

⚠️ bestie, please note: that field has been obsoleted, but it's still provided for compatibility. it's a legacy icon, we keep it around out of respect. 👑

🦋 Author 🦋

generated automatically by Doxygen for Coin from the source code. (not a human, just a very thorough robot doing its thing. respect. 🤖✨)

and that's the whole page, bestie!! 🎉 this was Coin manual page for SoPointSet, from version 4.0.10, dated Thu Jun 25 2026 00:00:00, and it lives at SoPointSet(3). slay, you made it to the end. go render some points. 💅🌟

📦 where this page comes from