Michael Richters ca0f80d607 | 3 years ago | |
---|---|---|
.. | ||
src | 3 years ago | |
README.md | 4 years ago | |
library.properties | 4 years ago |
README.md
OneShot Meta Keys
This plugin provides support for two special OneShot keys:
OneShot_MetaStickyKey
& OneShot_ActiveStickyKey
, each of which can be used
to make any key on the keyboard (not just modifiers and layer shift keys)
"sticky", so that they remain active even after the key has been released.
These are both Key
values that can be used as entries in your sketch's keymap.
Any keys made sticky in this way can be released just like OneShot modifier keys, by tapping them again to cancel the effect.
The OneShot_MetaStickyKey
This special OneShot key behaves like other OneShot keys, but its affect is to
make the next key pressed sticky. Tap OneShot_MetaStickyKey
, then tap X
, and
X
will become sticky. Tap X
again to deactivate it.
Double-tapping OneShot_MetaStickyKey
will make it sticky, just like any other
OneShot key. A third tap will release the key.
The OneShot_ActiveStickyKey
This special key doesn't act like a OneShot key, but instead makes any key(s)
currently held (or otherwise active) sticky. Press (and hold) X
, tap
OneShot_ActiveStickyKey
, then release X
, and X
will stay active until it
is tapped again to deactivate it.
Using the plugin
To use the plugin, just include one of the two special OneShot keys somewhere in your keymap, and add both OneShot and OneShotMetaKeys to your sketch:
#include <Kaleidoscope-OneShot.h>
#include <Kaleidoscope-OneShotMetaKeys.h>
// somewhere in the keymap...
OneShot_MetaStickyKey, OneShot_ActiveStickyKey
KALEIDOSCOPE_INIT_PLUGINS(OneShot, OneShotMetaKeys);
Important note: OneShotMetaKeys must be registered after OneShot in
KALEIDOSCOPE_INIT_PLUGINS()
in order to function properly.
Dependencies
Further reading
Starting from the example is the recommended way of getting started with the plugin.