rpi-rgb-led-matrix/python
2016-08-29 00:21:08 -07:00
..
rgbmatrix o use latest version of cython 2016-08-29 00:21:08 -07:00
samples o Little updates needed for Python3 2016-08-29 00:19:34 -07:00
.gitignore o Added support for background colors on DrawText and DrawGlyph 2015-12-01 22:30:55 -08:00
Makefile o Some initial Makefile cleanup. 2016-08-28 12:37:10 -07:00
README.md Merge branch 'master' of https://github.com/hzeller/rpi-rgb-led-matrix 2016-08-29 00:19:51 -07:00
setup.py o Improved directory structure of Python code. 2015-07-23 23:44:27 -07:00

Python bindings for RGB Matrix library

Building

In the root directory for the matrix library simply type:

sudo apt-get update && sudo apt-get install python2.7-dev python-pillow -y
make build-python
sudo make install-python

You can also build for Python 3:

sudo apt-get update && sudo apt-get install python3-dev python3-pillow -y
make build-python PYTHON=$(which python3)
sudo make install-python PYTHON=$(which python3)

Using the library

Be aware of the fact, that using the RGBMatrix requires root privileges. Therefore you will need to run all you python scripts as using sudo.

You find examples in the samples/ subdirectory.

Here a complete example how to write an image viewer:

#!/usr/bin/env python
import time
import sys

from rgbmatrix import RGBMatrix
from PIL import Image

if len(sys.argv) < 2:
    sys.exit("Require an image argument")
else:
    image_file = sys.argv[1]

image = Image.open(image_file)

rows = 32
chain = 1
parallel = 1
matrix = RGBMatrix(rows, chain, parallel)

# Make image fit our screen.
image.thumbnail((matrix.width, matrix.height), Image.ANTIALIAS)

matrix.SetImage(image.convert('RGB'))

try:
    print("Press CTRL-C to stop.")
    while True:
        time.sleep(100)
except KeyboardInterrupt:
    sys.exit(0)