Skip to content
Snippets Groups Projects
Select Git revision
  • master default protected
  • fcserver-1.04
  • fcserver-1.03
  • package-02
  • firmware-1.07
  • fcserver-1.02
  • fc64x8-rev-a
  • package-01
  • fcserver-1.01
  • fcserver-1.00
  • firmware-1.06
  • firmware-1.05
  • fc-boot-v101
  • firmware-1.1
14 results
Blame Permalink
README.md 2.45 KiB

Fadecandy C++ Mini-Framework

This is a tiny self-contained package of C++ header files that you can use to implement blazing fast LED patterns that can run on large or small computers. There are no other dependencies or libraries to fuss with, and you can copy these headers right into your own project.

This library includes:

  • Efficient Open Pixel Control client
  • JSON parsing (rapidjson)
  • Vector math (SVL)
  • PNG decoding (picopng)
  • KD-trees for spatial search (nanoflann)
  • Texture sampling with bilinear interpolation
  • HSV color space conversion
  • Particle system rendering, with floating point precision
  • Perlin Noise function
  • Generalized Effect framework
  • Main loop with smooth frame rate throttling
  • Concurrent rendering on multiple CPU cores, via the EffectMixer class
  • Command line parameters
  • Debug output including performance metrics

Writing an Effect is like writing a GPU shader. At its core, an Effect is a function that maps LED metadata to an LED color.

The color in this case uses floating point precision, so you can chain effects without losing color precision. It's converted to 8-bit per channel just before being sent out to the Fadecandy board.

The LED metadata includes a 3D position vector as well as any other data you choose to include in your layout JSON file. The full JSON object model is available for you to use to describe the properties of each light in your project.

Usage

  1. Copy the lib directory somewhere on your project's include search path.
  2. Use Makefile and simple.cpp as an example for starting your own project.
  3. Write an Effect subclass that does awesome things.
  4. Instantiate an EffectRunner and your Effect.
  5. Set up default options on the EffectRunner.
  6. Let the EffectRunner main loop do the rest.

License

All components are under BSD-style licenses. You're free to use this code in commercial or free software, as long as you keep copyright notices in the source.

Download

The latest revision of this library lives on GitHub in the scanlime/fadecandy repository. at examples/cpp/lib.