diff options
| author | git perforce import user <a@b> | 2016-10-25 12:29:14 -0600 |
|---|---|---|
| committer | Sheikh Dawood Abdul Ajees <Sheikh Dawood Abdul Ajees> | 2016-10-25 18:56:37 -0500 |
| commit | 3dfe2108cfab31ba3ee5527e217d0d8e99a51162 (patch) | |
| tree | fa6485c169e50d7415a651bf838f5bcd0fd3bfbd /PhysX_3.4/Source/Common/src/CmPtrTable.h | |
| download | physx-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.h | 142 |
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 |