PIXTOY is a fun and simple web toy for creating miniature pixelated graphics effects using the Lua programming language. The app exposes a small set of simple primitive drawing functions, as well as some other utility functions (maths, bitwise ops, etc.) to allow for the creation of these effects.

You can see an example of a PIXTOY program by going to the main page here.

If you're interested in trying it out follow the link above! There is also a helpful documentation page that consists of both a getting started section and a full reference for all of the API functions and global variables.

To build PIXTOY locally is quite simple, all of the dependencies are contained within the repository as submodules. Just run these commands from a terminal:

git clone https://github.com/JROB774/pixtoy.git --recursive
cd pixtoy
build setup
build

There are a few different commands the build script can perform:

build setup  :: setup the emscripten environment for compiling on the web
build clean  :: clean the output binary folder 'web/app/' of files
build server :: setup a localhost server for pixtoy (requires Python3)
build        :: build the actual PIXTOY C web app for local execution

The palette used in PIXTOY is the Sweetie 16 palette, developed by Grafxkid.

The project's code is available under the MIT License, Copyright (C) Joshua Robertson 2022.