SoCenterballDragger(3)

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

💖 SoCenterballDragger 💖

okay bestie, gather round, because we are reading the Coin manual page for SoCenterballDragger, section 3 of the manual (SoCenterballDragger(3)). It's a big one, so it comes in 4 parts, and this is part 1. No signing off, we're just getting started. 🫶

✨ NAME ✨

SoCenterballDragger — the SoCenterballDragger class is a dragger you can rotate and translate. spin it, slide it, it's giving main character energy 🌀💅

🦋 SYNOPSIS 🦋

#include <Inventor/draggers/SoCenterballDragger.h>

Inherits SoDragger.

🎀 Public Member Functions 🎀

  • virtual SoType getTypeId (void) const
  • virtual const SoNodekitCatalog * getNodekitCatalog (void) const
  • SoCenterballDragger (void)
  • virtual void saveStartParameters (void)

🌸 Public Member Functions inherited from SoDragger 🌸

these ones you get for free, signature-for-signature, no cap 👇

  • virtual void callback (SoCallbackAction *action)
  • virtual void GLRender (SoGLRenderAction *action)
  • virtual void rayPick (SoRayPickAction *action)
  • virtual void search (SoSearchAction *action)
  • virtual void write (SoWriteAction *action)
  • virtual void getPrimitiveCount (SoGetPrimitiveCountAction *action)
  • void setProjectorEpsilon (const float epsilon)
  • float getProjectorEpsilon (void) const
  • void addStartCallback (SoDraggerCB *func, void *data=NULL)
  • void removeStartCallback (SoDraggerCB *func, void *data=NULL)
  • void addMotionCallback (SoDraggerCB *func, void *data=NULL)
  • void removeMotionCallback (SoDraggerCB *func, void *data=NULL)
  • void addFinishCallback (SoDraggerCB *func, void *data=NULL)
  • void removeFinishCallback (SoDraggerCB *func, void *data=NULL)
  • void addValueChangedCallback (SoDraggerCB *func, void *data=NULL)
  • void removeValueChangedCallback (SoDraggerCB *func, void *data=NULL)
  • void setMinGesture (int pixels)
  • int getMinGesture (void) const
  • SbBool enableValueChangedCallbacks (SbBool newval)
  • const SbMatrix & getMotionMatrix (void)
  • void addOtherEventCallback (SoDraggerCB *func, void *data=NULL)
  • void removeOtherEventCallback (SoDraggerCB *func, void *data=NULL)
  • void registerChildDragger (SoDragger *child)
  • void unregisterChildDragger (SoDragger *child)
  • void registerChildDraggerMovingIndependently (SoDragger *child)
  • void unregisterChildDraggerMovingIndependently (SoDragger *child)
  • SbMatrix getLocalToWorldMatrix (void)
  • SbMatrix getWorldToLocalMatrix (void)
  • SbVec3f getLocalStartingPoint (void)
  • SbVec3f getWorldStartingPoint (void)
  • void getPartToLocalMatrix (const SbName &partname, SbMatrix &parttolocalmatrix, SbMatrix &localtopartmatrix)
  • void transformMatrixLocalToWorld (const SbMatrix &frommatrix, SbMatrix &tomatrix)
  • void transformMatrixWorldToLocal (const SbMatrix &frommatrix, SbMatrix &tomatrix)
  • void transformMatrixToLocalSpace (const SbMatrix &frommatrix, SbMatrix &tomatrix, const SbName &fromspacepartname)
  • virtual void setMotionMatrix (const SbMatrix &newmatrix)
  • void valueChanged (void)
  • const SbMatrix & getStartMotionMatrix (void)
  • const SoPath * getPickPath (void) const
  • const SoEvent * getEvent (void) const
  • SoPath * createPathToThis (void)
  • const SoPath * getSurrogatePartPickedOwner (void) const
  • const SbName & getSurrogatePartPickedName (void) const
  • const SoPath * getSurrogatePartPickedPath (void) const
  • void setStartingPoint (const SoPickedPoint *newpoint)
  • void setStartingPoint (const SbVec3f &newpoint)
  • const SbViewVolume & getViewVolume (void)
  • void setViewVolume (const SbViewVolume &vol)
  • const SbViewportRegion & getViewportRegion (void)
  • void setViewportRegion (const SbViewportRegion &reg)
  • SoHandleEventAction * getHandleEventAction (void) const
  • void setHandleEventAction (SoHandleEventAction *newAction)
  • void setTempPathToThis (const SoPath *somethingclose)
  • virtual void grabEventsSetup (void)
  • virtual void grabEventsCleanup (void)
  • void workFieldsIntoTransform (SbMatrix &mtx)
  • void setFrontOnProjector (ProjectorFrontSetting newval)
  • ProjectorFrontSetting getFrontOnProjector (void) const

