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_COLLISION_DEFS_H |
32 | #define PX_COLLISION_DEFS_H |
33 | |
34 | #include "PxPhysXConfig.h" |
35 | #include "foundation/PxVec3.h" |
36 | #include "foundation/PxMat33.h" |
37 | #include "geomutils/GuContactPoint.h" |
38 | #include "geomutils/GuContactBuffer.h" |
39 | #include "geometry/PxGeometry.h" |
40 | |
41 | #if !PX_DOXYGEN |
42 | namespace physx |
43 | { |
44 | #endif |
45 | |
46 | /** |
47 | \brief A structure to cache contact information produced by LL contact gen functions. |
48 | */ |
49 | struct PxCache |
50 | { |
51 | PxU8* mCachedData; //!< Cached data pointer. Allocated via PxCacheAllocator |
52 | PxU16 mCachedSize; //!< The total size of the cached data |
53 | PxU8 mPairData; //!< Pair data information used and cached internally by some contact gen functions to accelerate performance. |
54 | PxU8 mManifoldFlags; //!< Manifold flags used to identify the format the cached data is stored in. |
55 | |
56 | PX_FORCE_INLINE PxCache() : mCachedData(NULL), mCachedSize(0), mPairData(0), mManifoldFlags(0) |
57 | { |
58 | } |
59 | |
60 | PX_FORCE_INLINE void reset() { mCachedData = NULL; mCachedSize = 0; mPairData = 0; mManifoldFlags = 0;} |
61 | }; |
62 | |
63 | |
64 | /** |
65 | A callback class to allocate memory to cache information used in contact generation. |
66 | */ |
67 | class PxCacheAllocator |
68 | { |
69 | public: |
70 | /** |
71 | \brief Allocates cache data for contact generation. This data is stored inside PxCache objects. The application can retain and provide this information for future contact generation passes |
72 | for a given pair to improve contact generation performance. It is the application's responsibility to release this memory appropriately. If the memory is released, the application must ensure that |
73 | this memory is no longer referenced by any PxCache objects passed to PxGenerateContacts. |
74 | \param byteSize The size of the allocation in bytes |
75 | \return the newly-allocated memory. The returned address must be 16-byte aligned. |
76 | */ |
77 | virtual PxU8* allocateCacheData(const PxU32 byteSize) = 0; |
78 | |
79 | virtual ~PxCacheAllocator() {} |
80 | }; |
81 | |
82 | #if !PX_DOXYGEN |
83 | } |
84 | #endif |
85 | |
86 | #endif |
87 | |
88 | |