Coin Logo Coin3D is Free Software,
published under the BSD 3-clause license.
https://bitbucket.org/Coin3D/
http://www.kongsberg.com/kogt/
SbSphereSectionProjector Class Reference

The SbSphereSectionProjector projects 2D points to a sliced sphere. More...

#include <Inventor/projectors/SbSphereSectionProjector.h>

Inheritance diagram for SbSphereSectionProjector:
SbSphereProjector SbProjector 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 SbProjectorcopy (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 SbSpheregetSphere (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 SbViewVolumegetViewVolume (void) const
 
const SbMatrixgetWorkingSpace (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.

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() [1/2]

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.

◆ SbSphereSectionProjector() [2/2]

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

Constructor with explicit setting of the projection sphere.

Member Function Documentation

◆ copy()

SbProjector * SbSphereSectionProjector::copy ( void  ) const
virtual

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

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.

Implements SbProjector.

Reimplemented in SbSpherePlaneProjector.

◆ project()

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.

◆ getRotation()

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

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

Implements SbSphereProjector.

Reimplemented in SbSpherePlaneProjector.

◆ setTolerance()

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.

◆ getTolerance()

float SbSphereSectionProjector::getTolerance ( void  ) const

Returns edge tolerance for the sphere half.

◆ setRadialFactor()

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.

◆ getRadialFactor()

float SbSphereSectionProjector::getRadialFactor ( void  ) const

Returns value of radialFactor.

See also
setRadialFactor()

◆ isWithinTolerance()

SbBool SbSphereSectionProjector::isWithinTolerance ( const SbVec3f point)

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

◆ setupTolerance()

void SbSphereSectionProjector::setupTolerance ( void  )
protectedvirtual

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.

Member Data Documentation

◆ tolerance

SbSphereSectionProjector::tolerance
protected

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

◆ tolDist

SbSphereSectionProjector::tolDist
protected

Tolerance value multiplied with the sphere radius.

◆ radialFactor

SbSphereSectionProjector::radialFactor
protected

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

See also
setRadialFactor()

◆ planePoint

SbSphereSectionProjector::planePoint
protected

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

◆ planeDir

SbSphereSectionProjector::planeDir
protected

Direction of cutting plane.

◆ planeDist

SbSphereSectionProjector::planeDist
protected

Distance from plane to sphere center.

◆ tolPlane

SbSphereSectionProjector::tolPlane
protected

Defines the plane cutting the sphere into a projection part.


The documentation for this class was generated from the following files: