spine2d 0.3.0

Pure Rust runtime for Spine 4.3 (unofficial)
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
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
149
150
151
152
153
154
155
156

use crate::{MixBlend, Skeleton, SkeletonData, apply_animation, build_draw_list};

const SKELETON_ATTACHMENT_TIMELINE: &str = r#"
{
  "skeleton": { "spine": "4.3.00" },
  "bones": [ { "name": "root" } ],
  "slots": [ { "name": "slot0", "bone": "root", "attachment": "a" } ],
  "skins": {
    "default": {
      "slot0": {
        "a": { "type": "region", "path": "a.png", "width": 10, "height": 10 },
        "b": { "type": "region", "path": "b.png", "width": 10, "height": 10 }
      }
    }
  },
  "animations": {
    "anim": {
      "slots": {
        "slot0": {
          "attachment": [
            { "time": 0.5, "name": "b" }
          ]
        }
      }
    }
  }
}
"#;

const SKELETON_DRAW_ORDER: &str = r#"
{
  "skeleton": { "spine": "4.3.00" },
  "bones": [ { "name": "root" } ],
  "slots": [
    { "name": "slot0", "bone": "root", "attachment": "a" },
    { "name": "slot1", "bone": "root", "attachment": "b" }
  ],
  "skins": {
    "default": {
      "slot0": { "a": { "type": "region", "path": "a.png", "width": 10, "height": 10 } },
      "slot1": { "b": { "type": "region", "path": "b.png", "width": 10, "height": 10 } }
    }
  },
  "animations": {
    "anim": {
      "drawOrder": [
        {
          "time": 0,
          "offsets": [
            { "slot": "slot1", "offset": -1 }
          ]
        }
      ]
    }
  }
}
"#;

const SKELETON_DRAW_ORDER_FOLDER: &str = r#"
{
  "skeleton": { "spine": "4.3.00" },
  "bones": [ { "name": "root" } ],
  "slots": [
    { "name": "slot0", "bone": "root", "attachment": "a" },
    { "name": "slot1", "bone": "root", "attachment": "b" },
    { "name": "slot2", "bone": "root", "attachment": "c" },
    { "name": "slot3", "bone": "root", "attachment": "d" }
  ],
  "skins": {
    "default": {
      "slot0": { "a": { "type": "region", "path": "a.png", "width": 10, "height": 10 } },
      "slot1": { "b": { "type": "region", "path": "b.png", "width": 10, "height": 10 } },
      "slot2": { "c": { "type": "region", "path": "c.png", "width": 10, "height": 10 } },
      "slot3": { "d": { "type": "region", "path": "d.png", "width": 10, "height": 10 } }
    }
  },
  "animations": {
    "anim": {
      "drawOrder": [
        {
          "time": 0,
          "offsets": [
            { "slot": "slot3", "offset": -3 }
          ]
        }
      ],
      "drawOrderFolder": {
        "middle": {
          "slots": ["slot1", "slot2"],
          "keys": [
            {
              "time": 0,
              "offsets": [
                { "slot": "slot2", "offset": -1 }
              ]
            },
            { "time": 1 }
          ]
        }
      }
    }
  }
}
"#;

#[test]
fn slot_attachment_timeline_switches_attachment() {
    let data = SkeletonData::from_json_str(SKELETON_ATTACHMENT_TIMELINE).unwrap();
    let mut skeleton = Skeleton::new(data.clone());
    let (_, animation) = data.animation("anim").unwrap();
    skeleton.set_to_setup_pose();
    skeleton.update_world_transform();

    apply_animation(animation, &mut skeleton, 0.25, false, 1.0, MixBlend::First);
    assert_eq!(skeleton.slots[0].attachment.as_deref(), Some("a"));

    apply_animation(animation, &mut skeleton, 0.75, false, 1.0, MixBlend::First);
    assert_eq!(skeleton.slots[0].attachment.as_deref(), Some("b"));

    let draw_list = build_draw_list(&skeleton);
    assert_eq!(draw_list.draws.len(), 1);
    assert_eq!(draw_list.draws[0].texture_path, "b.png");
}

#[test]
fn draw_order_timeline_reorders_slots() {
    let data = SkeletonData::from_json_str(SKELETON_DRAW_ORDER).unwrap();
    let mut skeleton = Skeleton::new(data.clone());
    let (_, animation) = data.animation("anim").unwrap();
    skeleton.set_to_setup_pose();
    skeleton.update_world_transform();
    assert_eq!(skeleton.draw_order, vec![0, 1]);

    apply_animation(animation, &mut skeleton, 0.0, false, 1.0, MixBlend::First);
    assert_eq!(skeleton.draw_order, vec![1, 0]);

    let draw_list = build_draw_list(&skeleton);
    assert_eq!(draw_list.draws.len(), 2);
    assert_eq!(draw_list.draws[0].texture_path, "b.png");
    assert_eq!(draw_list.draws[1].texture_path, "a.png");
}

#[test]
fn draw_order_folder_timeline_reorders_only_folder_slots() {
    let data = SkeletonData::from_json_str(SKELETON_DRAW_ORDER_FOLDER).unwrap();
    let mut skeleton = Skeleton::new(data.clone());
    let (_, animation) = data.animation("anim").unwrap();
    skeleton.set_to_setup_pose();
    skeleton.update_world_transform();

    apply_animation(animation, &mut skeleton, 0.0, false, 1.0, MixBlend::First);
    assert_eq!(skeleton.draw_order, vec![3, 0, 2, 1]);

    apply_animation(animation, &mut skeleton, 1.0, false, 1.0, MixBlend::First);
    assert_eq!(skeleton.draw_order, vec![3, 0, 1, 2]);
}