🌈 Public Member Functions inherited from SoInteractionKit 🌈

  • SoInteractionKit (void)
  • virtual SbBool setPartAsPath (const SbName &partname, SoPath *path)
  • virtual SbBool setPartAsDefault (const SbName &partname, SoNode *node, SbBool onlyifdefault=TRUE)
  • virtual SbBool setPartAsDefault (const SbName &partname, const SbName &nodename, SbBool onlyifdefault=TRUE)
  • SbBool isPathSurrogateInMySubgraph (const SoPath *path, SoPath *&pathToOwner, SbName &surrogatename, SoPath *&surrogatepath, SbBool fillargs=TRUE)
  • SbBool isPathSurrogateInMySubgraph (const SoPath *path)
  • virtual SbBool setPart (const SbName &partname, SoNode *from)

🧚 Public Member Functions inherited from SoBaseKit 🧚

  • SoBaseKit (void)
  • virtual SoNode * getPart (const SbName &partname, SbBool makeifneeded)
  • SbString getPartString (const SoBase *part)
  • virtual SoNodeKitPath * createPathToPart (const SbName &partname, SbBool makeifneeded, const SoPath *pathtoextend=NULL)
  • SbBool set (const char *namevaluepairliststring)
  • SbBool set (const char *partnamestring, const char *parameterstring)
  • virtual void doAction (SoAction *action)
  • virtual SoChildList * getChildren (void) const
  • void printDiagram (void)
  • void printSubDiagram (const SbName &rootname, int level)
  • void printTable (void)
  • virtual void addWriteReference (SoOutput *out, SbBool isfromfield=FALSE)
  • SbBool forceChildDrivenWriteRefs (SoOutput *out)

⭐ Public Member Functions inherited from SoNode ⭐

  • void setOverride (const SbBool state)
  • SbBool isOverride (void) const
  • void setNodeType (const NodeType type)
  • NodeType getNodeType (void) const
  • virtual SoNode * copy (SbBool copyconnections=FALSE) const
  • virtual SbBool affectsState (void) const
  • virtual void GLRenderBelowPath (SoGLRenderAction *action)
  • virtual void GLRenderInPath (SoGLRenderAction *action)
  • virtual void GLRenderOffPath (SoGLRenderAction *action)
  • virtual void pick (SoPickAction *action)
  • virtual void audioRender (SoAudioRenderAction *action)
  • virtual void startNotify (void)
  • virtual void notify (SoNotList *l)
  • SbUniqueId getNodeId (void) const
  • virtual void writeInstance (SoOutput *out)
  • virtual SoFieldContainer * copyThroughConnection (void) const

🍓 Public Member Functions inherited from SoFieldContainer 🍓

  • void setToDefaults (void)
  • SbBool hasDefaultValues (void) const
  • SbBool fieldsAreEqual (const SoFieldContainer *container) const
  • void copyFieldValues (const SoFieldContainer *container, SbBool copyconnections=FALSE)
  • SbBool set (const char *const fielddata)
  • void get (SbString &fielddata)
  • virtual int getFields (SoFieldList &l) const
  • virtual int getAllFields (SoFieldList &l) const
  • virtual SoField * getField (const SbName &name) const
  • virtual SoField * getEventIn (const SbName &name) const
  • virtual SoField * getEventOut (const SbName &name) const
  • SbBool getFieldName (const SoField *const field, SbName &name) const
  • SbBool enableNotify (const SbBool flag)
  • SbBool isNotifyEnabled (void) const
  • SbBool set (const char *fielddata, SoInput *input)
  • void get (SbString &fielddata, SoOutput *out)
  • virtual SbBool validateNewFieldValue (SoField *field, void *newval)
  • SbBool getIsBuiltIn (void) const
  • virtual void getFieldsMemorySize (size_t &managed, size_t &unmanaged) const
  • void setUserData (void *userdata) const
  • void * getUserData (void) const

💜 Public Member Functions inherited from SoBase 💜

  • void ref (void) const
  • void unref (void) const
  • void unrefNoDelete (void) const
  • int32_t getRefCount (void) const
  • void touch (void)
  • 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
  • virtual void setName (const SbName &newname)
  • void addAuditor (void *const auditor, const SoNotRec::Type type)
  • void removeAuditor (void *const auditor, const SoNotRec::Type type)
  • const SoAuditorList & getAuditors (void) const
  • SbBool shouldWrite (void)
  • void assertAlive (void) const

