3 releases (breaking)
new 0.3.0 | Nov 12, 2024 |
---|---|
0.2.0 | Nov 12, 2024 |
0.1.0 | Nov 9, 2024 |
#1625 in Procedural macros
304 downloads per month
Used in ron_asset_manager
4KB
ron asset manager
A dead simple crate to manage Ron based assets which depend on other assets.
Assets can hot reload into a running game state. Use it to your advantage!
How to
Shandle<T>
is a thin wrapper around Handle<T>
that can be serialized by
behaving like a asset path in serialized form.
This crates provides the RonAsset
derive macro, RonAssetPlugin
and the Shandle
.
The idea is to mark asset dependencies via attribute.
Currently there is #[asset]
, #[asset_vec]
, #[asset_map]
.
Example
#[derive(Asset, TypePath, RonAsset, Deserialize)]
pub struct Wizard{
#[asset]
pub sprite: Shandle<Image>,
#[asset_map]
pub sound: HashMap<String, Shandle<AudioSource>>,
#[asset_vec]
pub spells: Vec<Shandle<Actions>>,
}
// also you need to register your type.
fn build(&self, app: &mut App) {
app.add_plugins(RonAssetPlugin::<Wizard>::default());
}
// that's all, time to use it
fn spawn_wizard(server: Res<AssetServer>){
let wizard_handle = server.load("/enemies/wizard.ron")
...
}
(
sprite: "sprite/wizard.png",
spells: {
"death" : "audio/wizard_death.ogg",
"hit" : "audio/wizard_hit.ogg",
"angry" : "audio/wizard_angy.ogg",
},
spells: (
"spells/fireball.ron",
"spells/lightning.ron",
)
)
Future plans
Nested structs via another attribute #[ron_struct(field1, field2)]
.
Dependencies
~25–60MB
~1M SLoC