Struct nphysics3d::solver::IntegrationParameters [−][src]
pub struct IntegrationParameters<N: RealField> {}Show fields
pub return_after_ccd_substep: bool, pub t: N, pub erp: N, pub warmstart_coeff: N, pub restitution_velocity_threshold: N, pub allowed_linear_error: N, pub allowed_angular_error: N, pub max_linear_correction: N, pub max_angular_correction: N, pub max_stabilization_multiplier: N, pub max_velocity_iterations: usize, pub max_position_iterations: usize, pub max_ccd_position_iterations: usize, pub max_ccd_substeps: usize, pub multiple_ccd_substep_sensor_events_enabled: bool, pub ccd_on_penetration_enabled: bool, // some fields omitted
Expand description
Parameters for a time-step of the physics engine.
Fields
return_after_ccd_substep: bool
If true
, the world’s step
method will stop right after resolving exactly one CCD event (default: false
).
This allows the user to take action during a timestep, in-between two CCD events.
t: N
The total elapsed time in the physics world.
This is the accumulation of the dt
of all the calls to world.step()
.
erp: N
The Error Reduction Parameter in [0, 1]
is the proportion of
the positional error to be corrected at each time step (default: 0.2
).
warmstart_coeff: N
Each cached impulse are multiplied by this coefficient in [0, 1]
when they are re-used to initialize the solver (default 1.0
).
restitution_velocity_threshold: N
Contacts at points where the involved bodies have a relative
velocity smaller than this threshold wont be affected by the restitution force (default: 1.0
).
allowed_linear_error: N
Ammount of penetration the engine wont attempt to correct (default: 0.001m
).
allowed_angular_error: N
Ammount of angular drift of joint limits the engine wont
attempt to correct (default: 0.001rad
).
max_linear_correction: N
Maximum linear correction during one step of the non-linear position solver (default: 0.2
).
max_angular_correction: N
Maximum angular correction during one step of the non-linear position solver (default: 0.2
).
max_stabilization_multiplier: N
Maximum nonlinear SOR-prox scaling parameter when the constraint
correction direction is close to the kernel of the involved multibody’s
jacobian (default: 0.2
).
max_velocity_iterations: usize
Maximum number of iterations performed by the velocity constraints solver (default: 8
).
max_position_iterations: usize
Maximum number of iterations performed by the position-based constraints solver (default: 3
).
max_ccd_position_iterations: usize
Maximum number of iterations performed by the position-based constraints solver for CCD steps (default: 10
).
This should be sufficiently high so all penetration get resolved. For example, if CCD cause your objects to stutter, that may be because the number of CCD position iterations is too low, causing them to remain stuck in a penetration configuration for a few frames.
The highest this number, the highest its computational cost.
max_ccd_substeps: usize
Maximum number of substeps performed by the solver (default: 1
).
multiple_ccd_substep_sensor_events_enabled: bool
Controls the number of Proximity::Intersecting events generated by a trigger during CCD resolution (default: false
).
If false, triggers will only generate one Proximity::Intersecting event during a step, even if another colliders repeatedly enters and leaves the triggers during multiple CCD substeps.
If true, triggers will generate as many Proximity::Intersecting and Proximity::Disjoint/Proximity::WithinMargin events as the number of times a collider repeatedly enters and leaves the triggers during multiple CCD substeps. This is more computationally intensive.
ccd_on_penetration_enabled: bool
Whether penetration are taken into account in CCD resolution (default: false
).
If this is set to false
two penetrating colliders will not be considered to have any time of impact
while they are penetrating. This may end up allowing some tunelling, but will avoid stuttering effect
when the constraints solver fails to completely separate two colliders after a CCD contact.
If this is set to true
, two penetrating colliders will be considered to have a time of impact
equal to 0 until the constraints solver manages to separate them. This will prevent tunnelling
almost completely, but may introduce stuttering effects when the constraints solver fails to completely
seperate two colliders after a CCD contact.
Implementations
impl<N: RealField> IntegrationParameters<N>
[src]
impl<N: RealField> IntegrationParameters<N>
[src]pub fn new(
dt: N,
erp: N,
warmstart_coeff: N,
restitution_velocity_threshold: N,
allowed_linear_error: N,
allowed_angular_error: N,
max_linear_correction: N,
max_angular_correction: N,
max_stabilization_multiplier: N,
max_velocity_iterations: usize,
max_position_iterations: usize,
max_ccd_position_iterations: usize,
max_ccd_substeps: usize,
return_after_ccd_substep: bool,
multiple_ccd_substep_sensor_events_enabled: bool,
ccd_on_penetration_enabled: bool
) -> Self
[src]
pub fn new(
dt: N,
erp: N,
warmstart_coeff: N,
restitution_velocity_threshold: N,
allowed_linear_error: N,
allowed_angular_error: N,
max_linear_correction: N,
max_angular_correction: N,
max_stabilization_multiplier: N,
max_velocity_iterations: usize,
max_position_iterations: usize,
max_ccd_position_iterations: usize,
max_ccd_substeps: usize,
return_after_ccd_substep: bool,
multiple_ccd_substep_sensor_events_enabled: bool,
ccd_on_penetration_enabled: bool
) -> Self
[src]Creates a set of integration parameters with the given values.
pub fn inv_dt(&self) -> N
[src]
pub fn inv_dt(&self) -> N
[src]The inverse of the time-stepping length.
This is zero if self.dt
is zero.
pub fn set_dt(&mut self, dt: N)
[src]
pub fn set_dt(&mut self, dt: N)
[src]Sets the time-stepping length.
This automatically recompute self.inv_dt
.
pub fn set_inv_dt(&mut self, inv_dt: N)
[src]
pub fn set_inv_dt(&mut self, inv_dt: N)
[src]Sets the inverse time-stepping length (i.e. the frequency).
This automatically recompute self.dt
.
Trait Implementations
impl<N: Clone + RealField> Clone for IntegrationParameters<N>
[src]
impl<N: Clone + RealField> Clone for IntegrationParameters<N>
[src]fn clone(&self) -> IntegrationParameters<N>
[src]
fn clone(&self) -> IntegrationParameters<N>
[src]Returns a copy of the value. Read more
fn clone_from(&mut self, source: &Self)
1.0.0[src]
fn clone_from(&mut self, source: &Self)
1.0.0[src]Performs copy-assignment from source
. Read more
Auto Trait Implementations
impl<N> RefUnwindSafe for IntegrationParameters<N> where
N: RefUnwindSafe,
N: RefUnwindSafe,
impl<N> Send for IntegrationParameters<N>
impl<N> Sync for IntegrationParameters<N>
impl<N> Unpin for IntegrationParameters<N> where
N: Unpin,
N: Unpin,
impl<N> UnwindSafe for IntegrationParameters<N> where
N: UnwindSafe,
N: UnwindSafe,
Blanket Implementations
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]
impl<T> BorrowMut<T> for T where
T: ?Sized,
[src]pub fn borrow_mut(&mut self) -> &mut T
[src]
pub fn borrow_mut(&mut self) -> &mut T
[src]Mutably borrows from an owned value. Read more
impl<T> Downcast for T where
T: Any,
[src]
impl<T> Downcast for T where
T: Any,
[src]pub fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
[src]
pub fn into_any(self: Box<T, Global>) -> Box<dyn Any + 'static, Global>
[src]Convert Box<dyn Trait>
(where Trait: Downcast
) to Box<dyn Any>
. Box<dyn Any>
can
then be further downcast
into Box<ConcreteType>
where ConcreteType
implements Trait
. Read more
pub fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
[src]
pub fn into_any_rc(self: Rc<T>) -> Rc<dyn Any + 'static>
[src]Convert Rc<Trait>
(where Trait: Downcast
) to Rc<Any>
. Rc<Any>
can then be
further downcast
into Rc<ConcreteType>
where ConcreteType
implements Trait
. Read more
pub fn as_any(&self) -> &(dyn Any + 'static)
[src]
pub fn as_any(&self) -> &(dyn Any + 'static)
[src]Convert &Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &Any
’s vtable from &Trait
’s. Read more
pub fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
[src]
pub fn as_any_mut(&mut self) -> &mut (dyn Any + 'static)
[src]Convert &mut Trait
(where Trait: Downcast
) to &Any
. This is needed since Rust cannot
generate &mut Any
’s vtable from &mut Trait
’s. Read more
impl<T> DowncastSync for T where
T: Any + Send + Sync,
[src]
impl<T> DowncastSync for T where
T: Any + Send + Sync,
[src]impl<T> Same<T> for T
impl<T> Same<T> for T
type Output = T
type Output = T
Should always be Self
impl<SS, SP> SupersetOf<SS> for SP where
SS: SubsetOf<SP>,
[src]
impl<SS, SP> SupersetOf<SS> for SP where
SS: SubsetOf<SP>,
[src]pub fn to_subset(&self) -> Option<SS>
[src]
pub fn to_subset(&self) -> Option<SS>
[src]The inverse inclusion map: attempts to construct self
from the equivalent element of its
superset. Read more
pub fn is_in_subset(&self) -> bool
[src]
pub fn is_in_subset(&self) -> bool
[src]Checks if self
is actually part of its subset T
(and can be converted to it).
pub fn to_subset_unchecked(&self) -> SS
[src]
pub fn to_subset_unchecked(&self) -> SS
[src]Use with care! Same as self.to_subset
but without any property checks. Always succeeds.
pub fn from_subset(element: &SS) -> SP
[src]
pub fn from_subset(element: &SS) -> SP
[src]The inclusion map: converts self
to the equivalent element of its superset.
impl<T> ToOwned for T where
T: Clone,
[src]
impl<T> ToOwned for T where
T: Clone,
[src]type Owned = T
type Owned = T
The resulting type after obtaining ownership.
pub fn to_owned(&self) -> T
[src]
pub fn to_owned(&self) -> T
[src]Creates owned data from borrowed data, usually by cloning. Read more
pub fn clone_into(&self, target: &mut T)
[src]
pub fn clone_into(&self, target: &mut T)
[src]🔬 This is a nightly-only experimental API. (toowned_clone_into
)
recently added
Uses borrowed data to replace owned data, usually by cloning. Read more