pebble-engine 0.2.0

A modular, ECS-style graphics/app framework for Rust.
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

use crate::{ecs::resources::Resources, ecs::system::Res};

/// A set of resources required by an [`Asset`](crate::assets::upload::Asset)
/// implementation before it can be uploaded to the backend.
///
/// Implement this trait for `()` (no deps), a single `Res<T>`, or a tuple of
/// `Res<T>` values. The sync system calls [`try_gather`] each tick and skips
/// the upload if any dependency is not yet present.
pub trait Dependencies<'a>: Sized {
    /// Attempt to gather all required resources from the world.
    ///
    /// Returns `None` if any dependency is missing, deferring the upload to
    /// the next tick.
    fn try_gather(world: &'a hecs::World, resources: &'a Resources) -> Option<Self>;
}

impl<'a> Dependencies<'a> for () {
    fn try_gather(_world: &'a hecs::World, _resources: &'a Resources) -> Option<Self> {
        Some(())
    }
}

impl<'a, A: 'static + Send + Sync> Dependencies<'a> for Res<'a, A> {
    fn try_gather(world: &'a hecs::World, resources: &'a Resources) -> Option<Self> {
        if !resources.has_resource::<A>(world) {
            return None;
        }

        Some(Res {
            data: resources.get_resource(world),
        })
    }
}

impl<'a, A, B> Dependencies<'a> for (Res<'a, A>, Res<'a, B>)
where
    A: 'static + Send + Sync,
    B: 'static + Send + Sync,
{
    fn try_gather(world: &'a hecs::World, resources: &'a Resources) -> Option<Self> {
        if !resources.has_resource::<A>(world) || !resources.has_resource::<B>(world) {
            return None;
        }

        Some((
            Res {
                data: resources.get_resource(world),
            },
            Res {
                data: resources.get_resource(world),
            },
        ))
    }
}