SoCenterballManip(3)

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

🎀 NAME 🎀

SoCenterballManip — okay so bestie, this is the whole vibe in one line: the SoCenterballManip wraps an SoCenterballDragger for convenience. That's it. That's the girl. Convenience is her entire personality 💅

✨ SYNOPSIS ✨


#include <Inventor/manips/SoCenterballManip.h>

Inherits SoTransformManip.

💖 Public Member Functions 💖

  • virtual SoType getTypeId (void) const — the type-id hook, standard Coin situation, she has one like every class does ✨
  • SoCenterballManip (void) — the constructor, default-style, no args, just vibes 🎀

🦋 Public Member Functions inherited from SoTransformManip 🦋

  • SoTransformManip (void) — constructor, handed down from above 🫶
  • SoDragger * getDragger (void) — grabs the dragger 🎯
  • SbBool replaceNode (SoPath *p) — swap-a-node situation, returns an SbBool 💫
  • SbBool replaceManip (SoPath *p, SoTransform *newone) const — swaps the manip out for a SoTransform *newone, const-flavoured 🌸
  • virtual void doAction (SoAction *action) — the do-action entry point 🔥
  • virtual void callback (SoCallbackAction *action) — callback action handling, very demure 💅
  • virtual void GLRender (SoGLRenderAction *action) — the GL render pass, main character energy 👑
  • virtual void getBoundingBox (SoGetBoundingBoxAction *action) — bounding box time 📦
  • virtual void getMatrix (SoGetMatrixAction *action) — matrix, get it ✨
  • virtual void handleEvent (SoHandleEventAction *action) — events get handled here 🎪
  • virtual void pick (SoPickAction *action) — picking, as one does 🎯
  • virtual void search (SoSearchAction *action) — the search action 🌈
  • virtual SoChildList * getChildren (void) const — hands you the child list ⭐

🧚 Public Member Functions inherited from SoTransform 🧚

  • SoTransform (void) — constructor, inherited 🫶
  • void pointAt (const SbVec3f &frompoint, const SbVec3f &topoint) — points at stuff, from frompoint to topoint 🎀
  • void getScaleSpaceMatrix (SbMatrix &mat, SbMatrix &inv) const — scale-space matrix + its inverse, both handed back by reference 💜
  • void getRotationSpaceMatrix (SbMatrix &mat, SbMatrix &inv) const — rotation-space matrix and inverse, same deal 🌀
  • void getTranslationSpaceMatrix (SbMatrix &mat, SbMatrix &inv) const — translation-space matrix and inverse 🌸
  • void multLeft (const SbMatrix &mat) — multiply on the left ✖️
  • void multRight (const SbMatrix &mat) — multiply on the right ➡️
  • void combineLeft (SoTransformation *nodeonright) — combines left, with the node on the right, yes the naming is Like That 💀
  • void combineRight (SoTransformation *nodeonleft) — combines right, node on the left, we don't make the rules 🙈
  • void setMatrix (const SbMatrix &mat) — sets the matrix, iconic behavior 💅
  • void recenter (const SbVec3f &newcenter) — recenters to newcenter 🎯
  • virtual void getPrimitiveCount (SoGetPrimitiveCountAction *action) — counts primitives 🔢

