00001 // This code contains NVIDIA Confidential Information and is disclosed to you 
00002 // under a form of NVIDIA software license agreement provided separately to you.
00003 //
00004 // Notice
00005 // NVIDIA Corporation and its licensors retain all intellectual property and
00006 // proprietary rights in and to this software and related documentation and 
00007 // any modifications thereto. Any use, reproduction, disclosure, or 
00008 // distribution of this software and related documentation without an express 
00009 // license agreement from NVIDIA Corporation is strictly prohibited.
00010 // 
00011 // ALL NVIDIA DESIGN SPECIFICATIONS, CODE ARE PROVIDED "AS IS.". NVIDIA MAKES
00012 // NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO
00013 // THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT,
00014 // MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.
00015 //
00016 // Information and code furnished is believed to be accurate and reliable.
00017 // However, NVIDIA Corporation assumes no responsibility for the consequences of use of such
00018 // information or for any infringement of patents or other rights of third parties that may
00019 // result from its use. No license is granted by implication or otherwise under any patent
00020 // or patent rights of NVIDIA Corporation. Details are subject to change without notice.
00021 // This code supersedes and replaces all information previously supplied.
00022 // NVIDIA Corporation products are not authorized for use as critical
00023 // components in life support devices or systems without express written approval of
00024 // NVIDIA Corporation.
00025 //
00026 // Copyright (c) 2008-2012 NVIDIA Corporation. All rights reserved.
00027 // Copyright (c) 2004-2008 AGEIA Technologies, Inc. All rights reserved.
00028 // Copyright (c) 2001-2004 NovodeX AG. All rights reserved.  
00029 
00030 
00031 #ifndef PX_COLLISION_NXCONVEXMESHDESC
00032 #define PX_COLLISION_NXCONVEXMESHDESC
00033 
00037 #include "foundation/PxVec3.h"
00038 #include "foundation/PxFlags.h"
00039 #include "common/PxCoreUtilityTypes.h"
00040 
00041 #ifndef PX_DOXYGEN
00042 namespace physx
00043 {
00044 #endif
00045 
00049 struct PxConvexFlag
00050 {
00051     enum Enum
00052     {
00065         eFLIPNORMALS        =   (1<<0),
00066 
00072         e16_BIT_INDICES     =   (1<<1),
00073 
00077         eCOMPUTE_CONVEX     =   (1<<2), 
00078 
00086         eINFLATE_CONVEX     =   (1<<3),
00087 
00093         eUSE_UNCOMPRESSED_NORMALS   =   (1<<5),
00094     };
00095 };
00096 
00102 typedef PxFlags<PxConvexFlag::Enum,PxU16> PxConvexFlags;
00103 PX_FLAGS_OPERATORS(PxConvexFlag::Enum,PxU16);
00104 
00105 
00106 typedef PxVec3 PxPoint;
00107 
00115 class PxConvexMeshDesc
00116 {
00117 public:
00118 
00125     PxBoundedData points;
00126 
00144     PxBoundedData triangles;
00145 
00151     PxConvexFlags flags;
00152 
00156     PX_INLINE PxConvexMeshDesc();
00160     PX_INLINE void setToDefault();
00166     PX_INLINE bool isValid() const;
00167 };
00168 
00169 PX_INLINE PxConvexMeshDesc::PxConvexMeshDesc()  //constructor sets to default
00170 {
00171 }
00172 
00173 PX_INLINE void PxConvexMeshDesc::setToDefault()
00174 {
00175     *this = PxConvexMeshDesc();
00176 }
00177 
00178 PX_INLINE bool PxConvexMeshDesc::isValid() const
00179 {
00180     // Check geometry
00181     if(points.count < 3 ||  //at least 1 trig's worth of points
00182         (points.count > 0xffff && flags & PxConvexFlag::e16_BIT_INDICES))
00183         return false;
00184     if(!points.data)
00185         return false;
00186     if(points.stride < sizeof(PxPoint)) //should be at least one point's worth of data
00187         return false;
00188 
00189     // Check topology
00190     // The triangles pointer is not mandatory: the vertex cloud is enough to define the convex hull.
00191     if(triangles.data)
00192     {
00193         // Indexed mesh
00194         if(triangles.count < 2) //some algos require at least 2 trigs
00195             return false;
00196 
00197         PxU32 limit = (flags & PxConvexFlag::e16_BIT_INDICES) ? sizeof(PxU16)*3 : sizeof(PxU32)*3;
00198         if(triangles.stride < limit) 
00199             return false;
00200     }
00201     else
00202     {
00203         // We can compute the hull from the vertices
00204         if(!(flags & PxConvexFlag::eCOMPUTE_CONVEX))
00205             return false;   // If the mesh is convex and we're not allowed to compute the hull,
00206                             // you have to provide it completely (geometry & topology).
00207     }
00208     return true;
00209 }
00210 
00211 #ifndef PX_DOXYGEN
00212 } // namespace physx
00213 #endif
00214 
00216 #endif