SoVRMLSphere(3)

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

✨ NAME ✨

SoVRMLSphere — the class that's literally a spherical 3D object, bestie. No cap, she's giving geometry realness. 💖

✨ SYNOPSIS ✨

Okay so first things first, you gotta include her:

#include <Inventor/VRMLnodes/SoVRMLSphere.h>

And she inherits from SoVRMLGeometry. Slay.

💅 Public Member Functions 💅

  • virtual SoType getTypeId (void) const — the type ID getter, she's iconic.
  • SoVRMLSphere (void) — the constructor, welcome to the sphere era.
  • virtual void GLRender (SoGLRenderAction *action) — renders with OpenGL, periodt.
  • virtual void rayPick (SoRayPickAction *action) — does the ray picking thing.
  • virtual void getPrimitiveCount (SoGetPrimitiveCountAction *action) — counts primitives, fr fr.

🦋 Public Member Functions inherited from SoVRMLGeometry 🦋

  • virtual void search (SoSearchAction *action) — search action vibes.
  • virtual void copyContents (const SoFieldContainer *from, SbBool copyConn) — copies contents, bestie.

🌸 Public Member Functions inherited from SoShape 🌸

  • virtual SbBool affectsState (void) const — does it affect state? mystery.
  • virtual void getBoundingBox (SoGetBoundingBoxAction *action) — gets the bounding box, iconic.
  • virtual void callback (SoCallbackAction *action) — callback action, she's here.
  • const SoBoundingBoxCache * getBoundingBoxCache (void) const — returns the bounding box cache, no cap.

👑 Public Member Functions inherited from SoNode 👑

  • void setOverride (const SbBool state) — sets override state.
  • SbBool isOverride (void) const — is it override? maybe.
  • void setNodeType (const NodeType type) — sets the node type.
  • NodeType getNodeType (void) const — gets the node type.
  • virtual SoNode * copy (SbBool copyconnections=FALSE) const — copies the node, default copyconnections=FALSE.
  • virtual void doAction (SoAction *action) — does the action.
  • virtual void GLRenderBelowPath (SoGLRenderAction *action) — GL render below path.
  • virtual void GLRenderInPath (SoGLRenderAction *action) — GL render in path.
  • virtual void GLRenderOffPath (SoGLRenderAction *action) — GL render off path.
  • virtual void getMatrix (SoGetMatrixAction *action) — gets the matrix.
  • virtual void handleEvent (SoHandleEventAction *action) — handles events.
  • virtual void pick (SoPickAction *action) — picks.
  • virtual void write (SoWriteAction *action) — writes.
  • virtual void audioRender (SoAudioRenderAction *action) — audio render.
  • virtual void grabEventsSetup (void) — grab events setup.
  • virtual void grabEventsCleanup (void) — grab events cleanup.
  • virtual void startNotify (void) — start notify.
  • SbUniqueId getNodeId (void) const — gets the node ID.
  • virtual void writeInstance (SoOutput *out) — write instance.
  • virtual SoNode * addToCopyDict (void) const — adds to copy dict.
  • virtual SoFieldContainer * copyThroughConnection (void) const — copy through connection.

💜 Public Member Functions inherited from SoFieldContainer 💜

  • void setToDefaults (void) — sets to defaults.
  • SbBool hasDefaultValues (void) const — has default values?.
  • SbBool fieldsAreEqual (const SoFieldContainer *container) const — checks if fields are equal.
  • void copyFieldValues (const SoFieldContainer *container, SbBool copyconnections=FALSE) — copies field values, default copyconnections=FALSE.
  • SbBool set (const char *const fielddata) — sets from fielddata.
  • void get (SbString &fielddata) — gets fielddata.
  • virtual int getFields (SoFieldList &l) const — gets fields.
  • virtual int getAllFields (SoFieldList &l) const — gets all fields.
  • virtual SoField * getField (const SbName &name) const — gets a field by name.
  • virtual SoField * getEventIn (const SbName &name) const — gets an event in.
  • virtual SoField * getEventOut (const SbName &name) const — gets an event out.
  • SbBool getFieldName (const SoField *const field, SbName &name) const — gets field name.
  • SbBool enableNotify (const SbBool flag) — enables notify.
  • SbBool isNotifyEnabled (void) const — is notify enabled?.
  • SbBool set (const char *fielddata, SoInput *input) — sets with input.
  • void get (SbString &fielddata, SoOutput *out) — gets with output.
  • virtual SbBool validateNewFieldValue (SoField *field, void *newval) — validates new field value.
  • virtual void addWriteReference (SoOutput *out, SbBool isfromfield=FALSE) — adds write reference, default isfromfield=FALSE.
  • SbBool getIsBuiltIn (void) const — gets is built in.
  • virtual void getFieldsMemorySize (size_t &managed, size_t &unmanaged) const — gets fields memory size.
  • void setUserData (void *userdata) const — sets user data.
  • void * getUserData (void) const — gets user data.

