SOSCALE2UNIFORMDRAGGER(3iv)

📦 version 2.1.6.1, in debian bookworm, debian trixie, ubuntu jammy, ubuntu noble, ubuntu questing, ubuntu resolute, ubuntu stonking

💖 NAME 💖

SoScale2UniformDragger — ok so bestie, this is the object you can scale uniformly in two dimensions by dragging with the mouse 🖱️✨

🌸 INHERITS FROM 🌸

SoBase > SoFieldContainer > SoNode > SoBaseKit > SoInteractionKit > SoDragger > SoScale2UniformDragger

✨ SYNOPSIS ✨

#include <Inventor/draggers/SoScale2UniformDragger.h>

🎀 Fields from class SoScale2UniformDragger

  • SoSFVec3f scaleFactor

🎀 Fields from class SoDragger

  • SoSFBool isActive

🎀 Fields from class SoInteractionKit

  • SoSFEnum renderCaching
  • SoSFEnum boundingBoxCaching
  • SoSFEnum renderCulling
  • SoSFEnum pickCulling

🎀 Parts from class SoBaseKit

  • (SoNodeKitListPart) callbackList

🎀 Methods from class SoScale2UniformDragger

  • SoScale2UniformDragger()
  • static const SoNodekitCatalog * getClassNodekitCatalog() const
  • static SoType getClassTypeId()

🎀 Methods from class SoDragger

  • void addStartCallback(SoDraggerCB *f, void *userData = NULL)
  • void removeStartCallback(SoDraggerCB *f, void *userData = NULL)
  • void addMotionCallback(SoDraggerCB *f, void *userData = NULL)
  • void removeMotionCallback(SoDraggerCB *f, void *userData = NULL)
  • void addFinishCallback(SoDraggerCB *f, void *userData = NULL)
  • void removeFinishCallback(SoDraggerCB *f, void *userData = NULL)
  • void addValueChangedCallback(SoDraggerCB *f, void *userData = NULL)
  • void removeValueChangedCallback(SoDraggerCB *f, void *userData = NULL)
  • SbBool enableValueChangedCallbacks()
  • void setMinGesture(int pixels)
  • int getMinGesture() const
  • static void setMinScale(float newMinScale)
  • static float getMinScale()

🎀 Methods from class SoInteractionKit

  • virtual SbBool setPartAsPath(const SbName &partName, SoPath *surrogatePath )

🎀 Methods from class SoBaseKit

  • virtual const SoNodekitCatalog * getNodekitCatalog() const
  • 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)
  • virtual SbBool setPart(const SbName &partName, SoNode *newPart)
  • SbBool set(char *partName, char *parameters)
  • SbBool set(char *nameValuePairs)
  • static SbBool isSearchingChildren()
  • static void setSearchingChildren(SbBool newVal)

🎀 Methods from class SoNode

  • void setOverride(SbBool state)
  • SbBool isOverride() const
  • SoNode * copy(SbBool copyConnections = FALSE) const
  • virtual SbBool affectsState() const
  • static SoNode * getByName(const SbName &name)
  • static int getByName(const SbName &name, SoNodeList &list)

🎀 Methods from class SoFieldContainer

  • void setToDefaults()
  • SbBool hasDefaultValues() const
  • SbBool fieldsAreEqual(const SoFieldContainer *fc) const
  • void copyFieldValues(const SoFieldContainer *fc, SbBool copyConnections = FALSE)
  • void get(SbString &fieldDataString)
  • virtual int getFields(SoFieldList &resultList) const
  • virtual SoField * getField(const SbName &fieldName) const
  • SbBool getFieldName(const SoField *field, SbName &fieldName) const
  • SbBool isNotifyEnabled() const
  • SbBool enableNotify(SbBool flag)

🎀 Methods from class SoBase

  • void ref()
  • void unref() const
  • void unrefNoDelete() const
  • void touch()
  • virtual SoType getTypeId() const
  • SbBool isOfType(SoType type) const
  • virtual void setName(const SbName &name)
  • virtual SbName getName() const

🎀 Macros from class SoBaseKit

  • SO_GET_PART(kit, partName, partClass)
  • SO_CHECK_PART(kit, partName, partClass)

💅 DESCRIPTION 💅

ok so SoScale2UniformDragger is a simple dragger that scales uniformly in the x and y dimensions when you drag it within the x-y plane with the mouse. no cap 🖱️✨

