spine_bevy 0.2.0

Bevy 0.19 plugin for the unofficial spine_runtime port: load, animate, and draw Spine 4.3 skeletons.
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

//! Bevy asset types + loaders for Spine `.atlas`, `.skel`, and `.json` files.

pub mod atlas_loader;
pub mod skel_json_loader;
pub mod skel_loader;

pub use atlas_loader::{SpineAtlasAsset, SpineAtlasLoader, SpineAtlasLoaderError};
pub use skel_json_loader::{
    SpineSkeletonJsonLoader, SpineSkeletonJsonLoaderError, SpineSkeletonJsonLoaderSettings,
};
pub use skel_loader::{
    SpineSkeletonAsset, SpineSkeletonLoader, SpineSkeletonLoaderError, SpineSkeletonLoaderSettings,
};

use bevy::asset::{AssetPath, ParseAssetPathError};
use thiserror::Error;

/// Shared atlas-path derivation used by every skeleton loader. Strips common
/// rig-suffix variants (`-pro`, `-ess`, `-ios`) off the stem and appends
/// `.atlas`, or returns the `override` path verbatim. Returns an
/// [`AtlasDeriveError`] that loader-specific error enums can `From`-convert.
pub(crate) fn derive_atlas_path(
    skel_path: &AssetPath<'static>,
    override_path: Option<&str>,
) -> Result<AssetPath<'static>, AtlasDeriveError> {
    if let Some(p) = override_path {
        return Ok(AssetPath::parse(p).clone_owned());
    }

    let stem = skel_path
        .path()
        .file_stem()
        .and_then(|s| s.to_str())
        .ok_or_else(|| AtlasDeriveError::BadStem(skel_path.to_string()))?;

    let base = ["-pro", "-ess", "-ios"]
        .into_iter()
        .find_map(|suffix| stem.strip_suffix(suffix))
        .unwrap_or(stem);

    let atlas_name = format!("{base}.atlas");
    Ok(skel_path.resolve_embed_str(&atlas_name)?)
}

#[derive(Debug, Error)]
pub(crate) enum AtlasDeriveError {
    #[error("could not derive atlas path from skeleton path {0:?}")]
    BadStem(String),
    #[error("asset path parse error: {0}")]
    Parse(#[from] ParseAssetPathError),
}