horntail 0.4.2

maplestory resource file unpack lib
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

use crate::reader::{Accessor, seek_back};
use crate::{AccessorOpt, EntryKind, Error, Image, TryFromAccessor};
use std::io::SeekFrom;
use std::ops::Deref;

const UNKNOWN: u8 = 1;
const UOL: u8 = 2;
const FOLDER: u8 = 3;
const IMAGE: u8 = 4;

#[derive(Clone)]
pub struct Directory {
    pub name: String,
    pub kind: EntryKind,
    pub offset: usize,
    pub parent_offset: usize,
}

impl TryFromAccessor for Option<Directory> {
    type Error = Error;

    fn try_from_accessor(
        opt: AccessorOpt,
        accessor: &mut dyn Accessor,
    ) -> Result<Self, Self::Error> {
        let kind = accessor.get_u8();
        if kind == UNKNOWN {
            accessor.advance(10);
            return Ok(None);
        }

        let (kind, name) = if kind == UOL {
            let off = accessor.get_u32_le() as usize + opt.parent_offset;
            seek_back(accessor, SeekFrom::Start(off as u64), |accessor| {
                (accessor.get_u8(), accessor.get_decrypt_string())
            })
        } else if kind == IMAGE || kind == FOLDER {
            (kind, accessor.get_decrypt_string())
        } else {
            panic!("invalid element kind {kind}");
        };

        let size = accessor.get_var_i32_le();
        // all the data byte sum together
        let _checksum = accessor.get_var_i32_le();
        let data_offset = compute_offset(&opt, accessor);

        match kind {
            IMAGE => {
                let mut image =
                    seek_back(accessor, SeekFrom::Start(data_offset as u64), |accessor| {
                        Image::try_from_accessor(opt.clone_with(data_offset), accessor)
                    })?;
                image.size = size as usize;
                Ok(Some(Directory {
                    name,
                    kind: image.kind,
                    offset: image.offset,
                    parent_offset: data_offset,
                }))
            }
            FOLDER => Ok(Some(Directory {
                name,
                kind: EntryKind::Folder,
                offset: data_offset,
                parent_offset: opt.parent_offset,
            })),
            _ => Err(Error::UnexpectedData(format!(
                "unexpected element kind {kind}"
            ))),
        }
    }
}

#[derive(Clone)]
pub struct Directories {
    directories: Vec<Directory>,
}

impl Deref for Directories {
    type Target = [Directory];
    fn deref(&self) -> &Self::Target {
        &self.directories
    }
}

impl Directories {
    #[inline]
    pub fn into_inner(self) -> Vec<Directory> {
        self.directories
    }
}

impl TryFromAccessor for Directories {
    type Error = Error;

    fn try_from_accessor(
        opt: AccessorOpt,
        accessor: &mut dyn Accessor,
    ) -> Result<Self, Self::Error> {
        let entry_count = accessor.get_var_i32_le() as usize;
        let mut directories = Vec::with_capacity(entry_count);
        for _ in 0..entry_count {
            let Some(directory) =
                Option::<Directory>::try_from_accessor(opt.clone_with(accessor.pos()), accessor)?
            else {
                continue;
            };
            directories.push(directory);
        }
        Ok(Directories { directories })
    }
}

#[inline]
fn compute_offset(opt: &AccessorOpt, accessor: &mut dyn Accessor) -> usize {
    let hash = opt.ver_hash as u32;
    let data_pos = opt.parent_offset;
    let offset = (accessor.pos().wrapping_sub(data_pos) as u32 ^ u32::MAX)
        .wrapping_mul(hash)
        .wrapping_sub(0x581c3f6d);
    let factor = offset & 0x1f;
    let enc_offset = accessor.get_u32_le();
    ((offset.wrapping_shl(factor) | offset.wrapping_shr(32 - factor)) ^ enc_offset)
        .wrapping_add((data_pos as u32).wrapping_shl(1)) as usize
}