SoScaleUniformDragger(3)

📦 version 2.5.0, in fedora 43, fedora 44

✨ NAME ✨

SoScaleUniformDragger — welcome to the manual page for SoScaleUniformDragger(3)! 🎀 This class is the whole mechanism your end-user pokes at when they want to scale stuff in three dimensions. Yes bestie, three. All of them. At once. It's giving uniform. 💅

🦋 SYNOPSIS 🦋

#include <Inventor/draggers/SoScaleUniformDragger.h>

Inherits SoDragger. So it's already part of the dragger family tree, iykyk. 🌳

💖 Public Member Functions 💖

virtual SoType getTypeId (void) const
virtual const SoNodekitCatalog * getNodekitCatalog (void) const
SoScaleUniformDragger (void)

Like, that's it for the fresh stuff — the rest is all inheritance, and there is so much of it. Buckle up. 🫶

🧚 Public Member Functions inherited from SoDragger

virtual void callback (SoCallbackAction *action)
virtual void GLRender (SoGLRenderAction *action)
virtual void getMatrix (SoGetMatrixAction *action)
virtual void rayPick (SoRayPickAction *action)
virtual void search (SoSearchAction *action)
virtual void write (SoWriteAction *action)
virtual void getPrimitiveCount (SoGetPrimitiveCountAction *action)
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)
void setMotionMatrix (const SbMatrix &newmatrix)
void valueChanged (void)
const SbMatrix & getStartMotionMatrix (void)
virtual void saveStartParameters (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

That's a lot of callbacks, bestie. Start, motion, finish, value-changed, other-event… the dragger is basically running a whole group chat. 💬

🌸 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=1)
virtual SbBool setPartAsDefault (const SbName &partname, const SbName
    &nodename, SbBool onlyifdefault=1)
SbBool isPathSurrogateInMySubgraph (const SoPath *path, SoPath
    *&pathToOwner, SbName &surrogatename, SoPath *&surrogatepath, SbBool
    fillargs=1)
SbBool isPathSurrogateInMySubgraph (const SoPath *path)
virtual SbBool setPart (const SbName &partname, SoNode *from)

Surrogates and defaults and parts, oh my! 🦋 The kit stuff is where the plug-and-play magic lives.

👑 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=0)
SbBool forceChildDrivenWriteRefs (SoOutput *out)

You can literally printDiagram() and printTable() your nodekit, which is iconic honestly. 📊✨

💜 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=0) 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)
uint32_t getNodeId (void) const
virtual void writeInstance (SoOutput *out)
virtual SoFieldContainer * copyThroughConnection (void) const

The render-below / render-in / render-off trio is so main character energy. 🔥

🌈 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=0)
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 *in)
void get (SbString &fielddata, SoOutput *out)
virtual SbBool validateNewFieldValue (SoField *field, void *newval)
SbBool getIsBuiltIn (void) const
void setUserData (void *userdata) const
void * getUserData (void) const

Fields, events in, events out, user data… it's the whole plumbing department and it ate. 💅

🎀 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
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

ref() and unref() — the original situationship. You gotta keep them balanced, fr fr. 😭

⭐ 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)
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)
static SoNode * typeCheck (const SbName &partname, const SoType
    &parttype, SoNode *node)

🦋 Static Public Member Functions inherited from SoNode

static uint32_t getCompatibilityTypes (const SoType &nodetype)
static SoType getClassTypeId (void)
static SoNode * getByName (const SbName &name)
static int getByName (const SbName &name, SoNodeList &l)
static void initClass (void)
static void initClasses (void)
static uint32_t getNextNodeId (void)
static int getActionMethodIndex (const SoType type)
static void getBoundingBoxS (SoAction *action, SoNode *node)
static void GLRenderS (SoAction *action, SoNode *node)
static void callbackS (SoAction *action, SoNode *node)
static void getMatrixS (SoAction *action, SoNode *node)
static void handleEventS (SoAction *action, SoNode *node)
static void pickS (SoAction *action, SoNode *node)
static void rayPickS (SoAction *action, SoNode *node)
static void searchS (SoAction *action, SoNode *node)
static void writeS (SoAction *action, SoNode *node)
static void audioRenderS (SoAction *action, SoNode *node)
static void getPrimitiveCountS (SoAction *action, SoNode *node)

