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.8 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 DY_THREAD_CONTEXT_H
#define DY_THREAD_CONTEXT_H

#include "foundation/PxTransform.h"
#include "geomutils/PxContactBuffer.h"

#include "PxPhysXConfig.h"
#include "PxvDynamics.h"
#include "PxcThreadCoherentCache.h"
#include "PxcConstraintBlockStream.h"
#include "foundation/PxBitMap.h"
#include "DyVArticulation.h"
#include "DyFrictionPatchStreamPair.h"
#include "DySolverConstraintDesc.h"
#include "DyCorrelationBuffer.h"
#include "foundation/PxAllocator.h"

namespace physx
{
struct PxsIndexedContactManager;
class PxsRigidBody;

namespace Dy
{

/*!
Cache information specific to the software implementation(non common).

See PxcgetThreadContext.

Not thread-safe, so remember to have one object per thread!

TODO! refactor this and rename(it is a general per thread cache). Move transform cache into its own class.
*/
class ThreadContext : public PxcThreadCoherentCache<ThreadContext, PxcNpMemBlockPool>::EntryBase
{
	PX_NOCOPY(ThreadContext)
public:

#if PX_ENABLE_SIM_STATS
	struct ThreadSimStats
	{
		void clear()
		{
			numActiveConstraints = 0;
			numActiveDynamicBodies = 0;
			numActiveKinematicBodies = 0;
			numAxisSolverConstraints = 0;
		}

		PxU32 numActiveConstraints;
		PxU32 numActiveDynamicBodies;
		PxU32 numActiveKinematicBodies;
		PxU32 numAxisSolverConstraints;
	};
#else
	PX_CATCH_UNDEFINED_ENABLE_SIM_STATS
#endif

	//TODO: tune cache size based on number of active objects.
	ThreadContext(PxcNpMemBlockPool* memBlockPool);
	void reset();
	void resizeArrays(PxU32 articulationCount);

#if PX_ENABLE_SIM_STATS
	PX_FORCE_INLINE ThreadSimStats& getSimStats()
	{
		return mThreadSimStats;
	}
#else
	PX_CATCH_UNDEFINED_ENABLE_SIM_STATS
#endif

	PxContactBuffer								mContactBuffer;

		// temporary buffer for correlation
	PX_ALIGN(16, CorrelationBuffer				mCorrelationBuffer); 

	FrictionPatchStreamPair						mFrictionPatchStreamPair;	// patch streams

	PxsConstraintBlockManager					mConstraintBlockManager;	// for when this thread context is "lead" on an island
	PxcConstraintBlockStream 					mConstraintBlockStream;		// constraint block pool

	// this stuff is just used for reformatting the solver data. Hopefully we should have a more
	// sane format for this when the dust settles - so it's just temporary. If we keep this around
	// here we should move these from public to private

	PxU32										mNumDifferentBodyConstraints;
	PxU32										mNumStaticConstraints;
	bool										mHasOverflowPartitions;

	PxU32										mNbArticulations;

	PxArray<PxU32>								mConstraintsPerPartition;
	//PxArray<PxU32>								mPartitionNormalizationBitmap;	// PT: for PX_NORMALIZE_PARTITIONS
	PxsBodyCore**								mBodyCoreArray;
	PxsRigidBody**								mRigidBodyArray;
	FeatherstoneArticulation**					mArticulationArray;
	Cm::SpatialVector*							motionVelocityArray;
	PxU32*										bodyRemapTable;
	PxU32*										mNodeIndexArray;

	// PT: TODO: unify names around here, some use "m", some don't

	//Constraint info for normal constraint solver
	PxSolverConstraintDesc*						contactConstraintDescArray;
	PxU32										contactDescArraySize;
	PxSolverConstraintDesc*						orderedContactConstraints;
	PxConstraintBatchHeader*					contactConstraintBatchHeaders;
	PxU32										numContactConstraintBatches;

	//Constraint info for partitioning
	PxSolverConstraintDesc*						tempConstraintDescArray;

#if PGS_SUPPORT_COMPOUND_CONSTRAINTS
	//Info for tracking compound contact managers (temporary data - could use scratch memory!)
	PxArray<CompoundContactManager>				compoundConstraints;

	//Used for sorting constraints. Temporary, could use scratch memory
	PxArray<const PxsIndexedContactManager*>	orderedContactList;
	PxArray<const PxsIndexedContactManager*>	tempContactList;
	PxArray<PxU32>								sortIndexArray;
#endif

	PxArray<Cm::SpatialVectorF>					mZVector; // scratch space, used for propagation during constraint prepping
	PxArray<Cm::SpatialVectorF>					mDeltaV; // scratch space, used temporarily for propagating velocities

	PxU32										mOrderedContactDescCount;
	PxU32										mOrderedFrictionDescCount;

	PxU32										mConstraintSize;		// PT: TODO: consider removing, this is only used for stats
	PxU32										mAxisConstraintCount;	// PT: TODO: consider removing, this is only used for stats

	PxU32										mMaxPartitions;
	PxU32										mMaxFrictionPartitions;
	PxU32										mMaxSolverPositionIterations;
	PxU32										mMaxSolverVelocityIterations;
	PxU32										mMaxArticulationLinks;
	
	PxSolverConstraintDesc*						mContactDescPtr;
private:

#if PX_ENABLE_SIM_STATS
	ThreadSimStats								mThreadSimStats;
#else
	PX_CATCH_UNDEFINED_ENABLE_SIM_STATS
#endif
};

}

}

#endif