SbLineProjector(3)

SbLineProjector(3) 💅

okay bestie, welcome to the Library Functions Manual page for SbLineProjector. This is the manual page SbLineProjector(3) and it's about the class that projects 2D points to 3D points along a line. No cap.

NAME ✨

SbLineProjector — The SbLineProjector class projects 2D points to 3D points along a line.

SYNOPSIS 🦋

#include <Inventor/projectors/SbLineProjector.h>

It inherits from SbProjector.

Public Member Functions 🫶

SbLineProjector (void)
virtual SbProjector * copy (void) const
virtual SbVec3f project (const SbVec2f &point)
void setLine (const SbLine &line)
const SbLine & getLine (void) const
virtual SbVec3f getVector (const SbVec2f &viewpos1, const SbVec2f &viewpos2)
virtual SbVec3f getVector (const SbVec2f &viewpos)
void setStartPosition (const SbVec2f &viewpos)
void setStartPosition (const SbVec3f &point)

Public Member Functions inherited from SbProjector 💜

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

Protected Attributes 🍓

SbLine line
SbVec3f lastPoint

Protected Attributes inherited from SbProjector 🌸

SbViewVolume viewVol
SbMatrix worldToWorking
SbMatrix workingToWorld

Additional Inherited Members ⭐

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

Detailed Description 🌈

The SbLineProjector class projects 2D points to 3D points along a line.

The 3D projection of the 2D coordinates is for this projector class constrained to lie along a pre-defined line.

Among other places, this is useful within the translation draggers, like for instance SoTranslate1Dragger, where we want to move "pieces" along one or more axes.

Constructor & Destructor Documentation 💖

SbLineProjector::SbLineProjector (void )

Constructor. Intializes the projector instance to use a line from <0, 0, 0> to <0, 1, 0>.

References lastPoint, and line.

Referenced by copy().

Member Function Documentation 🎀

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

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

DLL bestie warning: 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. 😭

Implements SbProjector.

References SbLineProjector().

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

References SbProjector::findVanishingDistance(), SbLine::getClosestPoint(), SbLine::getDirection(), SbLine::getPosition(), SbProjector::getWorkingLine(), SbPlane::intersect(), lastPoint, line, SbProjector::verifyProjection(), SbProjector::viewVol, SbProjector::workingToWorld, and SbProjector::worldToWorking.

Referenced by getVector(), getVector(), and setStartPosition().

void SbLineProjector::setLine (const SbLine & lineref)

Set a new projection line. 3D points will be mapped to be on this line.

References line.

const SbLine & SbLineProjector::getLine (void ) const

Returns the currently set projection line.

References line.

SbVec3f SbLineProjector::getVector (const SbVec2f & viewpos1, const SbVec2f & viewpos2) [virtual]

Calculates and returns a vector between the projected 3D position of viewpos1 and viewpos2.

References lastPoint, and project().

SbVec3f SbLineProjector::getVector (const SbVec2f & viewpos) [virtual]

Returns the 3D vector between the last projection and the one calculated for viewpos.

References lastPoint, and project().

void SbLineProjector::setStartPosition (const SbVec2f & viewpos)

Explicitly set position of initial projection, so we get correct values for later calls to getVector() etc.

References lastPoint, and project().

void SbLineProjector::setStartPosition (const SbVec3f & point)

Explicitly set position of initial projection, so we get correct values for later calls to getVector() etc.

References lastPoint.

Member Data Documentation 🌸

SbLine SbLineProjector::line [protected]

The projection line. Projected 3D points will be constrained to be on this line.

Referenced by getLine(), project(), SbLineProjector(), and setLine().

SbVec3f SbLineProjector::lastPoint [protected]

The last projected point.

Referenced by getVector(), getVector(), project(), SbLineProjector(), setStartPosition(), and setStartPosition().

Author ⭐

Generated automatically by Doxygen for Coin from the source code.

---

okay bestie that's the whole page 💖 the footer energy is Coin Version 2.5.0 and SbLineProjector(3) — so yeah, Coin Version 2.5.0, SbLineProjector(3), and you're all caught up. periodt. 🫶