And that's the whole static squad. 😌 Literally every …S variant is just the static dispatcher version, no cap.

okay bestie that's the SYNOPSIS done — part 2 is coming right up, don't go anywhere 💖

Static Public Member Functions inherited from SoFieldContainer 💅

okay so these are the static public member functions we inherited from SoFieldContainer, and yes, we're listing every single one. no skipping. periodt.

static void initClass (void) — the init moment, iconic.
static SoType getClassTypeId (void) — hands you the class type id, no cap.
static void initCopyDict (void) — sets up the copy dictionary, slay.
static void addCopy (const SoFieldContainer *orig, const SoFieldContainer *copy) — adds a copy, obviously.
static SoFieldContainer * checkCopy (const SoFieldContainer *orig) — checks a copy, bestie.
static SoFieldContainer * findCopy (const SoFieldContainer *orig, const SbBool copyconnections) — finds a copy, the way that it does.
static void copyDone (void) — copy is done, periodt.

Static Public Member Functions inherited from SoBase 💅

more static public functions, this time from SoBase. let's go.

static void initClass (void) — another init, because of course.
static SoType getClassTypeId (void) — type id again, we love consistency.
static void addName (SoBase *const base, const char *const name) — adds a name, fr fr.
static void removeName (SoBase *const base, const char *const name) — removes a name, bye.
static void incrementCurrentWriteCounter (void) — increments the write counter, lowkey.
static void decrementCurrentWriteCounter (void) — decrements it, highkey.
static SoBase * getNamedBase (const SbName &name, SoType type) — gets a named base, iykyk.
static int getNamedBases (const SbName &name, SoBaseList &baselist, SoType type) — gets named bases, plural.
static SbBool read (SoInput *in, SoBase *&base, SoType expectedtype) — reads, as one does.
static void setInstancePrefix (const SbString &c) — sets the instance prefix, cute.
static void setTraceRefs (SbBool trace) — sets trace refs, okay.
static SbBool getTraceRefs (void) — gets trace refs, got it.
static SbBool connectRoute (SoInput *in, const SbName &fromnodename, const SbName &fromfieldname, const SbName &tonodename, const SbName &tofieldname) — connects a route, the whole thing.
static SbBool readRoute (SoInput *in) — reads a route, periodt.

Public Attributes 👑

SoSFVec3f scaleFactor — the main character field! this is the scale factor, bestie. it's a SoSFVec3f, so it holds three floats. and remember, for this dragger, X, Y, and Z will always be exactly equal. no cap.

Public Attributes inherited from SoDragger 🎀

SoSFBool isActive — tells you if it's active, iconic.

Public Attributes inherited from SoInteractionKit 🎀

SoSFEnum renderCaching — render caching enum, slay.
SoSFEnum boundingBoxCaching — bounding box caching enum, yes.
SoSFEnum renderCulling — render culling enum, periodt.
SoSFEnum pickCulling — pick culling enum, fr fr.

Protected Member Functions 💖

these are protected, so don't touch unless you're a subclass, bestie.

virtual const SoFieldData * getFieldData (void) const — gets the field data, virtual and const, iconic.
~SoScaleUniformDragger () — the destructor, bye.
virtual SbBool setUpConnections (SbBool onoff, SbBool doitalways=0) — sets up connections, with a default of 0 for doitalways.
void dragStart (void) — starts the drag, here we go.
void drag (void) — drags, obviously.
void dragFinish (void) — finishes the drag, periodt.

Protected Member Functions inherited from SoDragger 💖

