use crate::dynamics::joint::{JointAxesMask, JointData}; use crate::dynamics::{JointAxis, MotorModel}; use crate::math::{Point, Real, UnitVector}; #[cfg_attr(feature = "serde-serialize", derive(Serialize, Deserialize))] #[derive(Copy, Clone, Debug, PartialEq)] pub struct PrismaticJoint { data: JointData, } impl PrismaticJoint { pub fn new(axis: UnitVector) -> Self { #[cfg(feature = "dim2")] let mask = JointAxesMask::Y | JointAxesMask::ANG_X; #[cfg(feature = "dim3")] let mask = JointAxesMask::Y | JointAxesMask::Z | JointAxesMask::ANG_X | JointAxesMask::ANG_Y | JointAxesMask::ANG_Z; let data = JointData::default() .lock_axes(mask) .local_axis1(axis) .local_axis2(axis); Self { data } } #[must_use] pub fn local_anchor1(mut self, anchor1: Point) -> Self { self.data = self.data.local_anchor1(anchor1); self } #[must_use] pub fn local_anchor2(mut self, anchor2: Point) -> Self { self.data = self.data.local_anchor2(anchor2); self } /// Set the spring-like model used by the motor to reach the desired target velocity and position. pub fn motor_model(mut self, model: MotorModel) -> Self { self.data = self.data.motor_model(JointAxis::X, model); self } /// Sets the target velocity this motor needs to reach. pub fn motor_velocity(mut self, target_vel: Real, factor: Real) -> Self { self.data = self.data.motor_velocity(JointAxis::X, target_vel, factor); self } /// Sets the target angle this motor needs to reach. pub fn motor_position(mut self, target_pos: Real, stiffness: Real, damping: Real) -> Self { self.data = self .data .motor_position(JointAxis::X, target_pos, stiffness, damping); self } /// Configure both the target angle and target velocity of the motor. pub fn motor_axis( mut self, target_pos: Real, target_vel: Real, stiffness: Real, damping: Real, ) -> Self { self.data = self .data .motor_axis(JointAxis::X, target_pos, target_vel, stiffness, damping); self } pub fn motor_max_impulse(mut self, max_impulse: Real) -> Self { self.data = self.data.motor_max_impulse(JointAxis::X, max_impulse); self } #[must_use] pub fn limit_axis(mut self, limits: [Real; 2]) -> Self { self.data = self.data.limit_axis(JointAxis::X, limits); self } } impl Into for PrismaticJoint { fn into(self) -> JointData { self.data } }