Upload images on your Twinkly lights

[Anders-Holst]

Finally I had some time to put this together - somewhat late but the season is not over yet: Upload arbitrary pictures or animated gifs on your Twinkly led lights.

Some disclaimers: It assumes fairly dense 2D layouts to make sense. Too fine details will not be visible of course. Also note that colors like brown or dark gray will essentially appear as dim yellow or dim white on the leds, so the impression will not be perfect. There is no smoothing or "anti-aliasing" used in this code - it just picks the color from the image that happens to be right under the position corresponding to each led. All in all this means that it works best for small drawn or computer generated pictures with clear colors in large contiguous areas, such as gifs. Real photos might not look as good as expected.

It is included in the repo from today, Dec 26. To use it from the command line, call it as:

python -m xled_plus.xled_picture [optional-device-ip] filename

If you start it from within Python you can also give some options, regarding how the image is scaled to fit the leds:

from xled_plus.xled_picture import *
ctr = HighControlInterface("device-ip-here")  # Give your device ip here
ctr.adjust_layout_aspect(1.0)  # Replace 1.0 with how many times wider than high the led installation is, to get correct aspect ratio.
pic = PictureEffect(ctr, "filename", fit="medium")  # fit can be "stretch" (default, violates aspect ratio), "small", "large", or "medium"
pic.launch_movie()