spectrusty 0.4.0

SPECTRUSTY is a library for building highly customizable emulators of the ZX Spectrum computer series and clones.
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
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123

/*
    Copyright (C) 2020-2022  Rafal Michalski

    This file is part of SPECTRUSTY, a Rust library for building emulators.

    For the full copyright notice, see the lib.rs file.
*/
use core::iter::{self, Empty};
use std::vec::Drain;

use crate::memory::PagedMemory8k;
use crate::clock::{VideoTs, VideoTsData2, VideoTsData6, VFrameTsCounter};
use crate::video::{
    RendererPlus, UlaPlusPalette, PaletteChange, BorderSize, BorderColor, PixelBuffer, Palette,
    VideoFrame, Video,
    frame_cache::{
        pixel_address_coords, color_address_coords
    }
};
use crate::chip::ula::UlaMemoryContention;
use super::frame_cache::{
    SourceMode, ScldFrameProducer
};
use super::Scld;

impl<M, D, X, V> Video for Scld<M, D, X, V>
    where M: PagedMemory8k,
          V: VideoFrame
{
    const PIXEL_DENSITY: u32 = 2;
    type VideoFrame = V;
    type Contention = UlaMemoryContention;

    #[inline]
    fn border_color(&self) -> BorderColor {
        self.ula.border_color()
    }

    fn set_border_color(&mut self, border: BorderColor) {
        self.change_border_color(border, self.ula.current_video_ts())
    }

    fn render_video_frame<'a, B: PixelBuffer<'a>, P: Palette<Pixel=B::Pixel>>(
            &mut self,
            buffer: &'a mut [u8],
            pitch: usize,
            border_size: BorderSize
        )
    {
        let mut palette = UlaPlusPalette::default();
        self.create_renderer(border_size, &mut palette)
            .render_pixels::<B, P, V>(buffer, pitch)
    }

    fn current_video_ts(&self) -> VideoTs {
        self.ula.current_video_ts()
    }

    fn current_video_clock(&self) -> VFrameTsCounter<Self::VideoFrame, Self::Contention> {
        self.ula.current_video_clock()
    }

    fn set_video_ts(&mut self, vts: VideoTs) {
        self.ula.set_video_ts(vts);
    }

    fn flash_state(&self) -> bool {
        self.ula.flash_state()
    }
}


impl<M, D, X, V> Scld<M, D, X, V>
    where M: PagedMemory8k,
          V: VideoFrame
{
    #[inline]
    pub(super) fn update_frame_cache(&mut self, addr: u16, ts: VideoTs) {
        let frame_cache = match addr {
            0x4000..=0x5AFF if self.mem_paged & 4 == 0 => &mut self.ula.frame_cache,
            0x6000..=0x7AFF if self.mem_paged & 8 == 0 => &mut self.sec_frame_cache,
            _ => return
        };

        if addr & 0x1800 != 0x1800 {
            let coords = pixel_address_coords(addr);
            frame_cache.update_frame_pixels(&self.ula.memory, coords, addr, ts);
        }
        else {
            let coords = color_address_coords(addr);
            frame_cache.update_frame_colors(&self.ula.memory, coords, addr, ts);
        }
    }

    fn create_renderer<'a, 'r>(
            &'a mut self,
            border_size: BorderSize,
            palette: &'r mut UlaPlusPalette
        ) -> RendererPlus<'r, ScldFrameProducer<'a, V, Drain<'a, VideoTsData2>>,
                          Drain<'a, VideoTsData6>,
                          Empty<PaletteChange>>
    {
        let render_mode = self.beg_render_mode();
        let invert_flash = self.flash_state();
        let screen0 = self.ula.memory.screen_ref(0).unwrap();
        let screen1 = self.ula.memory.screen_ref(1).unwrap();
        let frame_image_producer = ScldFrameProducer::new(
            SourceMode::from_scld_flags(self.beg_ctrl_flags),
            screen0, &self.ula.frame_cache,
            screen1, &self.sec_frame_cache,
            self.source_changes.drain(..));

        RendererPlus {
            render_mode,
            palette,
            frame_image_producer,
            mode_changes: self.mode_changes.drain(..),
            palette_changes: iter::empty(),
            border_size,
            invert_flash
        }
    }
}