pebble-engine 0.13.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
55
56
57
58
59
60
61
62
63
64

//! Crate-internal codegen for the `wgpu` module's per-asset-type `Plugin`s.
//! Not a public module — the generated types (`MeshPlugin`, `MaterialPlugin`,
//! `TexturePlugin`, ...) are exported from the modules that invoke these
//! macros, same as if they'd been hand-written there.

/// Declares a zero-config `Plugin` that registers a single
/// `AssetPlugin::<WGPUBackend, $gpu_ty>` — the shape shared by most of this
/// module's per-asset-type plugins (`MeshPlugin`, `MaterialPlugin`,
/// `ComputePlugin`, `MaterialInstancePlugin`, `ComputeInstancePlugin`),
/// which otherwise only differ in this one type parameter. Doc comments
/// written inside the invocation (before the name) become the generated
/// struct's own docs, same as if written by hand.
macro_rules! asset_plugin {
    ($(#[$doc:meta])* $name:ident, $gpu_ty:ty) => {
        $(#[$doc])*
        #[derive(Default)]
        pub struct $name;
        impl $name {
            pub fn new() -> Self {
                Self
            }
        }
        impl crate::ecs::plugin::Plugin for $name {
            fn build(&self, app: &mut crate::app::App) {
                app.add_plugin(crate::assets::plugin::AssetPlugin::<
                    crate::wgpu::backend::WGPUBackend,
                    $gpu_ty,
                >::new());
            }
        }
    };
}

/// Same as [`asset_plugin!`] but also registers the shared
/// `LazyResourcePlugin<WGPUBackend, MipmapGenerator>` first — the shape
/// used by the texture-like plugins (`TexturePlugin`, `CubemapPlugin`,
/// `TextureArrayPlugin`) whose descriptors support `generate_mips`.
macro_rules! mipmap_asset_plugin {
    ($(#[$doc:meta])* $name:ident, $gpu_ty:ty) => {
        $(#[$doc])*
        #[derive(Default)]
        pub struct $name;
        impl $name {
            pub fn new() -> Self {
                Self
            }
        }
        impl crate::ecs::plugin::Plugin for $name {
            fn build(&self, app: &mut crate::app::App) {
                app.add_plugin(crate::assets::singleton_asset::LazyResourcePlugin::<
                    crate::wgpu::backend::WGPUBackend,
                    crate::wgpu::mipmap::MipmapGenerator,
                >::new());
                app.add_plugin(crate::assets::plugin::AssetPlugin::<
                    crate::wgpu::backend::WGPUBackend,
                    $gpu_ty,
                >::new());
            }
        }
    };
}

pub(crate) use asset_plugin;
pub(crate) use mipmap_asset_plugin;