💜 Public Member Functions inherited from SoNode 💜

  • void setOverride (const SbBool state) — sets override to state 🎛️
  • SbBool isOverride (void) const — are we overriding? returns a bool 🫶
  • void setNodeType (const NodeType type) — sets the node type ✨
  • NodeType getNodeType (void) const — gets the node type back 🌸
  • virtual SoNode * copy (SbBool copyconnections=FALSE) const — copies the node, copyconnections defaults to FALSE 📋
  • virtual SbBool affectsState (void) const — does it affect state? bool says yes or no 🤔
  • virtual void GLRenderBelowPath (SoGLRenderAction *action) — GL render below the path 🛤️
  • virtual void GLRenderInPath (SoGLRenderAction *action) — GL render in the path 🛤️
  • virtual void GLRenderOffPath (SoGLRenderAction *action) — GL render off the path 🛤️
  • virtual void rayPick (SoRayPickAction *action) — ray pick, the spicy pick 🔦
  • virtual void write (SoWriteAction *action) — writes it out ✍️
  • virtual void audioRender (SoAudioRenderAction *action) — audio render, sound check 🔊
  • virtual void grabEventsSetup (void) — event-grabbing setup 🎪
  • virtual void grabEventsCleanup (void) — event-grabbing cleanup 🧹
  • virtual void startNotify (void) — kicks off notify 📣
  • virtual void notify (SoNotList *l) — notifies with the list l 📣
  • SbUniqueId getNodeId (void) const — returns the unique node id 🆔
  • virtual void writeInstance (SoOutput *out) — writes the instance out to out ✍️
  • virtual SoNode * addToCopyDict (void) const — adds itself to the copy dictionary 📚
  • virtual SoFieldContainer * copyThroughConnection (void) const — copies through the connection 🔗

🌈 Public Member Functions inherited from SoFieldContainer 🌈

  • void setToDefaults (void) — resets everything to defaults 🧼
  • SbBool hasDefaultValues (void) const — checks if it's all still default values ✅
  • SbBool fieldsAreEqual (const SoFieldContainer *container) const — compares fields against container ⚖️
  • void copyFieldValues (const SoFieldContainer *container, SbBool copyconnections=FALSE) — copies field values from container, copyconnections defaults to FALSE 📋
  • SbBool set (const char *const fielddata) — sets from a char * blob of field data 🎛️
  • void get (SbString &fielddata) — gets the field data out into an SbString 📤
  • virtual int getFields (SoFieldList &l) const — fills l with fields, returns an int 🔢
  • virtual int getAllFields (SoFieldList &l) const — all of them, into l, returns an int 🔢
  • virtual SoField * getField (const SbName &name) const — grabs the field by name 🔍
  • virtual SoField * getEventIn (const SbName &name) const — grabs the event-in by name 📥
  • virtual SoField * getEventOut (const SbName &name) const — grabs the event-out by name 📤
  • SbBool getFieldName (const SoField *const field, SbName &name) const — finds the name for a given field 🏷️
  • SbBool enableNotify (const SbBool flag) — turns notify on or off with flag 🔔
  • SbBool isNotifyEnabled (void) const — is notify on? bool time 🔔
  • SbBool set (const char *fielddata, SoInput *input) — sets from fielddata using input 📥
  • void get (SbString &fielddata, SoOutput *out) — gets field data out via out 📤
  • virtual SbBool validateNewFieldValue (SoField *field, void *newval) — validates a new value for field ✅
  • virtual void addWriteReference (SoOutput *out, SbBool isfromfield=FALSE) — adds a write reference, isfromfield defaults to FALSE ✍️
  • SbBool getIsBuiltIn (void) const — built-in or not, returns a bool 🏗️
  • virtual void getFieldsMemorySize (size_t &managed, size_t &unmanaged) const — hands back memory sizes for managed and unmanaged, both size_t by reference 🧮
  • void setUserData (void *userdata) const — stashes your userdata pointer, and yes it's const 💾
  • void * getUserData (void) const — gives that pointer back 🎁

🍓 Public Member Functions inherited from SoBase 🍓

  • void ref (void) const — refs it up ⬆️
  • void unref (void) const — unrefs it ⬇️
  • void unrefNoDelete (void) const — unrefs without deleting, sneaky but legal 🙈
  • int32_t getRefCount (void) const — returns the ref count as an int32_t 🔢
  • void touch (void) — touches it 👆
  • SbBool isOfType (SoType type) const — Returns TRUE if the type of this object is either of the same type or inherited from type. ✨
  • virtual SbName getName (void) const — returns the name as an SbName 🏷️
  • virtual void setName (const SbName &newname) — renames it to newname 🏷️
  • void addAuditor (void *const auditor, const SoNotRec::Type type) — adds an auditor of the given type 👀
  • void removeAuditor (void *const auditor, const SoNotRec::Type type) — removes that auditor 👋
  • const SoAuditorList & getAuditors (void) const — hands back the auditor list, by reference, const 📋
  • SbBool shouldWrite (void) — should it write? bool 🙋
  • void assertAlive (void) const — asserts that it's alive, drama queen 💀

