2019-11-23 20:27:39 +08:00
|
|
|
/****************************************************************************
|
|
|
|
Copyright (c) 2014-2016 Chukong Technologies Inc.
|
|
|
|
Copyright (c) 2017-2018 Xiamen Yaji Software Co., Ltd.
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2022-07-09 22:23:34 +08:00
|
|
|
https://axis-project.github.io/
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
Permission is hereby granted, free of charge, to any person obtaining a copy
|
|
|
|
of this software and associated documentation files (the "Software"), to deal
|
|
|
|
in the Software without restriction, including without limitation the rights
|
|
|
|
to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
|
|
|
|
copies of the Software, and to permit persons to whom the Software is
|
|
|
|
furnished to do so, subject to the following conditions:
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
The above copyright notice and this permission notice shall be included in
|
|
|
|
all copies or substantial portions of the Software.
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
|
|
|
|
IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
|
|
|
|
FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
|
|
|
|
AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
|
|
|
|
LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
|
|
|
|
OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN
|
|
|
|
THE SOFTWARE.
|
|
|
|
****************************************************************************/
|
|
|
|
|
2022-07-15 19:17:01 +08:00
|
|
|
#ifndef __AX_OBB_H__
|
|
|
|
#define __AX_OBB_H__
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
#include "3d/CCAABB.h"
|
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
NS_AX_BEGIN
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
/**
|
|
|
|
* @addtogroup _3d
|
|
|
|
* @{
|
|
|
|
*/
|
|
|
|
|
|
|
|
/**
|
2022-07-05 14:48:46 +08:00
|
|
|
*
|
|
|
|
* @brief Oriented Bounding Box(OBB): OBB is similar to AABB except the bounding box has the same direction as the
|
|
|
|
* MeshRenderer. so collision detection is more precise than AABB.
|
2019-11-23 20:27:39 +08:00
|
|
|
* @js NA
|
|
|
|
*/
|
2022-07-15 19:17:01 +08:00
|
|
|
class AX_DLL OBB
|
2019-11-23 20:27:39 +08:00
|
|
|
{
|
|
|
|
public:
|
|
|
|
OBB();
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Construct obb from oriented bounding box
|
|
|
|
*
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
OBB(const AABB& aabb);
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/*
|
|
|
|
* Construct obb from points
|
|
|
|
*
|
|
|
|
* @lua NA
|
|
|
|
*/
|
|
|
|
OBB(const Vec3* verts, int num);
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/*
|
|
|
|
* Check point in
|
|
|
|
*/
|
|
|
|
bool containPoint(const Vec3& point) const;
|
|
|
|
|
|
|
|
/*
|
|
|
|
* Specify obb values
|
|
|
|
*/
|
|
|
|
void set(const Vec3& center, const Vec3& _xAxis, const Vec3& _yAxis, const Vec3& _zAxis, const Vec3& _extents);
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/*
|
|
|
|
* Clear obb
|
2021-12-25 10:04:45 +08:00
|
|
|
*/
|
2019-11-23 20:27:39 +08:00
|
|
|
void reset();
|
|
|
|
|
|
|
|
/* face to the obb's -z direction
|
|
|
|
* verts[0] : left top front
|
|
|
|
* verts[1] : left bottom front
|
|
|
|
* verts[2] : right bottom front
|
|
|
|
* verts[3] : right top front
|
|
|
|
*
|
|
|
|
* face to the obb's z direction
|
|
|
|
* verts[4] : right top back
|
|
|
|
* verts[5] : right bottom back
|
|
|
|
* verts[6] : left bottom back
|
|
|
|
* verts[7] : left top back
|
|
|
|
*/
|
|
|
|
void getCorners(Vec3* verts) const;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/*
|
|
|
|
* Check intersect with other
|
|
|
|
*/
|
|
|
|
bool intersects(const OBB& box) const;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
|
|
|
/**
|
2019-11-23 20:27:39 +08:00
|
|
|
* Transforms the obb by the given transformation matrix.
|
|
|
|
*/
|
|
|
|
void transform(const Mat4& mat);
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
protected:
|
|
|
|
/*
|
2021-12-25 10:04:45 +08:00
|
|
|
* compute extX, extY, extZ
|
|
|
|
*/
|
2019-11-23 20:27:39 +08:00
|
|
|
void computeExtAxis()
|
|
|
|
{
|
|
|
|
_extentX = _xAxis * _extents.x;
|
|
|
|
_extentY = _yAxis * _extents.y;
|
|
|
|
_extentZ = _zAxis * _extents.z;
|
|
|
|
}
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/*
|
|
|
|
* Project point to the target axis
|
|
|
|
*/
|
|
|
|
float projectPoint(const Vec3& point, const Vec3& axis) const;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/*
|
|
|
|
* Calculate the min and max project value of through the box's corners
|
|
|
|
*/
|
2021-12-25 10:04:45 +08:00
|
|
|
void getInterval(const OBB& box, const Vec3& axis, float& min, float& max) const;
|
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/*
|
|
|
|
* Get the edge of x y z axis direction
|
|
|
|
*/
|
|
|
|
Vec3 getEdgeDirection(int index) const;
|
2021-12-25 10:04:45 +08:00
|
|
|
|
2019-11-23 20:27:39 +08:00
|
|
|
/*
|
|
|
|
* Get the face of x y z axis direction
|
|
|
|
*/
|
|
|
|
Vec3 getFaceDirection(int index) const;
|
|
|
|
|
|
|
|
public:
|
|
|
|
Vec3 _center; // obb center
|
|
|
|
Vec3 _xAxis; // x axis of obb, unit vector
|
|
|
|
Vec3 _yAxis; // y axis of obb, unit vector
|
|
|
|
Vec3 _zAxis; // z axis of obb, unit vector
|
|
|
|
Vec3 _extentX; // _xAxis * _extents.x
|
|
|
|
Vec3 _extentY; // _yAxis * _extents.y
|
|
|
|
Vec3 _extentZ; // _zAxis * _extents.z
|
|
|
|
Vec3 _extents; // obb length along each axis
|
|
|
|
};
|
|
|
|
|
|
|
|
// end of 3d group
|
|
|
|
/// @}
|
|
|
|
|
2022-07-11 17:50:21 +08:00
|
|
|
NS_AX_END
|
2019-11-23 20:27:39 +08:00
|
|
|
|
|
|
|
#endif
|