SoDragger (void) — constructor, the beginning.
virtual ~SoDragger () — destructor, the end.
SbVec2f getNormalizedLocaterPosition (void) — gets normalized locater position, cute.
SbVec2s getLocaterPosition (void) — gets locater position, slay.
SbVec2s getStartLocaterPosition (void) const — gets start locater position, const.
void setStartLocaterPosition (SbVec2s p) — sets start locater position, okay.
SbBool isAdequateConstraintMotion (void) — checks if motion is adequate, iykyk.
virtual SbBool shouldGrabBasedOnSurrogate (const SoPath *pickpath, const SoPath *surrogatepath) — should grab based on surrogate, the way that it does.
void setCameraInfo (SoAction *action) — sets camera info, periodt.
virtual void handleEvent (SoHandleEventAction *ha) — handles event, virtual.
void transferMotion (SoDragger *child) — transfers motion to a child, slay.
void setIgnoreInBbox (SbBool newval) — sets ignore in bbox, bestie.
SbBool isIgnoreInBbox (void) — checks ignore in bbox, yes.
virtual void getBoundingBox (SoGetBoundingBoxAction *action) — gets bounding box, virtual.
void setActiveChildDragger (SoDragger *newchilddragger) — sets active child dragger, iconic.
SoDragger * getActiveChildDragger (void) const — gets active child dragger, const.
virtual void setDefaultOnNonWritingFields (void) — sets default on non-writing fields, periodt.
void updateDraggerCache (const SoPath *path) — updates dragger cache, fr fr.

Protected Member Functions inherited from SoInteractionKit 💖

virtual ~SoInteractionKit () — destructor, bye.
virtual void copyContents (const SoFieldContainer *fromFC, SbBool copyConnections) — copies contents, virtual.
virtual SbBool setPart (const int partNum, SoNode *node) — sets a part, virtual.
virtual SbBool readInstance (SoInput *in, unsigned short flags) — reads instance, virtual.
virtual SbBool setAnyPartAsDefault (const SbName &partname, SoNode *node, SbBool anypart=1, SbBool onlyifdefault=1) — sets any part as default, with defaults anypart=1 and onlyifdefault=1.
virtual SbBool setAnyPartAsDefault (const SbName &partname, const SbName &nodename, SbBool anypart=1, SbBool onlyifdefault=1) — same but with a nodename, defaults again.
SbBool setAnySurrogatePath (const SbName &name, SoPath *path, SbBool leafcheck=0, SbBool publiccheck=0) — sets any surrogate path, defaults leafcheck=0 and publiccheck=0.
void connectSeparatorFields (SoSeparator *dest, SbBool onOff) — connects separator fields, slay.

Protected Member Functions inherited from SoBaseKit 💖

virtual ~SoBaseKit () — destructor, periodt.
virtual SoNode * addToCopyDict (void) const — adds to copy dict, virtual const.
SoGroup * getContainerNode (const SbName &listname, SbBool makeifneeded=1) — gets container node, default makeifneeded=1.
virtual SoNode * getAnyPart (const SbName &partname, SbBool makeifneeded, SbBool leafcheck=0, SbBool publiccheck=0) — gets any part, defaults leafcheck=0 and publiccheck=0.
virtual SoNodeKitPath * createPathToAnyPart (const SbName &partname, SbBool makeifneeded, SbBool leafcheck=0, SbBool publiccheck=0, const SoPath *pathtoextend=NULL) — creates path to any part, defaults leafcheck=0, publiccheck=0, pathtoextend=NULL.
virtual SbBool setAnyPart (const SbName &partname, SoNode *from, SbBool anypart=1) — sets any part, default anypart=1.
void createNodekitPartsList (void) — creates nodekit parts list, iconic.
void createFieldList (void) — creates field list, slay.
virtual void createDefaultParts (void) — creates default parts, virtual.
const SoNodekitParts * getNodekitPartsList (void) const — gets nodekit parts list, const.
const SbList< SoSFNode * > & getCatalogInstances (void) const — gets catalog instances, const.
void catalogError (void) — catalog error, oops.
void countMyFields (SoOutput *out) — counts my fields, periodt.

Protected Member Functions inherited from SoNode 💖

SoNode (void) — constructor, the start.
virtual ~SoNode () — destructor, the end.

Protected Member Functions inherited from SoFieldContainer 💖

SoFieldContainer (void) — constructor, hello.
~SoFieldContainer () — destructor, bye.

Protected Member Functions inherited from SoBase 💖

