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.

6.9 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_EXTENDED_BUCKET_PRUNER_H
#define GU_EXTENDED_BUCKET_PRUNER_H

#include "GuPrunerTypedef.h"
#include "GuAABBTreeUpdateMap.h"
#include "foundation/PxHashMap.h"
#include "GuAABBTreeBounds.h"
#include "GuSecondaryPruner.h"

namespace physx
{
	class PxRenderOutput;

namespace Gu
{
	class AABBTreeMergeData;

	// Extended bucket pruner data, if an object belongs to the tree of trees, we need to
	// remember node for the sub tree, the tree it belongs to and the main tree node
	struct ExtendedBucketPrunerData
	{
		PxU32			mTimeStamp;		// timestamp 		
		TreeNodeIndex	mSubTreeNode;	// sub tree node index
		PxU32			mMergeIndex;	// index in bounds and merged trees array
	};

	// Merged tree structure, holds tree and its timeStamp, released when no objects is in the tree
	// or timeStamped objects are released
	struct MergedTree
	{
		AABBTree*	mTree;			// AABB tree 
		size_t		mTimeStamp;		// 
	};
	
	// hashing function for PrunerPayload key
	// PT: TODO: move this to PrunerPayload?
	struct ExtendedBucketPrunerHash
	{
		PX_FORCE_INLINE uint32_t operator()(const PrunerPayload& payload) const
		{
#if PX_P64_FAMILY
//			const PxU32 h0 = PxHash((const void*)payload.data[0]);
//			const PxU32 h1 = PxHash((const void*)payload.data[1]);
			const PxU32 h0 = PxU32(PX_MAX_U32 & payload.data[0]);
			const PxU32 h1 = PxU32(PX_MAX_U32 & payload.data[1]);
			return physx::PxComputeHash(PxU64(h0) | (PxU64(h1) << 32));
#else
			return physx::PxComputeHash(PxU64(payload.data[0]) | (PxU64(payload.data[1]) << 32));
#endif
		}
		PX_FORCE_INLINE bool equal(const PrunerPayload& k0, const PrunerPayload& k1) const
		{
			return (k0.data[0] == k1.data[0]) && (k0.data[1] == k1.data[1]);
		}
	};

	// A.B. replace, this is useless, need to be able to traverse the map and release while traversing, also eraseAt failed
	typedef PxHashMap<PrunerPayload, ExtendedBucketPrunerData, ExtendedBucketPrunerHash>	ExtendedBucketPrunerMap;

	// Extended bucket pruner holds single objects in a bucket pruner and AABBtrees in a tree of trees.
	// Base usage of ExtendedBucketPruner is for dynamic AABBPruner new objects, that did not make it 
	// into new tree. Single objects go directly into a bucket pruner, while merged AABBtrees 
	// go into a tree of trees.
	// PT: TODO: this is not a Pruner (doesn't use the Pruner API) so its name should be e.g. "ExtendedBucketPrunerCore".
	// And it's also not always using a bucket pruner... so the whole "ExtendedBucketPruner" name everywhere is wrong.
	class ExtendedBucketPruner
	{
		public:
												ExtendedBucketPruner(PxU64 contextID, CompanionPrunerType type, const PruningPool* pool);
												~ExtendedBucketPruner();

		// release 
						void					release();

		// add single object into a bucket pruner directly
		PX_FORCE_INLINE bool					addObject(const PrunerPayload& object, PrunerHandle handle, const PxBounds3& worldAABB, const PxTransform& transform, PxU32 timeStamp, const PoolIndex poolIndex)
												{
													return mCompanion ? mCompanion->addObject(object, handle, worldAABB, transform, timeStamp, poolIndex) : true;
												}

		// add AABB tree from pruning structure - adds new primitive into main AABB tree
						void					addTree(const AABBTreeMergeData& mergeData, PxU32 timeStamp);

		// update object
						bool					updateObject(const PxBounds3& worldAABB, const PxTransform& transform, const PrunerPayload& object, PrunerHandle handle, const PoolIndex poolIndex);

		// remove object, removed object is replaced in pruning pool by swapped object, indices needs to be updated
						bool					removeObject(const PrunerPayload& object, PrunerHandle handle, PxU32 objectIndex, const PrunerPayload& swapObject, PxU32 swapObjectIndex);

		// swap object index, the object index can be in core pruner or tree of trees
						void					swapIndex(PxU32 objectIndex, const PrunerPayload& swapObject, PxU32 swapObjectIndex, bool corePrunerIncluded = true);

		// refit marked nodes in tree of trees
						void					refitMarkedNodes(const PxBounds3* boxes);

		// notify timestampChange - swap trees in incremental pruner
		PX_FORCE_INLINE	void					timeStampChange()
												{
													if(mCompanion)
														mCompanion->timeStampChange();
												}

		// look for objects marked with input timestamp everywhere in the structure, and remove them. This is the same
		// as calling 'removeObject' individually for all these objects, but much more efficient. Returns number of removed objects.
						PxU32					removeMarkedObjects(PxU32 timeStamp);

		// queries against the pruner
						bool					raycast(const PxVec3& origin, const PxVec3& unitDir, PxReal& inOutDistance, PrunerRaycastCallback&) const;
						bool					overlap(const ShapeData& queryVolume, PrunerOverlapCallback&) const;
						bool					sweep(const ShapeData& queryVolume, const PxVec3& unitDir, PxReal& inOutDistance, PrunerRaycastCallback&) const;

		// origin shift
						void					shiftOrigin(const PxVec3& shift);

		// debug visualize
						void					visualize(PxRenderOutput& out, PxU32 color) const;

		PX_FORCE_INLINE	void					build()
												{
													if(mCompanion)
														mCompanion->build();
												}

		PX_FORCE_INLINE PxU32					getNbObjects()	const
												{
													const PxU32 nb = mCompanion ? mCompanion->getNbObjects() : 0;
													return nb + mExtendedBucketPrunerMap.size();
												}

						void					getGlobalBounds(PxBounds3&)	const;
		private:
		// separate call for indices invalidation, object can be either in AABBPruner or Bucket pruner, but the swapped object can be 
		// in the tree of trees
						void					invalidateObject(const ExtendedBucketPrunerData& object, PxU32 objectIndex, const PrunerPayload& swapObject, PxU32 swapObjectIndex);

						void					resize(PxU32 size);
						void					buildMainAABBTree();
						void					cleanTrees();
#if PX_DEBUG
		// Extended bucket pruner validity check
						bool					checkValidity();
#endif
						CompanionPruner*		mCompanion;					// Companion pruner for single objects
						const PruningPool*		mPruningPool;				// Pruning pool from AABB pruner
						ExtendedBucketPrunerMap	mExtendedBucketPrunerMap;	// Map holding objects from tree merge - objects in tree of trees
						AABBTree*				mMainTree;					// Main tree holding merged trees
						AABBTreeUpdateMap		mMainTreeUpdateMap;			// Main tree updated map - merged trees index to nodes
						AABBTreeUpdateMap		mMergeTreeUpdateMap;		// Merged tree update map used while tree is merged
						AABBTreeBounds			mBounds;					// Merged trees bounds used for main tree building
						MergedTree*				mMergedTrees;				// Merged trees
						PxU32					mCurrentTreeIndex;			// Current trees index
						PxU32					mCurrentTreeCapacity;		// Current tress capacity
						bool					mTreesDirty;				// Dirty marker
	};

}

}

#endif