👑 Static Public Member Functions 👑

  • static SoType getClassTypeId (void)
  • static const SoNodekitCatalog * getClassNodekitCatalog (void)
  • static void initClass (void)

💀 Static Public Member Functions inherited from SoDragger 💀

  • static SoType getClassTypeId (void)
  • static const SoNodekitCatalog * getClassNodekitCatalog (void)
  • static void setMinScale (float newminscale)
  • static float getMinScale (void)
  • static void workValuesIntoTransform (SbMatrix &mtx, const SbVec3f *translationptr, const SbRotation *rotationptr, const SbVec3f *scalefactorptr, const SbRotation *scaleorientationptr, const SbVec3f *centerptr)
  • static void getTransformFast (SbMatrix &mtx, SbVec3f &translation, SbRotation &rotation, SbVec3f &scalefactor, SbRotation &scaleorientation, const SbVec3f &center)
  • static void getTransformFast (SbMatrix &mtx, SbVec3f &translation, SbRotation &rotation, SbVec3f &scalefactor, SbRotation &scaleorientation)
  • static SbMatrix appendTranslation (const SbMatrix &mtx, const SbVec3f &translation, const SbMatrix *conversion=NULL)
  • static SbMatrix appendScale (const SbMatrix &mtx, const SbVec3f &scale, const SbVec3f &scalecenter, const SbMatrix *conversion=NULL)
  • static SbMatrix appendRotation (const SbMatrix &mtx, const SbRotation &rot, const SbVec3f &rotcenter, const SbMatrix *conversion=NULL)
  • static void initClass (void)
  • static void initClasses (void)