SoBase (void) — constructor, again.
virtual ~SoBase () — destructor, again.
virtual void destroy (void) — destroys, virtual.
SbBool hasMultipleWriteRefs (void) const — checks multiple write refs, const.
SbBool writeHeader (SoOutput *out, SbBool isgroup, SbBool isengine) const — writes header, const.
void writeFooter (SoOutput *out) const — writes footer, const.
virtual const char * getFileFormatName (void) const — gets file format name, virtual const.

Static Protected Member Functions ✨

these are static and protected, so double the mystery.

static const SoFieldData ** getFieldDataPtr (void) — gets field data pointer, iconic.
static const SoNodekitCatalog ** getClassNodekitCatalogPtr (void) — gets class nodekit catalog pointer, slay.
static void startCB (void *f, SoDragger *d) — start callback, periodt.
static void motionCB (void *f, SoDragger *d) — motion callback, fr fr.
static void finishCB (void *f, SoDragger *d) — finish callback, yes.
static void fieldSensorCB (void *f, SoSensor *s) — field sensor callback, cute.
static void valueChangedCB (void *f, SoDragger *d) — value changed callback, iconic.

Static Protected Member Functions inherited from SoDragger ✨

static const SoFieldData ** getFieldDataPtr (void) — field data pointer again.
static const SoNodekitCatalog ** getClassNodekitCatalogPtr (void) — class nodekit catalog pointer again.
static void childTransferMotionAndValueChangedCB (void *, SoDragger *) — child transfer motion and value changed callback, the whole vibe.
static void childValueChangedCB (void *, SoDragger *) — child value changed callback, slay.
static void childStartCB (void *, SoDragger *) — child start callback, here we go.
static void childMotionCB (void *, SoDragger *) — child motion callback, moving.
static void childFinishCB (void *, SoDragger *) — child finish callback, done.
static void childOtherEventCB (void *, SoDragger *) — child other event callback, iykyk.

Static Protected Member Functions inherited from SoInteractionKit ✨

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

Static Protected Member Functions inherited from SoBaseKit ✨

static const SoFieldData ** getFieldDataPtr (void) — field data pointer, yes.
static const SoNodekitCatalog ** getClassNodekitCatalogPtr (void) — class nodekit catalog pointer, yes.

Static Protected Member Functions inherited from SoNode ✨

static const SoFieldData ** getFieldDataPtr (void) — field data pointer, periodt.
static void setNextActionMethodIndex (int index) — sets next action method index, slay.
static int getNextActionMethodIndex (void) — gets next action method index, iconic.
static void incNextActionMethodIndex (void) — increments next action method index, fr fr.
static void setCompatibilityTypes (const SoType &nodetype, const uint32_t bitmask) — sets compatibility types, with a bitmask.

Static Protected Member Functions inherited from SoBase ✨

static uint32_t getCurrentWriteCounter (void) — gets current write counter, cute.
static void staticDataLock (void) — locks static data, no cap.
static void staticDataUnlock (void) — unlocks static data, periodt.

Protected Attributes 🦋

SoSFNode feedback — feedback node, iconic.
SoSFNode feedbackActive — feedback active node, slay.
SoSFNode feedbackSwitch — feedback switch node, yes.
SoSFNode scaler — scaler node, the main character.
SoSFNode scalerActive — scaler active node, periodt.
SoSFNode scalerSwitch — scaler switch node, fr fr.
SoFieldSensor * fieldSensor — field sensor pointer, cute.
SbLineProjector * lineProj — line projector pointer, iconic.

Protected Attributes inherited from SoDragger 🦋

SoSFNode motionMatrix — motion matrix node, slay.

Protected Attributes inherited from SoInteractionKit 🦋

SoSFNode geomSeparator — geom separator node, yes.
SoSFNode topSeparator — top separator node, periodt.
SoFieldSensor * fieldSensor — field sensor pointer, again.
SoSeparator * oldTopSep — old top separator pointer, iykyk.

Protected Attributes inherited from SoBaseKit 🦋

SoSFNode callbackList — callback list node, iconic.
SoChildList * children — children list pointer, slay.
SbBool connectionsSetUp — connections set up boolean, fr fr.

Protected Attributes inherited from SoNode 🦋

uint32_t uniqueId — unique id, every node has one.

