mirui 0.3.1

A lightweight, no_std ECS-driven UI framework for embedded, desktop, and WebAssembly
Documentation 
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
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76

use alloc::vec::Vec;
use core::any::TypeId;
use core::marker::PhantomData;

use super::entity::Entity;
use super::world::World;

pub struct QueryBuilder<'w, T: 'static> {
    world: &'w World,
    and_filters: Vec<TypeId>,
    without_filters: Vec<TypeId>,
    _marker: PhantomData<T>,
}

impl<'w, T: 'static> QueryBuilder<'w, T> {
    pub(crate) fn new(world: &'w World) -> Self {
        Self {
            world,
            and_filters: Vec::new(),
            without_filters: Vec::new(),
            _marker: PhantomData,
        }
    }

    pub fn and<U: 'static>(mut self) -> Self {
        self.and_filters.push(TypeId::of::<U>());
        self
    }

    pub fn without<U: 'static>(mut self) -> Self {
        self.without_filters.push(TypeId::of::<U>());
        self
    }

    fn matches(&self, entity: Entity) -> bool {
        for &tid in &self.and_filters {
            if !self.world.has_type(entity, tid) {
                return false;
            }
        }
        for &tid in &self.without_filters {
            if self.world.has_type(entity, tid) {
                return false;
            }
        }
        true
    }

    /// Iterate over (Entity, &T) for all matching entities
    pub fn iter(&self) -> impl Iterator<Item = (Entity, &T)> + '_ {
        self.world
            .storage::<T>()
            .into_iter()
            .flat_map(|s| s.iter())
            .filter(|(e, _)| self.matches(*e))
    }

    /// Collect matching entity IDs into a user-provided buffer (zero alloc after first frame)
    pub fn collect_into(self, buf: &mut Vec<Entity>) {
        buf.clear();
        if let Some(storage) = self.world.storage::<T>() {
            for &entity in storage.entities() {
                if self.matches(entity) {
                    buf.push(entity);
                }
            }
        }
    }

    /// Collect matching entity IDs into a new Vec
    pub fn collect(self) -> Vec<Entity> {
        let mut buf = Vec::new();
        self.collect_into(&mut buf);
        buf
    }
}