quantum/process_keycode/process_tap_dance.h

   1 /* Copyright 2016 Jack Humbert
   2  *
   3  * This program is free software: you can redistribute it and/or modify
   4  * it under the terms of the GNU General Public License as published by
   5  * the Free Software Foundation, either version 2 of the License, or
   6  * (at your option) any later version.
   7  *
   8  * This program is distributed in the hope that it will be useful,
   9  * but WITHOUT ANY WARRANTY; without even the implied warranty of
  10  * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
  11  * GNU General Public License for more details.
  12  *
  13  * You should have received a copy of the GNU General Public License
  14  * along with this program.  If not, see <http://www.gnu.org/licenses/>.
  15  */
  16 #ifndef PROCESS_TAP_DANCE_H
  17 #define PROCESS_TAP_DANCE_H
  18
  19 #ifdef TAP_DANCE_ENABLE
  20
  21 #include <stdbool.h>
  22 #include <inttypes.h>
  23
  24 typedef struct
  25 {
  26   uint8_t count;
  27   uint8_t oneshot_mods;
  28   uint8_t weak_mods;
  29   uint16_t keycode;
  30   uint16_t interrupting_keycode;
  31   uint16_t timer;
  32   bool interrupted;
  33   bool pressed;
  34   bool finished;
  35 } qk_tap_dance_state_t;
  36
  37 #define TD(n) (QK_TAP_DANCE + n)
  38
  39 typedef void (*qk_tap_dance_user_fn_t) (qk_tap_dance_state_t *state, void *user_data);
  40
  41 typedef struct
  42 {
  43   struct {
  44     qk_tap_dance_user_fn_t on_each_tap;
  45     qk_tap_dance_user_fn_t on_dance_finished;
  46     qk_tap_dance_user_fn_t on_reset;
  47   } fn;
  48   qk_tap_dance_state_t state;
  49   uint16_t custom_tapping_term;
  50   void *user_data;
  51 } qk_tap_dance_action_t;
  52
  53 typedef struct
  54 {
  55   uint16_t kc1;
  56   uint16_t kc2;
  57 } qk_tap_dance_pair_t;
  58
  59 typedef struct
  60 {
  61   uint16_t kc;
  62   uint8_t layer;
  63 } qk_tap_dance_dual_role_t;
  64
  65 #define ACTION_TAP_DANCE_DOUBLE(kc1, kc2) { \
  66     .fn = { qk_tap_dance_pair_on_each_tap, qk_tap_dance_pair_finished, qk_tap_dance_pair_reset }, \
  67     .user_data = (void *)&((qk_tap_dance_pair_t) { kc1, kc2 }),  \
  68   }
  69
  70 #define ACTION_TAP_DANCE_DUAL_ROLE(kc, layer) { \
  71     .fn = { qk_tap_dance_dual_role_on_each_tap, qk_tap_dance_dual_role_finished, qk_tap_dance_dual_role_reset }, \
  72     .user_data = (void *)&((qk_tap_dance_dual_role_t) { kc, layer }), \
  73   }
  74
  75 #define ACTION_TAP_DANCE_FN(user_fn) {  \
  76     .fn = { NULL, user_fn, NULL }, \
  77     .user_data = NULL, \
  78   }
  79
  80 #define ACTION_TAP_DANCE_FN_ADVANCED(user_fn_on_each_tap, user_fn_on_dance_finished, user_fn_on_dance_reset) { \
  81     .fn = { user_fn_on_each_tap, user_fn_on_dance_finished, user_fn_on_dance_reset }, \
  82     .user_data = NULL, \
  83   }
  84
  85 #define ACTION_TAP_DANCE_FN_ADVANCED_TIME(user_fn_on_each_tap, user_fn_on_dance_finished, user_fn_on_dance_reset, tap_specific_tapping_term) { \
  86     .fn = { user_fn_on_each_tap, user_fn_on_dance_finished, user_fn_on_dance_reset }, \
  87     .user_data = NULL, \
  88     .custom_tapping_term = tap_specific_tapping_term, \
  89   }
  90
  91 extern qk_tap_dance_action_t tap_dance_actions[];
  92
  93 /* To be used internally */
  94
  95 void preprocess_tap_dance(uint16_t keycode, keyrecord_t *record);
  96 bool process_tap_dance(uint16_t keycode, keyrecord_t *record);
  97 void matrix_scan_tap_dance (void);
  98 void reset_tap_dance (qk_tap_dance_state_t *state);
  99
 100 void qk_tap_dance_pair_on_each_tap (qk_tap_dance_state_t *state, void *user_data);
 101 void qk_tap_dance_pair_finished (qk_tap_dance_state_t *state, void *user_data);
 102 void qk_tap_dance_pair_reset (qk_tap_dance_state_t *state, void *user_data);
 103
 104 void qk_tap_dance_dual_role_on_each_tap (qk_tap_dance_state_t *state, void *user_data);
 105 void qk_tap_dance_dual_role_finished (qk_tap_dance_state_t *state, void *user_data);
 106 void qk_tap_dance_dual_role_reset (qk_tap_dance_state_t *state, void *user_data);
 107
 108 #else
 109
 110 #define TD(n) KC_NO
 111
 112 #endif
 113
 114 #endif