//! Physics pipeline structures. use crate::counters::Counters; #[cfg(not(feature = "parallel"))] use crate::dynamics::IslandSolver; use crate::dynamics::{IntegrationParameters, JointSet, RigidBody, RigidBodyHandle, RigidBodySet}; #[cfg(feature = "parallel")] use crate::dynamics::{JointGraphEdge, ParallelIslandSolver as IslandSolver}; use crate::geometry::{ BroadPhase, BroadPhasePairEvent, Collider, ColliderHandle, ColliderPair, ColliderSet, ContactManifoldIndex, NarrowPhase, }; use crate::math::Vector; use crate::pipeline::EventHandler; /// The physics pipeline, responsible for stepping the whole physics simulation. /// /// This structure only contains temporary data buffers. It can be dropped and replaced by a fresh /// copy at any time. For performance reasons it is recommended to reuse the same physics pipeline /// instance to benefit from the cached data. /// /// Rapier relies on a time-stepping scheme. Its force computations /// uses two solvers: /// - A velocity based solver based on PGS which computes forces for contact and joint constraints. /// - A position based solver based on non-linear PGS which performs constraint stabilization (i.e. correction of errors like penetrations). // NOTE: this contains only workspace data, so there is no point in making this serializable. pub struct PhysicsPipeline { /// Counters used for benchmarking only. pub counters: Counters, manifold_indices: Vec>, joint_constraint_indices: Vec>, broadphase_collider_pairs: Vec, broad_phase_events: Vec, solvers: Vec, } impl Default for PhysicsPipeline { fn default() -> Self { PhysicsPipeline::new() } } #[allow(dead_code)] fn check_pipeline_send_sync() { fn do_test() {} do_test::(); } impl PhysicsPipeline { /// Initializes a new physics pipeline. pub fn new() -> PhysicsPipeline { PhysicsPipeline { counters: Counters::new(false), solvers: Vec::new(), manifold_indices: Vec::new(), joint_constraint_indices: Vec::new(), broadphase_collider_pairs: Vec::new(), broad_phase_events: Vec::new(), } } /// Executes one timestep of the physics simulation. pub fn step( &mut self, gravity: &Vector, integration_parameters: &IntegrationParameters, broad_phase: &mut BroadPhase, narrow_phase: &mut NarrowPhase, bodies: &mut RigidBodySet, colliders: &mut ColliderSet, joints: &mut JointSet, events: &dyn EventHandler, ) { // println!("Step"); self.counters.step_started(); bodies.maintain_active_set(); self.counters.stages.collision_detection_time.start(); self.counters.cd.broad_phase_time.start(); self.broadphase_collider_pairs.clear(); // let t = instant::now(); broad_phase.update_aabbs( integration_parameters.prediction_distance, bodies, colliders, ); // println!("Update AABBs time: {}", instant::now() - t); // let t = instant::now(); self.broad_phase_events.clear(); broad_phase.find_pairs(&mut self.broad_phase_events); // println!("Find pairs time: {}", instant::now() - t); narrow_phase.register_pairs(colliders, &self.broad_phase_events, events); self.counters.cd.broad_phase_time.pause(); // println!("Num contact pairs: {}", pairs.len()); self.counters.cd.narrow_phase_time.start(); // let t = instant::now(); narrow_phase.compute_contacts( integration_parameters.prediction_distance, bodies, colliders, events, ); narrow_phase.compute_proximities( integration_parameters.prediction_distance, bodies, colliders, events, ); // println!("Compute contact time: {}", instant::now() - t); self.counters.stages.island_construction_time.start(); bodies.update_active_set_with_contacts( colliders, narrow_phase.contact_graph(), joints.joint_graph(), integration_parameters.min_island_size, ); self.counters.stages.island_construction_time.pause(); // Update kinematic bodies velocities. bodies.foreach_active_kinematic_body_mut_internal(|_, body| { body.compute_velocity_from_predicted_position(integration_parameters.inv_dt()); }); if self.manifold_indices.len() < bodies.num_islands() { self.manifold_indices .resize(bodies.num_islands(), Vec::new()); } if self.joint_constraint_indices.len() < bodies.num_islands() { self.joint_constraint_indices .resize(bodies.num_islands(), Vec::new()); } let mut manifolds = Vec::new(); narrow_phase.sort_and_select_active_contacts( bodies, &mut manifolds, &mut self.manifold_indices, ); joints.select_active_interactions(bodies, &mut self.joint_constraint_indices); self.counters.cd.narrow_phase_time.pause(); self.counters.stages.collision_detection_time.pause(); self.counters.stages.update_time.start(); bodies.foreach_active_dynamic_body_mut_internal(|_, b| { b.update_world_mass_properties(); b.integrate_accelerations(integration_parameters.dt(), *gravity) }); self.counters.stages.update_time.pause(); self.counters.solver.reset(); self.counters.stages.solver_time.start(); if self.solvers.len() < bodies.num_islands() { self.solvers .resize_with(bodies.num_islands(), || IslandSolver::new()); } #[cfg(not(feature = "parallel"))] { enable_flush_to_zero!(); for island_id in 0..bodies.num_islands() { self.solvers[island_id].solve_island( island_id, &mut self.counters, integration_parameters, bodies, &mut manifolds[..], &self.manifold_indices[island_id], joints.joints_mut(), &self.joint_constraint_indices[island_id], ) } } #[cfg(feature = "parallel")] { use crate::geometry::ContactManifold; use rayon::prelude::*; use std::sync::atomic::Ordering; let num_islands = bodies.num_islands(); let solvers = &mut self.solvers[..num_islands]; let bodies = &std::sync::atomic::AtomicPtr::new(bodies as *mut _); let manifolds = &std::sync::atomic::AtomicPtr::new(&mut manifolds as *mut _); let joints = &std::sync::atomic::AtomicPtr::new(joints.joints_vec_mut() as *mut _); let manifold_indices = &self.manifold_indices[..]; let joint_constraint_indices = &self.joint_constraint_indices[..]; rayon::scope(|scope| { enable_flush_to_zero!(); solvers .par_iter_mut() .enumerate() .for_each(|(island_id, solver)| { let bodies: &mut RigidBodySet = unsafe { std::mem::transmute(bodies.load(Ordering::Relaxed)) }; let manifolds: &mut Vec<&mut ContactManifold> = unsafe { std::mem::transmute(manifolds.load(Ordering::Relaxed)) }; let joints: &mut Vec = unsafe { std::mem::transmute(joints.load(Ordering::Relaxed)) }; solver.solve_island( scope, island_id, integration_parameters, bodies, manifolds, &manifold_indices[island_id], joints, &joint_constraint_indices[island_id], ) }); }); } // Update colliders positions and kinematic bodies positions. // FIXME: do this in the solver? bodies.foreach_active_body_mut_internal(|_, rb| { if rb.is_kinematic() { rb.position = rb.predicted_position; rb.linvel = na::zero(); rb.angvel = na::zero(); } else { rb.update_predicted_position(integration_parameters.dt()); } for handle in &rb.colliders { let collider = &mut colliders[*handle]; collider.position = rb.position * collider.delta; collider.predicted_position = rb.predicted_position * collider.delta; } }); self.counters.stages.solver_time.pause(); bodies.modified_inactive_set.clear(); self.counters.step_completed(); } /// Remove a collider and all its associated data. pub fn remove_collider( &mut self, handle: ColliderHandle, broad_phase: &mut BroadPhase, narrow_phase: &mut NarrowPhase, bodies: &mut RigidBodySet, colliders: &mut ColliderSet, ) -> Option { broad_phase.remove_colliders(&[handle], colliders); narrow_phase.remove_colliders(&[handle], colliders, bodies); let collider = colliders.remove_internal(handle)?; if let Some(parent) = bodies.get_mut_internal(collider.parent) { parent.remove_collider_internal(handle, &collider); bodies.wake_up(collider.parent); } Some(collider) } /// Remove a rigid-body and all its associated data. pub fn remove_rigid_body( &mut self, handle: RigidBodyHandle, broad_phase: &mut BroadPhase, narrow_phase: &mut NarrowPhase, bodies: &mut RigidBodySet, colliders: &mut ColliderSet, joints: &mut JointSet, ) -> Option { // Remove the body. let body = bodies.remove_internal(handle)?; // Remove this rigid-body from the broad-phase and narrow-phase. broad_phase.remove_colliders(&body.colliders, colliders); narrow_phase.remove_colliders(&body.colliders, colliders, bodies); // Remove all joints attached to this body. joints.remove_rigid_body(body.joint_graph_index, bodies); // Remove all colliders attached to this body. for collider in &body.colliders { colliders.remove_internal(*collider); } Some(body) } } #[cfg(test)] mod test { use crate::dynamics::{JointSet, RigidBodyBuilder, RigidBodySet}; use crate::geometry::{BroadPhase, ColliderSet, NarrowPhase}; use crate::pipeline::PhysicsPipeline; #[test] fn rigid_body_removal_before_step() { let mut colliders = ColliderSet::new(); let mut joints = JointSet::new(); let mut pipeline = PhysicsPipeline::new(); let mut bf = BroadPhase::new(); let mut nf = NarrowPhase::new(); let mut set = RigidBodySet::new(); let rb = RigidBodyBuilder::new_dynamic().build(); // Check that removing the body right after inserting it works. let h1 = set.insert(rb.clone()); pipeline.remove_rigid_body(h1, &mut bf, &mut nf, &mut set, &mut colliders, &mut joints); } #[test] fn rigid_body_removal_snapshot_handle_determinism() { let mut colliders = ColliderSet::new(); let mut joints = JointSet::new(); let mut pipeline = PhysicsPipeline::new(); let mut bf = BroadPhase::new(); let mut nf = NarrowPhase::new(); let mut set = RigidBodySet::new(); let rb = RigidBodyBuilder::new_dynamic().build(); let h1 = set.insert(rb.clone()); let h2 = set.insert(rb.clone()); let h3 = set.insert(rb.clone()); pipeline.remove_rigid_body(h1, &mut bf, &mut nf, &mut set, &mut colliders, &mut joints); pipeline.remove_rigid_body(h3, &mut bf, &mut nf, &mut set, &mut colliders, &mut joints); pipeline.remove_rigid_body(h2, &mut bf, &mut nf, &mut set, &mut colliders, &mut joints); let ser_set = bincode::serialize(&set).unwrap(); let mut set2: RigidBodySet = bincode::deserialize(&ser_set).unwrap(); let h1a = set.insert(rb.clone()); let h2a = set.insert(rb.clone()); let h3a = set.insert(rb.clone()); let h1b = set2.insert(rb.clone()); let h2b = set2.insert(rb.clone()); let h3b = set2.insert(rb.clone()); assert_eq!(h1a, h1b); assert_eq!(h2a, h2b); assert_eq!(h3a, h3b); } }