Crate monotron_app

Monotron run-time application support for Rust.

You need to supply a function with this prototype, marked #[no_mangle] in your crate.

#![no_std]
#![no_main]
extern crate monotron_app;
#[no_mangle]
pub extern "C" fn main() -> i32 {
    123
}

If you want to test your app on Linux, you'll need something like:

#![cfg_attr(target_os = "none", no_std)]
#![cfg_attr(target_os = "none", no_main)]

use monotron_app::prelude::*;
use monotron_app::Host;

#[cfg(not(target_os = "none"))]
pub fn main() {
    std::process::exit(monotron_main());
}

#[no_mangle]
pub extern "C" fn monotron_main() -> i32 {
    write!(Host, "Hello, Rust!\n").unwrap();
    0
}

Modules

prelude	Useful things people should have in scope.
target	Implementation used when building code for Linux/Windows

Structs

Col	Represents a column on screen. Valid values are 0..=47.
Context	An internal representation of the context we're given by the Host.
Frequency	A frequency we can give to the synthesiser.
Host	Represents the Monotron we're running on. Can be passed to write! and friends.
JoystickState	Represents the current state of an Atari 9-pin joystick.
Row	Represents a row on screen. Valid values are 0..=36.
Table	The callbacks supplied by the Monotron OS.

Enums

Channel	A channel on the synthesiser. They all run concurrently.
Font	Represents a font we can set the screen to use. The whole screen uses the same font. Custom fonts must be exactly 4096 bytes (256 chars x 16 bytes/char) long.
Note	Notes on an piano keyboard, where A4 = 440 Hz.
Waveform	A waveform on the synthesiser. You can change this note by note.

Functions

_close	_close is required by newlib
_fstat	_fstat is required by newlib
_isatty	_isatty is required by newlib
_lseek	_lseek is required by newlib
_read	_read is required by newlib
_sbrk	_sbrk is required by newlib
_write	_write is required by newlib
deinit	C FFI for Host::deinit
font_normal	C FFI for Host::set_font
font_teletext	C FFI for Host::set_font
get_joystick	C FFI for Host::get_joystick
getchar	C FFI for Host::readc
getsize	C FFI for Host::getsize
init	C FFI for Host::init
joystick_fire_pressed	True if joystick is pointing right.
joystick_is_down	True if joystick is pointing down.
joystick_is_left	True if joystick is pointing left.
joystick_is_right	True if joystick is pointing right.
joystick_is_up	True if joystick is pointing up.
kbhit	C FFI for Host::kbhit
move_cursor	C FFI for Host::move_cursor
play	C FFI for Host::play
put_separated_sixel	Ugh
putchar	C FFI for Host::putchar
puts⚠	C FFI for Host::puts
set_cursor_visible	C FFI for Host::set_cursor_visible
wfvbi	C FFI for Host::wfvbi