SBSPHERESECTIONPROJECTOR(3coin3)

📦 version 3.1.3, in fedora 43, fedora 44

💖 SbSphereSectionProjector 💖

okay bestie, welcome to the Coin Library Functions Manual page for SbSphereSectionProjector(3) — that's the whole title, no cap, we're not skipping a single crumb 🍓

✨ NAME ✨

SbSphereSectionProjector — the icon that projects 2D points onto a sliced sphere 🎀

🌈 SYNOPSIS 🌈

#include <Inventor/projectors/SbSphereSectionProjector.h>

Inherits SbSphereProjector.

Inherited by SbSpherePlaneProjector.

👑 Public Member Functions

  • SbSphereSectionProjector(const float edgetol = 0.9f, const SbBool orienttoeye = TRUE)
  • SbSphereSectionProjector(const SbSphere &sph, const float edgetol = 0.9f, const SbBool orienttoeye = TRUE)
  • 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
  • virtual SbBool tryProject(const SbVec2f &point, const float epsilon, SbVec3f &result)

🔒 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 🌟

The SbSphereSectionProjector projects 2D points to a sliced sphere. yes, a sphere that got a slice taken out of it, like a melon at a picnic 🍉

The projection sphere for this class is sliced by a clipping plane. Projections will be mapped to the remaining sphere part.

See also

  • SbCylinderSectionProjector

🎀 Constructor & Destructor Documentation 🎀

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

Default constructor. See SbSphereProjector::SbSphereProjector().

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

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

Constructor with explicit setting of the projection sphere. you literally hand it the sphere yourself, main character energy 👑

💫 Member Function Documentation 💫

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

Construct and return a copy of this projector. The caller is responsible for destructing the new instance. (translation: you made it, you clean it up bestie 🧹)

⚠️ heads up, this one matters: 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 mysterious crash jumpscare 💀 keep your CRT consistent, i'm begging.

Implements SbProjector.

Reimplemented in SbSpherePlaneProjector.

SbVec3f SbSphereSectionProjector::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.

Implements SbProjector.

Reimplemented in SbSpherePlaneProjector.

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

Returns rotation on the projection surface which re-orients point1 to point2. glow-up, but for points ✨

Implements SbSphereProjector.

Reimplemented in SbSpherePlaneProjector.

void SbSphereSectionProjector::setTolerance(const float edgetol)

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

float SbSphereSectionProjector::getTolerance(void ) const

Returns edge tolerance for the sphere half.

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

Set up the controlling value for how the rotation calculation will be done "outside" the sphere.

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

float SbSphereSectionProjector::getRadialFactor(void ) const

Returns value of radialFactor.

See also

  • setRadialFactor()

SbBool SbSphereSectionProjector::isWithinTolerance(const SbVec3f & point)

Check if point is within the part of the sphere used for projections. vibe check for your point, basically 🫶

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

Recalculate the internal projection surface settings. Needs to be done if any of the parameters influencing the projection surface have been changed from subclasses without using the access methods. (sneaky direct edits? recalculate, bestie 🔄)

🍓 Member Data Documentation 🍓

float SbSphereSectionProjector::tolerance [protected]

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

float SbSphereSectionProjector::tolDist [protected]

Tolerance value multiplied with the sphere radius.

float SbSphereSectionProjector::radialFactor [protected]

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

See also

  • setRadialFactor()

SbVec3f SbSphereSectionProjector::planePoint [protected]

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

SbVec3f SbSphereSectionProjector::planeDir [protected]

Direction of cutting plane. that's the slice direction, iykyk 🔪

float SbSphereSectionProjector::planeDist [protected]

Distance from plane to sphere center.

SbPlane SbSphereSectionProjector::tolPlane [protected]

Defines the plane cutting the sphere into a projection part.

👑 Author 👑

Generated automatically by Doxygen for Coin from the source code. (not me, i just did the vibes 💅)

okay that's the whole page, you ate it up 🌈 and one last cute sign-off: this gorgeous thing comes from Coin, Version 3.1.3 — mwah, bye bestie 💖🦋

📦 where this page comes from