aboutsummaryrefslogtreecommitdiff
path: root/PhysX_3.4/Source/Common/src/CmPtrTable.h
diff options
context:
space:
mode:
authorgit perforce import user <a@b>2016-10-25 12:29:14 -0600
committerSheikh Dawood Abdul Ajees <Sheikh Dawood Abdul Ajees>2016-10-25 18:56:37 -0500
commit3dfe2108cfab31ba3ee5527e217d0d8e99a51162 (patch)
treefa6485c169e50d7415a651bf838f5bcd0fd3bfbd /PhysX_3.4/Source/Common/src/CmPtrTable.h
downloadphysx-3.4-3dfe2108cfab31ba3ee5527e217d0d8e99a51162.tar.xz
physx-3.4-3dfe2108cfab31ba3ee5527e217d0d8e99a51162.zip
Initial commit:
PhysX 3.4.0 Update @ 21294896 APEX 1.4.0 Update @ 21275617 [CL 21300167]
Diffstat (limited to 'PhysX_3.4/Source/Common/src/CmPtrTable.h')
-rw-r--r--PhysX_3.4/Source/Common/src/CmPtrTable.h142
1 files changed, 142 insertions, 0 deletions
diff --git a/PhysX_3.4/Source/Common/src/CmPtrTable.h b/PhysX_3.4/Source/Common/src/CmPtrTable.h
new file mode 100644
index 00000000..c0eb3b61
--- /dev/null
+++ b/PhysX_3.4/Source/Common/src/CmPtrTable.h
@@ -0,0 +1,142 @@
+// This code contains NVIDIA Confidential Information and is disclosed to you
+// under a form of NVIDIA software license agreement provided separately to you.
+//
+// Notice
+// NVIDIA Corporation and its licensors retain all intellectual property and
+// proprietary rights in and to this software and related documentation and
+// any modifications thereto. Any use, reproduction, disclosure, or
+// distribution of this software and related documentation without an express
+// license agreement from NVIDIA Corporation is strictly prohibited.
+//
+// ALL NVIDIA DESIGN SPECIFICATIONS, CODE ARE PROVIDED "AS IS.". NVIDIA MAKES
+// NO WARRANTIES, EXPRESSED, IMPLIED, STATUTORY, OR OTHERWISE WITH RESPECT TO
+// THE MATERIALS, AND EXPRESSLY DISCLAIMS ALL IMPLIED WARRANTIES OF NONINFRINGEMENT,
+// MERCHANTABILITY, AND FITNESS FOR A PARTICULAR PURPOSE.
+//
+// Information and code furnished is believed to be accurate and reliable.
+// However, NVIDIA Corporation assumes no responsibility for the consequences of use of such
+// information or for any infringement of patents or other rights of third parties that may
+// result from its use. No license is granted by implication or otherwise under any patent
+// or patent rights of NVIDIA Corporation. Details are subject to change without notice.
+// This code supersedes and replaces all information previously supplied.
+// NVIDIA Corporation products are not authorized for use as critical
+// components in life support devices or systems without express written approval of
+// NVIDIA Corporation.
+//
+// Copyright (c) 2008-2016 NVIDIA Corporation. All rights reserved.
+// Copyright (c) 2004-2008 AGEIA Technologies, Inc. All rights reserved.
+// Copyright (c) 2001-2004 NovodeX AG. All rights reserved.
+
+
+#ifndef PX_PHYSICS_COMMON_PTR_TABLE
+#define PX_PHYSICS_COMMON_PTR_TABLE
+
+#include "PxPhysXCommonConfig.h"
+#include "CmPhysXCommon.h"
+
+namespace physx
+{
+
+class PxSerializationContext;
+class PxDeserializationContext;
+
+
+namespace Cm
+{
+
+class PtrTableStorageManager
+{
+ // This will typically be backed by a MultiPool implementation with fallback to the user
+ // allocator. For MultiPool, when deallocating we want to know what the previously requested size was
+ // so we can release into the right pool
+
+public:
+
+ // capacity is in bytes
+
+ virtual void** allocate(PxU32 capacity) = 0;
+ virtual void deallocate(void** addr, PxU32 originalCapacity) = 0;
+
+ // whether memory allocated at one capacity can (and should) be safely reused at a different capacity
+ // allows realloc-style reuse by clients.
+
+ virtual bool canReuse(PxU32 originalCapacity, PxU32 newCapacity) = 0;
+protected:
+ virtual ~PtrTableStorageManager() {}
+};
+
+
+
+// specialized class to hold an array of pointers with extrinsic storage management,
+// serialization-compatible with 3.3.1 PtrTable
+//
+// note that extrinsic storage implies you *must* clear the table before the destructor runs
+//
+// capacity is implicit:
+// if the memory is not owned (i.e. came from deserialization) then the capacity is exactly mCount
+// else if mCount==0, capacity is 0
+// else the capacity is the power of 2 >= mCount
+//
+// one implication of this is that if we want to add or remove a pointer from unowned memory, we always realloc
+
+struct PX_PHYSX_COMMON_API PtrTable
+{
+//= ATTENTION! =====================================================================================
+// Changing the data layout of this class breaks the binary serialization format. See comments for
+// PX_BINARY_SERIAL_VERSION. If a modification is required, please adjust the getBinaryMetaData
+// function. If the modification is made on a custom branch, please change PX_BINARY_SERIAL_VERSION
+// accordingly.
+//==================================================================================================
+
+ PtrTable();
+ ~PtrTable();
+
+ void add(void* ptr, PtrTableStorageManager& sm);
+ void replaceWithLast(PxU32 index, PtrTableStorageManager& sm);
+ void clear(PtrTableStorageManager& sm);
+
+ PxU32 find(const void* ptr) const;
+
+ PX_FORCE_INLINE PxU32 getCount() const { return mCount; }
+ PX_FORCE_INLINE void*const* getPtrs() const { return mCount == 1 ? &mSingle : mList; }
+ PX_FORCE_INLINE void** getPtrs() { return mCount == 1 ? &mSingle : mList; }
+
+
+ // SERIALIZATION
+
+ // 3.3.1 compatibility fixup: this implementation ALWAYS sets 'ownsMemory' if the size is 0 or 1
+ PtrTable(const PxEMPTY)
+ {
+ mOwnsMemory = mCount<2;
+ if(mCount == 0)
+ mList = NULL;
+ }
+
+ void exportExtraData(PxSerializationContext& stream);
+ void importExtraData(PxDeserializationContext& context);
+
+ static void getBinaryMetaData(physx::PxOutputStream& stream);
+
+private:
+ void realloc(PxU32 oldCapacity, PxU32 newCapacity, PtrTableStorageManager& sm);
+
+ union
+ {
+ void* mSingle;
+ void** mList;
+ };
+
+ PxU16 mCount;
+ bool mOwnsMemory;
+ bool mBufferUsed; // dark magic in serialization requires this, otherwise redundant because it's logically equivalent to mCount == 1.
+
+};
+
+} // namespace Cm
+#if !PX_P64_FAMILY
+PX_COMPILE_TIME_ASSERT(sizeof(Cm::PtrTable)==8);
+#endif
+
+}
+
+#endif