fast3d 0.5.0

A Rust library for N64 Fast3D Graphics Rendering
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

use fast3d_gbi::defines::{ComponentSize, ImageFormat};
use std::hash::Hash;
use std::num::NonZeroUsize;

use crate::output::models::OutputTexture;

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct TextureCacheId(pub TextureConfig);

#[derive(Debug, Clone, Copy, PartialEq, Eq, Hash)]
pub struct TextureConfig {
    pub game_address: usize,
    pub format: ImageFormat,
    pub size: ComponentSize,
}

pub struct TextureCache {
    cache: lru::LruCache<TextureCacheId, OutputTexture>,
}

impl TextureCache {
    pub fn new(capacity: usize) -> Self {
        Self {
            cache: lru::LruCache::new(NonZeroUsize::new(capacity).unwrap()),
        }
    }

    pub fn contains(
        &mut self,
        game_address: usize,
        format: ImageFormat,
        size: ComponentSize,
    ) -> Option<TextureCacheId> {
        let texture_cache_id = TextureCacheId(TextureConfig {
            game_address,
            format,
            size,
        });

        if let Some(_texture) = self.cache.get(&texture_cache_id) {
            return Some(texture_cache_id);
        }

        None
    }

    pub fn get(&mut self, texture_cache_id: TextureCacheId) -> Option<&OutputTexture> {
        if let Some(texture) = self.cache.get(&texture_cache_id) {
            return Some(texture);
        }

        None
    }

    pub fn get_mut(&mut self, texture_cache_id: TextureCacheId) -> Option<&mut OutputTexture> {
        if let Some(texture) = self.cache.get_mut(&texture_cache_id) {
            return Some(texture);
        }

        None
    }

    #[allow(clippy::too_many_arguments)]
    pub fn insert(
        &mut self,
        game_address: usize,
        format: ImageFormat,
        size: ComponentSize,
        width: u32,
        height: u32,
        uls: u16,
        ult: u16,
        data: Vec<u8>,
    ) -> TextureCacheId {
        let texture = OutputTexture::new(game_address, format, size, width, height, uls, ult, data);
        let tex_cache_id = TextureCacheId(TextureConfig {
            game_address,
            format,
            size,
        });

        if let Some(_evicted_item) = self.cache.push(tex_cache_id, texture) {
            // TODO: handle evicted item by removing it from the GPU
        }

        tex_cache_id
    }
}