⭐ Static Public Member Functions ⭐

  • static SoType getClassTypeId (void) — the class type id, statically ⭐
  • 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 Public Member Functions inherited from SoTransformManip 🫶

  • static SoType getClassTypeId (void) — class type id, inherited flavour ⭐
  • 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 Public Member Functions inherited from SoTransform 🫶

  • static SoType getClassTypeId (void) — class type id again, still iconic ⭐
  • 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 Public Member Functions inherited from SoTransformation 🫶

  • static SoType getClassTypeId (void) — class type id, the family tradition ⭐
  • 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 Public Member Functions inherited from SoNode 💫

  • static uint32_t getCompatibilityTypes (const SoType &nodetype) — compatibility types for nodetype, returns a uint32_t 🧬
  • static SoType getClassTypeId (void) — class type id 🆔
  • static SoNode * getByName (const SbName &name) — finds a node by name 🔍
  • static int getByName (const SbName &name, SoNodeList &l) — finds by name, stuffs them into l, returns an int 🔍
  • 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 void initClasses (void) — plural! inits the classes 🎊
  • static SbUniqueId getNextNodeId (void) — hands you the next unique node id 🆔
  • static int getActionMethodIndex (const SoType type) — the action method index for type 🔢
  • static void getBoundingBoxS (SoAction *action, SoNode *node) — the static bounding-box call 📦
  • static void GLRenderS (SoAction *action, SoNode *node) — the static GL render call 🎨
  • static void callbackS (SoAction *action, SoNode *node) — the static callback call 📞
  • static void getMatrixS (SoAction *action, SoNode *node) — the static get-matrix call 🧮
  • static void handleEventS (SoAction *action, SoNode *node) — the static handle-event call 🎪
  • static void pickS (SoAction *action, SoNode *node) — the static pick call 🎯
  • static void rayPickS (SoAction *action, SoNode *node) — the static ray pick call 🔦
  • static void searchS (SoAction *action, SoNode *node) — the static search call 🔎
  • static void writeS (SoAction *action, SoNode *node) — the static write call ✍️
  • static void audioRenderS (SoAction *action, SoNode *node) — the static audio render call 🔊
  • static void getPrimitiveCountS (SoAction *action, SoNode *node) — the static primitive count call 🔢

💾 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. 🎀
  • static SoType getClassTypeId (void) — This static method returns the SoType object associated with objects of this class. ⭐
  • static void cleanupClass (void) — cleans the class up 🧹
  • static void initCopyDict (void) — sets up the copy dictionary 📚
  • static void addCopy (const SoFieldContainer *orig, const SoFieldContainer *copy) — registers copy as the copy of orig 📋
  • static SoFieldContainer * checkCopy (const SoFieldContainer *orig) — checks the copy for orig ✅
  • static SoFieldContainer * findCopy (const SoFieldContainer *orig, const SbBool copyconnections) — finds the copy of orig, taking copyconnections into account 🔍
  • static void copyDone (void) — copying's done, wrap it up 🎬

🧬 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. ⭐
  • static void addName (SoBase *const base, const char *const name) — gives base the name name 🏷️
  • static void removeName (SoBase *const base, const char *const name) — takes that name away 👋
  • static void incrementCurrentWriteCounter (void) — bumps the current write counter up ⬆️
  • static void decrementCurrentWriteCounter (void) — bumps it back down ⬇️
  • static SoBase * getNamedBase (const SbName &name, SoType type) — gets the named base matching name and type 🔍
  • static int getNamedBases (const SbName &name, SoBaseList &baselist, SoType type) — gets the named bases into baselist, returns an int 🔍
  • static SbBool read (SoInput *input, SoBase *&base, SoType expectedtype) — reads from input, base comes back by reference, expectedtype checked 📥
  • static void setInstancePrefix (const SbString &c) — sets the instance prefix to c 🏷️
  • static void setTraceRefs (SbBool trace) — turns ref tracing on or off 🕵️
  • static SbBool getTraceRefs (void) — is ref tracing on? bool 🕵️
  • static SbBool connectRoute (SoInput *input, const SbName &fromnodename, const SbName &fromfieldname, const SbName &tonodename, const SbName &tofieldname) — connects a route from fromnodename/fromfieldname to tonodename/tofieldname via input 🔗
  • static SbBool readRoute (SoInput *input) — reads a route from input 📥

