Struct myelin_engine::simulation::world::NphysicsWorld

pub struct NphysicsWorld { /* fields omitted */ }

An implementation of World that uses nphysics in the background.

Methods

impl NphysicsWorld

pub fn with_timestep(
    timestep: f64,
    rotation_translator: Box<dyn NphysicsRotationTranslator>
) -> Self

Instantiates a new empty world

Examples

use myelin_engine::prelude::*;
use myelin_engine::simulation::world::{
    rotation_translator::NphysicsRotationTranslatorImpl, NphysicsWorld,
};
use std::sync::{Arc, RwLock};

let rotation_translator = NphysicsRotationTranslatorImpl::default();
let mut world = NphysicsWorld::with_timestep(1.0, Box::new(rotation_translator));

Trait Implementations

impl World for NphysicsWorld

fn step(&mut self)

Advance the simulation by one tick. This will apply forces to the objects and handle collisions;

fn add_body(&mut self, body: PhysicalBody) -> BodyHandle

Place a [PhysicalBody] in the world. Returns a unique [BodyHandle] that can be passed to [body()] in order to retrieve the [PhysicalBody] again

#[must_use]

fn remove_body(&mut self, body_handle: BodyHandle) -> Option<PhysicalBody>

Removes a previously added [PhysicalBody] from the world. If body_handle was valid, this will return the removed physical body.

#[must_use]

fn body(&self, handle: BodyHandle) -> Option<PhysicalBody>

Returns a [PhysicalBody] that has previously been placed with [add_body()] by its [BodyHandle].

#[must_use]

fn apply_force(&mut self, body_handle: BodyHandle, force: Force) -> Option<()>

Register a force that will be applied to a body on the next step. # Errors Returns None if body_handle did not match any sensors.

fn set_simulated_timestep(&mut self, timestep: f64)

Sets how much time in seconds is simulated for each step. # Examples If you want to run a simulation with 60 steps per second, you can run set_simulated_timestep(1.0/60.0). Note that this method does not block the thread if called faster than expected.

fn is_body_passable(&self, body_handle: BodyHandle) -> bool

Checks if the given [BodyHandle] is marked passable

fn bodies_in_area(&self, area: Aabb) -> Vec<BodyHandle>

Returns all bodies either completely contained or intersecting with the area.

fn bodies_in_polygon(&self, area: Polygon) -> Vec<BodyHandle>

Returns all bodies either completely contained or intersecting with the area.

impl Debug for NphysicsWorld

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

Formats the value using the given formatter.