92 lines
3.6 KiB
C++
92 lines
3.6 KiB
C++
// Copyright (C) 2002-2008 Nikolaus Gebhardt
|
|
// This file is part of the "Irrlicht Engine".
|
|
// For conditions of distribution and use, see copyright notice in irrlicht.h
|
|
|
|
#ifndef __I_TRIANGLE_SELECTOR_H_INCLUDED__
|
|
#define __I_TRIANGLE_SELECTOR_H_INCLUDED__
|
|
|
|
#include "IReferenceCounted.h"
|
|
#include "triangle3d.h"
|
|
#include "aabbox3d.h"
|
|
#include "matrix4.h"
|
|
#include "line3d.h"
|
|
|
|
namespace irr
|
|
{
|
|
namespace scene
|
|
{
|
|
|
|
//! 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. */
|
|
class ITriangleSelector : public virtual IReferenceCounted
|
|
{
|
|
public:
|
|
|
|
//! Destructor
|
|
virtual ~ITriangleSelector() {}
|
|
|
|
//! Returns amount of all available triangles in this selector
|
|
virtual s32 getTriangleCount() const = 0;
|
|
|
|
//! Gets all triangles.
|
|
/** \param triangles: Array where the resulting triangles will be
|
|
written to.
|
|
\param arraySize: Size of the target array.
|
|
\param outTriangleCount: Amount of triangles which have been written
|
|
into the array.
|
|
\param 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 getTriangles(core::triangle3df* triangles, s32 arraySize,
|
|
s32& outTriangleCount, const core::matrix4* transform=0) const = 0;
|
|
|
|
//! 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.
|
|
\param triangles: Array where the resulting triangles will be written
|
|
to.
|
|
\param arraySize: Size of the target array.
|
|
\param outTriangleCount: Amount of triangles which have been written
|
|
into the array.
|
|
\param box: Only triangles which are in this axis aligned bounding box
|
|
will be written into the array.
|
|
\param 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 getTriangles(core::triangle3df* triangles, s32 arraySize,
|
|
s32& outTriangleCount, const core::aabbox3d<f32>& box,
|
|
const core::matrix4* transform=0) const = 0;
|
|
|
|
//! 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.
|
|
\param triangles: Array where the resulting triangles will be written
|
|
to.
|
|
\param arraySize: Size of the target array.
|
|
\param outTriangleCount: Amount of triangles which have been written
|
|
into the array.
|
|
\param line: Only triangles which may be in contact with this 3d line
|
|
will be written into the array.
|
|
\param 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 getTriangles(core::triangle3df* triangles, s32 arraySize,
|
|
s32& outTriangleCount, const core::line3d<f32>& line,
|
|
const core::matrix4* transform=0) const = 0;
|
|
};
|
|
|
|
} // end namespace scene
|
|
} // end namespace irr
|
|
|
|
|
|
#endif
|
|
|