🔒 Protected Member Functions 🔒

  • virtual const SoFieldData * getFieldData (void) const — returns the field data, protected business 🤫
  • virtual ~SoCenterballManip (void) — the destructor, virtual, say goodbye politely 👋
  • virtual void setDragger (SoDragger *newDragger) — sets the dragger to newDragger (capital D, yes, note it 💀)

🤫 Protected Member Functions inherited from SoTransformManip 🤫

  • virtual ~SoTransformManip (void) — destructor 👋
  • void setDragger (SoDragger *newdragger) — sets the dragger to newdragger (lowercase d this time, the inconsistency is canon 🙈)
  • virtual void copyContents (const SoFieldContainer *fromfc, SbBool copyconnections) — copies contents over from fromfc 📋
  • void attachSensors (const SbBool onoff) — attaches sensors, on or off 🎛️

🤫 Protected Member Functions inherited from SoTransform 🤫

  • virtual ~SoTransform () — destructor, note the empty parens, that's how she's written 👋

🤫 Protected Member Functions inherited from SoTransformation 🤫

  • SoTransformation (void) — constructor 🫶
  • virtual ~SoTransformation () — destructor 👋

🤫 Protected Member Functions inherited from SoNode 🤫

  • SoNode (void) — constructor 🫶
  • virtual ~SoNode () — destructor 👋
  • virtual SbBool readInstance (SoInput *in, unsigned short flags) — reads an instance from in with flags, returns a bool 📥

🤫 Protected Member Functions inherited from SoFieldContainer 🤫

  • SoFieldContainer (void) — constructor 🫶
  • virtual ~SoFieldContainer () — destructor 👋

🤫 Protected Member Functions inherited from SoBase 🤫

  • SoBase (void) — constructor 🫶
  • virtual ~SoBase () — destructor 👋
  • virtual void destroy (void) — destroys 💥
  • SbBool hasMultipleWriteRefs (void) const — multiple write refs? bool 🔢
  • SbBool writeHeader (SoOutput *out, SbBool isgroup, SbBool isengine) const — writes the header out, with isgroup and isengine flags ✍️
  • void writeFooter (SoOutput *out) const — writes the footer ✍️
  • virtual const char * getFileFormatName (void) const — the file format name, as a const char * 📄
  • virtual SoNotRec createNotRec (void) — creates a notification record 📝

🎀 Static Protected Member Functions 🎀

  • static const SoFieldData ** getFieldDataPtr (void) — the field data pointer, statically and protectively 🗂️
  • static void fieldSensorCB (void *f, SoSensor *s) — the field sensor callback 📞
  • static void valueChangedCB (void *f, SoDragger *d) — the value-changed callback 📞

🎀 Static Protected Member Functions inherited from SoTransformManip 🎀

  • static const SoFieldData ** getFieldDataPtr (void) — field data pointer 🗂️
  • static void transferFieldValues (const SoTransform *from, SoTransform *to) — moves field values from from into to 🚚
  • static void valueChangedCB (void *f, SoDragger *d) — value-changed callback 📞
  • static void fieldSensorCB (void *f, SoSensor *d) — field sensor callback, note it takes a SoSensor *d here, not s — yes, really 💀

🎀 Static Protected Member Functions inherited from SoTransform 🎀

  • static const SoFieldData ** getFieldDataPtr (void) — field data pointer 🗂️

🎀 Static Protected Member Functions inherited from SoTransformation 🎀

  • static const SoFieldData ** getFieldDataPtr (void) — field data pointer, and that's where this half of the page runs out, bestie 💖

