7d1c62b2cb | ||
---|---|---|
etc | ||
src | ||
.clang-format | ||
.gitignore | ||
LICENSE | ||
README.md | ||
build.sh |
README.md
Uxn11
An emulator for the Uxn stack-machine, written in ANSI C.
Building
Graphical
All you need is X11.
gcc -Os -DNDEBUG -g0 -s src/uxn.c src/devices/system.c src/devices/screen.c src/devices/controller.c src/devices/mouse.c src/devices/file.c src/devices/datetime.c src/uxn11.c -o bin/uxn11 -lX11
Terminal
If you wish to build the emulator without graphics mode:
gcc -Os -DNDEBUG -g0 -s src/uxn.c src/devices/system.c src/devices/file.c src/devices/datetime.c src/uxncli.c -o bin/uxncli
Usage
The first parameter is the rom file, the subsequent arguments will be accessible to the rom, via the Console vector.
bin/uxnemu bin/polycat.rom arg1 arg2
Devices
The file device is sandboxed, meaning that it should not be able to read or write outside of the working directory.
00
system10
console20
screen30
audio(missing)70
midi(missing)80
controller90
mousea0
file(sandboxed)c0
datetime
Emulator Controls
F2
print non-empty stacksF4
load boot.rom, or reload rom
Buttons
LCTRL
ALALT
BLSHIFT
SELHOME
START
Need a hand?
The following resources are a good place to start:
Contributing
Submit patches using git send-email
to the ~rabbits/public-inbox mailing list.