3 * Retrieval and storage of keybindings.
9 #include <stdint.h> /* for uint16_t */
13 /* Individual keybinding in keybinding chain. */
16 struct KeyBinding * next;
17 uint16_t key; /* keycode */
18 char * name; /* name of functionality bound to keycode */
23 /* Wrapper to keybinding chain, contains some keybinding editing metadata. */
26 struct KeyBinding * kbs;
27 uint8_t edit; /* 1 if currently editing a keybinding, else 0 */
28 uint16_t select; /* linear list index of keybinding selected for editing */
33 /* Return keycode matched by keybinding to command of "name". */
34 extern uint16_t get_keycode_to_action(struct KeyBinding * keybindings,
37 /* Return human-readable name (of maximum 9 chars) for "keycode" as matched by
38 * ncurses.h; if none is found, return "UNKNOWN".
40 extern char * get_name_to_keycode(uint16_t keycode);
42 /* Return number of keybindings in keybindings chain from "kb_p" on. */
43 extern uint16_t get_n_of_keybs(struct KeyBinding * kb_p);
45 /* Return "n"-th keybinding in keybindings chain from "kb_p" on. */
46 extern struct KeyBinding * get_keyb_of_n(struct KeyBinding * kb_p, uint16_t n);
50 /* Initialize/save keybindings data from/to file at "path" to/from keybindings
53 extern void init_keybindings(char * path, struct KeyBiData * kbd);
54 extern void save_keybindings(char * path, struct KeyBiData * kbd);
56 /* Free keybinding chain starting at "kb_start". */
57 extern void free_keybindings(struct KeyBinding * kb_start);
61 /* Mark keybinding selected for modification as being edited, get user input to
62 * modify it, then unmark it again. Ensure there are max. three digits in the
63 * keycode ASCII representation.
65 extern void mod_selected_keyb(struct KeyBiData * kbd);
67 /* Move keybinding modification selection upwards ("dir"=="u") or downwards
68 * ("dir"=="d") within the limits of the keybindings chain length.
70 extern void move_keyb_mod_selection(struct KeyBiData * kbd, char dir);