Firmware for the Keyboardio Model 01 and other keyboards with AVR or ARM MCUs.
You can not select more than 25 topics Topics must start with a letter or number, can include dashes ('-') and can be up to 35 characters long.
 
 
 
 
 
 
Go to file
Jesse Vincent 0c1b723650
Explicitly set LEDs that aren't active to zero. Otherwise, plugins like numlock won't get de-initialized
7 years ago
examples/LED-Stalker Migrate to Kaleidoscope.use() 8 years ago
src Explicitly set LEDs that aren't active to zero. Otherwise, plugins like numlock won't get de-initialized 7 years ago
.gitignore Test the plugin with Travis CI 8 years ago
.travis.yml New build infrastructure 8 years ago
COPYING Initial import 8 years ago
Makefile Update Makefile to fix OS X build 8 years ago
README.md README.md: Clarify how colors can be specified 8 years ago
library.properties The Big Rename 8 years ago

README.md

Kaleidoscope-LED-Stalker

status Build Status

The StalkerEffect plugin provides an interesting new typing experience: the LEDs light up as you tap keys and play one of the selected effects: a haunting trail of ghostly white lights, or a blazing trail of fire.

Using the plugin

To use the plugin, one needs to include the header and select the effect.

#include <Kaleidoscope.h>
#include <Kaleidoscope-LED-Stalker.h>

void setup (){
  Kaleidoscope.use(&StalkerEffect);

  Kaleidoscope.setup();

  StalkerEffect.variant = STALKER(Haunt, (CRGB(0, 128, 0)));
  StalkerEffect.activate();
}

It is recommended to place the activation of the plugin (the USE_PLUGINS call) as early as possible, so the plugin can catch all relevant key presses. The configuration can happen at any time and should use the STALKER macro to do so.

Plugin methods

The plugin provides the StalkerEffect object, which has the following properties:

.variant

Set the effect to use with the plugin. See below for a list.

It is recommended to use the STALKER macro to declare the effect itself.

.stepLength

The length - in milliseconds - of each step of the animation. An animation lasts 256 steps.

Defaults to 50.

Plugin helpers

STALKER(effect, params)

Returns an effect, to be used to assign a value the .variant property of the StalkerEffect object. Any arguments given to the macro are passed on to the effect. If the effect takes no arguments, use an empty params list.

Plugin effects

The plugin provides the following effects:

Haunt([color])

A ghostly haunt effect, that trails the key taps with a ghostly white color (or any other color, if specified). Use the CRGB(r,g,b) macro to specify the color, if you want something else than the ghostly white.

BlazingTrail()

A blazing trail of fire will follow our fingers!

Dependencies

Further reading

Starting from the example is the recommended way of getting started with the plugin.