ltk_anim 0.3.9

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

use crate::{rotation, Joint};
use byteorder::{ReadBytesExt, LE};
use glam::{Mat4, Quat};
use ltk_io_ext::ReaderExt;
use std::io;
use std::io::SeekFrom;
use std::io::{Read, Seek};

impl Joint {
    pub fn new(
        name: String,
        flags: u16,
        id: i16,
        parent_id: i16,
        radius: f32,
        local_transform: Mat4,
        inverse_bind_transform: Mat4,
    ) -> Self {
        let (local_scale, local_rotation, local_translation) =
            local_transform.to_scale_rotation_translation();
        let (inverse_bind_scale, inverse_bind_rotation, inverse_bind_translation) =
            inverse_bind_transform.to_scale_rotation_translation();

        Self {
            name,
            flags,
            id,
            parent_id,
            radius,
            local_transform,
            local_translation,
            local_scale,
            local_rotation,
            inverse_bind_transform,
            inverse_bind_translation,
            inverse_bind_scale,
            inverse_bind_rotation,
        }
    }

    pub fn from_reader<R: Read + Seek + ?Sized>(reader: &mut R) -> io::Result<Self> {
        let flags = reader.read_u16::<LE>()?;
        let id = reader.read_i16::<LE>()?;
        let parent_id = reader.read_i16::<LE>()?;
        reader.read_i16::<LE>()?; // padding
        let _name_hash = reader.read_u32::<LE>()?;
        let radius = reader.read_f32::<LE>()?;

        let local_translation = reader.read_vec3::<LE>()?;
        let local_scale = reader.read_vec3::<LE>()?;
        let local_rotation = normalized(reader.read_quat::<LE>()?, "local rotation")?;

        let inverse_bind_translation = reader.read_vec3::<LE>()?;
        let inverse_bind_scale = reader.read_vec3::<LE>()?;
        let inverse_bind_rotation = reader.read_quat::<LE>()?;
        let normalized_inverse_bind_rotation =
            normalized(inverse_bind_rotation, "inverse bind rotation")?;

        let name_off = reader.read_i32::<LE>()?;
        let return_pos = reader.stream_position()?;

        reader.seek(SeekFrom::Current(-4 + name_off as i64))?;
        let name = reader.read_str_until_nul()?;
        reader.seek(SeekFrom::Start(return_pos))?;

        Ok(Self {
            name,
            flags,
            id,
            parent_id,
            radius,
            local_transform: Mat4::from_scale_rotation_translation(
                local_scale,
                local_rotation.normalize(),
                local_translation,
            ),
            local_translation,
            local_scale,
            local_rotation,
            inverse_bind_transform: Mat4::from_scale_rotation_translation(
                inverse_bind_scale,
                normalized_inverse_bind_rotation,
                inverse_bind_translation,
            ),
            inverse_bind_translation,
            inverse_bind_scale,
            inverse_bind_rotation,
        })
    }
}

/// Scales a joint rotation to unit length.
///
/// # Errors
///
/// Returns [`io::ErrorKind::InvalidData`] for a rotation whose length is zero or not finite.
fn normalized(rotation: Quat, field: &str) -> io::Result<Quat> {
    rotation::try_normalize(rotation).ok_or_else(|| {
        io::Error::new(
            io::ErrorKind::InvalidData,
            format!("joint {field} {rotation} has no unit length"),
        )
    })
}