SBCYLINDERSECTIONPROJECTOR(3iv)

💖 SbCylinderSectionProjector(3IV) 💖

okay bestie, sit down, hydrate, and let me tell you about the cylinder-section projector from the <Inventor/projectors/SbCylinderSectionProjector.h> cinematic universe. this is a real one. no cap.

---

✨ INHERITS FROM ✨

it's giving royalty, because the family tree goes:

SbProjector > SbCylinderProjector > SbCylinderSectionProjector

three generations of projector excellence. main character energy, honestly. 👑

---

🌸 SYNOPSIS 🌸

first things first, you gotta let the compiler know you're locked in:

#include <Inventor/projectors/SbCylinderSectionProjector.h>

🎀 Methods from class SbCylinderSectionProjector:

                     SbCylinderSectionProjector(float edgeTol = .9, SbBool
                          orientToEye = TRUE)
                     SbCylinderSectionProjector(const SbCylinder &cyl,
                          float edgeTol = .9, SbBool orientToEye = TRUE)
                     ~SbCylinderSectionProjector()
 void                setTolerance(float edgeTol)
 float               getTolerance() const
 SbBool              isWithinTolerance(const SbVec3f &point)

🦋 Methods from class SbCylinderProjector:

 SbVec3f             projectAndGetRotation(const SbVec2f &point, SbRotation
                          &rot)
 virtual SbRotation  getRotation(const SbVec3f &point1, const SbVec3f
                          &point2)
 void                setCylinder(const SbCylinder &cyl)
 const SbCylinder &  getCylinder() const
 void                setOrientToEye(SbBool orientToEye)
 SbBool              isOrientToEye() const
 void                setFront(SbBool isFront)
 SbBool              isFront() const
 SbBool              isPointInFront(const SbVec3f &point) const

💜 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 🔥

so what does this thing actually do? SbCylinderSectionProjector takes a point in window space (usually wherever your mouse is at, bestie) and projects it onto the section of a cylinder that's been sliced by a plane. and then — plot twist — two projected points can produce a rotation along the cylinder's axis. obsessed.

the tolerance slice can be specified as a fraction of the radius of the cylinder. and important: the projection point will not extend beyond the sliced portion of the cylinder. it stays in its lane. periodt.

incremental changes (aka delta rotation) can be computed during interactive sessions. cylinder projectors are typically used to write interactive 3D manipulators and viewers — so if you're building one of those, this is your girl. 💅

---

💅 METHODS 💅

🌈 SbCylinderSectionProjector(float edgeTol = .9, SbBool orientToEye = TRUE)

🌈 SbCylinderSectionProjector(const SbCylinder &cyl, float edgeTol = .9, SbBool orientToEye = TRUE)

constructors, babes. here's the tea:

• the first one uses a default cylinder aligned with the Y axis with radius 1.0.
• the second one? you supply the cylinder yourself, cyl.

the position of the plane that slices the cylinder into a section is specified as a fraction of the cylinder radius with the parameter edgeTol. let's break it down:

• a tolerance value of 1.0 positions the plane down the center of the cylinder.
• a tolerance value of 0.5 defines the longitudinal plane halfway between the center and the outside edge of the cylinder.
• the default value is .9, so that almost half the cylinder is in front of the plane. cute.

the orientToEye parameter determines whether the plane is perpendicular to the eye, or perpendicular to the cylinder's Z axis. setting that parameter to TRUE (which is the default) specifies that the plane be perpendicular to the eye — which is most often the desired behavior. trust. 🫶

the default view volume is undefined, and the working space is identity. noted.

🌈 ~SbCylinderSectionProjector()

destructor. she's done, she's logging off, she's cleaning up after herself. bye bestie 👋

🌈 void setTolerance(float edgeTol)

🌈 float getTolerance() const

set and get the edge tolerance as a fraction of the radius of the cylinder. let's do the math:

• if this is 1.0, the projector is a half cylinder.
• if this is .1, the projector is a slice of the cylinder with radius .1*radius.

default is .9. slay. ✨

🌈 SbBool isWithinTolerance(const SbVec3f &point)

find whether this point on the cylinder or tolerance plane is within tolerance. a lil vibe check for your point. 💖

---

🧚 SEE ALSO 🧚

your other faves, the whole friend group:

• SbCylinderPlaneProjector
• SbCylinderSheetProjector
• SbLineProjector
• SbPlaneProjector
• SbSpherePlaneProjector
• SbSphereProjector
• SbSphereSectionProjector
• SbSphereSheetProjector

---

and that's the whole page, bestie!! 🎀 this was SbCylinderSectionProjector(3IV) — the (3IV) manual, and the footer literally just says SbCylinderSectionProjector(3IV)() because it's got no extra source or date tea to spill. iconic of her honestly. go forth and project some cylinders. 💜