🌈 Public Member Functions inherited from SoBase 🌈

  • void ref (void) const — refs the object.
  • void unref (void) const — unrefs.
  • void unrefNoDelete (void) const — unrefs without deleting.
  • int32_t getRefCount (void) const — gets ref count.
  • void touch (void) — touch it.
  • SbBool isOfType (SoType type) const — Returns TRUE if the type of this object is either of the same type or inherited from type. iykyk.
  • virtual SbName getName (void) const — gets the name.
  • virtual void setName (const SbName &newname) — sets the name.
  • void addAuditor (void *const auditor, const SoNotRec::Type type) — adds an auditor.
  • void removeAuditor (void *const auditor, const SoNotRec::Type type) — removes an auditor.
  • const SoAuditorList & getAuditors (void) const — gets the auditors.
  • SbBool shouldWrite (void) — should write?.
  • void assertAlive (void) const — asserts alive.

✨ Static Public Member Functions ✨

  • static SoType getClassTypeId (void) — gets the class type ID.
  • static void initClass (void) — initializes the class.

🫶 Static Public Member Functions inherited from SoVRMLGeometry 🫶

  • static SoType getClassTypeId (void) — gets the class type ID.
  • static void initClass (void) — initializes the class.

🎀 Static Public Member Functions inherited from SoShape 🎀

  • static SoType getClassTypeId (void) — gets the class type ID.
  • static void initClass (void) — Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system. slay.
  • static void getScreenSize (SoState *const state, const SbBox3f &boundingbox, SbVec2s &rectsize) — gets the screen size.
  • static float getDecimatedComplexity (SoState *state, float complexity) — gets decimated complexity.

⭐ Static Public Member Functions inherited from SoNode ⭐

  • static uint32_t getCompatibilityTypes (const SoType &nodetype) — gets compatibility types.
  • static SoType getClassTypeId (void) — gets the class type ID.
  • static SoNode * getByName (const SbName &name) — gets a node by name.
  • static int getByName (const SbName &name, SoNodeList &l) — gets nodes by name into a list.
  • static void initClass (void) — Sets up initialization for data common to all instances of this class, like submitting necessary information to the Coin type system. periodt.
  • static void initClasses (void) — initializes classes.
  • static SbUniqueId getNextNodeId (void) — gets the next node ID.
  • static int getActionMethodIndex (const SoType type) — gets the action method index.
  • static void getBoundingBoxS (SoAction *action, SoNode *node) — static bounding box.
  • static void GLRenderS (SoAction *action, SoNode *node) — static GL render.
  • static void callbackS (SoAction *action, SoNode *node) — static callback.
  • static void getMatrixS (SoAction *action, SoNode *node) — static get matrix.
  • static void handleEventS (SoAction *action, SoNode *node) — static handle event.
  • static void pickS (SoAction *action, SoNode *node) — static pick.
  • static void rayPickS (SoAction *action, SoNode *node) — static ray pick.
  • static void searchS (SoAction *action, SoNode *node) — static search.
  • static void writeS (SoAction *action, SoNode *node) — static write.
  • static void audioRenderS (SoAction *action, SoNode *node) — static audio render.
  • static void getPrimitiveCountS (SoAction *action, SoNode *node) — static get primitive 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 information to the Coin type system. iconic.
  • static SoType getClassTypeId (void) — This static method returns the SoType object associated with objects of this class. no cap.
  • static void cleanupClass (void) — cleans up the class.
  • static void initCopyDict (void) — initializes copy dict.
  • static void addCopy (const SoFieldContainer *orig, const SoFieldContainer *copy) — adds a copy.
  • static SoFieldContainer * checkCopy (const SoFieldContainer *orig) — checks a copy.
  • static SoFieldContainer * findCopy (const SoFieldContainer *orig, const SbBool copyconnections) — finds a copy.
  • static void copyDone (void) — copy done.

