Struct Emulator

pub struct Emulator<H: Host> { /* private fields */ }

Represents main Emulator structure

Implementations

impl<H: Host> Emulator<H>

pub fn new(settings: RustzxSettings, context: H::Context) -> Result<Self>

Constructs new emulator

Arguments

settings - emulator settings

pub fn set_speed(&mut self, new_speed: EmulationMode)

changes emulation speed

pub fn set_fast_load(&mut self, value: bool)

changes fast loading flag

pub fn load_snapshot( &mut self, snapshot: Snapshot<impl SnapshotAsset>, ) -> Result<()>

pub fn save_snapshot<R>(&mut self, recorder: SnapshotRecorder<R>) -> Result<()>

where R: DataRecorder,

pub fn load_tape(&mut self, tape: Tape<H::TapeAsset>) -> Result<()>

pub fn load_rom(&mut self, rom: impl RomSet) -> Result<()>

pub fn load_screen(&mut self, screen: Screen<impl ScreenAsset>) -> Result<()>

pub fn play_tape(&mut self)

pub fn stop_tape(&mut self)

pub fn rewind_tape(&mut self) -> Result<()>

Rewinds tape. May return error if underlying tape asset failed to perform seek operation to go back to the the beginning of the tape

pub fn screen_buffer(&self) -> &H::FrameBuffer

pub fn set_io_extender(&mut self, extender: H::IoExtender)

pub fn io_extender(&mut self) -> Option<&mut H::IoExtender>

pub fn set_debug_interface(&mut self, debug_interface: H::DebugInterface)

Sets Host::DebugInterface for the emulator instance

pub fn debug_interface(&mut self) -> Option<&mut H::DebugInterface>

Returns current Host::DebugInterface instance

pub fn peek(&self, addr: u16) -> u8

Reads byte from memory

pub fn border_color(&self) -> ZXColor

pub fn send_key(&mut self, key: ZXKey, pressed: bool)

pub fn send_compound_key(&mut self, key: CompoundKey, pressed: bool)

pub fn send_kempston_key(&mut self, key: KempstonKey, pressed: bool)

pub fn send_sinclair_key( &mut self, num: SinclairJoyNum, key: SinclairKey, pressed: bool, )

pub fn send_mouse_button(&mut self, button: KempstonMouseButton, pressed: bool)

pub fn send_mouse_wheel(&mut self, dir: KempstonMouseWheelDirection)

pub fn send_mouse_pos_diff(&mut self, x: i8, y: i8)

pub fn execute_poke(&mut self, poke: impl Poke)

Execute poke::Poke action on the emulator

pub fn emulate_frames( &mut self, emulation_limit: Duration, ) -> Result<EmulationInfo>

Perform emulatio up to emulation_limit duration, returns actual elapsed duration