1//
2// Redistribution and use in source and binary forms, with or without
3// modification, are permitted provided that the following conditions
4// are met:
5// * Redistributions of source code must retain the above copyright
6// notice, this list of conditions and the following disclaimer.
7// * Redistributions in binary form must reproduce the above copyright
8// notice, this list of conditions and the following disclaimer in the
9// documentation and/or other materials provided with the distribution.
10// * Neither the name of NVIDIA CORPORATION nor the names of its
11// contributors may be used to endorse or promote products derived
12// from this software without specific prior written permission.
13//
14// THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ''AS IS'' AND ANY
15// EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
16// IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR
17// PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR
18// CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL,
19// EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO,
20// PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR
21// PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY
22// OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT
23// (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE
24// OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE.
25//
26// Copyright (c) 2008-2021 NVIDIA Corporation. All rights reserved.
27// Copyright (c) 2004-2008 AGEIA Technologies, Inc. All rights reserved.
28// Copyright (c) 2001-2004 NovodeX AG. All rights reserved.
29
30
31#ifndef PX_PHYSICS_NX_BOX_GEOMETRY
32#define PX_PHYSICS_NX_BOX_GEOMETRY
33/** \addtogroup geomutils
34@{
35*/
36#include "geometry/PxGeometry.h"
37#include "foundation/PxVec3.h"
38
39#if !PX_DOXYGEN
40namespace physx
41{
42#endif
43
44/**
45\brief Class representing the geometry of a box.
46
47The geometry of a box can be fully specified by its half extents. This is the half of its width, height, and depth.
48\note The scaling of the box is expected to be baked into these values, there is no additional scaling parameter.
49*/
50class PxBoxGeometry : public PxGeometry
51{
52public:
53 /**
54 \brief Default constructor, initializes to a box with zero dimensions.
55 */
56 PX_INLINE PxBoxGeometry() : PxGeometry(PxGeometryType::eBOX), halfExtents(0,0,0) {}
57
58 /**
59 \brief Constructor to initialize half extents from scalar parameters.
60 \param hx Initial half extents' x component.
61 \param hy Initial half extents' y component.
62 \param hz Initial half extents' z component.
63 */
64 PX_INLINE PxBoxGeometry(PxReal hx, PxReal hy, PxReal hz) : PxGeometry(PxGeometryType::eBOX), halfExtents(hx, hy, hz) {}
65
66 /**
67 \brief Constructor to initialize half extents from vector parameter.
68 \param halfExtents_ Initial half extents.
69 */
70 PX_INLINE PxBoxGeometry(PxVec3 halfExtents_) : PxGeometry(PxGeometryType::eBOX), halfExtents(halfExtents_) {}
71
72 /**
73 \brief Returns true if the geometry is valid.
74
75 \return True if the current settings are valid
76
77 \note A valid box has a positive extent in each direction (halfExtents.x > 0, halfExtents.y > 0, halfExtents.z > 0).
78 It is illegal to call PxRigidActor::createShape and PxPhysics::createShape with a box that has zero extent in any direction.
79
80 @see PxRigidActor::createShape, PxPhysics::createShape
81 */
82 PX_INLINE bool isValid() const;
83
84public:
85 /**
86 \brief Half of the width, height, and depth of the box.
87 */
88 PxVec3 halfExtents;
89};
90
91
92PX_INLINE bool PxBoxGeometry::isValid() const
93{
94 if (mType != PxGeometryType::eBOX)
95 return false;
96 if (!halfExtents.isFinite())
97 return false;
98 if (halfExtents.x <= 0.0f || halfExtents.y <= 0.0f || halfExtents.z <= 0.0f)
99 return false;
100
101 return true;
102}
103
104#if !PX_DOXYGEN
105} // namespace physx
106#endif
107
108/** @} */
109#endif
110

source code of qtquick3dphysics/src/3rdparty/PhysX/include/geometry/PxBoxGeometry.h