SOHANDLEBOXMANIP(3iv)

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

💅 SoHandleBoxManip — from the 3IV manual, bestie

okay so picture this: you're in Open Inventor, you've got a scene graph, and you need a lil 3D gizmo that lets you drag scale and translation around like it's a TikTok transition. That's this. That's the whole vibe. Let's go. 🎀

✨ NAME ✨

SoHandleBoxManip — a transform node with a 3D Interface for Editing ScaleFactor and Translation. 💖

🌸 INHERITS FROM 🌸

SoBase > SoFieldContainer > SoNode > SoTransformation > SoTransform >
SoTransformManip > SoHandleBoxManip

yeah she's got a whole ancestry, generational wealth of node classes, we love a lineage 👑

🦋 SYNOPSIS 🦋

#include <Inventor/manips/SoHandleBoxManip.h>

⭐ Fields from class SoTransform

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

⭐ Methods from class SoHandleBoxManip

  • SoHandleBoxManip()
  • static SoType — getClassTypeId()

⭐ Methods from class SoTransformManip

  • SoDragger * — getDragger()
  • SbBool — replaceNode(SoPath *p)
  • SbBool — replaceManip(SoPath *p, SoTransform *newOne) const

⭐ Methods from class SoTransform

  • void — pointAt(const SbVec3f &fromPoint, const SbVec3f &toPoint)
  • void — getScaleSpaceMatrix(SbMatrix &mat, SbMatrix &inv) const
  • void — getRotationSpaceMatrix(SbMatrix &mat, SbMatrix &inv) const
  • void — getTranslationSpaceMatrix(SbMatrix &mat, SbMatrix &inv) const
  • void — multLeft(const SbMatrix &mat)
  • void — multRight(const SbMatrix &mat)
  • void — combineLeft(SoTransformation *nodeOnRight)
  • void — combineRight(SoTransformation *nodeOnLeft)
  • void — setMatrix(const SbMatrix &mat)
  • void — recenter(const SbVec3f &newCenter)

⭐ 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)
  • SbBool — set(const char *fieldDataString)
  • 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

👑 DESCRIPTION 👑

SoHandleBoxManip is derived from SoTransform (by way of SoTransformManip, so like, it's the child of a child, very nepo baby of it honestly 💅). When its fields change, nodes following it in the scene graph rotate, scale, and/or translate. ✨

As a subclass of SoTransformManip, this manip also has a 3D interface to edit some of its fields. In this case? The interface edits the scaleFactor and translation fields. That's the assignment, and she ate. 🍓

🫶 A manipulator differs from a dragger. When you move a dragger, no other nodes are affected. When you move an SoTransformManip, other nodes move along with it. (See the reference page for SoTransformManip.)

The interface for an SoHandleBoxManip is exactly the same as that of the SoHandleBoxDragger. To find out more about the interface, go read the reference page for SoHandleBoxDragger. And to find out how the manipulator uses a dragger to provide its interface, go read the reference page for SoTransformManip. iykyk 📚

On screen, this manip will surround the objects influenced by its motion. Why? Because it turns on the surroundScale part of the dragger (see the reference page for SoSurroundScale). It's giving main character energy, obviously — it's literally surrounding the whole scene. 💀

🧚 METHODS 🧚

  • SoHandleBoxManip() — Constructor. Makes the thing. That's it, that's the whole job, and she does it flawlessly. 🎀
  • static SoType getClassTypeId() — Returns the type identifier for this class. Your lil name tag at the function party. 🏷️

🌈 FILE FORMAT/DEFAULTS 🌈

HandleBoxManip {
    translation       0 0 0
    rotation          0 0 1  0
    scaleFactor       1 1 1
    scaleOrientation  0 0 1  0
    center            0 0 0
}

no cap, these are the defaults, and they are immaculate: nothing moved, nothing rotated, nothing scaled, everything centered. the neutral pose. the resting face. 😌

⭐ SEE ALSO ⭐

  • SoCenterballManip
  • SoHandleBoxDragger
  • SoJackManip
  • SoTabBoxManip
  • SoTrackballManip
  • SoTransformBoxManip
  • SoTransformerManip
  • SoTransform
  • SoTransformManip

and that's the whole page, bestie 🫶 the footer just says SoHandleBoxManip(3IV)() all over again — no version number, no date, just vibes and a page number. so here's my sign-off instead: stay iconic, keep your scale factor at 1 1 1, and go surround some objects. mwah. 💖✨🌸

📦 where this page comes from