updated README and example

pull/510/head
Selene Scriven 7 years ago
parent 32a0809929
commit 8cc00c119e

@ -9,9 +9,8 @@
[st:broken]: https://img.shields.io/badge/broken-X-black.svg?style=flat&colorA=e05d44&colorB=494e52 [st:broken]: https://img.shields.io/badge/broken-X-black.svg?style=flat&colorA=e05d44&colorB=494e52
[st:experimental]: https://img.shields.io/badge/experimental----black.svg?style=flat&colorA=dfb317&colorB=494e52 [st:experimental]: https://img.shields.io/badge/experimental----black.svg?style=flat&colorA=dfb317&colorB=494e52
The `WavepoolEffect` plugin provides an interesting new typing experience: the The `WavepoolEffect` plugin makes waves of light splash out from each keypress.
LEDs light up as you tap keys and play one of the selected effects: a haunting When idle, it will also simulate gentle rainfall on the keyboard.
trail of ghostly white lights, or a blazing trail of fire.
## Using the plugin ## Using the plugin
@ -26,55 +25,18 @@ void setup (){
Kaleidoscope.setup(); Kaleidoscope.setup();
WavepoolEffect.variant = WAVEPOOL(Haunt, (CRGB(0, 128, 0)));
WavepoolEffect.activate(); WavepoolEffect.activate();
} }
``` ```
It is recommended to place the activation of the plugin (the `USE_PLUGINS` call) 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 as early as possible, so the plugin can catch all relevant key presses.
configuration can happen at any time and should use the `WAVEPOOL` macro to do so.
## Plugin methods ## Plugin methods
The plugin provides the `WavepoolEffect` object, which has the following The plugin provides the `WavepoolEffect` object, which has the following
properties: properties:
### `.variant`
> Set the effect to use with the plugin. See below for a list.
>
> It is recommended to use the `WAVEPOOL` 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
### `WAVEPOOL(effect, params)`
> Returns an effect, to be used to assign a value the `.variant` property of the
> `WavepoolEffect` 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 ## Dependencies
* [Kaleidoscope-LEDControl](https://github.com/keyboardio/Kaleidoscope-LEDControl) * [Kaleidoscope-LEDControl](https://github.com/keyboardio/Kaleidoscope-LEDControl)

@ -45,7 +45,6 @@ void setup() {
Kaleidoscope.setup(); Kaleidoscope.setup();
WavepoolEffect.variant = WAVEPOOL(BlazingTrail);
WavepoolEffect.activate(); WavepoolEffect.activate();
} }

Loading…
Cancel
Save