SBSPHERESECTIONPROJECTOR(3coin2)

📦 version 2.5.0, in fedora 43, fedora 44

🎀 NAME 🎀

SbSphereSectionProjector — bestie, this one is the projector that maps 2D points onto a sliced sphere. That's it, that's the whole job description. 👑

✨ SYNOPSIS ✨

#include <Inventor/projectors/SbSphereSectionProjector.h>

Inherits SbSphereProjector.

Inherited by SbSpherePlaneProjector.

🌸 Public Member Functions 🌸

SbSphereSectionProjector(const float edgetol=0.9f, const SbBool orienttoeye=1) — 💖
SbSphereSectionProjector(const SbSphere &sph, const float edgetol=0.9f, const SbBool orienttoeye=1) — 🫶
virtual SbProjector * copy(void) const — ✨
virtual SbVec3f project(const SbVec2f &point) — 🌈
virtual SbRotation getRotation(const SbVec3f &point1, const SbVec3f &point2) — 💫
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 🛡️

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

🧚 Protected Attributes 🧚

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 💖

So, SbSphereSectionProjector projects 2D points onto a sliced sphere. Iconic behaviour, no notes.

The projection sphere for this class is sliced by a clipping plane, and the projections get mapped onto whatever's left of the sphere. It's giving "sphere but make it a lil slice". 🍰

👀 See also 👀

SbCylinderSectionProjector

🎂 Constructor & Destructor Documentation 🎂

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

Default constructor, bestie. Go check SbSphereProjector::SbSphereProjector() for the family lore.

The edgetol value should be within <0, 1], and it specifies how much of the sphere is used as a projection surface. A 1.0 means the full front half is used. Slay.

References: radialFactor, and tolerance.

Referenced by copy().

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

Constructor where you get to explicitly set the projection sphere. Very main character of you. 🫶

References: radialFactor, and tolerance.

🔥 Member Function Documentation 🔥

`SbProjector * SbSphereSectionProjector::copy(void ) const [virtual]`

Constructs and returns a copy of this projector. Heads up though: the caller is responsible for destructing the new instance. You break it, you bought it. 💀

⚠️ 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. Not the cute kind of mysterious. 😭

Implements SbProjector.

Reimplemented in SbSpherePlaneProjector.

References: SbSphereSectionProjector().

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

Projects the 2D point from normalized viewport coordinates to a 3D point. The mapping gets done in accordance with the type of the projector — so like, let the projector cook. 🔥

Implements SbProjector.

Reimplemented in SbSpherePlaneProjector.

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

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

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

Implements SbSphereProjector.

Reimplemented in SbSpherePlaneProjector.

References: SbSphereProjector::sphere.

Referenced by SbSpherePlaneProjector::getRotation().

`void SbSphereSectionProjector::setTolerance(const float edgetol)`

The edgetol value decides how much of the surface of the sphere is used for projection. A 1.0 means the full sphere half is used. 💅

References: SbSphereProjector::needSetup, and tolerance.

`float SbSphereSectionProjector::getTolerance(void ) const`

Returns the edge tolerance for the sphere half. 🍓

References: tolerance.

`void SbSphereSectionProjector::setRadialFactor(const float rad = 0.0f)`

Sets up the controlling value for how the rotation calculation will be done "outside" the sphere. Ngl, this one's the vibe-setter:

A radialFactor equal to 0.0 will make the rotations be done like if they were done by dragging the sphere.
A value of 1.0 will make the rotation be around the axis from the viewpoint towards the sphere.

References: radialFactor.

`float SbSphereSectionProjector::getRadialFactor(void ) const`

Returns the value of radialFactor. ⭐

`SbBool SbSphereSectionProjector::isWithinTolerance(const SbVec3f & point)`

Checks if point is within the part of the sphere used for projections. 🎯

References: SbSphereProjector::needSetup, planePoint, and setupTolerance().

Referenced by SbSpherePlaneProjector::getRotation(), SbSpherePlaneProjector::project(), and project().

`void SbSphereSectionProjector::setupTolerance(void ) [protected], [virtual]`

Recalculates the internal projection surface settings. 🛠️ You need to do this if any of the parameters influencing the projection surface have been changed from subclasses without using the access methods. Rude, but okay.

References: SbSphereProjector::intersectFront, SbSphereProjector::needSetup, SbSphereProjector::orientToEye, planeDir, planeDist, planePoint, SbSphereProjector::sphere, tolDist, tolerance, tolPlane, SbProjector::viewVol, and SbProjector::worldToWorking.

Referenced by isWithinTolerance(), SbSpherePlaneProjector::project(), and project().

🌈 Member Data Documentation 🌈

`float SbSphereSectionProjector::tolerance [protected]`

Tolerance value, deciding how much of the half-sphere to do projections against. 💫

Referenced by getTolerance(), SbSphereSectionProjector(), SbSphereSectionProjector(), setTolerance(), and setupTolerance().

`float SbSphereSectionProjector::tolDist [protected]`

Tolerance value multiplied with the sphere radius. Math girlies rise. 🧮

Referenced by SbSpherePlaneProjector::getRotation(), and setupTolerance().

`float SbSphereSectionProjector::radialFactor [protected]`

The radialfactor value decides how to calculate rotations outside of the sphere.

`SbVec3f SbSphereSectionProjector::planePoint [protected]`

A point in the plane where the center of the sphere is. 📍

Referenced by SbSpherePlaneProjector::getRotation(), isWithinTolerance(), and setupTolerance().

`SbVec3f SbSphereSectionProjector::planeDir [protected]`

Direction of the cutting plane. ✂️

Referenced by SbSpherePlaneProjector::getRotation(), and setupTolerance().

`float SbSphereSectionProjector::planeDist [protected]`

Distance from the plane to the sphere center. 📏

Referenced by setupTolerance().

`SbPlane SbSphereSectionProjector::tolPlane [protected]`

Defines the plane cutting the sphere into a projection part. 🍰🔪

Referenced by SbSpherePlaneProjector::project(), project(), and setupTolerance().

👑 Author 👑

Generated automatically by Doxygen for Coin from the source code. So like, no human wrote this one, it just manifested. 💅

✨ and that's the whole page, bestie ✨ — brought to you by the Coin girlies, Version 2.5.0, living in the Library Functions Manual as section 3. mwah 💋 🎀🦋💖

📦 where this page comes from

fedora 43: Coin2-devel 2.5.0-52.fc43 · GPL-2.0-only
fedora 43: Coin2-devel 2.5.0-52.fc43 · GPL-2.0-only
fedora 44: Coin2-devel 2.5.0-54.fc44 · GPL-2.0-only
fedora 44: Coin2-devel 2.5.0-54.fc44 · GPL-2.0-only
💖 girlified by deepseek-ai/DeepSeek-V4.1-Flash on 2026-10-14: a language model's rewrite of the original, under its terms