SOROTOR(3iv)

💫 SoRotor — animated rotation node 💫

okay bestie, we're looking at the SoRotor(3IV) manual page and honestly? she SPINS. let's get into it 🌀

---

🌸 INHERITS FROM 🌸

SoBase > SoFieldContainer > SoNode > SoTransformation > SoRotation >
SoRotor

so she's the baby of the family, descended from SoRotation, and all the way up the tree through SoTransformation, SoNode, SoFieldContainer and finally SoBase. generational talent fr 💅

---

✨ SYNOPSIS ✨

#include <Inventor/nodes/SoRotor.h>

🎀 Fields from class SoRotor

SoSFFloat           speed
SoSFBool            on

🎀 Fields from class SoRotation

SoSFRotation        rotation

🎀 Methods from class SoRotor

                     SoRotor()
static SoType       getClassTypeId()

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

okay so here's the tea ☕ — SoRotor is derived from SoRotation, which means it applies a rotation to the current transformation. that part? basic. the glow-up is that she's animated ✨ by hooking up engines to the realTime global field, the rotation value gets animated over time, and boom — spinning effect. literally main character energy 🌀

wanna adjust how fast she goes? tweak the speed field. that's it. that's the whole period-of-rotation situation.

the current rotation at any given moment lives in the rotation field, which she inherited from SoRotation. you can also set that field to tell her which axis to rotate around.

⚠️ heads up bestie: unless you specify a non-zero rotation for rotation, the node has no clue which axis to use. it just doesn't know. it's giving confused.

so like, if you want your rotor spinning about the y-axis, do this:

rotor->rotation.setValue(axis, 0.1);

where axis is a vector containing (0,1,0). and fr fr, any non-zero angle works in this code. pick your fave, she doesn't mind 💁‍♀️

---

🦋 FIELDS 🦋

• SoSFFloat speed — sets the speed of the rotor, measured in revolutions per second. how fast does she twirl? that's this. 🔥
• SoSFBool on — the on/off switch so your app can enable or disable the motion easily. no drama, just vibes. ⭐

---

🌈 METHODS 🌈

• SoRotor() — creates a rotor node with the default settings. brand new baby rotor, fresh out the box 🎀
• static SoType getClassTypeId() — hands you the type identifier for this class. iykyk. 💅

---

👑 ACTION BEHAVIOR 👑

• SoGLRenderAction, SoCallbackAction, SoGetBoundingBoxAction, SoRayPickAction — concatenates the current rotation value with the current transformation matrix. slay, she's doing the math 🧮✨
• SoGetMatrixAction — returns the transformation matrix specified by the rotation. iconic. 🌟

---

🍓 FILE FORMAT/DEFAULTS 🍓

Rotor {
    rotation  0 0 1  0
    speed     1
    on        TRUE
}

there she is, the whole default vibe. rotation of 0 0 1 0, speed of 1, on set to TRUE. periodt. 💜

---

🧚 SEE ALSO 🧚

• SoPendulum
• SoShuttle

her two besties. go say hi 🫶

---

okay that's the whole page!! thanks for reading my little breakdown of the SoRotor(3IV) manual — the footer just says SoRotor(3IV)() with no date or version attached, so that's all the source/version tea we've got 💀 anyway ily, go make something spin ✨🌀