// Redistribution and use in source and binary forms, with or without // modification, are permitted provided that the following conditions // are met: // * Redistributions of source code must retain the above copyright // notice, this list of conditions and the following disclaimer. // * Redistributions in binary form must reproduce the above copyright // notice, this list of conditions and the following disclaimer in the // documentation and/or other materials provided with the distribution. // * Neither the name of NVIDIA CORPORATION nor the names of its // contributors may be used to endorse or promote products derived // from this software without specific prior written permission. // // THIS SOFTWARE IS PROVIDED BY THE COPYRIGHT HOLDERS ''AS IS'' AND ANY // EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE // IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR // PURPOSE ARE DISCLAIMED. IN NO EVENT SHALL THE COPYRIGHT OWNER OR // CONTRIBUTORS BE LIABLE FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, // EXEMPLARY, OR CONSEQUENTIAL DAMAGES (INCLUDING, BUT NOT LIMITED TO, // PROCUREMENT OF SUBSTITUTE GOODS OR SERVICES; LOSS OF USE, DATA, OR // PROFITS; OR BUSINESS INTERRUPTION) HOWEVER CAUSED AND ON ANY THEORY // OF LIABILITY, WHETHER IN CONTRACT, STRICT LIABILITY, OR TORT // (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY OUT OF THE USE // OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF SUCH DAMAGE. // // Copyright (c) 2008-2025 NVIDIA Corporation. All rights reserved. // Copyright (c) 2004-2008 AGEIA Technologies, Inc. All rights reserved. // Copyright (c) 2001-2004 NovodeX AG. All rights reserved. #include "ExtDistanceJoint.h" #include "ExtConstraintHelper.h" #include "omnipvd/ExtOmniPvdSetData.h" using namespace physx; using namespace Ext; DistanceJoint::DistanceJoint(const PxTolerancesScale& scale, PxRigidActor* actor0, const PxTransform& localFrame0, PxRigidActor* actor1, const PxTransform& localFrame1) : DistanceJointT(PxJointConcreteType::eDISTANCE, actor0, localFrame0, actor1, localFrame1, "DistanceJointData") { DistanceJointData* data = static_cast(mData); data->stiffness = 0.0f; data->damping = 0.0f; data->minDistance = 0.0f; data->maxDistance = 0.0f; data->tolerance = 0.025f * scale.length; data->jointFlags = PxDistanceJointFlag::eMAX_DISTANCE_ENABLED; } PxReal DistanceJoint::getDistance() const { return getRelativeTransform().p.magnitude(); } void DistanceJoint::setMinDistance(PxReal distance) { PX_CHECK_AND_RETURN(PxIsFinite(distance) && distance>=0.0f, "PxDistanceJoint::setMinDistance: invalid parameter"); data().minDistance = distance; markDirty(); OMNI_PVD_SET(OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, minDistance, static_cast(*this), distance) } PxReal DistanceJoint::getMinDistance() const { return data().minDistance; } void DistanceJoint::setMaxDistance(PxReal distance) { PX_CHECK_AND_RETURN(PxIsFinite(distance) && distance>=0.0f, "PxDistanceJoint::setMaxDistance: invalid parameter"); data().maxDistance = distance; markDirty(); OMNI_PVD_SET(OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, maxDistance, static_cast(*this), distance) } PxReal DistanceJoint::getMaxDistance() const { return data().maxDistance; } void DistanceJoint::setTolerance(PxReal tolerance) { PX_CHECK_AND_RETURN(PxIsFinite(tolerance), "PxDistanceJoint::setTolerance: invalid parameter"); data().tolerance = tolerance; markDirty(); OMNI_PVD_SET(OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, tolerance, static_cast(*this), tolerance) } PxReal DistanceJoint::getTolerance() const { return data().tolerance; } void DistanceJoint::setStiffness(PxReal stiffness) { PX_CHECK_AND_RETURN(PxIsFinite(stiffness), "PxDistanceJoint::setStiffness: invalid parameter"); data().stiffness = stiffness; markDirty(); OMNI_PVD_SET(OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, stiffness, static_cast(*this), stiffness) } PxReal DistanceJoint::getStiffness() const { return data().stiffness; } void DistanceJoint::setDamping(PxReal damping) { PX_CHECK_AND_RETURN(PxIsFinite(damping), "PxDistanceJoint::setDamping: invalid parameter"); data().damping = damping; markDirty(); OMNI_PVD_SET(OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, damping, static_cast(*this), damping) } PxReal DistanceJoint::getDamping() const { return data().damping; } PxDistanceJointFlags DistanceJoint::getDistanceJointFlags() const { return data().jointFlags; } void DistanceJoint::setDistanceJointFlags(PxDistanceJointFlags flags) { data().jointFlags = flags; markDirty(); OMNI_PVD_SET(OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, jointFlags, static_cast(*this), flags) } void DistanceJoint::setDistanceJointFlag(PxDistanceJointFlag::Enum flag, bool value) { if(value) data().jointFlags |= flag; else data().jointFlags &= ~flag; markDirty(); OMNI_PVD_SET(OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, jointFlags, static_cast(*this), getDistanceJointFlags()) } static void DistanceJointVisualize(PxConstraintVisualizer& viz, const void* constantBlock, const PxTransform& body0Transform, const PxTransform& body1Transform, PxU32 flags) { const DistanceJointData& data = *reinterpret_cast(constantBlock); PxTransform32 cA2w, cB2w; joint::computeJointFrames(cA2w, cB2w, data, body0Transform, body1Transform); if(flags & PxConstraintVisualizationFlag::eLOCAL_FRAMES) viz.visualizeJointFrames(cA2w, cB2w); // PT: we consider the following is part of the joint's "limits" since that's the only available flag we have if(flags & PxConstraintVisualizationFlag::eLIMITS) { const bool enforceMax = (data.jointFlags & PxDistanceJointFlag::eMAX_DISTANCE_ENABLED); const bool enforceMin = (data.jointFlags & PxDistanceJointFlag::eMIN_DISTANCE_ENABLED); if(!enforceMin && !enforceMax) return; PxVec3 dir = cB2w.p - cA2w.p; const float currentDist = dir.normalize(); PxU32 color = 0x00ff00; if(enforceMax && currentDist>data.maxDistance) color = 0xff0000; if(enforceMin && currentDist=data.minDistance) c.flags |= Px1DConstraintFlag::eKEEPBIAS; return 1; } static PX_FORCE_INLINE PxU32 setupMaxConstraint(Px1DConstraint& c, const PxVec3& direction, const PxVec3& angular0, const PxVec3& angular1, const DistanceJointData& data, float distance) { setupConstraint(c, direction, angular0, angular1, data); c.geometricError = distance - data.maxDistance - data.tolerance; c.maxImpulse = 0.0f; if(distance<=data.maxDistance) c.flags |= Px1DConstraintFlag::eKEEPBIAS; return 1; } //TAG:solverprepshader static PxU32 DistanceJointSolverPrep(Px1DConstraint* constraints, PxVec3p& body0WorldOffset, PxU32 /*maxConstraints*/, PxConstraintInvMassScale& invMassScale, const void* constantBlock, const PxTransform& bA2w, const PxTransform& bB2w, bool /*useExtendedLimits*/, PxVec3p& cA2wOut, PxVec3p& cB2wOut) { const DistanceJointData& data = *reinterpret_cast(constantBlock); const bool enforceMax = (data.jointFlags & PxDistanceJointFlag::eMAX_DISTANCE_ENABLED) && data.maxDistance>=0.0f; const bool enforceMin = (data.jointFlags & PxDistanceJointFlag::eMIN_DISTANCE_ENABLED) && data.minDistance>=0.0f; if(!enforceMax && !enforceMin) return 0; PxTransform32 cA2w, cB2w; joint::ConstraintHelper ch(constraints, invMassScale, cA2w, cB2w, body0WorldOffset, data, bA2w, bB2w); cA2wOut = cB2w.p; cB2wOut = cB2w.p; PxVec3 direction = cA2w.p - cB2w.p; const PxReal distance = direction.normalize(); #define EPS_REAL 1.192092896e-07F if(distance < EPS_REAL) direction = PxVec3(1.0f, 0.0f, 0.0f); Px1DConstraint* c = constraints; const PxVec3 angular0 = ch.getRa().cross(direction); const PxVec3 angular1 = ch.getRb().cross(direction); if(enforceMin && !enforceMax) return setupMinConstraint(*c, direction, angular0, angular1, data, distance); else if(enforceMax && !enforceMin) return setupMaxConstraint(*c, direction, angular0, angular1, data, distance); else { if(data.minDistance == data.maxDistance) { setupConstraint(*c, direction, angular0, angular1, data); //add tolerance so we don't have contact-style jitter problem. const PxReal error = distance - data.maxDistance; c->geometricError = error > data.tolerance ? error - data.tolerance : error < -data.tolerance ? error + data.tolerance : 0.0f; return 1; } // since we dont know the current rigid velocity, we need to insert row for both limits PxU32 nb = setupMinConstraint(*c, direction, angular0, angular1, data, distance); if(nb) c++; nb += setupMaxConstraint(*c, direction, angular0, angular1, data, distance); return nb; } } /////////////////////////////////////////////////////////////////////////////// static PxConstraintShaderTable gDistanceJointShaders = { DistanceJointSolverPrep, DistanceJointVisualize, PxConstraintFlag::Enum(0) }; PxConstraintSolverPrep DistanceJoint::getPrep() const { return gDistanceJointShaders.solverPrep; } PxDistanceJoint* physx::PxDistanceJointCreate(PxPhysics& physics, PxRigidActor* actor0, const PxTransform& localFrame0, PxRigidActor* actor1, const PxTransform& localFrame1) { PX_CHECK_AND_RETURN_NULL(localFrame0.isSane(), "PxDistanceJointCreate: local frame 0 is not a valid transform"); PX_CHECK_AND_RETURN_NULL(localFrame1.isSane(), "PxDistanceJointCreate: local frame 1 is not a valid transform"); PX_CHECK_AND_RETURN_NULL(actor0 != actor1, "PxDistanceJointCreate: actors must be different"); PX_CHECK_AND_RETURN_NULL((actor0 && actor0->is()) || (actor1 && actor1->is()), "PxD6JointCreate: at least one actor must be dynamic"); return createJointT(physics, actor0, localFrame0, actor1, localFrame1, gDistanceJointShaders); } // PX_SERIALIZATION void DistanceJoint::resolveReferences(PxDeserializationContext& context) { mPxConstraint = resolveConstraintPtr(context, mPxConstraint, this, gDistanceJointShaders); } //~PX_SERIALIZATION #if PX_SUPPORT_OMNI_PVD void DistanceJoint::updateOmniPvdProperties() const { const PxDistanceJoint& j = static_cast(*this); OMNI_PVD_SET(OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, distance, j, getDistance()) } template<> void physx::Ext::omniPvdInitJoint(DistanceJoint& joint) { OMNI_PVD_WRITE_SCOPE_BEGIN(pvdWriter, pvdRegData) PxDistanceJoint& j = static_cast(joint); OMNI_PVD_CREATE_EXPLICIT(pvdWriter, pvdRegData, OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, j); omniPvdSetBaseJointParams(static_cast(joint), PxJointConcreteType::eDISTANCE); OMNI_PVD_SET_EXPLICIT(pvdWriter, pvdRegData, OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, minDistance, j, joint.getMinDistance()) OMNI_PVD_SET_EXPLICIT(pvdWriter, pvdRegData, OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, maxDistance, j, joint.getMaxDistance()) OMNI_PVD_SET_EXPLICIT(pvdWriter, pvdRegData, OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, tolerance, j, joint.getTolerance()) OMNI_PVD_SET_EXPLICIT(pvdWriter, pvdRegData, OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, stiffness, j, joint.getStiffness()) OMNI_PVD_SET_EXPLICIT(pvdWriter, pvdRegData, OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, damping, j, joint.getDamping()) OMNI_PVD_SET_EXPLICIT(pvdWriter, pvdRegData, OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, jointFlags, j, joint.getDistanceJointFlags()) OMNI_PVD_SET_EXPLICIT(pvdWriter, pvdRegData, OMNI_PVD_CONTEXT_HANDLE, PxDistanceJoint, distance, j, joint.getDistance()) OMNI_PVD_WRITE_SCOPE_END } #endif