🌈 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 information to the Coin type system. 💅.
  • static SoType getClassTypeId (void) — This static method returns the SoType object associated with objects of this class. fr fr.
  • static void addName (SoBase *const base, const char *const name) — adds a name.
  • static void removeName (SoBase *const base, const char *const name) — removes a name.
  • static void incrementCurrentWriteCounter (void) — increments current write counter.
  • static void decrementCurrentWriteCounter (void) — decrements current write counter.
  • static SoBase * getNamedBase (const SbName &name, SoType type) — gets a named base.
  • static int getNamedBases (const SbName &name, SoBaseList &baselist, SoType type) — gets named bases.
  • static SbBool read (SoInput *input, SoBase *&base, SoType expectedtype) — reads.
  • static void setInstancePrefix (const SbString &c) — sets instance prefix.
  • static void setTraceRefs (SbBool trace) — sets trace refs.
  • static SbBool getTraceRefs (void) — gets trace refs.
  • static SbBool connectRoute (SoInput *input, const SbName &fromnodename, const SbName &fromfieldname, const SbName &tonodename, const SbName &tofieldname) — connects a route.
  • static SbBool readRoute (SoInput *input) — reads a route.

🍓 Public Attributes 🍓

  • SoSFFloat radius — the radius, bestie. she's a float, single precision.

🧚 Protected Member Functions 🧚

  • virtual const SoFieldData * getFieldData (void) const — gets the field data.
  • virtual ~SoVRMLSphere () — the destructor, bye bestie.
  • virtual void generatePrimitives (SoAction *action) — generates primitives.
  • virtual void computeBBox (SoAction *action, SbBox3f &box, SbVec3f &center) — computes the bounding box.

💜 Protected Member Functions inherited from SoVRMLGeometry 💜

  • SoVRMLGeometry (void) — constructor.
  • virtual ~SoVRMLGeometry () — destructor.
  • void setupShapeHints (SoState *state, const SbBool ccw, const SbBool solid) — sets up shape hints.
  • virtual SbBool shouldGLRender (SoGLRenderAction *action) — should GL render?.
  • virtual SoChildList * getChildren (void) const — gets children.
  • virtual void notify (SoNotList *list) — notify.

🌸 Protected Member Functions inherited from SoShape 🌸

  • SoShape (void) — constructor.
  • virtual ~SoShape () — destructor.
  • float getComplexityValue (SoAction *action) — gets complexity value.
  • void beginSolidShape (SoGLRenderAction *action) — begins solid shape.
  • void endSolidShape (SoGLRenderAction *action) — ends solid shape.
  • void GLRenderBoundingBox (SoGLRenderAction *action) — GL renders bounding box.
  • SbBool shouldPrimitiveCount (SoGetPrimitiveCountAction *action) — should primitive count?.
  • SbBool shouldRayPick (SoRayPickAction *const action) — should ray pick?.
  • void computeObjectSpaceRay (SoRayPickAction *const action) — computes object space ray.
  • void computeObjectSpaceRay (SoRayPickAction *const action, const SbMatrix &matrix) — computes object space ray with matrix.
  • virtual SoDetail * createTriangleDetail (SoRayPickAction *action, const SoPrimitiveVertex *v1, const SoPrimitiveVertex *v2, const SoPrimitiveVertex *v3, SoPickedPoint *pp) — creates triangle detail.
  • virtual SoDetail * createLineSegmentDetail (SoRayPickAction *action, const SoPrimitiveVertex *v1, const SoPrimitiveVertex *v2, SoPickedPoint *pp) — creates line segment detail.
  • virtual SoDetail * createPointDetail (SoRayPickAction *action, const SoPrimitiveVertex *v, SoPickedPoint *pp) — creates point detail.
  • void invokeTriangleCallbacks (SoAction *const action, const SoPrimitiveVertex *const v1, const SoPrimitiveVertex *const v2, const SoPrimitiveVertex *const v3) — invokes triangle callbacks.
  • void invokeLineSegmentCallbacks (SoAction *const action, const SoPrimitiveVertex *const v1, const SoPrimitiveVertex *const v2) — invokes line segment callbacks.
  • void invokePointCallbacks (SoAction *const action, const SoPrimitiveVertex *const v) — invokes point callbacks.
  • void beginShape (SoAction *const action, const TriangleShape shapetype, SoDetail *const detail=NULL) — begins shape, default detail=NULL.
  • void shapeVertex (const SoPrimitiveVertex *const v) — shape vertex.
  • void endShape (void) — ends 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) — generates vertex.
  • 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) — generates vertex with r.
  • SbBool startVertexArray (SoGLRenderAction *action, const SoCoordinateElement *coords, const SbVec3f *pervertexnormals, const SbBool texpervertex, const SbBool colorpervertex) — starts vertex array.
  • void finishVertexArray (SoGLRenderAction *action, const SbBool vbo, const SbBool normpervertex, const SbBool texpervertex, const SbBool colorpervertex) — finishes vertex array.