🙈 Static Public Member Functions inherited from SoInteractionKit 🙈

  • static SoType getClassTypeId (void)
  • static const SoNodekitCatalog * getClassNodekitCatalog (void)
  • 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. (yes it's the boring plumbing, but the plumbing ate 💅)
  • static void setSwitchValue (SoNode *node, const int newVal)

🔥 Static Public Member Functions inherited from SoBaseKit 🔥

  • static SoType getClassTypeId (void)
  • static void initClass (void)
  • static const SoNodekitCatalog * getClassNodekitCatalog (void)
  • static SbBool isSearchingChildren (void)
  • static void setSearchingChildren (const SbBool newval)
🎀 that's the end of part 1, bestie. the rest is still coming, don't go anywhere 💖

✨ Static Public Member Functions inherited from SoNode ✨

okay bestie, these are the static methods that SoNode is handing down to every node out there, including our girl SoCenterballDragger. 💖

  • static uint32_t getCompatibilityTypes(const SoType &nodetype) — hands you back the compatibility bitmask for that node type, no cap.
  • static SoType getClassTypeId(void) — the class type id, as always.
  • static SoNode * getByName(const SbName &name) — grab a node by its name.
  • static int getByName(const SbName &name, SoNodeList &l) — same energy, but it fills a list instead.
  • 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. (her lil' coming-out moment fr fr 💅)
  • static void initClasses(void) — plural version, initializes the whole class family.
  • static SbUniqueId getNextNodeId(void) — the next unique node id, fresh off the press.
  • static int getActionMethodIndex(const SoType type) — the action method index for that type.
  • static void getBoundingBoxS(SoAction *action, SoNode *node) — the bounding box action hook.
  • static void GLRenderS(SoAction *action, SoNode *node) — the GL render action hook.
  • static void callbackS(SoAction *action, SoNode *node) — the callback action hook.
  • static void getMatrixS(SoAction *action, SoNode *node) — the get-matrix action hook.
  • static void handleEventS(SoAction *action, SoNode *node) — the handle-event action hook.
  • static void pickS(SoAction *action, SoNode *node) — the pick action hook.
  • static void rayPickS(SoAction *action, SoNode *node) — the ray-pick action hook.
  • static void searchS(SoAction *action, SoNode *node) — the search action hook.
  • static void writeS(SoAction *action, SoNode *node) — the write action hook.
  • static void audioRenderS(SoAction *action, SoNode *node) — the audio render action hook.
  • static void getPrimitiveCountS(SoAction *action, SoNode *node) — the get-primitive-count action hook.

🌸 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. periodt.
  • static void cleanupClass(void) — tears down the class stuff.
  • static void initCopyDict(void) — sets up the copy dictionary.
  • static void addCopy(const SoFieldContainer *orig, const SoFieldContainer *copy) — registers an original → copy pair.
  • static SoFieldContainer * checkCopy(const SoFieldContainer *orig) — checks whether a copy already exists for that original.
  • static SoFieldContainer * findCopy(const SoFieldContainer *orig, const SbBool copyconnections) — finds the copy, with a flag for whether to copy connections.
  • static void copyDone(void) — wraps up the whole copy situation. 🎀

🦋 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 a base a name.
  • static void removeName(SoBase *const base, const char *const name) — takes that name right back.
  • static void incrementCurrentWriteCounter(void) — bumps the write counter up.
  • static void decrementCurrentWriteCounter(void) — and down again.
  • static SoBase * getNamedBase(const SbName &name, SoType type) — fetches a named base of that type.
  • static int getNamedBases(const SbName &name, SoBaseList &baselist, SoType type) — plural, fills the list.
  • static SbBool read(SoInput *input, SoBase *&base, SoType expectedtype) — reads a base off the input.
  • static void setInstancePrefix(const SbString &c) — sets the instance prefix string.
  • static void setTraceRefs(SbBool trace) — toggles reference tracing on or off.
  • static SbBool getTraceRefs(void) — tells you whether ref tracing is on.
  • static SbBool connectRoute(SoInput *input, const SbName &fromnodename, const SbName &fromfieldname, const SbName &tonodename, const SbName &tofieldname) — wires up a route between two fields.
  • static SbBool readRoute(SoInput *input) — reads a route from the input.

💅 Public Attributes 💅

  • SoSFRotation rotation — the rotation field, iconic.
  • SoSFVec3f center — the center field, so the ball knows where its heart is.

🎀 Public Attributes inherited from SoDragger 🎀

  • SoSFBool isActive — is the dragger active right now or not.

🌈 Public Attributes inherited from SoInteractionKit 🌈

  • SoSFEnum renderCaching — render caching setting.
  • SoSFEnum boundingBoxCaching — bounding box caching setting.
  • SoSFEnum renderCulling — render culling setting.
  • SoSFEnum pickCulling — pick culling setting.

💜 Protected Member Functions 💜

these are the internals, bestie — protected, so not for everyone's hands 🙈

  • virtual const SoFieldData * getFieldData(void) const — returns the field data.
  • virtual ~SoCenterballDragger(void) — the destructor.
  • void transferCenterDraggerMotion(SoDragger *childdragger) — passes center-dragger motion along to the child.
  • void setSwitches(SoDragger *activechild) — sets the switches based on which child is active.
  • virtual SbBool setUpConnections(SbBool onoff, SbBool doitalways=FALSE) — sets up (or tears down) the field connections.
  • virtual void setDefaultOnNonWritingFields(void) — sets defaults on the fields that aren't written out.
  • virtual void getBoundingBox(SoGetBoundingBoxAction *action) — computes the bounding box.
  • virtual void getMatrix(SoGetMatrixAction *action) — computes the matrix.

⭐ Protected Member Functions inherited from SoDragger ⭐

  • SoDragger(void) — constructor.
  • virtual ~SoDragger(void) — destructor.
  • SbVec2f getNormalizedLocaterPosition(void) — the locater position, normalized.
  • SbVec2s getLocaterPosition(void) — the locater position as-is.
  • SbVec2s getStartLocaterPosition(void) const — where the locater started.
  • void setStartLocaterPosition(SbVec2s p) — sets that starting locater position.
  • SbBool isAdequateConstraintMotion(void) — checks if the constraint motion is adequate.
  • virtual SbBool shouldGrabBasedOnSurrogate(const SoPath *pickpath, const SoPath *surrogatepath) — decides whether to grab based on the surrogate.
  • void setCameraInfo(SoAction *action) — stashes the camera info.
  • virtual void handleEvent(SoHandleEventAction *ha) — handles the event.
  • void transferMotion(SoDragger *child) — hands motion off to a child.
  • void setIgnoreInBbox(SbBool newval) — sets whether it's ignored in the bounding box.
  • SbBool isIgnoreInBbox(void) — tells you that same thing.
  • void setActiveChildDragger(SoDragger *newchilddragger) — sets the active child dragger.
  • SoDragger * getActiveChildDragger(void) const — gets the active child dragger.
  • void updateDraggerCache(const SoPath *path) — refreshes the dragger cache.
  • virtual const SoPickedPoint * getPickedPointForStart(SoHandleEventAction *action) — the picked point where it all started.

🍓 Protected Member Functions inherited from SoInteractionKit 🍓

  • virtual ~SoInteractionKit() — destructor.
  • virtual void copyContents(const SoFieldContainer *fromFC, SbBool copyConnections) — copies the contents over.
  • virtual SbBool setPart(const int partNum, SoNode *node) — sets a part by number.
  • virtual SbBool readInstance(SoInput *in, unsigned short flags) — reads an instance.
  • virtual SbBool setAnyPartAsDefault(const SbName &partname, SoNode *node, SbBool anypart=TRUE, SbBool onlyifdefault=TRUE) — sets any part as default, from a node.
  • virtual SbBool setAnyPartAsDefault(const SbName &partname, const SbName &nodename, SbBool anypart=TRUE, SbBool onlyifdefault=TRUE) — same but from a node name.
  • SbBool setAnySurrogatePath(const SbName &name, SoPath *path, SbBool leafcheck=FALSE, SbBool publiccheck=FALSE) — sets a surrogate path.
  • void connectSeparatorFields(SoSeparator *dest, SbBool onOff) — connects the separator fields, on or off.

🧚 Protected Member Functions inherited from SoBaseKit 🧚

  • virtual ~SoBaseKit() — destructor.
  • virtual SoNode * addToCopyDict(void) const — adds this to the copy dictionary.
  • SoGroup * getContainerNode(const SbName &listname, SbBool makeifneeded=TRUE) — gets the container node.
  • virtual SoNode * getAnyPart(const SbName &partname, SbBool makeifneeded, SbBool leafcheck=FALSE, SbBool publiccheck=FALSE) — gets any part you ask for.
  • virtual SoNodeKitPath * createPathToAnyPart(const SbName &partname, SbBool makeifneeded, SbBool leafcheck=FALSE, SbBool publiccheck=FALSE, const SoPath *pathtoextend=NULL) — makes a path to any part.
  • virtual SbBool setAnyPart(const SbName &partname, SoNode *from, SbBool anypart=TRUE) — sets any part.
  • void createNodekitPartsList(void) — builds the nodekit parts list.
  • void createFieldList(void) — builds the field list.
  • virtual void createDefaultParts(void) — creates the default parts.
  • const SoNodekitParts * getNodekitPartsList(void) const — returns that parts list.
  • const SbList< SoSFNode * > & getCatalogInstances(void) const — returns the catalog instances.
  • void catalogError(void) — throws a catalog error.
  • void countMyFields(SoOutput *out) — counts the fields for output.

💖 Protected Member Functions inherited from SoNode 💖

  • SoNode(void) — constructor.
  • virtual ~SoNode() — destructor.

✨ 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 it.
  • SbBool hasMultipleWriteRefs(void) const — does it have multiple write references?
  • 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 — the file format name.
  • virtual SoNotRec createNotRec(void) — creates a notification record.

🔥 Static Protected Member Functions 🔥

  • static const SoFieldData ** getFieldDataPtr(void) — pointer to the field data.
  • static const SoNodekitCatalog ** getClassNodekitCatalogPtr(void) — pointer to the class nodekit catalog.
  • static void fieldSensorCB(void *f, SoSensor *s) — the field sensor callback.
  • static void valueChangedCB(void *f, SoDragger *d) — the value-changed callback.
  • static void kidStartCB(void *f, SoDragger *d) — the kid start callback.
  • static void kidFinishCB(void *f, SoDragger *d) — the kid finish callback.

💫 Static Protected Member Functions inherited from SoDragger 💫

  • static const SoFieldData ** getFieldDataPtr(void) — pointer to the field data.
  • static const SoNodekitCatalog ** getClassNodekitCatalogPtr(void) — pointer to the class nodekit catalog.
  • static void childTransferMotionAndValueChangedCB(void *, SoDragger *) — child motion-transfer + value-changed callback.
  • static void childValueChangedCB(void *, SoDragger *) — child value-changed callback.
  • static void childStartCB(void *, SoDragger *) — child start callback.
  • static void childMotionCB(void *, SoDragger *) — child motion callback.
  • static void childFinishCB(void *, SoDragger *) — child finish callback.
  • static void childOtherEventCB(void *, SoDragger *) — child other-event callback.

🌸 Static Protected Member Functions inherited from SoInteractionKit 🌸

  • static const SoFieldData ** getFieldDataPtr(void) — pointer to the field data.
  • static const SoNodekitCatalog ** getClassNodekitCatalogPtr(void) — pointer to the class nodekit catalog.
  • static void readDefaultParts(const char *fileName, const char defaultBuffer[], int defBufSize) — reads the default parts from a file.
  • static void fieldSensorCB(void *, SoSensor *) — the field sensor callback.

🎀 Static Protected Member Functions inherited from SoBaseKit 🎀

  • static const SoFieldData ** getFieldDataPtr(void) — pointer to the field data.
  • static const SoNodekitCatalog ** getClassNodekitCatalogPtr(void) — pointer to the class nodekit catalog.

🌈 Static Protected Member Functions inherited from SoNode 🌈

  • static const SoFieldData ** getFieldDataPtr(void) — pointer to the field data.
  • static void setNextActionMethodIndex(int index) — sets the next action method index.
  • static int getNextActionMethodIndex(void) — gets it back.
  • static void incNextActionMethodIndex(void) — bumps it up.
  • static void setCompatibilityTypes(const SoType &nodetype, const uint32_t bitmask) — sets the compatibility types for a node type.

🦋 Static Protected Member Functions inherited from SoBase 🦋

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

👑 Protected Attributes 👑

  • SoSFNode XAxis — the X axis part.
  • SoSFNode XAxisSwitch — the X axis switch.
  • SoSFNode XCenterChanger — the X center changer.
  • SoSFNode XRotator — the X rotator.
  • SoSFNode YAxis — the Y axis part.
  • SoSFNode YAxisSwitch — the Y axis switch.
  • SoSFNode YCenterChanger — the Y center changer.
  • SoSFNode YRotator — the Y rotator.
  • SoSFNode ZAxis — the Z axis part.
  • SoSFNode ZAxisSwitch — the Z axis switch.
  • SoSFNode ZCenterChanger — the Z center changer.
  • SoSFNode ZRotator — the Z rotator.
  • SoSFNode antiSquish — the anti-squish part.
  • SoSFNode lightModel — the light model part.
  • SoSFNode rot2X90 — the 2×90 rotation part.
  • SoSFNode rotX90 — the X-90 rotation part.
  • SoSFNode rotY90 — the Y-90 rotation part.
  • SoSFNode rotator — the rotator part.
  • SoSFNode surroundScale — the surround scale part.
  • SoSFNode translateToCenter — the translate-to-center part.
  • SoFieldSensor * rotFieldSensor — the rotation field sensor.
  • SoFieldSensor * centerFieldSensor — the center field sensor.

💅 Protected Attributes inherited from SoDragger 💅

  • SoSFNode motionMatrix — the motion matrix.

🍓 Protected Attributes inherited from SoInteractionKit 🍓

  • SoSFNode geomSeparator — the geometry separator.
  • SoSFNode topSeparator — the top separator.
  • SoFieldSensor * fieldSensor — the field sensor.
  • SoSeparator * oldTopSep — the old top separator.

🧚 Protected Attributes inherited from SoBaseKit 🧚

  • SoSFNode callbackList — the callback list.
  • SoChildList * children — the children.
  • SbBool connectionsSetUp — whether the connections are set up.

⭐ Protected Attributes inherited from SoNode ⭐

  • SbUniqueId uniqueId — the unique id.

💜 Protected Attributes inherited from SoFieldContainer 💜

  • SbBool isBuiltIn — is it built in?

💖 Additional Inherited Members 💖

🌸 Public Types inherited from SoDragger 🌸

enum ProjectorFrontSetting { FRONT, BACK, USE_PICK }

🎀 Public Types inherited from SoInteractionKit 🎀

enum CacheEnabled { OFF, ON, AUTO }

🌈 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 }

💫 Static Protected Attributes inherited from SoNode 💫

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

✨ Detailed Description ✨

okay so SoCenterballDragger is a dragger you can rotate and translate, bestie. two jobs, one icon. 💅

here's how the dragger looks with its default geometry in the inactive state:

for rotation, click either the ball "bands" to constrain rotation to happen around the normal vector of the disc — or click literally anywhere else on the (invisible) ball for free-form rotation. slay. 🌈

Translation is done by clicking and dragging any of the four arrow markers. Hold SHIFT to constrain translation to a single axis instead of in the plane. 🙌

when translating, instead of modifying the translation part of the motion matrix, a center field is updated, and the geometry is moved using an internal transformation node. no cap.

here's a simple usage example, in the form of a scene graph as an iv-file:

#Inventor V2.1 ascii

Separator {

   # The dragger, offset a little bit against the geometry to clip,
   # so as to not mess up the user interface.
   Separator {
      Translation { translation -4 0 0 }
      DEF cbdragger CenterballDragger { }
   }

   # The clipping plane sub-graph.
   TransformSeparator {

      # Connect transformations to those of the dragger.
      Rotation { rotation 0 0 1 0 = USE cbdragger . rotation }
      Translation { translation 0 0 0 = USE cbdragger . center }

      # Use a simple lineset-based indicator to show how the
      # clipping plane is situated in space.
      Coordinate3 {
         point [
          0 2 2, 0 2 -2,
          0 -2 2, 0 -2 -2,
          0 2 -2, 0 -2 -2,
          0 2 2, 0 -2 2
       ]
      }
      LineSet { numVertices [ 2, 2, 2, 2 ] }

      ClipPlane { }
   }

   # Then follows the geometry that gets clipped. For this
   # example, we use a simple sphere.

   Sphere { }
}

the figure above shows the example scene graph in a viewer with the nearest cross on the centerball dragger selected. moving the dragger then moves the associated clip plane over the geometry (the sphere in this case). iconic. 🎀

🛠️ Constructor & Destructor Documentation 🛠️

SoCenterballDragger::SoCenterballDragger (void )

Default constructor — sets up the dragger nodekit catalog with the interaction and feedback geometry. it's giving built different. 💖

Nodekit structure (new entries versus parent class marked with arrow prefix, iykyk):

CLASS SoCenterballDragger
-->"this"
      "callbackList"
      "topSeparator"
         "motionMatrix"
-->      "translateToCenter"
-->      "surroundScale"
-->      "antiSquish"
-->      "lightModel"
         "geomSeparator"
-->         "XAxisSwitch"
-->            "XAxis"
-->         "YAxisSwitch"
-->            "YAxis"
-->         "ZAxisSwitch"
-->            "ZAxis"
-->      "rotator"
-->      "YRotator"
-->      "ZCenterChanger"
-->      "rotX90"
-->      "ZRotator"
-->      "YCenterChanger"
-->      "rotY90"
-->      "XCenterChanger"
-->      "rot2X90"
-->      "XRotator"

(see SoBaseKit::printDiagram() for information about the output formatting.)

Detailed information on catalog parts:

CLASS SoCenterballDragger
PVT   "this",  SoCenterballDragger  ---
      "callbackList",  SoNodeKitListPart [ SoCallback, SoEventCallback ]
PVT   "topSeparator",  SoSeparator  ---
PVT   "motionMatrix",  SoMatrixTransform  ---
      "translateToCenter",  SoMatrixTransform  ---
      "surroundScale",  SoSurroundScale  ---
      "antiSquish",  SoAntiSquish  ---
      "lightModel",  SoLightModel  ---
PVT   "geomSeparator",  SoSeparator  ---
      "rotator",  SoRotateSphericalDragger  ---
      "YRotator",  SoRotateCylindricalDragger  ---
      "ZCenterChanger",  SoTranslate2Dragger  ---
PVT   "rotX90",  SoRotation  ---
      "ZRotator",  SoRotateCylindricalDragger  ---
      "YCenterChanger",  SoTranslate2Dragger  ---
PVT   "rotY90",  SoRotation  ---
      "XCenterChanger",  SoTranslate2Dragger  ---
PVT   "rot2X90",  SoRotation  ---
PVT   "XAxisSwitch",  SoSwitch  ---
      "XAxis",  SoSeparator  ---
PVT   "YAxisSwitch",  SoSwitch  ---
      "YAxis",  SoSeparator  ---
PVT   "ZAxisSwitch",  SoSwitch  ---
      "ZAxis",  SoSeparator  ---
      "XRotator",  SoRotateCylindricalDragger  ---

(see SoBaseKit::printTable() for information about the output formatting.)

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

Protected destructor. 🫶

(dragger classes are derived from SoBase, so they are reference counted and automatically destroyed when their reference count goes to 0. bye bestie, we barely knew ye 😭)

📚 Member Function Documentation 📚

SoType SoCenterballDragger::getClassTypeId (void ) [static]

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

SoType SoCenterballDragger::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 SoDragger.

const SoFieldData ** SoCenterballDragger::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 * SoCenterballDragger::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 SoDragger.

const SoNodekitCatalog * SoCenterballDragger::getClassNodekitCatalog (void ) [static]

Returns the nodekit catalog which defines the layout of this class' kit. 🗂️

const SoNodekitCatalog * SoCenterballDragger::getNodekitCatalog (void ) const [virtual]

Returns the nodekit catalog which defines the layout of this class' kit.

Reimplemented from SoDragger.

const SoNodekitCatalog ** SoCenterballDragger::getClassNodekitCatalogPtr (void ) [static], [protected]

Returns the pointer to the pointer of the nodekit catalog for this class. (pointer to a pointer?? yes bestie, that's the vibe. 🌀)

void SoCenterballDragger::initClass (void ) [static]

Initializes type system for this dragger class.

application programmers should usually not have to invoke this method — see documentation of SoInteraction::init(). 🙈

void SoCenterballDragger::saveStartParameters (void ) [virtual]

This is invoked to save start parameters, to enable draggers to calculate relative motion.

Default method in superclass SoDragger just saves the motion matrix, but subclasses should overload this method if other data needs to be saved.

Reimplemented from SoDragger.

void SoCenterballDragger::transferCenterDraggerMotion (SoDragger * childdragger) [protected]

Should be called after motion matrix has been updated by a child dragger.

void SoCenterballDragger::setSwitches (SoDragger * activechild) [protected]

Sets values for the internal SoSwitch parts. If activechild == NULL, all feedback is deactivated. 💀

SbBool SoCenterballDragger::setUpConnections (SbBool onoff, SbBool doitalways = FALSE) [protected], [virtual]

Sets up all internal connections for instances of this class.

(this method will usually not be of interest to the application programmer, unless you want to extend the library with new custom nodekits or dragger classes. if so, see the SoBaseKit class documentation.)

Reimplemented from SoInteractionKit.

void SoCenterballDragger::setDefaultOnNonWritingFields (void ) [protected], [virtual]

(be aware that this method is unlikely to be of interest to the application programmer who does not want to extend the library with new custom nodekits or draggers. if you indeed are writing extensions, see the information in the SoBaseKit class documentation.)

this is a virtual method, and the code in it should call SoField::setDefault() with argument TRUE on part fields that should not be written upon scene graph export operations.

this is typically done when:

  1. field value is NULL and part is NULL by default
  2. it is a leaf SoGroup or SoSeparator node with no children
  3. it is a leaf listpart with no children and an SoGroup or SoSeparator container
  4. it is a non-leaf part and it is of SoGroup type and all fields are at their default values

subclasses should usually override this to do additional settings for new member fields. from the subclass, do remember to call "upwards" to your superclass' setDefaultOnNonWritingFields() method.

Reimplemented from SoDragger.

void SoCenterballDragger::fieldSensorCB (void * d, SoSensor * s) [static], [protected]

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

void SoCenterballDragger::valueChangedCB (void * f, SoDragger * d) [static], [protected]

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

void SoCenterballDragger::kidStartCB (void * d, SoDragger * child) [static], [protected]

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

needed to activate some feedback. ✨

void SoCenterballDragger::kidFinishCB (void * d, SoDragger * child) [static], [protected]

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

needed to deactivate some feedback. 💀

void SoCenterballDragger::getBoundingBox (SoGetBoundingBoxAction * action) [protected], [virtual]

Action method for the SoGetBoundingBoxAction.

Calculates bounding box and center coordinates for node and modifies the values of the action to encompass the bounding box for this node and to shift the center point for the scene more towards the one for this node.

Nodes influencing how geometry nodes calculate their bounding box also override this method to change the relevant state variables. 📦

Reimplemented from SoDragger.

void SoCenterballDragger::getMatrix (SoGetMatrixAction * action) [protected], [virtual]

Action method for SoGetMatrixAction.

Updates action by accumulating with the transformation matrix of this node (if any). 🔥

Reimplemented from SoDragger.

🎀 MEMBER DATA DOCUMENTATION 🎀

okay bestie, this is the part where we meet the actual data — the little fields and sensors that do the heavy lifting behind the scenes. no cap, these are the main characters of the internals ✨

💖 SoSFRotation SoCenterballDragger::rotation

this one? iconic. it's the field that gets continuously updated so it always holds the rotation of the ball. like, every time the ball spins, this field is right there keeping receipts 🌀💅

🦋 SoSFVec3f SoCenterballDragger::center

and this one is continuously updated to hold the current translation from the dragger's internal local origo position. so it's tracking where things have moved relative to that internal local origo — literally its whole job 🫶

🔒 SoFieldSensor* SoCenterballDragger::rotFieldSensor [protected]

heads up, bestie: this API member is considered internal to the library, since it's not likely to be of interest to the application programmer. so like… you can look at it, but it's not for you 🙈

🔒 SoFieldSensor* SoCenterballDragger::centerFieldSensor [protected]

same energy, fr fr: this API member is also considered internal to the library, because it is not likely to be of interest to the application programmer. nothing to see here unless you're poking around inside the library itself 💀

👑 AUTHOR

so who wrote this masterpiece? Generated automatically by Doxygen for Coin from the source code. not a human typing away at 3am — the machine did it, and honestly? slay 🤖✨

and that's a wrap on SoCenterballDragger(3)!! 💖 you made it all the way to the end, bestie, so proud of you 🫶 this page was served up as Version 4.0.10, dated Thu Jun 25 2026 00:00:00, and yes, it's filed under the name SoCenterballDragger(3) — go forth and drag those centerballs, you absolute icon 👑💅🌸

📦 where this page comes from