Coin Logo http://www.sim.no
http://www.coin3d.org

SbLineProjector Class Reference
[Projector classes (mostly for internal use)]

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. More...

#include <Inventor/projectors/SbLineProjector.h>

Inheritance diagram for SbLineProjector:

SbProjector

List of all members.

Public Member Functions

 SbLineProjector (void)
virtual SbProjectorcopy (void) const
virtual SbVec3f project (const SbVec2f &point)
void setLine (const SbLine &line)
const SbLinegetLine (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)

Protected Attributes

SbLine line
SbVec3f lastPoint


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>.

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.

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]

void SbLineProjector::setLine ( const SbLine lineref  ) 

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

SbLineProjector::line [protected]

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

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

The last projected point.

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


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

Copyright © 1998-2007 by Systems in Motion AS. All rights reserved.

Generated on Mon Feb 23 16:33:41 2009 for Coin by Doxygen. 1.5.8