Gergely Nagy
6c8bf9e99a
|
6 years ago | |
---|---|---|
examples/LEDEffects | 6 years ago | |
extras | 8 years ago | |
src | 6 years ago | |
.gitignore | 8 years ago | |
.travis.yml | 6 years ago | |
CONTRIBUTING.md | 6 years ago | |
COPYING | 8 years ago | |
Makefile | 7 years ago | |
README.md | 6 years ago | |
TriColor.md | 6 years ago | |
library.properties | 6 years ago |
README.md
Kaleidoscope-LEDEffects
The LEDEffects
plugin provides a selection of LED effects, each of them fairly
simple, simple enough to not need a plugin of their own.
Using the plugin
There are a number of different effects included in the package, all of them are available once including the header, and one's free to choose any number of them.
#include <Kaleidoscope.h>
#include <Kaleidoscope-LEDEffects.h>
KALEIDOSCOPE_INIT_PLUGINS(LEDControl, JukeBoxEffect);
void setup(void) {
Kaleidoscope.setup();
}
Included effects
All of these effects will scan the active layers, and apply effects based on what keys are active on each position, thus, it needs no hints or configuration to figure out our layout!
MiamiEffect
Applies a color effect to the keyboard, inspired by the popular Miami keyset:
Alphas, punctuation, numbers, the space bar, the numbers and the dot on the keypad, and half the function keys will be in a cyan-ish color, the rest in magenta.
JukeboxEffect
Applies a color effect to the keyboard, inspired by the JukeBox keyset:
Alphas, punctuation, numbers, the space bar, the numbers and the dot on the
keypad, and half the function keys will be in a beige-ish color, the rest in
light green, except for the Esc
key, which will be in red.
An alternative color scheme exists under the JukeboxAlternateEffect
name,
where the light green and red colors are swapped.
Plugin methods
The plugin provides a single method on each of the included effect objects:
.activate()
When called, immediately activates the effect. Mostly useful in the
setup()
method of the Sketch, or in macros that are meant to switch to the selected effect, no matter where we are in the list.
Dependencies
Further reading
Starting from the example is the recommended way of getting started with the plugin.