game-toolkit 0.11.3

A Rust game-jam toolkit for 2D and 3D - umbrella crate; use game_toolkit::prelude::* and go.
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

//! `ctx.load_aseprite(..)`: asset-root loading for sprite sheets, on every platform.
//!
//! Lives here rather than in core because core must not depend on the aseprite crate.

use std::path::Path;

use anyhow::Result;
use game_toolkit_aseprite::SpriteSheet;
use game_toolkit_core::Context;

/// Load Aseprite sprite sheets through [`Context::assets`], so the same call works natively
/// and on the web (where assets are preloaded into memory).
pub trait LoadAseprite {
    /// Load a native `.aseprite`/`.ase` file from the asset root.
    fn load_aseprite(&mut self, rel: impl AsRef<Path>) -> Result<SpriteSheet>;

    /// Load an exported sheet (PNG atlas + Aseprite JSON sidecar) from the asset root.
    fn load_aseprite_json(
        &mut self,
        png: impl AsRef<Path>,
        json: impl AsRef<Path>,
    ) -> Result<SpriteSheet>;
}

impl LoadAseprite for Context {
    fn load_aseprite(&mut self, rel: impl AsRef<Path>) -> Result<SpriteSheet> {
        let rel = rel.as_ref();
        let bytes = self.assets.read(rel)?;
        SpriteSheet::from_aseprite_bytes(&mut self.gfx, &bytes, &rel.to_string_lossy())
    }

    fn load_aseprite_json(
        &mut self,
        png: impl AsRef<Path>,
        json: impl AsRef<Path>,
    ) -> Result<SpriteSheet> {
        let png_bytes = self.assets.read(png.as_ref())?;
        let json_bytes = self.assets.read(json.as_ref())?;
        SpriteSheet::from_aseprite_json_bytes(
            &mut self.gfx,
            &png_bytes,
            &json_bytes,
            &png.as_ref().to_string_lossy(),
        )
    }
}