mirror of https://git.sr.ht/~rabbits/porporo
82 lines
2.8 KiB
Markdown
82 lines
2.8 KiB
Markdown
# Porporo
|
|
|
|
[Porporo](https://wiki.xxiivv.com/site/porporo.html) is an experimental operating system specification for [Varvara](https://wiki.xxiivv.com/site/varvara.html), written in [Uxntal](https://wiki.xxiivv.com/site/uxntal.html) and ANSI C. For more details, see the [devlog](https://rabbits.srht.site/decadv/).
|
|
|
|
## Build
|
|
|
|
To build the emulator, you must install [SDL2](https://wiki.libsdl.org/) for your distro. If you are using a package manager:
|
|
|
|
```sh
|
|
sudo pacman -Sy sdl2 # Arch
|
|
sudo apt install libsdl2-dev # Ubuntu
|
|
sudo xbps-install SDL2-devel # Void Linux
|
|
brew install sdl2 # OS X
|
|
```
|
|
|
|
To build Porporo and the required roms:
|
|
|
|
```
|
|
make run
|
|
```
|
|
|
|
Since parts of Porporo are built with itself, we need to have a partial implementation of the varvara ecosystem(`src/uxncli`), and an assembler(`src/uxnasm`). Compiling porporo begins by building these two tools, then assembling the roms required by porporo(`menu.rom`, `wallpaper.rom`, `potato.rom`). These 3 roms then needs to be converted to C style arrays with `format-c.rom` rom. When this is done we can finally compile porporo.
|
|
|
|
## Global Controls
|
|
|
|
- `F1`, lock varvara.
|
|
- `F2`, center varvara.
|
|
- `F4`, exit varvara.
|
|
- `F5`, soft-reboot varvara.
|
|
|
|
## Action Controls
|
|
|
|
- `esc`, set normal mode.
|
|
- `m`, set move mode.
|
|
- `d`, set draw mode.
|
|
|
|
## Roms
|
|
|
|
### Menu.rom
|
|
|
|
- `tab`, see all files.
|
|
- `esc`, exit.
|
|
- `mouse1`, or `enter`, run file.
|
|
- `mouse2`m or `shift+enter`, send filename.
|
|
|
|
### Wallpaper.rom
|
|
|
|
The rom expects a file named `.wallpaper` in the [chr format](https://wiki.xxiivv.com/site/chr_format.html) that is large enough to fill the screen. The way I do it is by, first getting the screen size(let's say `1328x640`), creating a `wallpaper.tga` image at that size, converting it with [tgachr](https://git.sr.ht/~rabbits/uxn-utils/tree/main/item/cli/tgachr/tgachr.tal), generating a file named `wallpapera6x50.chr`, and finally renaming it to `.wallpaper`. Voila!
|
|
|
|
```
|
|
uxncli ~/roms/tgachr.rom wallpaper.tga
|
|
mv wallpapera6x50.chr .wallpaper
|
|
```
|
|
|
|
### Potato.rom
|
|
|
|
Potato is the menubar rom that holds some of the state of porporo in its zero-page:
|
|
|
|
- `0x00*` action vector
|
|
- `0x02` action value
|
|
|
|
## Messages
|
|
|
|
Porporo listens special console messages types:
|
|
|
|
- `0xff` run command
|
|
- `0xfe` set action type
|
|
|
|
## Need a hand?
|
|
|
|
The following resources are a good place to start:
|
|
|
|
* [XXIIVV — uxntal](https://wiki.xxiivv.com/site/uxntal.html)
|
|
* [XXIIVV — uxntal reference](https://wiki.xxiivv.com/site/uxntal_reference.html)
|
|
* [compudanzas — uxn tutorial](https://compudanzas.net/uxn_tutorial.html)
|
|
|
|
You can also find us in [`#uxn` on irc.esper.net](ircs://irc.esper.net:6697/#uxn).
|
|
|
|
## Contributing
|
|
|
|
Submit patches using [`git send-email`](https://git-send-email.io/) to the [~rabbits/public-inbox mailing list](https://lists.sr.ht/~rabbits/public-inbox).
|