ltk_anim 0.3.2

Animation formats support for League Toolkit
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

use crate::Joint;
use byteorder::{WriteBytesExt, LE};
use ltk_hash::elf;
use ltk_io_ext::WriterExt;
use std::io;
use std::io::{Seek, Write};

impl Joint {
    pub fn to_writer<W: Write + Seek + ?Sized>(
        &self,
        writer: &mut W,
        name_off: u64,
    ) -> io::Result<()> {
        writer.write_u16::<LE>(self.flags)?;
        writer.write_i16::<LE>(self.id)?;
        writer.write_i16::<LE>(self.parent_id)?;

        writer.write_i16::<LE>(0)?; // padding

        writer.write_u32::<LE>(elf::elf(&self.name) as u32)?;
        writer.write_f32::<LE>(self.radius)?;

        writer.write_vec3::<LE>(&self.local_translation)?;
        writer.write_vec3::<LE>(&self.local_scale)?;
        writer.write_quat::<LE>(&self.local_rotation)?;

        writer.write_vec3::<LE>(&self.inverse_bind_translation)?;
        writer.write_vec3::<LE>(&self.inverse_bind_scale)?;
        writer.write_quat::<LE>(&self.inverse_bind_rotation)?;

        let pos = writer.stream_position()?;
        writer.write_i32::<LE>((name_off as i64 - pos as i64) as i32)?;

        Ok(())
    }
}

#[cfg(test)]
mod test {
    use super::*;
    use approx::assert_ulps_eq;
    use glam::{vec3, Mat4, Quat};
    use io::SeekFrom;
    use std::io::Cursor;

    macro_rules! assert_joint_fuzzy_vec {
        ($a: ident, $b: ident, $field:tt) => {
            for (a, b) in $a.$field.to_array().iter().zip($b.$field.to_array().iter()) {
                assert_ulps_eq!(a, b);
            }
            $a.$field = $b.$field;
        };
    }
    macro_rules! assert_joint_fuzzy_mat {
        ($a: ident, $b: ident, $field:tt) => {
            for (a, b) in $a
                .$field
                .to_cols_array()
                .iter()
                .zip($b.$field.to_cols_array().iter())
            {
                assert_ulps_eq!(a, b);
            }
            $a.$field = $b.$field;
        };
    }

    #[test]
    fn roundtrip_write() {
        let mat = Mat4::from_scale_rotation_translation(
            vec3(0.5, 0.5, 0.5),
            Quat::from_array([1.0, 0.8, 0.1, 0.0]).normalize(),
            vec3(1.0, 50.0, 34.0),
        );

        let joint_name = "joint";
        let joint_size = 100; // size of joint in bytes
        let mut buf = Cursor::new(vec![0; joint_size + joint_name.len() + 1]); // +1 for nul terminator

        let mut a = Joint::new(
            joint_name.into(),
            1234,
            5432,
            9876,
            42.0,
            mat,
            mat.inverse(),
        );

        let name_off = joint_size as u64;

        a.to_writer(&mut buf, name_off).unwrap();

        buf.seek(SeekFrom::Start(name_off)).unwrap();
        buf.write_all(joint_name.as_bytes()).unwrap();
        buf.rewind().unwrap();

        println!("{buf:?}");

        let b = Joint::from_reader(&mut buf).unwrap();
        /*
         Because assert_eq isn't good with floats,
         we first check the float values with the 'approx' crate (see above macros),
         then *sets* the fields equal to each other,
         so that the assert_eq doesn't fail on those fields - but still checks everything else.
        */
        assert_joint_fuzzy_vec!(a, b, local_scale);
        assert_joint_fuzzy_vec!(a, b, local_rotation);
        assert_joint_fuzzy_vec!(a, b, local_translation);
        assert_joint_fuzzy_mat!(a, b, local_transform);

        assert_joint_fuzzy_vec!(a, b, inverse_bind_scale);
        assert_joint_fuzzy_vec!(a, b, inverse_bind_rotation);
        assert_joint_fuzzy_vec!(a, b, inverse_bind_translation);
        assert_joint_fuzzy_mat!(a, b, inverse_bind_transform);

        assert_eq!(a, b);
    }
}