SbCylinderSectionProjector(3)

📦
version 4.0.10 · 4 versions
, in fedora 43, fedora 44

💖 NAME 💖

SbCylinderSectionProjector — the projector that takes 2D points and lands them on a sliced cylinder, bestie. That's the whole vibe. 🥒✨

This page lives in the Coin manual, section 3 (library functions, iykyk).

✨ SYNOPSIS ✨

#include <Inventor/projectors/SbCylinderSectionProjector.h>

Inherits SbCylinderProjector.

Inherited by SbCylinderPlaneProjector.

🎀 Public Member Functions 🎀

  • SbCylinderSectionProjector (const float edgetol=0.9f, const SbBool orienttoeye=TRUE) — the default constructor, no args required, she just shows up.
  • SbCylinderSectionProjector (const SbCylinder &cyl, const float edgetol=0.9f, const SbBool orienttoeye=TRUE) — same energy but you hand her the cylinder yourself.
  • virtual SbProjector * copy (void) const — clone her, and the clone is your responsibility now.
  • virtual SbVec3f project (const SbVec2f &point) — 2D in, 3D out. The main character move.
  • virtual SbRotation getRotation (const SbVec3f &point1, const SbVec3f &point2) — the spin that carries point1 over to point2.
  • void setTolerance (const float edgetol) — how much of the cylinder counts as fair game.
  • float getTolerance (void) const — read that tolerance back out.
  • SbBool isWithinTolerance (const SbVec3f &point) — is this point inside the usable slice or nah?

🦋 Public Member Functions inherited from SbCylinderProjector 🦋

  • SbVec3f projectAndGetRotation (const SbVec2f &point, SbRotation &rot)
  • void setCylinder (const SbCylinder &cyl)
  • const SbCylinder & getCylinder (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) — she recalculates her whole internal projection setup. Iconic but lowkey needy.

🌸 Protected Member Functions inherited from SbCylinderProjector 🌸

  • SbCylinderProjector (const SbBool orienttoeye)
  • SbCylinderProjector (const SbCylinder &cylinder, const SbBool orienttoeye)
  • SbBool intersectCylinderFront (const SbLine &line, 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
  • SbVec3f planeDir
  • SbLine planeLine
  • float planeDist
  • SbPlane tolPlane

🍓 Protected Attributes inherited from SbCylinderProjector 🍓

  • SbBool intersectFront
  • SbCylinder cylinder
  • SbBool orientToEye
  • SbBool needSetup
  • SbVec3f lastPoint

👑 Protected Attributes inherited from SbProjector 👑

  • SbViewVolume viewVol
  • SbMatrix worldToWorking
  • SbMatrix workingToWorld

🌺 Detailed Description 🌺

The SbCylinderSectionProjector projects 2D points to a sliced cylinder. Not a whole cylinder. A sliced one. The drama. 💅

The projection cylinder for this class is sliced by a clipping plane parallel to its height axis. Projections will be mapped to the remaining cylinder part.

So: plane goes snip, part of the cylinder is off-limits, and all your points land on whatever's left. It's giving "bouncer at the club but for geometry." 🚪

See also

  • SbSphereSectionProjector

🎀 Constructor & Destructor Documentation 🎀

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

Default constructor. See SbCylinderProjector::SbCylinderProjector().

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

Bestie, mind the interval — <0, 1]. Zero is not invited to this party. 🚫

SbCylinderSectionProjector::SbCylinderSectionProjector (const SbCylinder & cyl, const float edgetol = 0.9f, const SbBool orienttoeye = TRUE)

Constructor with explicit setting of the projection cylinder. You bring the cylinder, she brings the slicing. 🫶

🦋 Member Function Documentation 🦋

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

Construct and return a copy of this projector. The caller is responsible for destructing the new instance.

⚠️ Real talk, no cap: 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 are 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. 💀 Same CRT instance or chaos. That's the rule.

Implements SbProjector.

Reimplemented in SbCylinderPlaneProjector.

SbVec3f SbCylinderSectionProjector::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. She's a projector, she projects, it's her whole personality. ✨

Implements SbCylinderProjector.

Reimplemented in SbCylinderPlaneProjector.

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

Returns rotation on the projection surface which reorients point1 to point2. Basically "how do I spin this so that becomes this." 🌀

Implements SbCylinderProjector.

Reimplemented in SbCylinderPlaneProjector.

void SbCylinderSectionProjector::setTolerance (const float edgetol)

The edgetol value decides how much of the surface of the cylinder is used for projection. 1.0 means the full cylinder half is used. Crank it to 1.0 and she's using the entire front half. Periodt. 🔥

float SbCylinderSectionProjector::getTolerance (void ) const

Returns edge tolerance for the cylinder half.

SbBool SbCylinderSectionProjector::isWithinTolerance (const SbVec3f & point)

Check if point is within the part of the cylinder used for projections. Vibe check, but for geometry. ✅❌

void SbCylinderSectionProjector::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.

Translation: if a subclass went behind her back and poked the internals directly instead of using the proper access methods, she has no idea anything changed, so you have to make her recalculate. 🙈

💎 Member Data Documentation 💎

float SbCylinderSectionProjector::tolerance [protected]

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

float SbCylinderSectionProjector::tolDist [protected]

Tolerance value multiplied with the cylinder radius.

SbVec3f SbCylinderSectionProjector::planeDir [protected]

Direction of cutting plane.

SbLine SbCylinderSectionProjector::planeLine [protected]

A line within the plane which is parallel to the cylinder axis.

float SbCylinderSectionProjector::planeDist [protected]

Distance from plane to cylinder axis.

SbPlane SbCylinderSectionProjector::tolPlane [protected]

Defines the plane cutting the cylinder into a projection part. She's the one holding the knife. 🔪✨

👑 Author 👑

Generated automatically by Doxygen for Coin from the source code. (Not a human, not a girlie, just Doxygen doing her thing. 🤖💅)

Okay that's the whole page, bestie, you ate. This was Version 4.0.10, dated Thu Jun 25 2026, and the clock on it read 00:00. Generated automatically by Doxygen for Coin from the source code. Now go project something cute. 🦋💖

📦 where this page comes from