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.

3.7 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 EXT_DEFAULT_CPU_DISPATCHER_H
#define EXT_DEFAULT_CPU_DISPATCHER_H

#include "common/PxProfileZone.h"
#include "task/PxTask.h"
#include "extensions/PxDefaultCpuDispatcher.h"

#include "foundation/PxUserAllocated.h"
#include "foundation/PxSync.h"
#include "ExtSharedQueueEntryPool.h"
#include "ExtTaskQueueHelper.h"
#include "ExtCpuWorkerThread.h"

namespace physx
{
namespace Ext
{
#if PX_VC
#pragma warning(push)
#pragma warning(disable:4324)	// Padding was added at the end of a structure because of a __declspec(align) value.
#endif							// Because of the SList member I assume

	class DefaultCpuDispatcher : public PxDefaultCpuDispatcher, public PxUserAllocated
	{
																		PX_NOCOPY(DefaultCpuDispatcher)
	private:
																		~DefaultCpuDispatcher();
	public:
																		DefaultCpuDispatcher(PxU32 numThreads, PxU32* affinityMasks, PxDefaultCpuDispatcherWaitForWorkMode::Enum mode = PxDefaultCpuDispatcherWaitForWorkMode::eWAIT_FOR_WORK, PxU32 yieldProcessorCount = 0);

		// PxCpuDispatcher
		virtual			void											submitTask(PxBaseTask& task)		PX_OVERRIDE;
		virtual			PxU32											getWorkerCount()	const			PX_OVERRIDE	{ return mNumThreads;			}
		//~PxCpuDispatcher

		// PxDefaultCpuDispatcher
		virtual			void											release()							PX_OVERRIDE;
		virtual			void											setRunProfiled(bool runProfiled)	PX_OVERRIDE	{ mRunProfiled = runProfiled;	}
		virtual			bool											getRunProfiled()	const			PX_OVERRIDE	{ return mRunProfiled;			}
		//~PxDefaultCpuDispatcher

		template<const bool highPriorityT>
						PxBaseTask*										fetchNextTask()
																		{
																			// PT: get job from local list
																			PxBaseTask* task = mHelper.fetchTask<highPriorityT>();
																			if(!task)
																			{
																				// PT: steal job from other threads
																				const PxU32 nbThreads = mNumThreads;
																				for(PxU32 i=0; i<nbThreads; ++i)
																				{
																					task = mWorkerThreads[i].getJob<highPriorityT>();
																					if(task)
																						return task;
																				}
																			}
																			return task;
																		}

		PX_FORCE_INLINE	void											runTask(PxBaseTask& task)
																		{
																			if(mRunProfiled)
																			{
																				PX_PROFILE_ZONE(task.getName(), task.getContextId());
																				task.run();
																			}
																			else
																				task.run();
																		}

    					void											waitForWork()						{ PX_ASSERT(PxDefaultCpuDispatcherWaitForWorkMode::eWAIT_FOR_WORK == mWaitForWorkMode); mWorkReady.wait(); }
						void											resetWakeSignal();

		static			void											getAffinityMasks(PxU32* affinityMasks, PxU32 threadCount);

		PX_FORCE_INLINE	PxDefaultCpuDispatcherWaitForWorkMode::Enum		getWaitForWorkMode()		const	{ return mWaitForWorkMode;		}
		PX_FORCE_INLINE	PxU32											getYieldProcessorCount()	const	{ return mYieldProcessorCount;	}

	protected:
						CpuWorkerThread*								mWorkerThreads;
						TaskQueueHelper									mHelper;
						PxSync											mWorkReady;
						PxU8*											mThreadNames;
						PxU32											mNumThreads;
						bool											mShuttingDown;
						bool											mRunProfiled;
		const			PxDefaultCpuDispatcherWaitForWorkMode::Enum		mWaitForWorkMode;
		const			PxU32											mYieldProcessorCount;
	};

#if PX_VC
#pragma warning(pop)
#endif

} // namespace Ext
}

#endif