Files
godot/modules/jolt_physics/joints/jolt_generic_6dof_joint_3d.cpp
noahbackus 9d30169a8d
Some checks failed
🔗 GHA / 📊 Static checks (push) Has been cancelled
🔗 GHA / 🤖 Android (push) Has been cancelled
🔗 GHA / 🍏 iOS (push) Has been cancelled
🔗 GHA / 🐧 Linux (push) Has been cancelled
🔗 GHA / 🍎 macOS (push) Has been cancelled
🔗 GHA / 🏁 Windows (push) Has been cancelled
🔗 GHA / 🌐 Web (push) Has been cancelled
initial commit, 4.5 stable
2025-09-16 20:46:46 -04:00

687 lines
25 KiB
C++

/**************************************************************************/
/* jolt_generic_6dof_joint_3d.cpp */
/**************************************************************************/
/* This file is part of: */
/* GODOT ENGINE */
/* https://godotengine.org */
/**************************************************************************/
/* Copyright (c) 2014-present Godot Engine contributors (see AUTHORS.md). */
/* Copyright (c) 2007-2014 Juan Linietsky, Ariel Manzur. */
/* */
/* Permission is hereby granted, free of charge, to any person obtaining */
/* a copy of this software and associated documentation files (the */
/* "Software"), to deal in the Software without restriction, including */
/* without limitation the rights to use, copy, modify, merge, publish, */
/* distribute, sublicense, and/or sell copies of the Software, and to */
/* permit persons to whom the Software is furnished to do so, subject to */
/* the following conditions: */
/* */
/* The above copyright notice and this permission notice shall be */
/* included in all copies or substantial portions of the Software. */
/* */
/* THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, */
/* EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF */
/* MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. */
/* IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY */
/* CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, */
/* TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE */
/* SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE. */
/**************************************************************************/
#include "jolt_generic_6dof_joint_3d.h"
#include "../misc/jolt_type_conversions.h"
#include "../objects/jolt_body_3d.h"
#include "../spaces/jolt_space_3d.h"
#include "Jolt/Physics/Constraints/SixDOFConstraint.h"
namespace {
constexpr double G6DOF_DEFAULT_LINEAR_LIMIT_SOFTNESS = 0.7;
constexpr double G6DOF_DEFAULT_LINEAR_RESTITUTION = 0.5;
constexpr double G6DOF_DEFAULT_LINEAR_DAMPING = 1.0;
constexpr double G6DOF_DEFAULT_ANGULAR_LIMIT_SOFTNESS = 0.5;
constexpr double G6DOF_DEFAULT_ANGULAR_DAMPING = 1.0;
constexpr double G6DOF_DEFAULT_ANGULAR_RESTITUTION = 0.0;
constexpr double G6DOF_DEFAULT_ANGULAR_FORCE_LIMIT = 0.0;
constexpr double G6DOF_DEFAULT_ANGULAR_ERP = 0.5;
} // namespace
JPH::Constraint *JoltGeneric6DOFJoint3D::_build_6dof(JPH::Body *p_jolt_body_a, JPH::Body *p_jolt_body_b, const Transform3D &p_shifted_ref_a, const Transform3D &p_shifted_ref_b) const {
JPH::SixDOFConstraintSettings constraint_settings;
for (int axis = 0; axis < AXIS_COUNT; ++axis) {
double lower = limit_lower[axis];
double upper = limit_upper[axis];
if (axis >= AXIS_ANGULAR_X && axis <= AXIS_ANGULAR_Z) {
const double temp = lower;
lower = -upper;
upper = -temp;
}
if (!limit_enabled[axis] || lower > upper) {
constraint_settings.MakeFreeAxis((JoltAxis)axis);
} else {
constraint_settings.SetLimitedAxis((JoltAxis)axis, (float)lower, (float)upper);
}
}
constraint_settings.mSpace = JPH::EConstraintSpace::LocalToBodyCOM;
constraint_settings.mPosition1 = to_jolt_r(p_shifted_ref_a.origin);
constraint_settings.mAxisX1 = to_jolt(p_shifted_ref_a.basis.get_column(Vector3::AXIS_X));
constraint_settings.mAxisY1 = to_jolt(p_shifted_ref_a.basis.get_column(Vector3::AXIS_Y));
constraint_settings.mPosition2 = to_jolt_r(p_shifted_ref_b.origin);
constraint_settings.mAxisX2 = to_jolt(p_shifted_ref_b.basis.get_column(Vector3::AXIS_X));
constraint_settings.mAxisY2 = to_jolt(p_shifted_ref_b.basis.get_column(Vector3::AXIS_Y));
constraint_settings.mSwingType = JPH::ESwingType::Pyramid;
if (p_jolt_body_a == nullptr) {
return constraint_settings.Create(JPH::Body::sFixedToWorld, *p_jolt_body_b);
} else if (p_jolt_body_b == nullptr) {
return constraint_settings.Create(*p_jolt_body_a, JPH::Body::sFixedToWorld);
} else {
return constraint_settings.Create(*p_jolt_body_a, *p_jolt_body_b);
}
}
void JoltGeneric6DOFJoint3D::_update_limit_spring_parameters(int p_axis) {
JPH::SixDOFConstraint *constraint = static_cast<JPH::SixDOFConstraint *>(jolt_ref.GetPtr());
if (unlikely(constraint == nullptr)) {
return;
}
JPH::SpringSettings settings = constraint->GetLimitsSpringSettings((JoltAxis)p_axis);
settings.mMode = JPH::ESpringMode::FrequencyAndDamping;
if (limit_spring_enabled[p_axis]) {
settings.mFrequency = (float)limit_spring_frequency[p_axis];
settings.mDamping = (float)limit_spring_damping[p_axis];
} else {
settings.mFrequency = 0.0f;
settings.mDamping = 0.0f;
}
constraint->SetLimitsSpringSettings((JoltAxis)p_axis, settings);
}
void JoltGeneric6DOFJoint3D::_update_motor_state(int p_axis) {
if (JPH::SixDOFConstraint *constraint = static_cast<JPH::SixDOFConstraint *>(jolt_ref.GetPtr())) {
if (motor_enabled[p_axis]) {
constraint->SetMotorState((JoltAxis)p_axis, JPH::EMotorState::Velocity);
} else if (spring_enabled[p_axis]) {
constraint->SetMotorState((JoltAxis)p_axis, JPH::EMotorState::Position);
} else {
constraint->SetMotorState((JoltAxis)p_axis, JPH::EMotorState::Off);
}
}
}
void JoltGeneric6DOFJoint3D::_update_motor_velocity(int p_axis) {
JPH::SixDOFConstraint *constraint = static_cast<JPH::SixDOFConstraint *>(jolt_ref.GetPtr());
if (unlikely(constraint == nullptr)) {
return;
}
if (p_axis >= AXIS_LINEAR_X && p_axis <= AXIS_LINEAR_Z) {
constraint->SetTargetVelocityCS(JPH::Vec3(
(float)motor_speed[AXIS_LINEAR_X],
(float)motor_speed[AXIS_LINEAR_Y],
(float)motor_speed[AXIS_LINEAR_Z]));
} else {
// We flip the direction since Jolt is CCW but Godot is CW.
constraint->SetTargetAngularVelocityCS(JPH::Vec3(
(float)-motor_speed[AXIS_ANGULAR_X],
(float)-motor_speed[AXIS_ANGULAR_Y],
(float)-motor_speed[AXIS_ANGULAR_Z]));
}
}
void JoltGeneric6DOFJoint3D::_update_motor_limit(int p_axis) {
JPH::SixDOFConstraint *constraint = static_cast<JPH::SixDOFConstraint *>(jolt_ref.GetPtr());
if (unlikely(constraint == nullptr)) {
return;
}
JPH::MotorSettings &motor_settings = constraint->GetMotorSettings((JoltAxis)p_axis);
float limit = FLT_MAX;
if (motor_enabled[p_axis]) {
limit = (float)motor_limit[p_axis];
} else if (spring_enabled[p_axis]) {
limit = (float)spring_limit[p_axis];
}
if (p_axis >= AXIS_LINEAR_X && p_axis <= AXIS_LINEAR_Z) {
motor_settings.SetForceLimit(limit);
} else {
motor_settings.SetTorqueLimit(limit);
}
}
void JoltGeneric6DOFJoint3D::_update_spring_parameters(int p_axis) {
JPH::SixDOFConstraint *constraint = static_cast<JPH::SixDOFConstraint *>(jolt_ref.GetPtr());
if (unlikely(constraint == nullptr)) {
return;
}
JPH::MotorSettings &motor_settings = constraint->GetMotorSettings((JoltAxis)p_axis);
if (spring_use_frequency[p_axis]) {
motor_settings.mSpringSettings.mMode = JPH::ESpringMode::FrequencyAndDamping;
motor_settings.mSpringSettings.mFrequency = (float)spring_frequency[p_axis];
} else {
motor_settings.mSpringSettings.mMode = JPH::ESpringMode::StiffnessAndDamping;
motor_settings.mSpringSettings.mStiffness = (float)spring_stiffness[p_axis];
}
motor_settings.mSpringSettings.mDamping = (float)spring_damping[p_axis];
}
void JoltGeneric6DOFJoint3D::_update_spring_equilibrium(int p_axis) {
JPH::SixDOFConstraint *constraint = static_cast<JPH::SixDOFConstraint *>(jolt_ref.GetPtr());
if (unlikely(constraint == nullptr)) {
return;
}
if (p_axis >= AXIS_LINEAR_X && p_axis <= AXIS_LINEAR_Z) {
const Vector3 target_position = Vector3(
(float)spring_equilibrium[AXIS_LINEAR_X],
(float)spring_equilibrium[AXIS_LINEAR_Y],
(float)spring_equilibrium[AXIS_LINEAR_Z]);
constraint->SetTargetPositionCS(to_jolt(target_position));
} else {
// We flip the direction since Jolt is CCW but Godot is CW.
const Basis target_orientation = Basis::from_euler(
Vector3((float)-spring_equilibrium[AXIS_ANGULAR_X],
(float)-spring_equilibrium[AXIS_ANGULAR_Y],
(float)-spring_equilibrium[AXIS_ANGULAR_Z]),
EulerOrder::ZYX);
constraint->SetTargetOrientationCS(to_jolt(target_orientation));
}
}
void JoltGeneric6DOFJoint3D::_limits_changed() {
rebuild();
_wake_up_bodies();
}
void JoltGeneric6DOFJoint3D::_limit_spring_parameters_changed(int p_axis) {
_update_limit_spring_parameters(p_axis);
_wake_up_bodies();
}
void JoltGeneric6DOFJoint3D::_motor_state_changed(int p_axis) {
_update_motor_state(p_axis);
_update_motor_limit(p_axis);
_wake_up_bodies();
}
void JoltGeneric6DOFJoint3D::_motor_speed_changed(int p_axis) {
_update_motor_velocity(p_axis);
_wake_up_bodies();
}
void JoltGeneric6DOFJoint3D::_motor_limit_changed(int p_axis) {
_update_motor_limit(p_axis);
_wake_up_bodies();
}
void JoltGeneric6DOFJoint3D::_spring_state_changed(int p_axis) {
_update_motor_state(p_axis);
_wake_up_bodies();
}
void JoltGeneric6DOFJoint3D::_spring_parameters_changed(int p_axis) {
_update_spring_parameters(p_axis);
_wake_up_bodies();
}
void JoltGeneric6DOFJoint3D::_spring_equilibrium_changed(int p_axis) {
_update_spring_equilibrium(p_axis);
_wake_up_bodies();
}
void JoltGeneric6DOFJoint3D::_spring_limit_changed(int p_axis) {
_update_motor_limit(p_axis);
_wake_up_bodies();
}
JoltGeneric6DOFJoint3D::JoltGeneric6DOFJoint3D(const JoltJoint3D &p_old_joint, JoltBody3D *p_body_a, JoltBody3D *p_body_b, const Transform3D &p_local_ref_a, const Transform3D &p_local_ref_b) :
JoltJoint3D(p_old_joint, p_body_a, p_body_b, p_local_ref_a, p_local_ref_b) {
rebuild();
}
double JoltGeneric6DOFJoint3D::get_param(Axis p_axis, Param p_param) const {
const int axis_lin = AXES_LINEAR + (int)p_axis;
const int axis_ang = AXES_ANGULAR + (int)p_axis;
switch ((int)p_param) {
case PhysicsServer3D::G6DOF_JOINT_LINEAR_LOWER_LIMIT: {
return limit_lower[axis_lin];
}
case PhysicsServer3D::G6DOF_JOINT_LINEAR_UPPER_LIMIT: {
return limit_upper[axis_lin];
}
case PhysicsServer3D::G6DOF_JOINT_LINEAR_LIMIT_SOFTNESS: {
return G6DOF_DEFAULT_LINEAR_LIMIT_SOFTNESS;
}
case PhysicsServer3D::G6DOF_JOINT_LINEAR_RESTITUTION: {
return G6DOF_DEFAULT_LINEAR_RESTITUTION;
}
case PhysicsServer3D::G6DOF_JOINT_LINEAR_DAMPING: {
return G6DOF_DEFAULT_LINEAR_DAMPING;
}
case PhysicsServer3D::G6DOF_JOINT_LINEAR_MOTOR_TARGET_VELOCITY: {
return motor_speed[axis_lin];
}
case PhysicsServer3D::G6DOF_JOINT_LINEAR_MOTOR_FORCE_LIMIT: {
return motor_limit[axis_lin];
}
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_SPRING_STIFFNESS: {
return spring_stiffness[axis_lin];
}
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_SPRING_DAMPING: {
return spring_damping[axis_lin];
}
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_SPRING_EQUILIBRIUM_POINT: {
return spring_equilibrium[axis_lin];
}
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_LOWER_LIMIT: {
return limit_lower[axis_ang];
}
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_UPPER_LIMIT: {
return limit_upper[axis_ang];
}
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_LIMIT_SOFTNESS: {
return G6DOF_DEFAULT_ANGULAR_LIMIT_SOFTNESS;
}
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_DAMPING: {
return G6DOF_DEFAULT_ANGULAR_DAMPING;
}
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_RESTITUTION: {
return G6DOF_DEFAULT_ANGULAR_RESTITUTION;
}
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_FORCE_LIMIT: {
return G6DOF_DEFAULT_ANGULAR_FORCE_LIMIT;
}
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_ERP: {
return G6DOF_DEFAULT_ANGULAR_ERP;
}
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_MOTOR_TARGET_VELOCITY: {
return motor_speed[axis_ang];
}
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_MOTOR_FORCE_LIMIT: {
return motor_limit[axis_ang];
}
case JoltPhysicsServer3D::G6DOF_JOINT_ANGULAR_SPRING_STIFFNESS: {
return spring_stiffness[axis_ang];
}
case JoltPhysicsServer3D::G6DOF_JOINT_ANGULAR_SPRING_DAMPING: {
return spring_damping[axis_ang];
}
case JoltPhysicsServer3D::G6DOF_JOINT_ANGULAR_SPRING_EQUILIBRIUM_POINT: {
return spring_equilibrium[axis_ang];
}
default: {
ERR_FAIL_V_MSG(0.0, vformat("Unhandled parameter: '%d'. This should not happen. Please report this.", p_param));
}
}
}
void JoltGeneric6DOFJoint3D::set_param(Axis p_axis, Param p_param, double p_value) {
const int axis_lin = AXES_LINEAR + (int)p_axis;
const int axis_ang = AXES_ANGULAR + (int)p_axis;
switch ((int)p_param) {
case PhysicsServer3D::G6DOF_JOINT_LINEAR_LOWER_LIMIT: {
limit_lower[axis_lin] = p_value;
_limits_changed();
} break;
case PhysicsServer3D::G6DOF_JOINT_LINEAR_UPPER_LIMIT: {
limit_upper[axis_lin] = p_value;
_limits_changed();
} break;
case PhysicsServer3D::G6DOF_JOINT_LINEAR_LIMIT_SOFTNESS: {
if (!Math::is_equal_approx(p_value, G6DOF_DEFAULT_LINEAR_LIMIT_SOFTNESS)) {
WARN_PRINT(vformat("6DOF joint linear limit softness is not supported when using Jolt Physics. Any such value will be ignored. This joint connects %s.", _bodies_to_string()));
}
} break;
case PhysicsServer3D::G6DOF_JOINT_LINEAR_RESTITUTION: {
if (!Math::is_equal_approx(p_value, G6DOF_DEFAULT_LINEAR_RESTITUTION)) {
WARN_PRINT(vformat("6DOF joint linear restitution is not supported when using Jolt Physics. Any such value will be ignored. This joint connects %s.", _bodies_to_string()));
}
} break;
case PhysicsServer3D::G6DOF_JOINT_LINEAR_DAMPING: {
if (!Math::is_equal_approx(p_value, G6DOF_DEFAULT_LINEAR_DAMPING)) {
WARN_PRINT(vformat("6DOF joint linear damping is not supported when using Jolt Physics. Any such value will be ignored. This joint connects %s.", _bodies_to_string()));
}
} break;
case PhysicsServer3D::G6DOF_JOINT_LINEAR_MOTOR_TARGET_VELOCITY: {
motor_speed[axis_lin] = p_value;
_motor_speed_changed(axis_lin);
} break;
case PhysicsServer3D::G6DOF_JOINT_LINEAR_MOTOR_FORCE_LIMIT: {
motor_limit[axis_lin] = p_value;
_motor_limit_changed(axis_lin);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_SPRING_STIFFNESS: {
spring_stiffness[axis_lin] = p_value;
_spring_parameters_changed(axis_lin);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_SPRING_DAMPING: {
spring_damping[axis_lin] = p_value;
_spring_parameters_changed(axis_lin);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_SPRING_EQUILIBRIUM_POINT: {
spring_equilibrium[axis_lin] = p_value;
_spring_equilibrium_changed(axis_lin);
} break;
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_LOWER_LIMIT: {
limit_lower[axis_ang] = p_value;
_limits_changed();
} break;
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_UPPER_LIMIT: {
limit_upper[axis_ang] = p_value;
_limits_changed();
} break;
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_LIMIT_SOFTNESS: {
if (!Math::is_equal_approx(p_value, G6DOF_DEFAULT_ANGULAR_LIMIT_SOFTNESS)) {
WARN_PRINT(vformat("6DOF joint angular limit softness is not supported when using Jolt Physics. Any such value will be ignored. This joint connects %s.", _bodies_to_string()));
}
} break;
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_DAMPING: {
if (!Math::is_equal_approx(p_value, G6DOF_DEFAULT_ANGULAR_DAMPING)) {
WARN_PRINT(vformat("6DOF joint angular damping is not supported when using Jolt Physics. Any such value will be ignored. This joint connects %s.", _bodies_to_string()));
}
} break;
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_RESTITUTION: {
if (!Math::is_equal_approx(p_value, G6DOF_DEFAULT_ANGULAR_RESTITUTION)) {
WARN_PRINT(vformat("6DOF joint angular restitution is not supported when using Jolt Physics. Any such value will be ignored. This joint connects %s.", _bodies_to_string()));
}
} break;
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_FORCE_LIMIT: {
if (!Math::is_equal_approx(p_value, G6DOF_DEFAULT_ANGULAR_FORCE_LIMIT)) {
WARN_PRINT(vformat("6DOF joint angular force limit is not supported when using Jolt Physics. Any such value will be ignored. This joint connects %s.", _bodies_to_string()));
}
} break;
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_ERP: {
if (!Math::is_equal_approx(p_value, G6DOF_DEFAULT_ANGULAR_ERP)) {
WARN_PRINT(vformat("6DOF joint angular ERP is not supported when using Jolt Physics. Any such value will be ignored. This joint connects %s.", _bodies_to_string()));
}
} break;
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_MOTOR_TARGET_VELOCITY: {
motor_speed[axis_ang] = p_value;
_motor_speed_changed(axis_ang);
} break;
case PhysicsServer3D::G6DOF_JOINT_ANGULAR_MOTOR_FORCE_LIMIT: {
motor_limit[axis_ang] = p_value;
_motor_limit_changed(axis_ang);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_ANGULAR_SPRING_STIFFNESS: {
spring_stiffness[axis_ang] = p_value;
_spring_parameters_changed(axis_ang);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_ANGULAR_SPRING_DAMPING: {
spring_damping[axis_ang] = p_value;
_spring_parameters_changed(axis_ang);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_ANGULAR_SPRING_EQUILIBRIUM_POINT: {
spring_equilibrium[axis_ang] = p_value;
_spring_equilibrium_changed(axis_ang);
} break;
default: {
ERR_FAIL_MSG(vformat("Unhandled parameter: '%d'. This should not happen. Please report this.", p_param));
} break;
}
}
bool JoltGeneric6DOFJoint3D::get_flag(Axis p_axis, Flag p_flag) const {
const int axis_lin = AXES_LINEAR + (int)p_axis;
const int axis_ang = AXES_ANGULAR + (int)p_axis;
switch ((int)p_flag) {
case PhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_LINEAR_LIMIT: {
return limit_enabled[axis_lin];
}
case PhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_ANGULAR_LIMIT: {
return limit_enabled[axis_ang];
}
case JoltPhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_ANGULAR_SPRING: {
return spring_enabled[axis_ang];
}
case JoltPhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_LINEAR_SPRING: {
return spring_enabled[axis_lin];
}
case PhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_MOTOR: {
return motor_enabled[axis_ang];
}
case PhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_LINEAR_MOTOR: {
return motor_enabled[axis_lin];
}
default: {
ERR_FAIL_V_MSG(false, vformat("Unhandled flag: '%d'. This should not happen. Please report this.", p_flag));
}
}
}
void JoltGeneric6DOFJoint3D::set_flag(Axis p_axis, Flag p_flag, bool p_enabled) {
const int axis_lin = AXES_LINEAR + (int)p_axis;
const int axis_ang = AXES_ANGULAR + (int)p_axis;
switch ((int)p_flag) {
case PhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_LINEAR_LIMIT: {
limit_enabled[axis_lin] = p_enabled;
_limits_changed();
} break;
case PhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_ANGULAR_LIMIT: {
limit_enabled[axis_ang] = p_enabled;
_limits_changed();
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_ANGULAR_SPRING: {
spring_enabled[axis_ang] = p_enabled;
_spring_state_changed(axis_ang);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_LINEAR_SPRING: {
spring_enabled[axis_lin] = p_enabled;
_spring_state_changed(axis_lin);
} break;
case PhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_MOTOR: {
motor_enabled[axis_ang] = p_enabled;
_motor_state_changed(axis_ang);
} break;
case PhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_LINEAR_MOTOR: {
motor_enabled[axis_lin] = p_enabled;
_motor_state_changed(axis_lin);
} break;
default: {
ERR_FAIL_MSG(vformat("Unhandled flag: '%d'. This should not happen. Please report this.", p_flag));
} break;
}
}
double JoltGeneric6DOFJoint3D::get_jolt_param(Axis p_axis, JoltParam p_param) const {
const int axis_lin = AXES_LINEAR + (int)p_axis;
const int axis_ang = AXES_ANGULAR + (int)p_axis;
switch ((int)p_param) {
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_SPRING_FREQUENCY: {
return spring_frequency[axis_lin];
}
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_SPRING_MAX_FORCE: {
return spring_limit[axis_lin];
}
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_LIMIT_SPRING_FREQUENCY: {
return limit_spring_frequency[axis_lin];
}
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_LIMIT_SPRING_DAMPING: {
return limit_spring_damping[axis_lin];
}
case JoltPhysicsServer3D::G6DOF_JOINT_ANGULAR_SPRING_FREQUENCY: {
return spring_frequency[axis_ang];
}
case JoltPhysicsServer3D::G6DOF_JOINT_ANGULAR_SPRING_MAX_TORQUE: {
return spring_limit[axis_ang];
}
default: {
ERR_FAIL_V_MSG(0.0, vformat("Unhandled parameter: '%d'. This should not happen. Please report this.", p_param));
}
}
}
void JoltGeneric6DOFJoint3D::set_jolt_param(Axis p_axis, JoltParam p_param, double p_value) {
const int axis_lin = AXES_LINEAR + (int)p_axis;
const int axis_ang = AXES_ANGULAR + (int)p_axis;
switch ((int)p_param) {
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_SPRING_FREQUENCY: {
spring_frequency[axis_lin] = p_value;
_spring_parameters_changed(axis_lin);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_SPRING_MAX_FORCE: {
spring_limit[axis_lin] = p_value;
_spring_limit_changed(axis_lin);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_LIMIT_SPRING_FREQUENCY: {
limit_spring_frequency[axis_lin] = p_value;
_limit_spring_parameters_changed(axis_lin);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_LINEAR_LIMIT_SPRING_DAMPING: {
limit_spring_damping[axis_lin] = p_value;
_limit_spring_parameters_changed(axis_lin);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_ANGULAR_SPRING_FREQUENCY: {
spring_frequency[axis_ang] = p_value;
_spring_parameters_changed(axis_ang);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_ANGULAR_SPRING_MAX_TORQUE: {
spring_limit[axis_ang] = p_value;
_spring_limit_changed(axis_ang);
} break;
default: {
ERR_FAIL_MSG(vformat("Unhandled parameter: '%d'. This should not happen. Please report this.", p_param));
} break;
}
}
bool JoltGeneric6DOFJoint3D::get_jolt_flag(Axis p_axis, JoltFlag p_flag) const {
const int axis_lin = AXES_LINEAR + (int)p_axis;
const int axis_ang = AXES_ANGULAR + (int)p_axis;
switch ((int)p_flag) {
case JoltPhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_LINEAR_LIMIT_SPRING: {
return limit_spring_enabled[axis_lin];
}
case JoltPhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_LINEAR_SPRING_FREQUENCY: {
return spring_use_frequency[axis_lin];
}
case JoltPhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_ANGULAR_SPRING_FREQUENCY: {
return spring_use_frequency[axis_ang];
}
default: {
ERR_FAIL_V_MSG(false, vformat("Unhandled flag: '%d'. This should not happen. Please report this.", p_flag));
}
}
}
void JoltGeneric6DOFJoint3D::set_jolt_flag(Axis p_axis, JoltFlag p_flag, bool p_enabled) {
const int axis_lin = AXES_LINEAR + (int)p_axis;
const int axis_ang = AXES_ANGULAR + (int)p_axis;
switch ((int)p_flag) {
case JoltPhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_LINEAR_LIMIT_SPRING: {
limit_spring_enabled[axis_lin] = p_enabled;
_limit_spring_parameters_changed(axis_lin);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_LINEAR_SPRING_FREQUENCY: {
spring_use_frequency[axis_lin] = p_enabled;
_spring_parameters_changed(axis_lin);
} break;
case JoltPhysicsServer3D::G6DOF_JOINT_FLAG_ENABLE_ANGULAR_SPRING_FREQUENCY: {
spring_use_frequency[axis_ang] = p_enabled;
_spring_parameters_changed(axis_ang);
} break;
default: {
ERR_FAIL_MSG(vformat("Unhandled flag: '%d'. This should not happen. Please report this.", p_flag));
} break;
}
}
float JoltGeneric6DOFJoint3D::get_applied_force() const {
JPH::SixDOFConstraint *constraint = static_cast<JPH::SixDOFConstraint *>(jolt_ref.GetPtr());
ERR_FAIL_NULL_V(constraint, 0.0f);
JoltSpace3D *space = get_space();
ERR_FAIL_NULL_V(space, 0.0f);
const float last_step = space->get_last_step();
if (unlikely(last_step == 0.0f)) {
return 0.0f;
}
const JPH::Vec3 total_lambda = constraint->GetTotalLambdaPosition() + constraint->GetTotalLambdaMotorTranslation();
return total_lambda.Length() / last_step;
}
float JoltGeneric6DOFJoint3D::get_applied_torque() const {
JPH::SixDOFConstraint *constraint = static_cast<JPH::SixDOFConstraint *>(jolt_ref.GetPtr());
ERR_FAIL_NULL_V(constraint, 0.0f);
JoltSpace3D *space = get_space();
ERR_FAIL_NULL_V(space, 0.0f);
const float last_step = space->get_last_step();
if (unlikely(last_step == 0.0f)) {
return 0.0f;
}
const JPH::Vec3 total_lambda = constraint->GetTotalLambdaRotation() + constraint->GetTotalLambdaMotorRotation();
return total_lambda.Length() / last_step;
}
void JoltGeneric6DOFJoint3D::rebuild() {
destroy();
JoltSpace3D *space = get_space();
if (space == nullptr) {
return;
}
JPH::Body *jolt_body_a = body_a != nullptr ? body_a->get_jolt_body() : nullptr;
JPH::Body *jolt_body_b = body_b != nullptr ? body_b->get_jolt_body() : nullptr;
ERR_FAIL_COND(jolt_body_a == nullptr && jolt_body_b == nullptr);
Transform3D shifted_ref_a;
Transform3D shifted_ref_b;
_shift_reference_frames(Vector3(), Vector3(), shifted_ref_a, shifted_ref_b);
jolt_ref = _build_6dof(jolt_body_a, jolt_body_b, shifted_ref_a, shifted_ref_b);
space->add_joint(this);
_update_enabled();
_update_iterations();
_update_limit_spring_parameters(AXIS_LINEAR_X);
_update_limit_spring_parameters(AXIS_LINEAR_Y);
_update_limit_spring_parameters(AXIS_LINEAR_Z);
for (int axis = 0; axis < AXIS_COUNT; ++axis) {
_update_motor_state(axis);
_update_motor_velocity(axis);
_update_motor_limit(axis);
_update_spring_parameters(axis);
_update_spring_equilibrium(axis);
}
}