spine_bevy 0.2.2

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
52
53
54
55
56
57

//! Asset types and loaders for Spine `.atlas`, `.skel` and `.json` files.
//!
//! A skeleton is loaded against an atlas: [`SpineSkeletonLoader`] (`.skel`)
//! and [`SpineSkeletonJsonLoader`] (`.json`) load the atlas as a dependency,
//! resolve attachments against it, and produce a [`SpineSkeletonAsset`] that
//! holds the shared skeleton data and a handle to the [`SpineAtlasAsset`].
//! The atlas path comes from the loader settings or is derived from the
//! skeleton's file name; see [`SpineSkeletonLoaderSettings::atlas_path`].

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;

/// Returns `override_path` if given. Otherwise strips a `-pro`, `-ess` or
/// `-ios` suffix from the skeleton's file stem and resolves `<stem>.atlas`
/// beside it: `spineboy-pro.skel` gives `spineboy.atlas`.
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),
}