myelin-engine 0.14.2

This crate contains the physical engine of the simulation, as well as the objects that reside within it
1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35

use crate::prelude::*;
use crate::private::Sealed;
#[cfg(any(test, feature = "use-mocks"))]
use mockiato::mockable;
use std::fmt::Debug;
use std::time::Duration;

/// Trait used by [`WorldInteractor`].
/// Implementors of this trait provide the actual code used for the performed actions
///
/// This trait is sealed and cannot be implemented by downstream crates.
#[cfg_attr(any(test, feature = "use-mocks"), mockable)]
pub trait Interactable<T>: Debug + Sealed {
    /// Returns read-only descriptions for all objects either completely
    /// contained or intersecting with the given area.
    fn objects_in_area(&self, area: Aabb) -> Snapshot<'_, T>;

    /// Returns read-only descriptions for all objects either completely
    /// contained or intersecting with the given area.
    fn objects_in_polygon(&self, area: &Polygon) -> Snapshot<'_, T>;

    /// Returns read-only descriptions for all objects
    /// intersecting with the given vector.
    fn objects_in_ray(&self, origin: Point, direction: Vector) -> Snapshot<'_, T>;

    /// Returns the amount of time that passed since the last call
    /// to the `step` function of [`Simulation`]
    fn elapsed_time_in_update(&self) -> Duration;

    /// Returns an object, if the specified ID is valid
    fn object(&self, id: Id) -> Option<Object<'_, T>>;
}

#[cfg(any(test, feature = "use-mocks"))]
impl<T> Sealed for InteractableMock<'_, T> {}