Jesse Vincent
271aba9373
|
8 years ago | |
---|---|---|
examples/SpaceCadet | 8 years ago | |
src | 8 years ago | |
.gitignore | 8 years ago | |
.travis.yml | 8 years ago | |
COPYING | 8 years ago | |
Makefile | 8 years ago | |
README.md | 8 years ago | |
library.properties | 8 years ago |
README.md
Kaleidoscope-SpaceCadet
Space Cadet Shift is a way to make it more convenient to input
parens - those (
and )
things -, symbols that a lot of programming languages
use frequently. If you are working with Lisp, you are using these all the time.
What it does, is that it turns your left and right Shift
keys into parens if
you tap and release them, without pressing any other key while holding them.
Therefore, to input, say, (print foo)
, you don't need to press Shift
, hold
it, and press 9
to get a (
, you simply press and release Shift
, and
continue writing. You use it as if you had a dedicated key for parens!
But if you wish to write capital letters, you hold it, as usual, and you will
not see any parens when you release it. You can also hold it for a longer time,
and it still would act as a Shift
, without the parens inserted on release:
this is useful when you want to augment some mouse action with Shift
, to
select text, for example.
Using the plugin
Using the plugin with its defaults is as simple as including the header, and enabling the plugin:
#include <Kaleidoscope.h>
#include <Kaleidoscope-SpaceCadet.h>
void setup() {
USE_PLUGINS(&SpaceCadetShift);
Kaleidoscope.setup();
}
This assumes a US QWERTY layout on the host computer, and will use the 9
and
0
keys for the left and right parens, respectively. To change these keys, use
the .opening_paren
and .closing_paren
properties outlined below.
Plugin methods
The plugin provides the SpaceCadetShift
object, with the following methods and
properties:
.opening_paren
Set this property to the key that - when shifted - will result in an opening paren.
Defaults to
Key_9
.
.closing_paren
Set this property to the key that - when shifted - will result in a closing paren.
Defaults to
Key_0
.
.time_out
Set this property to the number of milliseconds to wait before considering a held key in isolation as its secondary role. That is, we'd have to hold a
Shift
key this long, by itself, to trigger theShift
role in itself.Defaults to 1000.
Further reading
Starting from the example is the recommended way of getting started with the plugin.