Home | Namespaces | Hierarchy | Alphabetical List | Class list | Files | Namespace Members | Class members | File members
irr::scene::ITriangleSelector

irr::scene::ITriangleSelector Class Reference

Interface to return triangles with specific properties. More...

#include <ITriangleSelector.h>

Inheritance diagram for irr::scene::ITriangleSelector:

irr::IReferenceCounted irr::scene::IMetaTriangleSelector List of all members.

Public Member Functions

virtual s32 getTriangleCount () const =0
 Returns amount of all available triangles in this selector.
virtual void getTriangles (core::triangle3df *triangles, s32 arraySize, s32 &outTriangleCount, const core::line3d< f32 > &line, const core::matrix4 *transform=0) const =0
 Gets all triangles which have or may have contact with a 3d line.
virtual void getTriangles (core::triangle3df *triangles, s32 arraySize, s32 &outTriangleCount, const core::aabbox3d< f32 > &box, const core::matrix4 *transform=0) const =0
 Gets all triangles which lie within a specific bounding box.
virtual void getTriangles (core::triangle3df *triangles, s32 arraySize, s32 &outTriangleCount, const core::matrix4 *transform=0) const =0
 Gets all triangles.
virtual ~ITriangleSelector ()
 Destructor.

Detailed Description

Interface to return triangles with specific properties.

Every ISceneNode may have a triangle selector, available with ISceneNode::getTriangleScelector() or ISceneManager::createTriangleSelector. This is used for doing collision detection: For example if you know, that a collision may have happened in the area between (1,1,1) and (10,10,10), you can get all triangles of the scene node in this area with the ITriangleSelector easily and check every triangle if it collided.

Definition at line 26 of file ITriangleSelector.h.

Constructor & Destructor Documentation

virtual irr::scene::ITriangleSelector::~ITriangleSelector (   )  [inline, virtual]
 

Destructor.

Definition at line 31 of file ITriangleSelector.h.

Member Function Documentation

virtual s32 irr::scene::ITriangleSelector::getTriangleCount (   )  const [pure virtual]
 

Returns amount of all available triangles in this selector.

virtual void irr::scene::ITriangleSelector::getTriangles (  core::triangle3df *  triangles,
s32  arraySize,
s32 &  outTriangleCount,
const core::line3d< f32 > &  line,
const core::matrix4 *  transform = 0
)  const [pure virtual]
 

Gets all triangles which have or may have contact with a 3d line.

Please note that unoptimized triangle selectors also may return triangles which are not in contact at all with the 3d line.

Parameters:
triangles,: Array where the resulting triangles will be written to.
arraySize,: Size of the target array.
outTriangleCount,: Amount of triangles which have been written into the array.
line,: Only triangles which may be in contact with this 3d line will be written into the array.
transform,: Pointer to matrix for transforming the triangles before they are returned. Useful for example to scale all triangles down into an ellipsoid space. If this pointer is null, no transformation will be done.

virtual void irr::scene::ITriangleSelector::getTriangles (  core::triangle3df *  triangles,
s32  arraySize,
s32 &  outTriangleCount,
const core::aabbox3d< f32 > &  box,
const core::matrix4 *  transform = 0
)  const [pure virtual]
 

Gets all triangles which lie within a specific bounding box.

Please note that unoptimized triangle selectors also may return triangles which are not in the specific box at all.

Parameters:
triangles,: Array where the resulting triangles will be written to.
arraySize,: Size of the target array.
outTriangleCount,: Amount of triangles which have been written into the array.
box,: Only triangles which are in this axis aligned bounding box will be written into the array.
transform,: Pointer to matrix for transforming the triangles before they are returned. Useful for example to scale all triangles down into an ellipsoid space. If this pointer is null, no transformation will be done.

virtual void irr::scene::ITriangleSelector::getTriangles (  core::triangle3df *  triangles,
s32  arraySize,
s32 &  outTriangleCount,
const core::matrix4 *  transform = 0
)  const [pure virtual]
 

Gets all triangles.

Parameters:
triangles,: Array where the resulting triangles will be written to.
arraySize,: Size of the target array.
outTriangleCount,: Amount of triangles which have been written into the array.
transform,: Pointer to matrix for transforming the triangles before they are returned. Useful for example to scale all triangles down into an ellipsoid space. If this pointer is null, no transformation will be done.

The documentation for this class was generated from the following file:
The Irrlicht Engine
The Irrlicht Engine Documentation © 2003-2008 by Nikolaus Gebhardt. Generated on Sun Jun 1 07:59:21 2008 by Doxygen (1.4.2)