SBPLANEPROJECTOR(3iv)

💅 SbPlaneProjector(3IV) — plane projector 💅

okay so bestie, this is the SbPlaneProjector(3IV) page from the 3IV manual, and it's lowkey one of the cutest little projectors in the whole Inventor toolkit. sit down, grab a boba, we're projecting a mouse onto a plane and it's gonna be iconic 💖

---

🎀 NAME 🎀

SbPlaneProjector — plane projector. that's it, that's the whole vibe, she projects onto a plane and she does it beautifully ✨

---

🌸 INHERITS FROM 🌸

SbProjector > SbPlaneProjector

so yeah, she's a SbProjector at heart — she inherits all the projector energy from her parent class and then adds her own plane-flavored main character moments on top 🫶

---

✨ SYNOPSIS ✨

       #include <Inventor/projectors/SbPlaneProjector.h>

          Methods from class SbPlaneProjector:

                         SbPlaneProjector(SbBool orient = FALSE)
                         SbPlaneProjector(const SbPlane &plane, SbBool orient =
                              FALSE)
                         ~SbPlaneProjector()
     void                setPlane(const SbPlane &plane)
     const SbPlane &     getPlane() const
     void                setOrientToEye(SbBool orientToEye)
     SbBool              isOrientToEye() const
     virtual SbVec3f     getVector(const SbVec2f &mousePosition1, const SbVec2f
                              &mousePosition2)
     virtual SbVec3f     getVector(const SbVec2f &mousePosition)
     void                setStartPosition(const SbVec2f &mousePosition)
     void                setStartPosition(const SbVec3f &point)

          Methods from class SbProjector:

     virtual SbVec3f        project(const SbVec2f &point)
     virtual void           setViewVolume(const SbViewVolume &vol)
     const SbViewVolume &   getViewVolume() const
     virtual void           setWorkingSpace(const SbMatrix &space)
     const SbMatrix &       getWorkingSpace() const
     virtual SbProjector *  copy() const

---

🌈 DESCRIPTION 🌈

SbPlaneProjector projects the mouse onto a plane. that's the whole job bestie, and she's obsessed with it 💅

this is typically used to write interactive 3D manipulators and viewers. so like, when you drag something around in a 3D scene and it just knows where your mouse is pointing — yeah, that's this girl working behind the scenes ✨

---

🔥 METHODS 🔥

🦋 SbPlaneProjector(SbBool orient = FALSE)

Constructor. the default plane passes through the origin and is oriented perpendicular to the Z axis. so if you just roll up with no arguments, you get the classic, the standard, the default serve 🎀

🦋 SbPlaneProjector(const SbPlane &plane, SbBool orient = FALSE)

Constructor which is passed a plane. if orient to eye is TRUE, the plane will be reoriented to the eye 👁️✨

🦋 ~SbPlaneProjector()

Destructor. she said bye bestie, clean up after yourself 💖

🦋 void setPlane(const SbPlane &plane) / const SbPlane & getPlane() const

Set and get the plane to use. simple as that, no notes 👑

🦋 void setOrientToEye(SbBool orientToEye) / SbBool isOrientToEye() const

Set and get whether the projector should be oriented towards the eye. if orientToEye is set to TRUE, the given plane's direction is ignored, and the plane will be oriented to the eye. it will pass through the same point from the origin defined by the original dir * dist. set to FALSE if the plane's direction should remain in working space. so like, TRUE = eye-coded, FALSE = working-space-coded, pick your fighter 🙈

🦋 virtual SbVec3f getVector(const SbVec2f &mousePosition1, const SbVec2f &mousePosition2)

Get a vector on this plane given two normalized mouse positions. two points, one vector, math is serving 🌸

🦋 virtual SbVec3f getVector(const SbVec2f &mousePosition)

Get a vector given the current mouse point. uses the last point on this projector from the previous call to getVector() or setStartPostion().

⚠️ do not use this if the working space transform is changing since the new point will be in a different space than the old one. fr fr, that's not a vibe, that's a bug waiting to happen 💀

🦋 void setStartPosition(const SbVec2f &mousePosition)

Set the initial mouse position. gotta have a starting point, it's giving origin story ✨

🦋 void setStartPosition(const SbVec3f &point)

Set the initial position from a point on the projector. now she's anchored in 3D and she's thriving 🫶

---

👑 SEE ALSO 👑

• SbCylinderProjector
• SbCylinderPlaneProjector
• SbCylinderSectionProjector
• SbCylinderSheetProjector
• SbLineProjector
• SbSpherePlaneProjector
• SbSphereProjector
• SbSphereSectionProjector
• SbSphereSheetProjector

the whole projector friend group honestly, they all hang out, they all slay 🌈

---

and that's the page bestie!! the footer at the bottom just echoes SbPlaneProjector(3IV)() right back at you — same title, same manual, and the date slot is just sitting there empty like it's too cool to commit 💀 but the source is the 3IV manual and the name is SbPlaneProjector(3IV), so you know exactly where this came from. periodt 💅✨🎀