LED Cube Engine

Note: quality and frame rate are downsampled to reduce GIF size.

Getting started

Make sure you have the following packages installed on your system:

• Compiler of your choice (GCC and Clang are tested and supported);
• Boost;
• CMake (version 3.13 or higher);

To build and run the mock target follow the steps below:

1. Install GCC, cmake, boost and the required packages for the mock target:

   $ sudo apt update
   $ sudo apt install build-essential cmake libboost-all-dev # For simplicity, install everything from libboost
   $ sudo apt install libopengl0 libopengl-dev libglfw3 libglfw3-dev libglew2.1 libglew-dev # Dependencies only for mock target

2. Clone this repository:

   $ git clone https://github.com/LimpSquid/led-cube-engine.git

3. Change directory to the root of the repository and make a build folder:

   $ cd led-cube-engine
   $ mkdir build

4. Change directory to the build folder and configure the project:

   $ cd build
   $ cmake ..

5. If desired, change the LED cube engine's target (default is mock):

   $ cmake -D LCE_TARGET=<new_target> .

6. Build the source:

   $ cmake --build . -j4

7. Render an animation:

   $ bin/led-cube-engine render --animation stars
   $ bin/led-cube-engine render --animation lightning '{"cloud_gradient":{"gradient_stops":[{"stop_color":"#ff8000ff","stop_position":0.5},{"stop_color":"random","stop_position":1}]}}'
   $ bin/led-cube-engine render --animation helix '{"rotation_time_ms":1500,"phase_shift_sin_factor":0.04,"thickness":2,"le