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.
74 lines
2.1 KiB
74 lines
2.1 KiB
8 years ago
|
# Kaleidoscope-LED-AlphaSquare
|
||
|
|
||
|
![status][st:experimental]
|
||
|
|
||
|
[st:stable]: https://img.shields.io/badge/stable-✔-black.png?style=flat&colorA=44cc11&colorB=494e52
|
||
|
[st:broken]: https://img.shields.io/badge/broken-X-black.png?style=flat&colorA=e05d44&colorB=494e52
|
||
|
[st:experimental]: https://img.shields.io/badge/experimental----black.png?style=flat&colorA=dfb317&colorB=494e52
|
||
|
|
||
|
An alphabet for your per-key LEDs, `AlphaSquare` provides a way to display 4x4
|
||
|
"pixel" symbols on your keyboard. With this building block, one can build some
|
||
|
sweet animations, or just show off - the possibilities are almost endless!
|
||
|
|
||
|
## Using the plugin
|
||
|
|
||
|
To use the plugin, one needs to include the header, and one way or another, call
|
||
|
the `display` method.
|
||
|
|
||
|
```c++
|
||
|
#include <Kaleidoscope.h>
|
||
|
#include <Kaleidoscope-LED-AlphaSquare.h>
|
||
|
|
||
|
void setup () {
|
||
|
Kaleidoscope.setup (KEYMAP_SIZE);
|
||
|
|
||
|
Kaleidoscope.use (&AlphaSquare, NULL);
|
||
|
|
||
|
AlphaSquare.display (Key_A);
|
||
|
}
|
||
|
```
|
||
|
|
||
|
## Plugin methods
|
||
|
|
||
|
The plugin provides the `AlphaSquare` object, which has the following methods:
|
||
|
|
||
|
### `.display(key)`
|
||
|
### `.display(key, row, col)`
|
||
|
### `.display(key, col)`
|
||
|
|
||
|
> Display the symbol for `key` at the given row or column. If `row` is omitted,
|
||
|
> the first row - `0` is assumed. If the column is omitted too, then the third -
|
||
|
> `2` - column is used by default.
|
||
|
>
|
||
|
> The plugin can display the English alphabet, and the numbers from 0 to 9.
|
||
|
|
||
|
### `.display(symbol)`
|
||
|
### `.display(symbol, row, col)`
|
||
|
### `.display(symbol, col)`
|
||
|
|
||
|
> Almost the same as the previous function, but instead of a key, it expects a
|
||
|
> 4x4 bitmap.
|
||
|
|
||
|
### `.color`
|
||
|
|
||
|
> The color to use to draw the pixels.
|
||
|
>
|
||
|
> Not a method itself, but a changeable value.
|
||
|
>
|
||
|
> Defaults to { 0x80, 0x80, 0x80 }.
|
||
|
|
||
|
## Plugin helpers
|
||
|
|
||
|
### `SYM4x4(...)`
|
||
|
|
||
|
> A helper macro, which can be used to set up custom bitmaps. It expects 16
|
||
|
> values, a 4x4 square of zeroes and ones. Zeroes are transparent pixels, ones
|
||
|
> will be colored.
|
||
|
|
||
|
## Further reading
|
||
|
|
||
|
Starting from the [example][plugin:example] is the recommended way of getting
|
||
|
started with the plugin.
|
||
|
|
||
|
[plugin:example]: https://github.com/keyboardio/Kaleidoscope-LED-AlphaSquare/blob/master/examples/LED-AlphaSquare/LED-AlphaSquare.ino
|