gcrecomp-runtime 0.0.1-alpha

Runtime library for GameCube recompiled 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
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65

// Video RAM simulation (2MB)
use anyhow::Result;

pub struct VRam {
    data: Vec<u8>,
    size: usize,
}

impl VRam {
    pub fn new() -> Self {
        const VRAM_SIZE: usize = 2 * 1024 * 1024; // 2MB
        Self {
            data: vec![0; VRAM_SIZE],
            size: VRAM_SIZE,
        }
    }

    pub fn read_u32(&self, address: u32) -> Result<u32> {
        let addr = (address & 0x001FFFFF) as usize; // 21-bit addressing
        if addr + 4 <= self.size {
            Ok(u32::from_be_bytes([
                self.data[addr],
                self.data[addr + 1],
                self.data[addr + 2],
                self.data[addr + 3],
            ]))
        } else {
            anyhow::bail!("VRAM read out of bounds: 0x{:08X}", address);
        }
    }

    pub fn write_u32(&mut self, address: u32, value: u32) -> Result<()> {
        let addr = (address & 0x001FFFFF) as usize;
        if addr + 4 <= self.size {
            let bytes = value.to_be_bytes();
            self.data[addr..addr + 4].copy_from_slice(&bytes);
            Ok(())
        } else {
            anyhow::bail!("VRAM write out of bounds: 0x{:08X}", address);
        }
    }

    pub fn read_bytes(&self, address: u32, len: usize) -> Result<Vec<u8>> {
        let addr = (address & 0x001FFFFF) as usize;
        if addr + len <= self.size {
            Ok(self.data[addr..addr + len].to_vec())
        } else {
            anyhow::bail!("VRAM read out of bounds: 0x{:08X} len {}", address, len);
        }
    }

    pub fn write_bytes(&mut self, address: u32, data: &[u8]) -> Result<()> {
        let addr = (address & 0x001FFFFF) as usize;
        if addr + data.len() <= self.size {
            self.data[addr..addr + data.len()].copy_from_slice(data);
            Ok(())
        } else {
            anyhow::bail!(
                "VRAM write out of bounds: 0x{:08X} len {}",
                address,
                data.len()
            );
        }
    }
}