Revision control

Copy as Markdown

// SPDX-FileCopyrightText: Copyright (c) 2008-2026 NVIDIA CORPORATION & AFFILIATES. All rights reserved.
// SPDX-License-Identifier: Apache-2.0
#ifndef SC_SHAPESIM_BASE_H
#define SC_SHAPESIM_BASE_H
#include "ScElementSim.h"
#include "ScShapeCore.h"
#include "ScRigidSim.h"
namespace physx
{
namespace Sc
{
class ShapeCore;
struct UpdateCachedParams
{
PX_FORCE_INLINE UpdateCachedParams(PxsTransformCache& cache, Bp::BoundsArray& bounds, PxU32 flags = 0) :
mTransformCache(cache), mBoundsArray(bounds), mTransformFlags(flags) {}
PxsTransformCache& mTransformCache;
Bp::BoundsArray& mBoundsArray;
PxU32 mTransformFlags;
};
class ShapeSimBase : public ElementSim
{
PX_NOCOPY(ShapeSimBase)
public:
ShapeSimBase(ActorSim& owner, const ShapeCore* core) :
ElementSim (owner),
mSqBoundsId (PX_INVALID_U32),
mPrunerIndex(PX_INVALID_U32)
{ setCore(core); }
~ShapeSimBase() { }
PX_FORCE_INLINE void setCore(const ShapeCore* core);
PX_FORCE_INLINE const ShapeCore& getCore() const;
PX_FORCE_INLINE bool isPxsCoreValid() const { return mShapeCore != NULL; }
PX_INLINE PxGeometryType::Enum getGeometryType() const { return getCore().getGeometryType(); }
// This is just for getting a reference for the user, so we cast away const-ness
PX_INLINE PxShape* getPxShape() const { return const_cast<PxShape*>(getCore().getPxShape()); }
PX_FORCE_INLINE PxReal getRestOffset() const { return getCore().getRestOffset(); }
PX_FORCE_INLINE PxReal getTorsionalPatchRadius() const { return getCore().getTorsionalPatchRadius(); }
PX_FORCE_INLINE PxReal getMinTorsionalPatchRadius() const { return getCore().getMinTorsionalPatchRadius(); }
PX_FORCE_INLINE PxU32 getFlags() const { return getCore().getFlags(); }
PX_FORCE_INLINE PxReal getContactOffset() const { return getCore().getContactOffset(); }
PX_FORCE_INLINE PxU32 getTransformCacheID() const { return getElementID(); }
PX_FORCE_INLINE PxU32 getSqBoundsId() const { return mSqBoundsId; }
PX_FORCE_INLINE void setSqBoundsId(PxU32 id) { mSqBoundsId = id; }
PX_FORCE_INLINE PxU32 getSqPrunerIndex() const { return mPrunerIndex; }
PX_FORCE_INLINE void setSqPrunerIndex(PxU32 index) { mPrunerIndex = index; }
PX_FORCE_INLINE PxsShapeCore* getPxsShapeCore() { return mShapeCore; }
void onFilterDataChange();
void onRestOffsetChange();
void onFlagChange(PxShapeFlags oldFlags);
void onResetFiltering();
void onVolumeOrTransformChange();
void onContactOffsetChange();
void markBoundsForUpdate();
void reinsertBroadPhase();
void removeFromBroadPhase(bool wakeOnLostTouch);
void getAbsPoseAligned(PxTransform* PX_RESTRICT globalPose) const;
PxNodeIndex getActorNodeIndex() const;
PX_FORCE_INLINE RigidSim& getRbSim() const { return static_cast<RigidSim&>(getActor()); }
BodySim* getBodySim() const;
PxsRigidCore& getPxsRigidCore() const;
void createSqBounds();
void destroySqBounds();
// PT: we now use two separate bools to control what the code is doing:
// "fromTask" indicates whether this is called from a single-threaded caller or from multiple tasks. If true, the transform cache changed bool is not set,
// and the virtual calls from updateBounds are skipped.
// "useAtomics" tells the code to use atomic ORs to update the bitmap.
void updateCached(const UpdateCachedParams& params, Cm::PinnableBitMap* shapeChangedMap, bool fromTask, bool useAtomics);
// PT: use this version when calling from a single thread. In particular the code is not thread-safe
// when shapeChangedMap is not null. If shapeChangedMap is null, the code might be safe to call from
// multiple threads but it could be suboptimal, as we will write to the same cache line from multiple
// threads. If shapeChangedMap is not null, the 'useAtomics' parameter controls if writes to the map
// use atomics or not.
PX_FORCE_INLINE void updateCached_NotThreadSafe(const UpdateCachedParams& params, Cm::PinnableBitMap* shapeChangedMap, bool fromTask, bool useAtomics)
{
updateCached(params, shapeChangedMap, fromTask, useAtomics);
}
// PT: use this version when calling from multiple threads. It still has potential performance issues
// from false sharing but it should be safe. Callers are expected to:
// - set PxsTransformCache::mHasAnythingChanged and BoundsArray::mHasAnythingChanged themselves
// - do the changed bitmap update outside of the call (although we could use atomic ORs these days)
PX_FORCE_INLINE void updateCached_ThreadSafe(const UpdateCachedParams& params)
{
updateCached(params, NULL, true, true);
}
void updateBPGroup();
protected:
PX_FORCE_INLINE void internalAddToBroadPhase();
PX_FORCE_INLINE bool internalRemoveFromBroadPhase(bool wakeOnLostTouch = true);
void initSubsystemsDependingOnElementID(PxU32 indexFrom);
ShapeCore* mShapeCore;
PxU32 mSqBoundsId;
PxU32 mPrunerIndex;
};
PX_FORCE_INLINE void ShapeSimBase::setCore(const ShapeCore* core)
{
mShapeCore = const_cast<ShapeCore*>(core);
}
PX_FORCE_INLINE const ShapeCore& ShapeSimBase::getCore() const
{
return *mShapeCore;
}
} // namespace Sc
}
#endif