xc3_lib 0.21.0

Xenoblade Chronicles file format library
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

//! Skeletons in .hkt files.
//!
//! # File Paths
//!
//! | Game | File Patterns |
//! | --- | --- |
//! | Xenoblade X | `**/*.hkt` |
use binrw::{BinRead, NullString};
use xc3_write::{Xc3Write, Xc3WriteOffsets};

// TODO: Come up with a better name
// TODO: implement proper write support
// TODO: havok skeleton file?
#[cfg_attr(feature = "arbitrary", derive(arbitrary::Arbitrary))]
#[derive(Debug, BinRead, Xc3Write, Xc3WriteOffsets, PartialEq, Clone)]
#[br(magic(b"\x57\xe0\xe0\x57\x10\xc0\xc0\x10"))]
#[xc3(magic(b"\x57\xe0\xe0\x57\x10\xc0\xc0\x10"))]
pub struct Hkt {
    // TODO: data and then Khk_2013.1.0-r1 version string?
    pub unk1: [u32; 14],

    // __classnames__
    #[br(map(|x: NullString| x.to_string()))]
    #[br(pad_size_to = 16)]
    pub unk2: String,
    pub unk3: [u32; 8],

    // __types__
    #[br(map(|x: NullString| x.to_string()))]
    #[br(pad_size_to = 16)]
    pub unk4: String,
    pub unk5: [u32; 8],

    // __data__
    #[br(map(|x: NullString| x.to_string()))]
    #[br(pad_size_to = 16)]
    pub unk6: String,
    pub unk7: [u32; 8],

    #[br(count = unk3[2])]
    pub unk8_1: Vec<u8>,

    pub unk8_2: [u32; 52],

    // TODO: counts?
    pub count: u32,
    pub unk9_2: [u32; 19],

    // TODO: offset 640 or 672?
    // TODO: root bone name?
    #[br(map(|x: NullString| x.to_string()))]
    #[br(pad_size_to = 16)]
    pub unk10: String,

    // Parent indices?
    #[br(count = count)]
    #[br(align_after = 16)]
    pub parent_indices: Vec<i16>,

    // TODO: padding until names?
    #[br(count = count)]
    pub unk11: Vec<u64>,

    #[br(count = count)]
    pub names: Vec<BoneName>,

    #[br(count = count)]
    pub transforms: Vec<Transform>,
    // TODO: more integer values?
}

#[cfg_attr(feature = "arbitrary", derive(arbitrary::Arbitrary))]
#[derive(Debug, BinRead, Xc3Write, Xc3WriteOffsets, PartialEq, Clone)]
pub struct Transform {
    pub translation: [f32; 4],
    pub rotation_quaternion: [f32; 4],
    pub scale: [f32; 4],
}

#[cfg_attr(feature = "arbitrary", derive(arbitrary::Arbitrary))]
#[derive(Debug, BinRead, Xc3Write, Xc3WriteOffsets, PartialEq, Clone)]
pub struct BoneName {
    #[br(map(|x: NullString| x.to_string()))]
    #[br(align_after = 16)]
    pub name: String,
}