assets_manager 0.13.9

Conveniently load, cache, and reload external resources
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

//! In this example, we define a custom asset type and load it from a cache.
//!
//! The asset is stored in RON, in the file `assets/example/monsters/goblin.ron`.

use assets_manager::{AssetCache, BoxedError};

#[derive(serde::Deserialize, assets_manager::Asset)]
#[asset_format = "ron"]
struct Monster {
    name: String,
    description: String,
    health: u32,
}

fn main() -> Result<(), BoxedError> {
    // The cache used to load assets
    // Its root is directory `assets`
    let cache = AssetCache::new("assets")?;

    // Load an asset with type `Vec<MonsterStats>`
    // The result is a lock on the stats
    let goblin = cache.load::<Monster>("example.monsters.goblin")?;

    // Lock the asset for reading. This is necessary because we might want to
    // reload it from disk (eg with hot-reloading)
    let goblin = goblin.read();

    // Use it
    println!(
        "A {} ({}) has {} HP",
        goblin.name, goblin.description, goblin.health
    );

    Ok(())
}