Struct bevy_rapier2d::prelude::IntegrationParameters

pub struct IntegrationParameters {
    pub dt: f32,
    pub min_ccd_dt: f32,
    pub velocity_solve_fraction: f32,
    pub erp: f32,
    pub allowed_linear_error: f32,
    pub prediction_distance: f32,
    pub max_velocity_iterations: usize,
    pub max_velocity_friction_iterations: usize,
    pub max_stabilization_iterations: usize,
    pub interleave_restitution_and_friction_resolution: bool,
    pub min_island_size: usize,
    pub max_ccd_substeps: usize,
}

Parameters for a time-step of the physics engine.

Fields

dt: f32

The timestep length (default: 1.0 / 60.0)

min_ccd_dt: f32

Minimum timestep size when using CCD with multiple substeps (default 1.0 / 60.0 / 100.0)

When CCD with multiple substeps is enabled, the timestep is subdivided into smaller pieces. This timestep subdivision won’t generate timestep lengths smaller than min_ccd_dt.

Setting this to a large value will reduce the opportunity to performing CCD substepping, resulting in potentially more time dropped by the motion-clamping mechanism. Setting this to an very small value may lead to numerical instabilities.

velocity_solve_fraction: f32

0-1: how much of the velocity to dampen out in the constraint solver? (default 1.0).

erp: f32

0-1: multiplier for how much of the constraint violation (e.g. contact penetration) will be compensated for during the velocity solve. If zero, you need to enable the positional solver. If non-zero, you do not need the positional solver. A good non-zero value is around 0.2. (default 0.0).

allowed_linear_error: f32

Amount of penetration the engine wont attempt to correct (default: 0.001m).

prediction_distance: f32

The maximal distance separating two objects that will generate predictive contacts (default: 0.002).

max_velocity_iterations: usize

Maximum number of iterations performed to solve non-penetration and joint constraints (default: 4).

max_velocity_friction_iterations: usize

Maximum number of iterations performed to solve friction constraints (default: 8).

max_stabilization_iterations: usize

Maximum number of iterations performed to remove the energy introduced by penetration corrections (default: 1).

interleave_restitution_and_friction_resolution: bool

If false, friction and non-penetration constraints will be solved in the same loop. Otherwise, non-penetration constraints are solved first, and friction constraints are solved after (default: true).

min_island_size: usize

Minimum number of dynamic bodies in each active island (default: 128).

max_ccd_substeps: usize

Maximum number of substeps performed by the solver (default: 1).

Implementations

impl IntegrationParameters

pub fn inv_dt(&self) -> f32

The inverse of the time-stepping length, i.e. the steps per seconds (Hz).

This is zero if self.dt is zero.

pub fn set_dt(&mut self, dt: f32)

👎 Deprecated:

You can just set the IntegrationParams::dt value directly

Sets the time-stepping length.

pub fn set_inv_dt(&mut self, inv_dt: f32)

Sets the inverse time-stepping length (i.e. the frequency).

This automatically recompute self.dt.

Trait Implementations

impl Clone for IntegrationParameters

pub fn clone(&self) -> IntegrationParameters

Returns a copy of the value.

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

Performs copy-assignment from source.

impl Default for IntegrationParameters

pub fn default() -> IntegrationParameters

Returns the “default value” for a type.

impl Copy for IntegrationParameters