picori 0.1.0

Picori is a library for decompilation, modding, and rom-hacking with focus on GameCube and Wii games.
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

//! [GCM][`crate::gcm`] executable file. This is the [DOL][`crate::dol`] file
//! that contains the actual game code.

use crate::error::ParseProblem;
use crate::helper::{Parser, ProblemLocation, Seeker};
use crate::Result;

/// [GCM][`crate::gcm`] executable file object.
#[derive(Debug, Default)]
pub struct Executable {
    data: Vec<u8>,
}

impl Executable {
    /// Parse [GCM][`crate::gcm`] Executable ([DOL][`crate::dol`]) from binary.
    pub fn from_binary<D: Parser + Seeker>(input: &mut D) -> Result<Self> {
        let base = input.position()?;
        let text_offsets = input.bu32_array::<7>()?;
        let data_offsets = input.bu32_array::<11>()?;
        let _ = input.bu32_array::<7>()?;
        let _ = input.bu32_array::<11>()?;
        let text_sizes = input.bu32_array::<7>()?;
        let data_sizes = input.bu32_array::<11>()?;

        let text_iter = text_offsets
            .iter()
            .zip(text_sizes.iter())
            .map(|(offset, size)| offset + size);

        let data_iter = data_offsets
            .iter()
            .zip(data_sizes.iter())
            .map(|(offset, size)| offset + size);

        let total_size = text_iter.chain(data_iter).max().ok_or_else(|| {
            ParseProblem::InvalidHeader(
                "unable to determine executable size",
                std::panic::Location::current(),
            )
        })?;

        input.goto(base)?;
        let data = input.read_as_vec(total_size as usize)?;
        Ok(Self { data })
    }

    /// Get the executable data.
    pub fn data(&self) -> &[u8] { &self.data }
}