Struct Emulator

pub struct Emulator { /* private fields */ }

Available on crate feature genesis only.

A SEGA Genesis emulator that the auto splitter is attached to.

Implementations

impl Emulator

pub fn attach() -> Option<Self>

Attaches to the emulator process

Returns Option<Genesis> if successful, None otherwise.

Supported emulators are:

• Retroarch
• SEGA Classics / SEGA Game Room
• Fusion
• Gens
• BlastEm

pub async fn wait_attach() -> Self

Asynchronously awaits attaching to a target emulator, yielding back to the runtime between each try.

Supported emulators are:

• Retroarch
• SEGA Classics / SEGA Game Room
• Fusion
• Gens
• BlastEm

pub fn is_open(&self) -> bool

Checks whether the emulator is still open. If it is not open anymore, you should drop the emulator.

pub const fn until_closes<F>(&self, future: F) -> UntilEmulatorCloses<'_, F>

Executes a future until the emulator process closes.

pub fn update(&self) -> bool

Calls the internal routines needed in order to find (and update, if needed) the address of the emulated RAM.

Returns true if successful, false otherwise.

pub fn get_address(&self, offset: u32) -> Result<Address, Error>

Converts a SEGA Genesis memory address to a real memory address in the emulator process’ virtual memory space

The offset provided must not be higher than 0xFFFF

pub fn read<T: CheckedBitPattern + FromEndian>( &self, offset: u32, ) -> Result<T, Error>

Reads any value from the emulated RAM.

The offset provided is meant to be the same used on the original, big-endian system. The call will automatically convert the offset and the output value to little endian.

The offset provided must not be higher than 0xFFFF, otherwise this method will immediately return Err().