Class to manage collisions between the camera and the scene. More...
#include <Inventor/Win/viewers/SoWinCollisionViewer.h>
Public Member Functions | |
SoWinCollisionViewer (SoWinViewer *viewer) | |
~SoWinCollisionViewer () | |
SoWinViewer * | getViewer () |
void | setDistance (float distance) |
float | getDistance () const |
void | setNumSteps (int num_steps) |
int | getNumSteps () const |
void | setCollisionDetection (SbBool value=TRUE) |
SbBool | getCollisionDetection () const |
void | setZBufferOptimization (SbBool value=TRUE, SbBool useZBufferOnly=FALSE) |
SbBool | getZBufferOptimistation () const |
void | addCallback (SoWinCollisionViewerCB *f, void *ud=NULL) |
void | removeCallback (SoWinCollisionViewerCB *f, void *ud=NULL) |
This class is used to constrain a viewer, preventing the viewer's camera from colliding with the objects in the scene. It overrides the RenderCallback on the viewer that it's attached to.
The programmer can define the maximum distance between the camera and the objects.
When Z-buffer optimization is enabled, the algorithm looks at the Z-buffer to see if there is an object in front of the camera when the user moves forward, and an SoIntersectionDetectionAction when the user moves backward.
NOTE: This class is not a viewer.
SoCollisionManager, SoIntersectionDetectionAction
SoWinCollisionViewer::SoWinCollisionViewer | ( | SoWinViewer * | viewer | ) |
Constructor.
SoWinCollisionViewer::~SoWinCollisionViewer | ( | ) |
Destructor.
void SoWinCollisionViewer::addCallback | ( | SoWinCollisionViewerCB * | f, | |
void * | ud = NULL | |||
) |
Adds callback.
This callback is called when a collision occurs between the camera and the scene.
SbBool SoWinCollisionViewer::getCollisionDetection | ( | ) | const |
Gets the collision detection active flag.
float SoWinCollisionViewer::getDistance | ( | ) | const |
Gets the distance between the camera and the objects.
int SoWinCollisionViewer::getNumSteps | ( | ) | const |
Gets the number of steps to be used in the collision computation.
SoWinViewer* SoWinCollisionViewer::getViewer | ( | ) |
Gets the original viewer.
SbBool SoWinCollisionViewer::getZBufferOptimistation | ( | ) | const |
Gets the Z buffer optimization active flag.
void SoWinCollisionViewer::removeCallback | ( | SoWinCollisionViewerCB * | f, | |
void * | ud = NULL | |||
) |
Removes callback.
void SoWinCollisionViewer::setCollisionDetection | ( | SbBool | value = TRUE |
) |
Sets the collision detection active flag.
The default value is TRUE.
void SoWinCollisionViewer::setDistance | ( | float | distance | ) |
Sets the distance between the camera and the objects.
void SoWinCollisionViewer::setNumSteps | ( | int | num_steps | ) |
Sets the number of steps to be used in the collision computation.
The default number of steps is 4. The minimum value is 2.
void SoWinCollisionViewer::setZBufferOptimization | ( | SbBool | value = TRUE , |
|
SbBool | useZBufferOnly = FALSE | |||
) |
Sets the Z buffer optimization active flag.
The default value is TRUE.
Also sets the useZBufferOnly flag. When this flag is TRUE, the geometric collision detection algorithm is never used. Therefore there is no collision check when the camera is moving backward, but this may be desireable for large scenes when this check is too slow.