bevy/crates/bevy_ecs/src/system/system.rs

49 lines
1.8 KiB
Rust
Raw Normal View History

use crate::{ArchetypeComponent, Resources, TypeAccess, World};
use std::{any::TypeId, borrow::Cow};
2020-07-10 04:18:35 +00:00
#[derive(Debug, Copy, Clone, Eq, PartialEq, Hash)]
pub struct SystemId(pub usize);
2020-07-10 04:18:35 +00:00
impl SystemId {
#[allow(clippy::new_without_default)]
2020-07-10 04:18:35 +00:00
pub fn new() -> Self {
SystemId(rand::random::<usize>())
2020-07-10 04:18:35 +00:00
}
}
2020-08-16 03:27:41 +00:00
/// An ECS system that can be added to a [Schedule](crate::Schedule)
pub trait System: Send + Sync + 'static {
2020-12-13 02:04:42 +00:00
type In;
type Out;
2020-07-10 04:18:35 +00:00
fn name(&self) -> Cow<'static, str>;
fn id(&self) -> SystemId;
fn update_access(&mut self, world: &World);
fn archetype_component_access(&self) -> &TypeAccess<ArchetypeComponent>;
fn component_access(&self) -> &TypeAccess<TypeId>;
fn resource_access(&self) -> &TypeAccess<TypeId>;
fn is_non_send(&self) -> bool;
/// # Safety
/// This might access World and Resources in an unsafe manner. This should only be called in one of the following contexts:
/// 1. This system is the only system running on the given World and Resources across all threads
/// 2. This system only runs in parallel with other systems that do not conflict with the `archetype_component_access()` or `resource_access()`
unsafe fn run_unsafe(
&mut self,
2020-12-13 02:04:42 +00:00
input: Self::In,
world: &World,
resources: &Resources,
2020-12-13 02:04:42 +00:00
) -> Option<Self::Out>;
fn run(
&mut self,
2020-12-13 02:04:42 +00:00
input: Self::In,
world: &mut World,
resources: &mut Resources,
2020-12-13 02:04:42 +00:00
) -> Option<Self::Out> {
// SAFE: world and resources are exclusively borrowed
unsafe { self.run_unsafe(input, world, resources) }
}
fn apply_buffers(&mut self, world: &mut World, resources: &mut Resources);
fn initialize(&mut self, world: &mut World, resources: &mut Resources);
2020-07-10 04:18:35 +00:00
}
pub type BoxedSystem<In = (), Out = ()> = Box<dyn System<In = In, Out = Out>>;