Protected Attributes inherited from SoFieldContainer 🦋

SbBool isBuiltIn — is built in boolean, periodt.

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 }

Protected Types inherited from SoBase 🧚

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

Static Protected Attributes inherited from SoNode ⭐

static uint32_t nextUniqueId = 0
static int nextActionMethodIndex = 0

Detailed Description 💜

The SoScaleUniformDragger class is literally a mechanism for the end-user to scale in three dimensions. it's giving scale, bestie.

Here's how the dragger looks with its default geometry in the inactive state: (imagine a cute little dragger, no cap).

Use this dragger to allow the end-user of your application to scale simultaneously along all the axes. it's the main character for uniform scaling.

Scaling with this dragger can only be done in a uniform manner, ie the X, Y and Z components of the SoScaleUniformDragger::scaleFactor will always be exactly equal. no cap, they're always equal. periodt.

See also: SoScale2UniformDragger — go check it out, iykyk.

💖 Constructor & Destructor Documentation 💖

✨ `SoScaleUniformDragger::SoScaleUniformDragger` ( `void` ) ✨

Okay bestie, this is the default constructor — it sets up the dragger nodekit catalog with the interaction geometry AND the feedback geometry. Two-for-one, iconic.

Here's the node kit structure, and heads up: new entries versus the parent class get an arrow prefix (that's the --> vibe check):

CLASS SoScaleUniformDragger
-->"this"
      "callbackList"
      "topSeparator"
         "motionMatrix"
         "geomSeparator"
-->         "scalerSwitch"
-->            "scaler"
-->            "scalerActive"
-->         "feedbackSwitch"
-->            "feedback"
-->            "feedbackActive"

(If you wanna know about that output formatting, see SoBaseKit::printDiagram(). She explains it. 🫶)

And here's the detailed tea on the catalog parts:

CLASS SoScaleUniformDragger
PVT   "this",  SoScaleUniformDragger  ---
      "callbackList",  SoNodeKitListPart [ SoCallback, SoEventCallback ]
PVT   "topSeparator",  SoSeparator  ---
PVT   "motionMatrix",  SoMatrixTransform  ---
PVT   "geomSeparator",  SoSeparator  ---
PVT   "scalerSwitch",  SoSwitch  ---
      "scaler",  SoSeparator  ---
      "scalerActive",  SoSeparator  ---
PVT   "feedbackSwitch",  SoSwitch  ---
      "feedback",  SoSeparator  ---
      "feedbackActive",  SoSeparator  ---

(And for that formatting, go see SoBaseKit::printTable(). 💅)

References: SoDragger::addFinishCallback(), SoDragger::addMotionCallback(), SoDragger::addStartCallback(), SoDragger::addValueChangedCallback(), fieldSensor, fieldSensorCB(), finishCB(), lineProj, motionCB(), SoInteractionKit::readDefaultParts(), scaleFactor, SoInteractionKit::setPartAsDefault(), SoInteractionKit::setSwitchValue(), setUpConnections(), SoScaleUniformDragger(), startCB(), and valueChangedCB().

Referenced by: fieldSensorCB(), finishCB(), getFieldData(), motionCB(), SoScaleUniformDragger(), startCB(), and valueChangedCB().

✨ `SoScaleUniformDragger::~SoScaleUniformDragger` ( ) `[protected]` ✨

Protected destructor, bestie. Very exclusive, very "you can't just call me, I'm handled."

