bevy_elf 0.1.0

Serializable Bevy asset definitions that resolve string references into Handles
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
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91

macro_rules! from_def_self {
    ($($ty:ty),+ $(,)?) => {
        $(
            impl $crate::FromDef for $ty {
                type Def = Self;

                fn from_def(
                    def: Self::Def,
                    _: &mut bevy_asset::LoadContext<'_>,
                ) -> Result<Self, crate::FromDefError> {
                    Ok(def)
                }
            }
        )+
    };
}

from_def_self![
    (),
    u8,
    u16,
    u32,
    u64,
    usize,
    i8,
    i16,
    i32,
    i64,
    isize,
    f32,
    f64,
    bool,
    String,
    std::time::Duration,
];

/// Generates [`FromDef`](crate::FromDef) implementations for a set of types, gated
/// behind a cargo feature.
///
/// Expands to a module named `$mod_name`, annotated with `#[cfg(feature = $feature)]`,
/// that `use`s the given `types` from `$krate` and implements [`FromDef`](crate::FromDef)
/// for each of them. Each implementation is a no-op passthrough: `Def` is `Self`, and
/// `from_def` simply returns the value unchanged.
///
/// This is intended for third-party types that are already in their final, usable form
/// and don't need any resolution or conversion step — they just need to satisfy the
/// [`FromDef`](crate::FromDef) bound so they can be used as fields in other `Def` types.
///
/// # Example
///
/// ```ignore
/// from_def_types!(
///     mod math,
///     feature = "math",
///     use bevy_math,
///     types = [Vec2, Vec3, Quat],
/// );
/// ```
macro_rules! from_def_types {
    (
        mod $mod_name:ident,
        feature = $feature:literal,
        use $krate:path,
        types = [$($ty:ident),+ $(,)?]
    ) => {
        #[cfg(feature = $feature)]
        mod $mod_name {
            use $krate::{$($ty),+};

            from_def_self![$($ty),+];
        }
    };
}

from_def_types!(
    mod math,
    feature = "math",
    use bevy_math,
    types = [
        BVec2, BVec3, BVec3A, BVec4, BVec4A, EulerRot, IRect, IVec2, IVec3, IVec4, Isometry2d,
        Isometry3d, Mat2, Mat3, Mat3A, Mat4, Quat, Ray2d, Ray3d, Rect, Rot2, URect, UVec2, UVec3,
        UVec4, Vec2, Vec3, Vec3A, Vec4,
    ]
);

from_def_types!(
    mod image,
    feature = "image",
    use bevy_image,
    types = [TextureAtlasLayout]
);