Struct parry2d::mass_properties::MassProperties

pub struct MassProperties {
    pub local_com: Point<Real>,
    pub inv_mass: Real,
    pub inv_principal_inertia_sqrt: AngVector<Real>,
}

The local mass properties of a rigid-body.

Fields

local_com: Point<Real>

The center of mass of a rigid-body expressed in its local-space.

inv_mass: Real

The inverse of the mass of a rigid-body.

If this is zero, the rigid-body is assumed to have infinite mass.

inv_principal_inertia_sqrt: AngVector<Real>

The inverse of the principal angular inertia of the rigid-body.

Components set to zero are assumed to be infinite along the corresponding principal axis.

Implementations

impl MassProperties

pub fn new(local_com: Point<Real>, mass: Real, principal_inertia: Real) -> Self

Initializes the mass properties with the given center-of-mass, mass, and angular inertia.

The center-of-mass is specified in the local-space of the rigid-body.

pub fn world_com(&self, pos: &Isometry<Real>) -> Point<Real>

The world-space center of mass of the rigid-body.

pub fn world_inv_inertia_sqrt(
    &self,
    _rot: &Rotation<Real>
) -> AngularInertia<Real>

The world-space inverse angular inertia tensor of the rigid-body.

pub fn transform_by(&self, m: &Isometry<Real>) -> Self

Transform each element of the mass properties.

pub fn set_mass(&mut self, new_mass: Real, adjust_angular_inertia: bool)

Changes the mass on these mass-properties.

The adjust_angular_inertia argument should always be true, unless there are some specific reasons not to do so. Setting this to true will automatically adjust the angular inertia of self to account for the mass change (i.e. it will multiply the angular inertia by new_mass / prev_mass). Setting it to false will not change the current angular inertia.

impl MassProperties

pub fn from_ball(density: Real, radius: Real) -> Self

Computes the mass properties of a ball.

impl MassProperties

pub fn from_capsule(
    density: Real,
    a: Point<Real>,
    b: Point<Real>,
    radius: Real
) -> Self

Computes the mass properties of a capsule.

impl MassProperties

pub fn from_compound(
    density: Real,
    shapes: &[(Isometry<Real>, SharedShape)]
) -> Self

Computes the mass properties of a compound shape.

impl MassProperties

pub fn from_convex_polygon(
    density: Real,
    vertices: &[Point<Real>]
) -> MassProperties

Computes the mass properties of a convex polygon.

impl MassProperties

pub fn from_cuboid(density: Real, half_extents: Vector<Real>) -> Self

Computes the mass properties of a cuboid.

impl MassProperties

pub fn from_triangle(
    density: Real,
    a: &Point<Real>,
    b: &Point<Real>,
    c: &Point<Real>
) -> MassProperties

Computes the mass properties of a triangle.

impl MassProperties

pub fn from_trimesh(
    density: Real,
    vertices: &[Point<Real>],
    indices: &[[u32; 3]]
) -> MassProperties

Computes the mass properties of a triangle-mesh.

Trait Implementations

impl AbsDiffEq<MassProperties> for MassProperties

type Epsilon = Real

Used for specifying relative comparisons.

fn default_epsilon() -> Self::Epsilon

The default tolerance to use when testing values that are close together.

fn abs_diff_eq(&self, other: &Self, epsilon: Self::Epsilon) -> bool

A test for equality that uses the absolute difference to compute the approximate equality of two numbers.

pub fn abs_diff_ne(&self, other: &Rhs, epsilon: Self::Epsilon) -> bool

The inverse of AbsDiffEq::abs_diff_eq.

impl Add<MassProperties> for MassProperties

type Output = Self

The resulting type after applying the + operator.

fn add(self, other: MassProperties) -> Self

Performs the + operation.

impl AddAssign<MassProperties> for MassProperties

fn add_assign(&mut self, rhs: MassProperties)

Performs the += operation.

impl Clone for MassProperties

fn clone(&self) -> MassProperties

Returns a copy of the value.

pub fn clone_from(&mut self, source: &Self)

Performs copy-assignment from source.

impl Copy for MassProperties

impl Debug for MassProperties

fn fmt(&self, f: &mut Formatter<'_>) -> Result

Formats the value using the given formatter.

impl PartialEq<MassProperties> for MassProperties

fn eq(&self, other: &MassProperties) -> bool

This method tests for self and other values to be equal, and is used by ==.

fn ne(&self, other: &MassProperties) -> bool

This method tests for !=.

impl RelativeEq<MassProperties> for MassProperties

fn default_max_relative() -> Self::Epsilon

The default relative tolerance for testing values that are far-apart.

fn relative_eq(
    &self,
    other: &Self,
    epsilon: Self::Epsilon,
    max_relative: Self::Epsilon
) -> bool

A test for equality that uses a relative comparison if the values are far apart.

pub fn relative_ne(
    &self,
    other: &Rhs,
    epsilon: Self::Epsilon,
    max_relative: Self::Epsilon
) -> bool

The inverse of RelativeEq::relative_eq.

impl StructuralPartialEq for MassProperties

impl Sub<MassProperties> for MassProperties

type Output = Self

The resulting type after applying the - operator.

fn sub(self, other: MassProperties) -> Self

Performs the - operation.

impl SubAssign<MassProperties> for MassProperties

fn sub_assign(&mut self, rhs: MassProperties)

Performs the -= operation.

impl Sum<MassProperties> for MassProperties

fn sum<I>(iter: I) -> Self where
    I: Iterator<Item = Self>, 

Method which takes an iterator and generates Self from the elements by “summing up” the items.

impl Zero for MassProperties

fn zero() -> Self

Returns the additive identity element of Self, 0.

fn is_zero(&self) -> bool

Returns true if self is equal to the additive identity.

pub fn set_zero(&mut self)

Sets self to the additive identity element of Self, 0.