oxygengine-core 0.30.0

Core module for Oxygengine
Documentation
use crate::{
    app::AppBuilder,
    ecs::{
        components::{Events, EventsPrefabProxy},
        pipeline::{PipelineBuilder, PipelineBuilderError, PipelineLayer},
        Comp, Entity, Universe, WorldRef,
    },
    prefab::PrefabManager,
};
use std::{
    any::TypeId,
    collections::{HashMap, HashSet},
};

#[derive(Debug, Default)]
pub struct EntityChanges {
    pub skip_clearing: bool,
    pub(crate) entities: HashSet<Entity>,
    pub(crate) spawned: HashSet<Entity>,
    pub(crate) despawned: HashSet<Entity>,
    pub(crate) added_components: HashMap<Entity, HashSet<TypeId>>,
    pub(crate) removed_components: HashMap<Entity, HashSet<TypeId>>,
}

impl EntityChanges {
    pub fn has_changed(&self) -> bool {
        !self.spawned.is_empty() || !self.despawned.is_empty()
    }

    pub fn entities(&self) -> impl Iterator<Item = Entity> + '_ {
        self.entities.iter().copied()
    }

    pub fn spawned(&self) -> impl Iterator<Item = Entity> + '_ {
        self.spawned.iter().copied()
    }

    pub fn has_spawned(&self, entity: Entity) -> bool {
        self.spawned.contains(&entity)
    }

    pub fn despawned(&self) -> impl Iterator<Item = Entity> + '_ {
        self.despawned.iter().copied()
    }

    pub fn has_despawned(&self, entity: Entity) -> bool {
        self.despawned.contains(&entity)
    }

    pub fn added_component_iter<T: 'static>(&self) -> impl Iterator<Item = Entity> + '_ {
        let type_id = TypeId::of::<T>();
        self.added_components
            .iter()
            .filter_map(move |(entity, types)| {
                if types.contains(&type_id) {
                    Some(*entity)
                } else {
                    None
                }
            })
    }

    pub fn added_components(&self, entity: Entity) -> Option<impl Iterator<Item = TypeId> + '_> {
        self.added_components
            .get(&entity)
            .map(|types| types.iter().copied())
    }

    pub fn has_added_component<T: 'static>(&self, entity: Entity) -> bool {
        let type_id = TypeId::of::<T>();
        self.added_components
            .get(&entity)
            .map(|types| types.contains(&type_id))
            .unwrap_or_default()
    }

    pub fn removed_component_iter<T: 'static>(&self) -> impl Iterator<Item = Entity> + '_ {
        let type_id = TypeId::of::<T>();
        self.removed_components
            .iter()
            .filter_map(move |(entity, types)| {
                if types.contains(&type_id) {
                    Some(*entity)
                } else {
                    None
                }
            })
    }

    pub fn removed_components(&self, entity: Entity) -> Option<impl Iterator<Item = TypeId> + '_> {
        self.removed_components
            .get(&entity)
            .map(|types| types.iter().copied())
    }

    pub fn has_removed_component<T: 'static>(&self, entity: Entity) -> bool {
        let type_id = TypeId::of::<T>();
        self.removed_components
            .get(&entity)
            .map(|types| types.contains(&type_id))
            .unwrap_or_default()
    }

    pub(crate) fn clear(&mut self) {
        if self.skip_clearing {
            self.skip_clearing = false;
            return;
        }
        self.entities.clear();
        self.spawned.clear();
        self.despawned.clear();
        self.added_components.clear();
        self.removed_components.clear();
    }
}

pub type EventsSystemResources<'a, T> = (WorldRef, Comp<&'a mut Events<T>>);

pub fn events_system<T>(universe: &mut Universe)
where
    T: Send + Sync + 'static,
{
    let (world, ..) = universe.query_resources::<EventsSystemResources<T>>();

    for (_, events) in world.query::<&mut Events<T>>().iter() {
        if events.auto_clear {
            events.clear();
        }
    }
}

pub fn events_system_installer<PB, T>(
    builder: &mut AppBuilder<PB>,
    postfix: &str,
) -> Result<(), PipelineBuilderError>
where
    PB: PipelineBuilder,
    T: Send + Sync + 'static,
{
    builder.install_system_on_layer::<EventsSystemResources<T>>(
        &format!("events-system-{}", postfix),
        events_system::<T>,
        &[],
        PipelineLayer::Post,
        false,
    )?;
    Ok(())
}

pub fn events_prefab_installer<T>(postfix: &str, prefabs: &mut PrefabManager)
where
    T: Send + Sync + 'static,
{
    prefabs.register_component_factory_proxy::<Events<T>, EventsPrefabProxy<T>>(&format!(
        "Events-{}",
        postfix
    ));
}