SbSpherePlaneProjector(3)

💖 SbSpherePlaneProjector(3) 💖

okay bestie, gather round, because today we're reading the manual page for SbSpherePlaneProjector — that's a Library Functions Manual situation, and honestly? it's giving projector royalty. 👑

---

✨ NAME ✨

The SbSpherePlaneProjector class projects 2D points to a half-sphere and a plane. no cap, that's literally the whole job description. 🎀

---

🌸 SYNOPSIS 🌸

#include <Inventor/projectors/SbSpherePlaneProjector.h>

Inherits SbSphereSectionProjector. so it's part of the projector family tree, and it inherited some absolutely iconic genes. 💅

🫶 Public Member Functions

• SbSpherePlaneProjector(const float edgetol=0.9f, const SbBool orienttoeye=1) — default-ish constructor vibe.
• SbSpherePlaneProjector(const SbSphere &sph, const float edgetol=0.9f, const SbBool orienttoeye=1) — constructor where you hand it the sphere yourself.
• virtual SbProjector * copy(void) const — makes a duplicate of this projector.
• virtual SbVec3f project(const SbVec2f &point) — turns your 2D point into a 3D point.
• virtual SbRotation getRotation(const SbVec3f &point1, const SbVec3f &point2) — the rotation that takes point1 to point2.

🌈 Public Member Functions inherited from SbSphereSectionProjector

• SbSphereSectionProjector(const float edgetol=0.9f, const SbBool orienttoeye=1)
• SbSphereSectionProjector(const SbSphere &sph, const float edgetol=0.9f, const SbBool orienttoeye=1)
• void setTolerance(const float edgetol)
• float getTolerance(void) const
• void setRadialFactor(const float rad=0.0f)
• float getRadialFactor(void) const
• SbBool isWithinTolerance(const SbVec3f &point)

🌈 Public Member Functions inherited from SbSphereProjector

• SbVec3f projectAndGetRotation(const SbVec2f &point, SbRotation &rot)
• void setSphere(const SbSphere &sph)
• const SbSphere & getSphere(void) const
• void setOrientToEye(const SbBool orienttoeye)
• SbBool isOrientToEye(void) const
• void setFront(const SbBool infront)
• SbBool isFront(void) const
• SbBool isPointInFront(const SbVec3f &point) const
• virtual void setWorkingSpace(const SbMatrix &space)

🌈 Public Member Functions inherited from SbProjector

• virtual void setViewVolume(const SbViewVolume &vol)
• const SbViewVolume & getViewVolume(void) const
• const SbMatrix & getWorkingSpace(void) const

🧚 Protected Member Functions

• SbRotation getRotation(const SbVec3f &point1, const SbBool tol1, const SbVec3f &point2, const SbBool tol2) — the internal one that also takes tolerance flags.

🧚 Protected Member Functions inherited from SbSphereSectionProjector

• virtual void setupTolerance(void)

🧚 Protected Member Functions inherited from SbSphereProjector

• SbSphereProjector(const SbBool orienttoeye)
• SbSphereProjector(const SbSphere &s, const SbBool orienttoeye)
• SbBool intersectSphereFront(const SbLine &l, SbVec3f &result)

🧚 Protected Member Functions inherited from SbProjector

• SbProjector(void)
• virtual ~SbProjector()
• SbLine getWorkingLine(const SbVec2f &point) const
• float findVanishingDistance(void) const
• SbBool verifyProjection(const SbVec3f &projpt) const

👑 Additional Inherited Members

👑 Protected Attributes inherited from SbSphereSectionProjector

• float tolerance
• float tolDist
• float radialFactor
• SbVec3f planePoint
• SbVec3f planeDir
• float planeDist
• SbPlane tolPlane

👑 Protected Attributes inherited from SbSphereProjector

• SbBool intersectFront
• SbSphere sphere
• SbBool orientToEye
• SbBool needSetup
• SbVec3f lastPoint

👑 Protected Attributes inherited from SbProjector

• SbViewVolume viewVol
• SbMatrix worldToWorking
• SbMatrix workingToWorld

---

🦋 Detailed Description 🦋

The SbSpherePlaneProjector class projects 2D points to a half-sphere and a plane.

This projector uses a plane along with the half-sphere of SbSphereSectionProjector for projections. If the 2D point mapping "misses" the sphere section, the 3D point will be projected onto the plane. like... it's got a backup plan, bestie. the plane is the safety net. 💅

See also

• SbCylinderPlaneProjector

---

🎀 Constructor & Destructor Documentation 🎀

SbSpherePlaneProjector::SbSpherePlaneProjector(const float edgetol = 0.9f, const SbBool orienttoeye = 1)

Default constructor. See SbSphereSectionProjector::SbSphereSectionProjector().

Referenced by copy().

SbSpherePlaneProjector::SbSpherePlaneProjector(const SbSphere & sph, const float edgetol = 0.9f, const SbBool orienttoeye = 1)

Constructor with explicit specification of projection sphere. you bring the sphere, it does the projecting. ✨

---

💜 Member Function Documentation 💜

SbProjector * SbSpherePlaneProjector::copy(void ) const [virtual]

Construct and return a copy of this projector. The caller is responsible for destructing the new instance. so like, you made it, you clean it up. 🫶

Note that if the Coin library has been built as a DLL under Microsoft Windows and you use this method from application code, you must make sure that both the Coin DLL and the application executable is using the same instance of a C Run-Time (CRT) library. Otherwise, you will get memory heap corruption upon deallocating the returned instances, eventually leading to mysterious crashes. 💀

Reimplemented from SbSphereSectionProjector.

References SbSpherePlaneProjector().

SbVec3f SbSpherePlaneProjector::project(const SbVec2f & point) [virtual]

Project the 2D point from normalized viewport coordinates to a 3D point. The mapping will be done in accordance with the type of the projector.

Reimplemented from SbSphereSectionProjector.

References SbProjector::getWorkingLine(), SbSphereProjector::intersectSphereFront(), SbSphereSectionProjector::isWithinTolerance(), SbSphereProjector::lastPoint, SbSphereProjector::needSetup, SoDebugError::postWarning(), SbSphereSectionProjector::setupTolerance(), and SbSphereSectionProjector::tolPlane.

SbRotation SbSpherePlaneProjector::getRotation(const SbVec3f & point1, const SbVec3f & point2) [virtual]

Returns rotation on the projection surface which re-orients point1 to point2.

Reimplemented from SbSphereSectionProjector.

References getRotation(), and SbSphereSectionProjector::isWithinTolerance().

Referenced by getRotation().

SbRotation SbSpherePlaneProjector::getRotation(const SbVec3f & point1, const SbBool tol1, const SbVec3f & point2, const SbBool tol2) [protected]

Calculates rotation from point1 to point2, with tol1 and tol2 deciding whether or not to use the tolerance setting.

References SbVec3f::cross(), SbVec3f::dot(), SbSphereSectionProjector::getRotation(), SbRotation::identity(), SbVec3f::length(), SbVec3f::normalize(), SbSphereSectionProjector::planeDir, SbSphereSectionProjector::planePoint, SoDebugError::postWarning(), SbSphereProjector::sphere, and SbSphereSectionProjector::tolDist.

---

⭐ Author ⭐

Generated automatically by Doxygen for Coin from the source code. (yes bestie, a robot wrote the original. we're just here to make it cute. 🤖💖)

---

and that's a wrap, my love! this lil page came straight out of Coin, Version 2.5.0, and its title is SbSpherePlaneProjector(3) — go forth and project, you main character. 🌈👑✨