💅 Protected Member Functions 💅

okay so these are the protected member functions you inherit, bestie. they're giving legacy energy but we love them. no cap.

🫶 Protected Member Functions inherited from SoNode 🫶

  • SoNode (void) — constructor vibes.
  • virtual ~SoNode () — destructor, slay.
  • virtual SbBool readInstance (SoInput *in, unsigned short flags) — reads an instance, periodt.

🫶 Protected Member Functions inherited from SoFieldContainer 🫶

  • SoFieldContainer (void) — constructor, fr fr.
  • virtual ~SoFieldContainer () — destructor, no cap.

🫶 Protected Member Functions inherited from SoBase 🫶

  • SoBase (void) — constructor.
  • virtual ~SoBase () — destructor.
  • virtual void destroy (void) — destroys, literally.
  • SbBool hasMultipleWriteRefs (void) const — checks multiple write refs, iykyk.
  • SbBool writeHeader (SoOutput *out, SbBool isgroup, SbBool isengine) const — writes the header.
  • void writeFooter (SoOutput *out) const — writes the footer.
  • virtual const char * getFileFormatName (void) const — gets the file format name.
  • virtual SoNotRec createNotRec (void) — creates a not rec.

🌸 Static Protected Member Functions 🌸

these are static, meaning they belong to the class itself, not an instance. main character energy.

  • static const SoFieldData ** getFieldDataPtr (void) — returns a pointer to the field data pointer. lowkey internal.

🦋 Static Protected Member Functions inherited from SoVRMLGeometry 🦋

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

🦋 Static Protected Member Functions inherited from SoShape 🦋

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

🦋 Static Protected Member Functions inherited from SoNode 🦋

  • static const SoFieldData ** getFieldDataPtr (void) — inherited.
  • 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 the next action method index.
  • static void setCompatibilityTypes (const SoType &nodetype, const uint32_t bitmask) — sets compatibility types.

🦋 Static Protected Member Functions inherited from SoBase 🦋

  • static uint32_t getCurrentWriteCounter (void) — gets the current write counter.
  • static void staticDataLock (void) — locks static data.
  • static void staticDataUnlock (void) — unlocks static data.

💜 Additional Inherited Members 💜

more inherited stuff, bestie. it's giving legacy code but we love her.

🌈 Public Types inherited from SoShape 🌈

  • enum TriangleShape { TRIANGLE_STRIP, TRIANGLE_FAN, TRIANGLES, POLYGON, QUADS, QUAD_STRIP, POINTS, LINES, LINE_STRIP } — all the triangle shapes, slay.

🌈 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 } — all the node types, iconic.

🌈 Protected Types inherited from SoBase 🌈

  • enum BaseFlags { IS_ENGINE = 0x01, IS_GROUP = 0x02 } — base flags, periodt.

🌈 Protected Attributes inherited from SoNode 🌈

  • SbUniqueId uniqueId — a unique ID, no cap.

🌈 Protected Attributes inherited from SoFieldContainer 🌈

  • SbBool isBuiltIn — is it built in? yes.

🌈 Static Protected Attributes inherited from SoNode 🌈

  • static SbUniqueId nextUniqueId = 1 — the next unique ID, starts at 1.
  • static int nextActionMethodIndex = 0 — the next action method index, starts at 0.

