pub struct JointMotor {
pub target_vel: f32,
pub target_pos: f32,
pub stiffness: f32,
pub damping: f32,
pub max_force: f32,
pub impulse: f32,
pub model: MotorModel,
}Expand description
A powered motor that drives a joint toward a target position/velocity.
Motors add actuation to joints - they apply forces to make the joint move toward a desired state. Think of them as servos, electric motors, or hydraulic actuators.
§Two control modes
- Velocity control: Set
target_velto make the motor spin/slide at constant speed - Position control: Set
target_poswithstiffness/dampingto reach a target angle/position
You can combine both for precise control.
§Parameters
stiffness: How strongly to pull toward target (spring constant)damping: Resistance to motion (prevents oscillation)max_force: Maximum force/torque the motor can apply
§Example
// Motor that spins a wheel at 10 rad/s
revolute_joint.set_motor_velocity(10.0, 0.8);
// Motor that moves to position 5.0
prismatic_joint.set_motor_position(5.0, 100.0, 10.0); // stiffness=100, damping=10Fields§
§target_vel: f32Target velocity (units/sec for prismatic, rad/sec for revolute).
target_pos: f32Target position (units for prismatic, radians for revolute).
stiffness: f32Spring constant - how strongly to pull toward target position.
damping: f32Damping coefficient - resistance to motion (prevents oscillation).
max_force: f32Maximum force the motor can apply (Newtons for prismatic, Nm for revolute).
impulse: f32Internal: current impulse being applied.
model: MotorModelForce-based or acceleration-based motor model.
Trait Implementations§
Source§impl Clone for JointMotor
impl Clone for JointMotor
Source§fn clone(&self) -> JointMotor
fn clone(&self) -> JointMotor
Returns a duplicate of the value. Read more
1.0.0 · Source§fn clone_from(&mut self, source: &Self)
fn clone_from(&mut self, source: &Self)
Performs copy-assignment from
source. Read moreSource§impl Debug for JointMotor
impl Debug for JointMotor
Source§impl Default for JointMotor
impl Default for JointMotor
Source§impl PartialEq for JointMotor
impl PartialEq for JointMotor
impl Copy for JointMotor
impl StructuralPartialEq for JointMotor
Auto Trait Implementations§
impl Freeze for JointMotor
impl RefUnwindSafe for JointMotor
impl Send for JointMotor
impl Sync for JointMotor
impl Unpin for JointMotor
impl UnwindSafe for JointMotor
Blanket Implementations§
Source§impl<T> BorrowMut<T> for Twhere
T: ?Sized,
impl<T> BorrowMut<T> for Twhere
T: ?Sized,
Source§fn borrow_mut(&mut self) -> &mut T
fn borrow_mut(&mut self) -> &mut T
Mutably borrows from an owned value. Read more
Source§impl<T> CloneToUninit for Twhere
T: Clone,
impl<T> CloneToUninit for Twhere
T: Clone,
Source§impl<T> Downcast for Twhere
T: Any,
impl<T> Downcast for Twhere
T: Any,
Source§fn into_any(self: Box<T>) -> Box<dyn Any>
fn into_any(self: Box<T>) -> Box<dyn Any>
Converts
Box<dyn Trait> (where Trait: Downcast) to Box<dyn Any>, which can then be
downcast into Box<dyn ConcreteType> where ConcreteType implements Trait.Source§fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
fn into_any_rc(self: Rc<T>) -> Rc<dyn Any>
Converts
Rc<Trait> (where Trait: Downcast) to Rc<Any>, which can then be further
downcast into Rc<ConcreteType> where ConcreteType implements Trait.Source§fn as_any(&self) -> &(dyn Any + 'static)
fn as_any(&self) -> &(dyn Any + 'static)
Converts
&Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &Any’s vtable from &Trait’s.Source§fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
Converts
&mut Trait (where Trait: Downcast) to &Any. This is needed since Rust cannot
generate &mut Any’s vtable from &mut Trait’s.Source§impl<T> DowncastSend for T
impl<T> DowncastSend for T
Source§impl<T> DowncastSync for T
impl<T> DowncastSync for T
Source§impl<T> IntoEither for T
impl<T> IntoEither for T
Source§fn into_either(self, into_left: bool) -> Either<Self, Self>
fn into_either(self, into_left: bool) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left is true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
fn into_either_with<F>(self, into_left: F) -> Either<Self, Self>
Converts
self into a Left variant of Either<Self, Self>
if into_left(&self) returns true.
Converts self into a Right variant of Either<Self, Self>
otherwise. Read moreSource§impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
impl<SS, SP> SupersetOf<SS> for SPwhere
SS: SubsetOf<SP>,
Source§fn to_subset(&self) -> Option<SS>
fn to_subset(&self) -> Option<SS>
The inverse inclusion map: attempts to construct
self from the equivalent element of its
superset. Read moreSource§fn is_in_subset(&self) -> bool
fn is_in_subset(&self) -> bool
Checks if
self is actually part of its subset T (and can be converted to it).Source§fn to_subset_unchecked(&self) -> SS
fn to_subset_unchecked(&self) -> SS
Use with care! Same as
self.to_subset but without any property checks. Always succeeds.Source§fn from_subset(element: &SS) -> SP
fn from_subset(element: &SS) -> SP
The inclusion map: converts
self to the equivalent element of its superset.