The local space? It's determined by its location in the scene graph, bestie. Transformation nodes placed before it will affect both the dragger AND the plane of motion — the way that they're linked like that? iconic. 👑

This node has a scaleFactor field which always reflects its size in local space. Set the field → the dragger changes accordingly, simple as that. You can also connect fields of other nodes or engines from this one to make them follow the dragger's motion. chain reaction vibes 🔥

This dragger contains four parts: scaler, scalerActive, feedback, and feedbackActive. 🎀

Each of these is set by default from a resource described in the Dragger Resource section of the online reference page for this class. Wanna change the parts in any instance of this dragger? Use setPart(). easy 💅

Wanna make your program use different default resources for the parts? Slay, here's the move: copy the file

/usr/share/data/draggerDefaults/scale2UniformDragger.iv

into your own directory, edit the file, and then set the environment variable SO_DRAGGER_DIR to be a path to that directory. that's it, that's the whole ritual 🦋

🦋 FIELDS 🦋

  • SoSFVec3f scaleFactor — the scale factor affecting the dragger. that's the one, bestie 💖

⭐ METHODS ⭐

  • SoScale2UniformDragger() — the constructor, aka the birth of your dragger 🌱
  • static const SoNodekitCatalog * getClassNodekitCatalog() const — returns an SoNodekitCatalog for this class 📖
  • static SoType getClassTypeId() — returns the type identifier for this class 🏷️

👑 CATALOG PARTS 👑

✨ All parts ✨

  • callbackList — Part Type: NodeKitListPart, Default Type: --, NULL by Default: yes
  • scaler — Part Type: Separator, Default Type: --, NULL by Default: yes
  • scalerActive — Part Type: Separator, Default Type: --, NULL by Default: yes
  • feedback — Part Type: Separator, Default Type: --, NULL by Default: yes
  • feedbackActive — Part Type: Separator, Default Type: --, NULL by Default: yes

✨ Extra information for list parts from above table ✨

  • callbackList — Container Type: Separator, Permissible Types: Callback, EventCallback

🌈 DRAGGER RESOURCES 🌈

  • Resource: scale2UniformScaler
    • Part: scaler
    • Appearance: white outline of square with photo-corner shapes at vertices. Lies within plane of motion
    • Description: picking this initiates the scaling ✋
  • Resource: scale2UniformScalerActive
    • Part: scalerActive
    • Appearance: yellow version of scaler, but with an extra yellow surrounding box 💛
    • Description: displayed instead of scaler while in motion
  • Resource: scale2UniformFeedback
    • Part: feedback
    • Appearance: thin purple 3-D crosshair 💜
    • Description: shows center of scale when still
  • Resource: scale2UniformFeedbackActive
    • Part: feedbackActive
    • Appearance: thin, slightly brighter purple 3-D crosshair 💜✨
    • Description: shows center of scale while in motion

🎀 FILE FORMAT/DEFAULTS 🎀

Scale2UniformDragger {
   renderCaching       AUTO
   boundingBoxCaching  AUTO
   renderCulling       AUTO
   pickCulling         AUTO
   isActive            FALSE
   scaleFactor         1 1 1
   callbackList        NULL
   scaler              <scale2UniformScaler resource>
   scalerActive        <scale2UniformScalerActive resource>
   feedback            <scale2UniformFeedback resource>
   feedbackActive      <scale2UniformFeedbackActive resource>
}

💖 SEE ALSO 💖

  • SoInteractionKit
  • SoDragger
  • SoCenterballDragger
  • SoDirectionalLightDragger
  • SoDragPointDragger
  • SoHandleBoxDragger
  • SoJackDragger
  • SoPointLightDragger
  • SoRotateCylindricalDragger
  • SoRotateDiscDragger
  • SoRotateSphericalDragger
  • SoScale1Dragger
  • SoScale2Dragger
  • SoScaleUniformDragger
  • SoSpotLightDragger
  • SoTabBoxDragger
  • SoTabPlaneDragger
  • SoTrackballDragger
  • SoTransformBoxDragger
  • SoTransformerDragger
  • SoTranslate1Dragger
  • SoTranslate2Dragger

and that's the whole page, bestie 🫶 this was SoScale2UniformDragger(3IV)() — go scale something uniform, ily, bye 💖✨🎀

📦 where this page comes from