✨ Static Protected Member Functions inherited from SoNode ✨

okay so bestie, SoNode left these protected static member functions in the will, and SoCenterballManip is inheriting them like the queen she is 👑. No cap, they're all here:

  • static const SoFieldData ** getFieldDataPtr (void) — returns a pointer to the field data pointer, iykyk. It's giving internal library energy.
  • static void setNextActionMethodIndex (int index) — sets the next action method index to index. Lowkey bookkeeping vibes.
  • static int getNextActionMethodIndex (void) — returns the next action method index. Periodt.
  • static void incNextActionMethodIndex (void) — increments the next action method index. Slay.
  • static void setCompatibilityTypes (const SoType &nodetype, const uint32_t bitmask) — sets compatibility types for nodetype with bitmask. Fr fr.

✨ Static Protected Member Functions inherited from SoBase ✨

and SoBase said "here, take these too, bestie" 💖:

  • static uint32_t getCurrentWriteCounter (void) — returns the current write counter. 💅
  • static void staticDataLock (void) — locks the static data. 🔒
  • static void staticDataUnlock (void) — unlocks the static data. 🔓

🌈 Additional Inherited Members 🌈

these are the extra goodies that come with the inheritance package, and honestly? We're obsessed. 🎀

💖 Public Types inherited from SoNode 💖

the NodeType enum is giving "I have so many moods" energy, and we respect it. ✨

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 }

🦋 Public Attributes inherited from SoTransform 🦋

these are the public attributes that SoTransform is passing down, and they're all slay:

  • SoSFVec3f translation
  • SoSFRotation rotation
  • SoSFVec3f scaleFactor
  • SoSFRotation scaleOrientation
  • SoSFVec3f center

🎀 Protected Types inherited from SoBase 🎀

SoBase said "here's a little secret" with BaseFlags:

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

🌸 Protected Attributes inherited from SoTransformManip 🌸

these are the protected attributes, lowkey the backstage pass of the class:

  • SoFieldSensor * rotateFieldSensor
  • SoFieldSensor * translFieldSensor
  • SoFieldSensor * scaleFieldSensor
  • SoFieldSensor * centerFieldSensor
  • SoFieldSensor * scaleOrientFieldSensor
  • SoChildList * children

💜 Protected Attributes inherited from SoNode 💜

  • SbUniqueId uniqueId

🍓 Protected Attributes inherited from SoFieldContainer 🍓

  • SbBool isBuiltIn

⭐ Static Protected Attributes inherited from SoNode ⭐

  • static SbUniqueId nextUniqueId = 1
  • static int nextActionMethodIndex = 0

✨ Detailed Description ✨

okay so the SoCenterballManip wraps an SoCenterballDragger for convenience. It's giving "I got you, bestie" energy 🫶.

The manipulator class takes care of wrapping up the SoCenterballDragger in a simple and convenient API for the application programmer, making it automatically surround the geometry it influences and taking care of the book-keeping routines for its interaction with the relevant fields of an SoTransformation node. Periodt. 💅

✨ Constructor & Destructor Documentation ✨

💖 SoCenterballManip::SoCenterballManip (void ) 💖

Default constructor. Allocates an SoCenterballDragger and an SoSurroundScale node to surround the geometry within our part of the scene graph. Slay.

😭 SoCenterballManip::~SoCenterballManip (void ) [protected], [virtual] 😭

Destructor. It's giving goodbye vibes. 💀

✨ Member Function Documentation ✨

👑 SoType SoCenterballManip::getClassTypeId (void ) [static] 👑

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

🦋 SoType SoCenterballManip::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 SoTransformManip.

🎀 const SoFieldData ** SoCenterballManip::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 * SoCenterballManip::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 SoTransformManip.

✨ Author ✨

Generated automatically by Doxygen for Coin from the source code. 🤖

And that's a wrap, bestie! This page is from Version 4.0.10, dated Thu Jun 25 2026 00:00:00, and it's the SoCenterballManip(3) manual page. Stay iconic, and don't forget to wrap your draggers in style 💅✨.

📦 where this page comes from