(Dragger classes are derived from SoBase, so they're reference counted and automatically destroyed when their reference count goes to 0. She cleans up after herself. Queen behavior. 👑)

References: fieldSensor, and lineProj.

🌸 Member Function Documentation 🌸

✨ `SoType SoScaleUniformDragger::getTypeId` ( `void` ) `const` `[virtual]` ✨

Returns the type identification of an object derived from a class inheriting SoBase. This is what you use for run-time type checking and "downward" casting. iykyk.

Usage example, keep it exact:

void foo(SoNode * node)
{
  if (node->getTypeId() == SoFile::getClassTypeId()) {
    SoFile * filenode = (SoFile *)node;  // safe downward cast, knows the type
  }
  else if (node->getTypeId().isOfType(SoGroup::getClassTypeId())) {
    SoGroup * group = (SoGroup *)node;  // safe downward cast, knows the type
  }
}

Now for the application programmers who wanna extend the library with new nodes, engines, nodekits, draggers or whatever — listen up: this method needs to be overridden in all subclasses. This is typically done as part of setting up the full type system for extension classes, which is usually accomplished by using the pre-defined macros available through, for instance, Inventor/nodes/SoSubNode.h (SO_NODE_INIT_CLASS and SO_NODE_CONSTRUCTOR for node classes), Inventor/engines/SoSubEngine.h (for engine classes) and so on. Macros doing the heavy lifting? Love that for us. 💅

For more info on writing Coin extensions, see the class documentation of the toplevel superclasses for the various class groups.

Reimplemented from SoDragger.

✨ `const SoFieldData * SoScaleUniformDragger::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? She returns NULL. No fields, no problem. 😭

Reimplemented from SoDragger.

References: SoScaleUniformDragger().

✨ `const SoNodekitCatalog * SoScaleUniformDragger::getNodekitCatalog` ( `void` ) `const` `[virtual]` ✨

Returns the nodekit catalog which defines the layout of this class' kit. It's giving interior design, but for nodes. 🎀

Reimplemented from SoDragger.

✨ `SbBool SoScaleUniformDragger::setUpConnections` ( `SbBool onoff`, `SbBool doitalways = 0` ) `[protected]`, `[virtual]` ✨

Sets up all internal connections for instances of this class. Wires everywhere, no cap.

(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 that's you, go read the SoBaseKit class documentation. Go on, we'll wait. 🫶)

Reimplemented from SoInteractionKit.

References: SoBaseKit::connectionsSetUp, fieldSensor, fieldSensorCB(), scaleFactor, and SoBaseKit::setUpConnections().

Referenced by SoScaleUniformDragger().

✨ `void SoScaleUniformDragger::startCB` ( `void * f`, `SoDragger * d` ) `[static]`, `[protected]` ✨

References: dragStart(), SoDragger::SoDragger(), and SoScaleUniformDragger().

Referenced by SoScaleUniformDragger().

✨ `void SoScaleUniformDragger::motionCB` ( `void * f`, `SoDragger * d` ) `[static]`, `[protected]` ✨

References: drag(), SoDragger::SoDragger(), and SoScaleUniformDragger().

Referenced by SoScaleUniformDragger().

✨ `void SoScaleUniformDragger::finishCB` ( `void * f`, `SoDragger * d` ) `[static]`, `[protected]` ✨

References: dragFinish(), SoDragger::SoDragger(), and SoScaleUniformDragger().

Referenced by SoScaleUniformDragger().

✨ `void SoScaleUniformDragger::fieldSensorCB` ( `void * d`, `SoSensor * s` ) `[static]`, `[protected]` ✨

References: SoDragger::getMotionMatrix(), SbMatrix::getTransform(), scaleFactor, SoDragger::setMotionMatrix(), SbMatrix::setTransform(), and SoScaleUniformDragger().

Referenced by setUpConnections(), and SoScaleUniformDragger().

✨ `void SoScaleUniformDragger::valueChangedCB` ( `void * f`, `SoDragger * d` ) `[static]`, `[protected]` ✨

References: SoFieldSensor::attach(), SoFieldSensor::detach(), fieldSensor, SoDragger::getMotionMatrix(), SbMatrix::getTransform(), scaleFactor, SoDragger::SoDragger(), and SoScaleUniformDragger().

Referenced by SoScaleUniformDragger().

✨ `void SoScaleUniformDragger::dragStart` ( `void` ) `[protected]` ✨

Called when the dragger is selected (picked) by the user. So like, the moment of being chosen. Main character energy. ⭐

References: SoDragger::getLocalStartingPoint(), lineProj, and SoInteractionKit::setSwitchValue().

Referenced by startCB().

✨ `void SoScaleUniformDragger::drag` ( `void` ) `[protected]` ✨

Called when the user drags the mouse after picking the dragger. Here we go, bestie. 🔥

References: SoDragger::appendScale(), SbVec3f::dot(), SoDragger::getLocalStartingPoint(), SoDragger::getLocalToWorldMatrix(), SoDragger::getNormalizedLocaterPosition(), SoDragger::getStartMotionMatrix(), SoDragger::getViewVolume(), SbVec3f::length(), lineProj, and SoDragger::setMotionMatrix().

Referenced by motionCB().

✨ `void SoScaleUniformDragger::dragFinish` ( `void` ) `[protected]` ✨

Called when the mouse button is released after picking and interacting with the dragger. That's a wrap. 🎀

References: SoInteractionKit::setSwitchValue().

Referenced by finishCB().

💜 Member Data Documentation 💜

✨ `SoSFVec3f SoScaleUniformDragger::scaleFactor` ✨

Continuously updated to contain the current vector of scaling along the X, Y and Z axes. Three axes, always keeping her receipts. ✨

Referenced by fieldSensorCB(), setUpConnections(), SoScaleUniformDragger(), and valueChangedCB().

✨ `SoFieldSensor* SoScaleUniformDragger::fieldSensor` `[protected]` ✨

Referenced by setUpConnections(), SoScaleUniformDragger(), valueChangedCB(), and ~SoScaleUniformDragger().

✨ `SbLineProjector* SoScaleUniformDragger::lineProj` `[protected]` ✨

Referenced by drag(), dragStart(), SoScaleUniformDragger(), and ~SoScaleUniformDragger().

🌈 Author 🌈

Generated automatically by Doxygen for Coin from the source code.

And that's the whole page, bestie! 🫶 This one came from Coin, Version 2.5.0, and it's the SoScaleUniformDragger(3) manpage. Go forth and scale uniformly, you gorgeous genius. 💅✨🎀

📦 where this page comes from

fedora 43: Coin2-devel 2.5.0-52.fc43 · GPL-2.0-only
fedora 43: Coin2-devel 2.5.0-52.fc43 · GPL-2.0-only
fedora 44: Coin2-devel 2.5.0-54.fc44 · GPL-2.0-only
fedora 44: Coin2-devel 2.5.0-54.fc44 · GPL-2.0-only
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-14: a language model's rewrite of the original, under its terms

SoScaleUniformDragger(3)

✨ NAME ✨

🦋 SYNOPSIS 🦋

💖 Public Member Functions 💖

🧚 Public Member Functions inherited from SoDragger

🌸 Public Member Functions inherited from SoInteractionKit

👑 Public Member Functions inherited from SoBaseKit

💜 Public Member Functions inherited from SoNode

🌈 Public Member Functions inherited from SoFieldContainer

🎀 Public Member Functions inherited from SoBase

⭐ Static Public Member Functions ⭐

🍓 Static Public Member Functions inherited from SoDragger

🫶 Static Public Member Functions inherited from SoInteractionKit

🌸 Static Public Member Functions inherited from SoBaseKit

🦋 Static Public Member Functions inherited from SoNode

Static Public Member Functions inherited from SoFieldContainer 💅

Static Public Member Functions inherited from SoBase 💅

Public Attributes 👑

Public Attributes inherited from SoDragger 🎀

Public Attributes inherited from SoInteractionKit 🎀

Protected Member Functions 💖

Protected Member Functions inherited from SoDragger 💖

Protected Member Functions inherited from SoInteractionKit 💖

Protected Member Functions inherited from SoBaseKit 💖

Protected Member Functions inherited from SoNode 💖

Protected Member Functions inherited from SoFieldContainer 💖

Protected Member Functions inherited from SoBase 💖

Static Protected Member Functions ✨

Static Protected Member Functions inherited from SoDragger ✨

Static Protected Member Functions inherited from SoInteractionKit ✨

Static Protected Member Functions inherited from SoBaseKit ✨

Static Protected Member Functions inherited from SoNode ✨

Static Protected Member Functions inherited from SoBase ✨

Protected Attributes 🦋

Protected Attributes inherited from SoDragger 🦋

Protected Attributes inherited from SoInteractionKit 🦋

Protected Attributes inherited from SoBaseKit 🦋

Protected Attributes inherited from SoNode 🦋

Protected Attributes inherited from SoFieldContainer 🦋

Additional Inherited Members 🌈

Public Types inherited from SoDragger 👑

Public Types inherited from SoInteractionKit 👑

Public Types inherited from SoNode 👑

Protected Types inherited from SoBase 🧚

Static Protected Attributes inherited from SoNode ⭐

Detailed Description 💜

💖 Constructor & Destructor Documentation 💖

✨ SoScaleUniformDragger::SoScaleUniformDragger ( void ) ✨

✨ SoScaleUniformDragger::~SoScaleUniformDragger ( ) [protected] ✨

🌸 Member Function Documentation 🌸

✨ SoType SoScaleUniformDragger::getTypeId ( void ) const [virtual] ✨

✨ const SoFieldData * SoScaleUniformDragger::getFieldData ( void ) const [protected], [virtual] ✨

✨ const SoNodekitCatalog * SoScaleUniformDragger::getNodekitCatalog ( void ) const [virtual] ✨

✨ SbBool SoScaleUniformDragger::setUpConnections ( SbBool onoff, SbBool doitalways = 0 ) [protected], [virtual] ✨

✨ void SoScaleUniformDragger::startCB ( void * f, SoDragger * d ) [static], [protected] ✨

✨ void SoScaleUniformDragger::motionCB ( void * f, SoDragger * d ) [static], [protected] ✨

✨ void SoScaleUniformDragger::finishCB ( void * f, SoDragger * d ) [static], [protected] ✨

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

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

✨ void SoScaleUniformDragger::dragStart ( void ) [protected] ✨

✨ void SoScaleUniformDragger::drag ( void ) [protected] ✨

✨ void SoScaleUniformDragger::dragFinish ( void ) [protected] ✨

💜 Member Data Documentation 💜

✨ SoSFVec3f SoScaleUniformDragger::scaleFactor ✨

✨ SoFieldSensor* SoScaleUniformDragger::fieldSensor [protected] ✨

✨ SbLineProjector* SoScaleUniformDragger::lineProj [protected] ✨

🌈 Author 🌈

✨ `SoScaleUniformDragger::SoScaleUniformDragger` ( `void` ) ✨

✨ `SoScaleUniformDragger::~SoScaleUniformDragger` ( ) `[protected]` ✨

✨ `SoType SoScaleUniformDragger::getTypeId` ( `void` ) `const` `[virtual]` ✨

✨ `const SoFieldData * SoScaleUniformDragger::getFieldData` ( `void` ) `const` `[protected]`, `[virtual]` ✨

✨ `const SoNodekitCatalog * SoScaleUniformDragger::getNodekitCatalog` ( `void` ) `const` `[virtual]` ✨

✨ `SbBool SoScaleUniformDragger::setUpConnections` ( `SbBool onoff`, `SbBool doitalways = 0` ) `[protected]`, `[virtual]` ✨

✨ `void SoScaleUniformDragger::startCB` ( `void * f`, `SoDragger * d` ) `[static]`, `[protected]` ✨

✨ `void SoScaleUniformDragger::motionCB` ( `void * f`, `SoDragger * d` ) `[static]`, `[protected]` ✨

✨ `void SoScaleUniformDragger::finishCB` ( `void * f`, `SoDragger * d` ) `[static]`, `[protected]` ✨

✨ `void SoScaleUniformDragger::fieldSensorCB` ( `void * d`, `SoSensor * s` ) `[static]`, `[protected]` ✨

✨ `void SoScaleUniformDragger::valueChangedCB` ( `void * f`, `SoDragger * d` ) `[static]`, `[protected]` ✨

✨ `void SoScaleUniformDragger::dragStart` ( `void` ) `[protected]` ✨

✨ `void SoScaleUniformDragger::drag` ( `void` ) `[protected]` ✨

✨ `void SoScaleUniformDragger::dragFinish` ( `void` ) `[protected]` ✨

✨ `SoSFVec3f SoScaleUniformDragger::scaleFactor` ✨

✨ `SoFieldSensor* SoScaleUniformDragger::fieldSensor` `[protected]` ✨

✨ `SbLineProjector* SoScaleUniformDragger::lineProj` `[protected]` ✨