Skip to content

A fast 2D and 3D game engine — TypeScript SDK, C++/WebAssembly core, visual editor. Ship one project to web, desktop, WeChat MiniGames, playable ads, and native Android / iOS.

4.6 KB
Raw Blame
// Copyright (c) 2001-2004 NovodeX AG. All rights reserved.
// Copyright (c) 2004-2008 AGEIA Technologies, Inc. All rights reserved.
// SPDX-FileCopyrightText: Copyright (c) 2008-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
// SPDX-License-Identifier: Apache-2.0

#ifndef GU_PRUNING_POOL_H
#define GU_PRUNING_POOL_H

#include "common/PxPhysXCommonConfig.h"
#include "GuPrunerTypedef.h"
#include "GuPrunerPayload.h"
#include "GuBounds.h"
#include "GuAABBTreeBounds.h"

namespace physx
{
namespace Gu
{
	enum TransformCacheMode
	{
		TRANSFORM_CACHE_UNUSED,
		TRANSFORM_CACHE_LOCAL,
		TRANSFORM_CACHE_GLOBAL
	};

	// This class is designed to maintain a two way mapping between pair(PrunerPayload/userdata,AABB) and PrunerHandle
	// Internally there's also an index for handles (AP: can be simplified?)
	// This class effectively stores bounded pruner payloads/userdata, returns a PrunerHandle and allows O(1)
	// access to them using a PrunerHandle
	// Supported operations are add, remove, update bounds
	class PX_PHYSX_COMMON_API PruningPool : public PxUserAllocated
	{
												PX_NOCOPY(PruningPool)
		public:
												PruningPool(PxU64 contextID, TransformCacheMode mode/*=TRANSFORM_CACHE_UNUSED*/);
												~PruningPool();

		PX_FORCE_INLINE	const PrunerPayload&	getPayloadData(PrunerHandle handle, PrunerPayloadData* data=NULL)	const
												{
													const PoolIndex index = getIndex(handle);
													if(data)
													{
														PxBounds3* wb = const_cast<PxBounds3*>(mWorldBoxes.getBounds());
														data->mBounds = wb + index;
														data->mTransform = mTransforms ? mTransforms + index : NULL;
													}
													return mObjects[index];
												}

						void					shiftOrigin(const PxVec3& shift);

		// PT: adds 'count' objects to the pool. Needs 'count' bounds and 'count' payloads passed as input. Writes out 'count' handles
		// in 'results' array. Function returns number of successfully added objects, ideally 'count' but can be less in case we run
		// out of memory.
						PxU32					addObjects(PrunerHandle* results, const PxBounds3* bounds, const PrunerPayload* data, const PxTransform* transforms, PxU32 count);

		// this function will swap the last object with the hole formed by removed PrunerHandle object
		// and return the removed last object's index in the pool
						PoolIndex				removeObject(PrunerHandle h, PrunerPayloadRemovalCallback* removalCallback);

		// Data access
		PX_FORCE_INLINE	PoolIndex				getIndex(PrunerHandle h)const	{ return mHandleToIndex[h];			}
		PX_FORCE_INLINE	PrunerPayload*			getObjects()			const	{ return mObjects;					}
		PX_FORCE_INLINE	const PxTransform*		getTransforms()			const	{ return mTransforms;				}
		PX_FORCE_INLINE	PxTransform*			getTransforms()					{ return mTransforms;				}
		PX_FORCE_INLINE	bool					setTransform(PrunerHandle handle, const PxTransform& transform)
												{
													if(!mTransforms)
														return false;
													mTransforms[getIndex(handle)] = transform;
													return true;
												}
		PX_FORCE_INLINE	PxU32					getNbActiveObjects()		const	{ return mNbObjects;				}
		PX_FORCE_INLINE	const PxBounds3*		getCurrentWorldBoxes()		const	{ return mWorldBoxes.getBounds();	}
		PX_FORCE_INLINE	PxBounds3*				getCurrentWorldBoxes()				{ return mWorldBoxes.getBounds();	}
		PX_FORCE_INLINE	const AABBTreeBounds&	getCurrentAABBTreeBounds()	const	{ return mWorldBoxes;				}

						void					updateAndInflateBounds(const PrunerHandle* handles, const PxU32* boundsIndices, const PxBounds3* newBounds, const PxTransform32* newTransforms, PxU32 count, float epsilon);
						void					preallocate(PxU32 entries);
//	protected:

						PxU32					mNbObjects;			//!< Current number of objects
						PxU32					mMaxNbObjects;		//!< Max. number of objects (capacity for mWorldBoxes, mObjects)

						//!< these arrays are parallel
						AABBTreeBounds			mWorldBoxes;		//!< List of world boxes, stores mNbObjects, capacity=mMaxNbObjects
						PrunerPayload*			mObjects;			//!< List of objects, stores mNbObjects, capacity=mMaxNbObjects
						PxTransform*			mTransforms;
				const	TransformCacheMode		mTransformCacheMode;
//	private:			
						PoolIndex*				mHandleToIndex;		//!< Maps from PrunerHandle to internal index (payload/userData index in mObjects)
						PrunerHandle*			mIndexToHandle;		//!< Inverse map from objectIndex to PrunerHandle

				// this is the head of a list of holes formed in mHandleToIndex by removed handles
				// the rest of the list is stored in holes in mHandleToIndex (in place)
						PrunerHandle			mFirstRecycledHandle;

						PxU64					mContextID;

						bool					resize(PxU32 newCapacity);
	};
}

}

#endif