matrixgfx

About The Project

This project contains a library with some drawing functions, and some sample apps:

Fire

Draws a simple fire effect

Plasma

Draws a simple plasma effect

Clock

Draws a clock with a 7 segment LED style font. Some sprites walk across the screen occasionally. At 10s before midnight New Year's eve, it will countdown the last 10 seconds of the year, then disaplay fireworks and scroll "HAPPY NEW YEAR" for 10 minutes. Technically, it runs every night at 11:59:50 because I am lazy and need to fix it.

Scroller

Demo of scrolling text.

matrixgfx library

Has some functions for blitting transparent images, drawing scrolling text, generating color gradients, etc. Maybe I should write some documentation?

(back to top)

Built With

• rpi-rgb-led-matrix
• CMake

(back to top)

Prerequisites

• Raspberry Pi
• RGB Matrix and Driver hat
• cmake, and the c compiler can be installed with the package manager
• rpi-rgb-led-matrix libray

I'm using a Pi 3 with two 64x32 panels chained together as 128x32

Installation

1. Clone the repo

   git clone https://github.com/vicricker/matrixgfx.git

2. Build the code

   cd matrixgfx
   mkdir build
   cd build
   cmake ..
   make

3. Some of the apps reference the fonts and sprites from the current directory. You can link them into the build directory to make things easier.

   cd build
   ls -s ../fonts
   ln -s ../sprites

(back to top)

Usage

sudo ./fire --led-cols=128 --led-rows=32 --led-gpio-mapping=adafruit-hat-pwm --led-show-refresh --led-limit-refresh=120

All of the apps accept the command line options supported by rpi-rgb-led-matrix.

I use --led-gpio-mapping=adafruit-hat-pwm which requires a hardware mod to the hat. Also, I might have hardcoded things in the rpi-rgb-led-matrix library for my hardware. I forget. You may need to alter the configration for your environment.

(back to top)

License

Distributed under the MIT License. See LICENSE.txt for more information.

(back to top)

Contact

Vic Ricker - vic@ricker.us

Project Link: https://github.com/vicricker/matrixgfx

(back to top)