🎀 Detailed Description 🎀

okay so the tea: SoVRMLSphere is used to represent a spherical 3D object. literally a ball. slay.

The detailed class documentation is taken verbatim from the VRML97 standard (ISO/IEC 14772-1:1997). It is copyright The Web3D Consortium, and is used by permission of the Consortium:

Sphere {
  field SFFloat radius  1    # (0, inf)
}

The Sphere node specifies a sphere centred at (0, 0, 0) in the local coordinate system. The radius field specifies the radius of the sphere and shall be greater than zero. Figure 6.15 depicts the fields of the Sphere node.

Figure 6.15 -- Sphere node

When a texture is applied to a sphere, the texture covers the entire surface, wrapping counterclockwise from the back of the sphere (i.e., longitudinal arc intersecting the -Z-axis) when viewed from the top of the sphere. The texture has a seam at the back where the X=0 plane intersects the sphere and Z values are negative. TextureTransform affects the texture coordinates of the Sphere. The Sphere node's geometry requires outside faces only. When viewed from the inside the results are undefined.

⚠️ when viewed from the inside, the results are undefined — so don't do that, bestie.

💅 Constructor & Destructor Documentation 💅

✨ SoVRMLSphere::SoVRMLSphere (void ) ✨

Constructor. it makes the sphere.

✨ SoVRMLSphere::~SoVRMLSphere () [protected], [virtual] ✨

Destructor. it destroys the sphere.

🔥 Member Function Documentation 🔥

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

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

⭐ SoType SoVRMLSphere::getTypeId (void ) const [virtual] ⭐

Returns the type identification of an object derived from a class inheriting SoBase. This is used for runtime type checking and "downward" casting.

Reimplemented from SoVRMLGeometry.

⭐ const SoFieldData ** SoVRMLSphere::getFieldDataPtr (void ) [static], [protected] ⭐

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

Returns the SoFieldData class which holds information about fields in this node.

⭐ const SoFieldData * SoVRMLSphere::getFieldData (void ) const [protected], [virtual] ⭐

Returns a pointer to the class-wide field data storage object for this instance. If no fields are present, returns NULL.

Reimplemented from SoVRMLGeometry.

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

Initializes the class, bestie.

⭐ void SoVRMLSphere::GLRender (SoGLRenderAction * action) [virtual] ⭐

Action method for the SoGLRenderAction.

This is called during rendering traversals. Nodes influencing the rendering state in any way or want to throw geometry primitives at OpenGL override this method.

Reimplemented from SoShape.

⭐ void SoVRMLSphere::rayPick (SoRayPickAction * action) [virtual] ⭐

Calculates picked point based on primitives generated by subclasses.

Reimplemented from SoShape.

⭐ void SoVRMLSphere::getPrimitiveCount (SoGetPrimitiveCountAction * action) [virtual] ⭐

Action method for the SoGetPrimitiveCountAction.

Calculates the number of triangle, line segment and point primitives for the node and adds these to the counters of the action.

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

Reimplemented from SoShape.

⭐ void SoVRMLSphere::generatePrimitives (SoAction * action) [protected], [virtual] ⭐

The method implements action behavior for shape nodes for SoCallbackAction. It is invoked from SoShape::callback(). (Subclasses should not override SoNode::callback().)

The subclass implementations uses 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 SoVRMLSphere::computeBBox (SoAction * action, SbBox3f & box, SbVec3f & center) [protected], [virtual] ⭐

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.

The method implements action behavior for shape nodes for SoGetBoundingBoxAction. It is invoked from SoShape::getBoundingBox(). (Subclasses should not override SoNode::getBoundingBox().)

The box parameter sent in is guaranteed to be an empty box, while center is undefined upon function entry.

Implements SoShape.

💖 Member Data Documentation 💖

🍓 SoSFFloat SoVRMLSphere::radius 🍓

Sphere radius. Default value is 1.0.

👑 Author 👑

Generated automatically by Doxygen for Coin from the source code.

that's the whole vibe, bestie. this page is from Coin version 4.0.10, dated Thu Jun 25 2026 00:00:00, for SoVRMLSphere(3). slay and stay iconic. 💅✨

📦 where this page comes from