Lutro

Experimental Lua game framework for libretro, following the LÖVE API.

Lutro is software rendered and implements only a subset of the LÖVE API. It targets portability though the libretro API and backed in dependancies.

Sample Games

• https://github.com/kivutar/onion-kidd
• https://github.com/kivutar/love-vespa
• https://github.com/kivutar/lutro-spaceship
• https://github.com/libretro/lutro-platformer
• https://github.com/libretro/lutro-game-of-life
• https://github.com/libretro/lutro-snake
• https://github.com/libretro/lutro-tetris
• https://github.com/libretro/lutro-iyfct
• https://github.com/libretro/lutro-sienna
• https://github.com/libretro/lutro-pong

Usage

Through RetroArch, use the Lutro core to load the game's source directory:

retroarch -L libretro_lutro.so path/to/gamedir/

Alternatively, you can load a compressed .lutro file:

retroarch -L libretro_lutro.so game.lutro

Build

Compile Lutro by installing the RetroArch dependencies, and running:

make

There are a few optional defines you can use to change how Lutro behaves.

• make WANT_COMPOSITION=1 Enables alpha-blending.
• make WANT_TRANSFORM=1 Enables scaling
• make TRACE_ALLOCATION=1 Enables memory allocation tracing

Test

Run the Lutro testing suite by executing:

make test

To run tests manually, run:

retroarch -L path/to/lutro_libretro.so test