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.
Kaleidoscope/plugins/Kaleidoscope-Leader/src/kaleidoscope/plugin/Leader.cpp

155 lines
3.9 KiB

/* -*- mode: c++ -*-
* Kaleidoscope-Leader -- VIM-style leader keys
* Copyright (C) 2016, 2017, 2018, 2021 Keyboard.io, Inc
*
* This program is free software: you can redistribute it and/or modify it under
* the terms of the GNU General Public License as published by the Free Software
* Foundation, version 3.
*
* This program is distributed in the hope that it will be useful, but WITHOUT
* ANY WARRANTY; without even the implied warranty of MERCHANTABILITY or FITNESS
* FOR A PARTICULAR PURPOSE. See the GNU General Public License for more
* details.
*
* You should have received a copy of the GNU General Public License along with
* this program. If not, see <http://www.gnu.org/licenses/>.
*/
#include <Kaleidoscope-Leader.h>
#include <Kaleidoscope-FocusSerial.h>
#include "kaleidoscope/keyswitch_state.h"
#include "kaleidoscope/keyswitch_state.h"
#include "kaleidoscope/key_events.h"
#include "kaleidoscope/KeyEventTracker.h"
namespace kaleidoscope {
namespace plugin {
// --- state ---
Key Leader::sequence_[LEADER_MAX_SEQUENCE_LENGTH + 1];
KeyEventTracker Leader::event_tracker_;
uint8_t Leader::sequence_pos_;
uint16_t Leader::start_time_ = 0;
uint16_t Leader::time_out = 1000;
const Leader::dictionary_t *Leader::dictionary;
// --- helpers ---
#define PARTIAL_MATCH -1
#define NO_MATCH -2
#define isLeader(k) (k.getRaw() >= ranges::LEAD_FIRST && k.getRaw() <= ranges::LEAD_LAST)
#define isActive() (sequence_[0] != Key_NoKey)
// --- actions ---
int8_t Leader::lookup(void) {
bool match;
for (uint8_t seq_index = 0; ; seq_index++) {
match = true;
if (dictionary[seq_index].sequence[0].readFromProgmem() == Key_NoKey)
break;
Key seq_key;
for (uint8_t i = 0; i <= sequence_pos_; i++) {
seq_key = dictionary[seq_index].sequence[i].readFromProgmem();
if (sequence_[i] != seq_key) {
match = false;
break;
}
}
if (!match)
continue;
seq_key
= dictionary[seq_index].sequence[sequence_pos_ + 1].readFromProgmem();
if (seq_key == Key_NoKey) {
return seq_index;
} else {
return PARTIAL_MATCH;
}
}
return NO_MATCH;
}
// --- api ---
void Leader::reset(void) {
sequence_pos_ = 0;
sequence_[0] = Key_NoKey;
}
// DEPRECATED
void Leader::inject(Key key, uint8_t key_state) {
Runtime.handleKeyEvent(KeyEvent(KeyAddr::none(), key_state | INJECTED, key));
}
// --- hooks ---
EventHandlerResult Leader::onNameQuery() {
return ::Focus.sendName(F("Leader"));
}
EventHandlerResult Leader::onKeyswitchEvent(KeyEvent &event) {
// If the plugin has already processed and released this event, ignore it.
// There's no need to update the event tracker explicitly.
if (event_tracker_.shouldIgnore(event))
return EventHandlerResult::OK;
if (keyToggledOff(event.state) || event.state & INJECTED)
return EventHandlerResult::OK;
if (!isActive()) {
if (!isLeader(event.key))
return EventHandlerResult::OK;
start_time_ = Runtime.millisAtCycleStart();
sequence_pos_ = 0;
sequence_[sequence_pos_] = event.key;
return EventHandlerResult::ABORT;
}
++sequence_pos_;
if (sequence_pos_ > LEADER_MAX_SEQUENCE_LENGTH) {
reset();
return EventHandlerResult::OK;
}
start_time_ = Runtime.millisAtCycleStart();
sequence_[sequence_pos_] = event.key;
int8_t action_index = lookup();
if (action_index == NO_MATCH) {
reset();
return EventHandlerResult::OK;
}
if (action_index == PARTIAL_MATCH) {
return EventHandlerResult::ABORT;
}
action_t leaderAction = (action_t) pgm_read_ptr((void const **) & (dictionary[action_index].action));
(*leaderAction)(action_index);
reset();
return EventHandlerResult::ABORT;
}
EventHandlerResult Leader::afterEachCycle() {
if (!isActive())
return EventHandlerResult::OK;
if (Runtime.hasTimeExpired(start_time_, time_out))
reset();
return EventHandlerResult::OK;
}
}
}
kaleidoscope::plugin::Leader Leader;