psx 0.1.8

Library for developing homebrew for the Sony PlayStation 1
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

use crate::gpu::{Color, Vertex};
use crate::hw::gpu::{GP0Command, GP0};
use crate::hw::Register;

impl GP0 {
    ///  Requests interrupt [`IRQ::GPU`][crate::hw::irq::IRQ::GPU].
    pub fn interrupt_request(&mut self) -> &mut Self {
        self.assign(0x1F << 24).store();
        self
    }

    /// Inserts a NOP which may be used for timing in the GPU buffer.
    pub fn nop(&mut self) -> &mut Self {
        self.assign(0x00 << 24).store();
        self
    }

    /// Fill a rectangle in VRAM with a [`Color`].
    pub fn fill_rectangle(&mut self, color: Color, offset: Vertex, size: Vertex) -> &mut Self {
        self.assign(0x02 << 24 | u32::from(color))
            .store()
            .assign(u32::from(offset))
            .store()
            .assign(u32::from(size))
            .store();
        self
    }

    /// Sends the GP0 command `cmd` to the GPU.
    ///
    /// # Safety
    ///
    /// Make sure that the GPU buffer has room for the command to avoid
    /// overflow. `GP0Command` types larger than the GPU buffer may not be sent
    /// without dropping some commands. This will not corrupt memory, but may
    /// cause unintended on-screen effects.
    // TODO: Make this unsafe
    pub fn send_command<C: GP0Command + ?Sized>(&mut self, cmd: &C) -> &mut Self {
        for &word in cmd.data() {
            self.assign(word).store();
        }
        self
    }
}