Struct CellGcmTexture

Source

pub struct CellGcmTexture {
    pub format: u8,
    pub mipmap: u8,
    pub dimension: u8,
    pub cubemap: u8,
    pub remap: u32,
    pub width: u16,
    pub height: u16,
    pub depth: u16,
    pub location: u8,
    pub pad: u8,
    pub pitch: u32,
    pub offset: u32,
}

Expand description

The 24-byte descriptor, including GPU address metadata.

Fields§

§format: u8

The pixel format byte. Bit 0x20 (LN) selects linear storage with a constant base pitch and bit 0x40 (UN) selects unnormalized coordinates; the format proper is format & !0x60.

§mipmap: u8

The mip count.

§dimension: u8

1, 2 or 3 (a volume).

§cubemap: u8

1 for a cube map.

§remap: u32

The libgcm component remap word; identity is 0xaae4.

§width: u16

The width in texels.

§height: u16

The height in texels.

§depth: u16

The depth in texels (1 unless a volume).

§location: u8

The memory location code, as stored.

§pad: u8

The padding byte after the location, as stored.

§pitch: u32

The base row pitch in bytes, meaningful for linear storage.

§offset: u32

The GPU address offset, as stored.

Implementations§

Source §

impl CellGcmTexture

Source

pub fn parse(data: &[u8]) -> Result<Self, Error>

Parse exactly one descriptor as data.

§Errors

Error::DescriptorLength when data is not 24 bytes.

Examples found in repository ?

examples/inspect_rsx.rs (line 10)

5fn main() -> Result<(), Box<dyn std::error::Error>> {
6    let mut args = std::env::args().skip(1);
7    let (Some(texture_path), Some(shader_path)) = (args.next(), args.next()) else {
8        return Err("usage: inspect <texture.bin> <shader.fpo>".into());
9    };
10    let texture = gcm::CellGcmTexture::parse(&std::fs::read(texture_path)?)?; // exactly 24 bytes
11    println!(
12        "{}x{}, {} mips, linear: {}",
13        texture.width,
14        texture.height,
15        texture.mipmap,
16        texture.linear()
17    );
18
19    let shader = std::fs::read(shader_path)?;
20    let program = cgbinary::parse(&shader)?;
21    if let cgbinary::Stage::Fragment(_) = program.stage {
22        let code = fragment::decode(program.microcode)?;
23        print!("{}", code.disassemble());
24    }
25    Ok(())
26}

Source

pub fn linear(self) -> bool

LN: linear storage with a constant base pitch.

Examples found in repository ?

examples/inspect_rsx.rs (line 16)

5fn main() -> Result<(), Box<dyn std::error::Error>> {
6    let mut args = std::env::args().skip(1);
7    let (Some(texture_path), Some(shader_path)) = (args.next(), args.next()) else {
8        return Err("usage: inspect <texture.bin> <shader.fpo>".into());
9    };
10    let texture = gcm::CellGcmTexture::parse(&std::fs::read(texture_path)?)?; // exactly 24 bytes
11    println!(
12        "{}x{}, {} mips, linear: {}",
13        texture.width,
14        texture.height,
15        texture.mipmap,
16        texture.linear()
17    );
18
19    let shader = std::fs::read(shader_path)?;
20    let program = cgbinary::parse(&shader)?;
21    if let cgbinary::Stage::Fragment(_) = program.stage {
22        let code = fragment::decode(program.microcode)?;
23        print!("{}", code.disassemble());
24    }
25    Ok(())
26}