Annotation of src/usr.bin/tmux/input-keys.c, Revision 1.67
1.67 ! nicm 1: /* $OpenBSD: input-keys.c,v 1.66 2019/11/18 09:42:09 nicm Exp $ */
1.1 nicm 2:
3: /*
1.53 nicm 4: * Copyright (c) 2007 Nicholas Marriott <nicholas.marriott@gmail.com>
1.1 nicm 5: *
6: * Permission to use, copy, modify, and distribute this software for any
7: * purpose with or without fee is hereby granted, provided that the above
8: * copyright notice and this permission notice appear in all copies.
9: *
10: * THE SOFTWARE IS PROVIDED "AS IS" AND THE AUTHOR DISCLAIMS ALL WARRANTIES
11: * WITH REGARD TO THIS SOFTWARE INCLUDING ALL IMPLIED WARRANTIES OF
12: * MERCHANTABILITY AND FITNESS. IN NO EVENT SHALL THE AUTHOR BE LIABLE FOR
13: * ANY SPECIAL, DIRECT, INDIRECT, OR CONSEQUENTIAL DAMAGES OR ANY DAMAGES
14: * WHATSOEVER RESULTING FROM LOSS OF MIND, USE, DATA OR PROFITS, WHETHER
15: * IN AN ACTION OF CONTRACT, NEGLIGENCE OR OTHER TORTIOUS ACTION, ARISING
16: * OUT OF OR IN CONNECTION WITH THE USE OR PERFORMANCE OF THIS SOFTWARE.
17: */
18:
19: #include <sys/types.h>
20:
21: #include <stdint.h>
22: #include <stdlib.h>
23: #include <string.h>
24:
25: #include "tmux.h"
26:
1.8 nicm 27: /*
28: * This file is rather misleadingly named, it contains the code which takes a
29: * key code and translates it into something suitable to be sent to the
30: * application running in a pane (similar to input.c does in the other
31: * direction with output).
32: */
33:
1.56 nicm 34: static void input_key_mouse(struct window_pane *, struct mouse_event *);
1.42 nicm 35:
1.1 nicm 36: struct input_key_ent {
1.46 nicm 37: key_code key;
1.1 nicm 38: const char *data;
39:
40: int flags;
41: #define INPUTKEY_KEYPAD 0x1 /* keypad key */
42: #define INPUTKEY_CURSOR 0x2 /* cursor key */
43: };
44:
1.56 nicm 45: static const struct input_key_ent input_keys[] = {
1.61 nicm 46: /* Paste keys. */
47: { KEYC_PASTE_START, "\033[200~", 0 },
48: { KEYC_PASTE_END, "\033[201~", 0 },
1.3 nicm 49:
1.1 nicm 50: /* Function keys. */
1.9 nicm 51: { KEYC_F1, "\033OP", 0 },
52: { KEYC_F2, "\033OQ", 0 },
53: { KEYC_F3, "\033OR", 0 },
54: { KEYC_F4, "\033OS", 0 },
55: { KEYC_F5, "\033[15~", 0 },
56: { KEYC_F6, "\033[17~", 0 },
57: { KEYC_F7, "\033[18~", 0 },
58: { KEYC_F8, "\033[19~", 0 },
59: { KEYC_F9, "\033[20~", 0 },
60: { KEYC_F10, "\033[21~", 0 },
61: { KEYC_F11, "\033[23~", 0 },
62: { KEYC_F12, "\033[24~", 0 },
1.38 nicm 63: { KEYC_F1|KEYC_SHIFT, "\033[25~", 0 },
64: { KEYC_F2|KEYC_SHIFT, "\033[26~", 0 },
65: { KEYC_F3|KEYC_SHIFT, "\033[28~", 0 },
66: { KEYC_F4|KEYC_SHIFT, "\033[29~", 0 },
67: { KEYC_F5|KEYC_SHIFT, "\033[31~", 0 },
68: { KEYC_F6|KEYC_SHIFT, "\033[32~", 0 },
69: { KEYC_F7|KEYC_SHIFT, "\033[33~", 0 },
70: { KEYC_F8|KEYC_SHIFT, "\033[34~", 0 },
1.9 nicm 71: { KEYC_IC, "\033[2~", 0 },
72: { KEYC_DC, "\033[3~", 0 },
73: { KEYC_HOME, "\033[1~", 0 },
74: { KEYC_END, "\033[4~", 0 },
75: { KEYC_NPAGE, "\033[6~", 0 },
76: { KEYC_PPAGE, "\033[5~", 0 },
77: { KEYC_BTAB, "\033[Z", 0 },
1.7 nicm 78:
1.13 nicm 79: /*
80: * Arrow keys. Cursor versions must come first. The codes are toggled
81: * between CSI and SS3 versions when ctrl is pressed.
82: */
1.10 nicm 83: { KEYC_UP|KEYC_CTRL, "\033[A", INPUTKEY_CURSOR },
84: { KEYC_DOWN|KEYC_CTRL, "\033[B", INPUTKEY_CURSOR },
85: { KEYC_RIGHT|KEYC_CTRL, "\033[C", INPUTKEY_CURSOR },
86: { KEYC_LEFT|KEYC_CTRL, "\033[D", INPUTKEY_CURSOR },
1.18 nicm 87:
1.7 nicm 88: { KEYC_UP, "\033OA", INPUTKEY_CURSOR },
89: { KEYC_DOWN, "\033OB", INPUTKEY_CURSOR },
90: { KEYC_RIGHT, "\033OC", INPUTKEY_CURSOR },
91: { KEYC_LEFT, "\033OD", INPUTKEY_CURSOR },
92:
1.9 nicm 93: { KEYC_UP|KEYC_CTRL, "\033OA", 0 },
94: { KEYC_DOWN|KEYC_CTRL, "\033OB", 0 },
95: { KEYC_RIGHT|KEYC_CTRL, "\033OC", 0 },
96: { KEYC_LEFT|KEYC_CTRL, "\033OD", 0 },
97:
1.7 nicm 98: { KEYC_UP, "\033[A", 0 },
99: { KEYC_DOWN, "\033[B", 0 },
100: { KEYC_RIGHT, "\033[C", 0 },
101: { KEYC_LEFT, "\033[D", 0 },
102:
1.8 nicm 103: /* Keypad keys. Keypad versions must come first. */
1.17 nicm 104: { KEYC_KP_SLASH, "\033Oo", INPUTKEY_KEYPAD },
105: { KEYC_KP_STAR, "\033Oj", INPUTKEY_KEYPAD },
106: { KEYC_KP_MINUS, "\033Om", INPUTKEY_KEYPAD },
107: { KEYC_KP_SEVEN, "\033Ow", INPUTKEY_KEYPAD },
108: { KEYC_KP_EIGHT, "\033Ox", INPUTKEY_KEYPAD },
109: { KEYC_KP_NINE, "\033Oy", INPUTKEY_KEYPAD },
110: { KEYC_KP_PLUS, "\033Ok", INPUTKEY_KEYPAD },
111: { KEYC_KP_FOUR, "\033Ot", INPUTKEY_KEYPAD },
112: { KEYC_KP_FIVE, "\033Ou", INPUTKEY_KEYPAD },
113: { KEYC_KP_SIX, "\033Ov", INPUTKEY_KEYPAD },
114: { KEYC_KP_ONE, "\033Oq", INPUTKEY_KEYPAD },
115: { KEYC_KP_TWO, "\033Or", INPUTKEY_KEYPAD },
116: { KEYC_KP_THREE, "\033Os", INPUTKEY_KEYPAD },
117: { KEYC_KP_ENTER, "\033OM", INPUTKEY_KEYPAD },
118: { KEYC_KP_ZERO, "\033Op", INPUTKEY_KEYPAD },
119: { KEYC_KP_PERIOD, "\033On", INPUTKEY_KEYPAD },
120:
121: { KEYC_KP_SLASH, "/", 0 },
122: { KEYC_KP_STAR, "*", 0 },
123: { KEYC_KP_MINUS, "-", 0 },
124: { KEYC_KP_SEVEN, "7", 0 },
125: { KEYC_KP_EIGHT, "8", 0 },
126: { KEYC_KP_NINE, "9", 0 },
127: { KEYC_KP_PLUS, "+", 0 },
1.18 nicm 128: { KEYC_KP_FOUR, "4", 0 },
1.17 nicm 129: { KEYC_KP_FIVE, "5", 0 },
130: { KEYC_KP_SIX, "6", 0 },
131: { KEYC_KP_ONE, "1", 0 },
132: { KEYC_KP_TWO, "2", 0 },
133: { KEYC_KP_THREE, "3", 0 },
134: { KEYC_KP_ENTER, "\n", 0 },
135: { KEYC_KP_ZERO, "0", 0 },
136: { KEYC_KP_PERIOD, ".", 0 },
1.1 nicm 137: };
138:
1.54 nicm 139: /* Split a character into two UTF-8 bytes. */
140: static size_t
141: input_split2(u_int c, u_char *dst)
142: {
143: if (c > 0x7f) {
144: dst[0] = (c >> 6) | 0xc0;
145: dst[1] = (c & 0x3f) | 0x80;
146: return (2);
147: }
148: dst[0] = c;
149: return (1);
150: }
151:
1.8 nicm 152: /* Translate a key code into an output key sequence. */
1.67 ! nicm 153: int
1.46 nicm 154: input_key(struct window_pane *wp, key_code key, struct mouse_event *m)
1.1 nicm 155: {
1.46 nicm 156: const struct input_key_ent *ike;
157: u_int i;
158: size_t dlen;
159: char *out;
1.66 nicm 160: key_code justkey, newkey;
1.47 nicm 161: struct utf8_data ud;
1.1 nicm 162:
1.46 nicm 163: log_debug("writing key 0x%llx (%s) to %%%u", key,
1.44 nicm 164: key_string_lookup_key(key), wp->id);
1.42 nicm 165:
166: /* If this is a mouse key, pass off to mouse function. */
167: if (KEYC_IS_MOUSE(key)) {
168: if (m != NULL && m->wp != -1 && (u_int)m->wp == wp->id)
169: input_key_mouse(wp, m);
1.67 ! nicm 170: return (0);
1.64 nicm 171: }
172:
173: /* Literal keys go as themselves (can't be more than eight bits). */
174: if (key & KEYC_LITERAL) {
175: ud.data[0] = (u_char)key;
176: bufferevent_write(wp->event, &ud.data[0], 1);
1.67 ! nicm 177: return (0);
1.65 nicm 178: }
179:
180: /* Is this backspace? */
181: if ((key & KEYC_MASK_KEY) == KEYC_BSPACE) {
1.66 nicm 182: newkey = options_get_number(global_options, "backspace");
183: if (newkey >= 0x7f)
184: newkey = '\177';
185: key = newkey|(key & KEYC_MASK_MOD);
1.42 nicm 186: }
1.1 nicm 187:
1.8 nicm 188: /*
189: * If this is a normal 7-bit key, just send it, with a leading escape
1.46 nicm 190: * if necessary. If it is a UTF-8 key, split it and send it.
1.8 nicm 191: */
1.62 nicm 192: justkey = (key & ~(KEYC_XTERM|KEYC_ESCAPE));
1.52 nicm 193: if (justkey <= 0x7f) {
1.2 nicm 194: if (key & KEYC_ESCAPE)
1.15 nicm 195: bufferevent_write(wp->event, "\033", 1);
1.47 nicm 196: ud.data[0] = justkey;
197: bufferevent_write(wp->event, &ud.data[0], 1);
1.67 ! nicm 198: return (0);
1.46 nicm 199: }
1.52 nicm 200: if (justkey > 0x7f && justkey < KEYC_BASE) {
1.48 nicm 201: if (utf8_split(justkey, &ud) != UTF8_DONE)
1.67 ! nicm 202: return (-1);
1.46 nicm 203: if (key & KEYC_ESCAPE)
204: bufferevent_write(wp->event, "\033", 1);
1.47 nicm 205: bufferevent_write(wp->event, ud.data, ud.size);
1.67 ! nicm 206: return (0);
1.12 nicm 207: }
208:
1.18 nicm 209: /*
1.12 nicm 210: * Then try to look this up as an xterm key, if the flag to output them
211: * is set.
212: */
1.45 nicm 213: if (options_get_number(wp->window->options, "xterm-keys")) {
1.58 nicm 214: if ((out = xterm_keys_lookup(key)) != NULL) {
1.14 nicm 215: bufferevent_write(wp->event, out, strlen(out));
1.26 nicm 216: free(out);
1.67 ! nicm 217: return (0);
1.12 nicm 218: }
1.1 nicm 219: }
1.60 nicm 220: key &= ~KEYC_XTERM;
1.1 nicm 221:
1.8 nicm 222: /* Otherwise look the key up in the table. */
1.1 nicm 223: for (i = 0; i < nitems(input_keys); i++) {
224: ike = &input_keys[i];
225:
1.58 nicm 226: if ((ike->flags & INPUTKEY_KEYPAD) &&
227: !(wp->screen->mode & MODE_KKEYPAD))
1.1 nicm 228: continue;
1.58 nicm 229: if ((ike->flags & INPUTKEY_CURSOR) &&
230: !(wp->screen->mode & MODE_KCURSOR))
1.1 nicm 231: continue;
232:
1.2 nicm 233: if ((key & KEYC_ESCAPE) && (ike->key | KEYC_ESCAPE) == key)
1.1 nicm 234: break;
235: if (ike->key == key)
236: break;
237: }
238: if (i == nitems(input_keys)) {
1.46 nicm 239: log_debug("key 0x%llx missing", key);
1.67 ! nicm 240: return (-1);
1.1 nicm 241: }
242: dlen = strlen(ike->data);
1.46 nicm 243: log_debug("found key 0x%llx: \"%s\"", key, ike->data);
1.1 nicm 244:
1.9 nicm 245: /* Prefix a \033 for escape. */
1.2 nicm 246: if (key & KEYC_ESCAPE)
1.14 nicm 247: bufferevent_write(wp->event, "\033", 1);
248: bufferevent_write(wp->event, ike->data, dlen);
1.67 ! nicm 249: return (0);
1.1 nicm 250: }
251:
1.8 nicm 252: /* Translate mouse and output. */
1.56 nicm 253: static void
1.42 nicm 254: input_key_mouse(struct window_pane *wp, struct mouse_event *m)
1.1 nicm 255: {
1.59 nicm 256: struct screen *s = wp->screen;
257: int mode = s->mode;
258: char buf[40];
259: size_t len;
260: u_int x, y;
1.42 nicm 261:
1.59 nicm 262: if ((mode & ALL_MOUSE_MODES) == 0)
1.42 nicm 263: return;
1.63 nicm 264: if (cmd_mouse_at(wp, m, &x, &y, 0) != 0)
265: return;
1.42 nicm 266: if (!window_pane_visible(wp))
1.24 nicm 267: return;
268:
1.59 nicm 269: /* If this pane is not in button or all mode, discard motion events. */
270: if (MOUSE_DRAG(m->b) &&
271: (mode & (MODE_MOUSE_BUTTON|MODE_MOUSE_ALL)) == 0)
272: return;
273:
274: /*
275: * If this event is a release event and not in all mode, discard it.
276: * In SGR mode we can tell absolutely because a release is normally
277: * shown by the last character. Without SGR, we check if the last
278: * buttons was also a release.
279: */
280: if (m->sgr_type != ' ') {
281: if (MOUSE_DRAG(m->sgr_b) &&
282: MOUSE_BUTTONS(m->sgr_b) == 3 &&
283: (~mode & MODE_MOUSE_ALL))
284: return;
285: } else {
286: if (MOUSE_DRAG(m->b) &&
287: MOUSE_BUTTONS(m->b) == 3 &&
288: MOUSE_BUTTONS(m->lb) == 3 &&
289: (~mode & MODE_MOUSE_ALL))
290: return;
291: }
1.42 nicm 292:
293: /*
294: * Use the SGR (1006) extension only if the application requested it
295: * and the underlying terminal also sent the event in this format (this
296: * is because an old style mouse release event cannot be converted into
297: * the new SGR format, since the released button is unknown). Otherwise
298: * pretend that tmux doesn't speak this extension, and fall back to the
1.51 nicm 299: * UTF-8 (1005) extension if the application requested, or to the
1.42 nicm 300: * legacy format.
301: */
1.59 nicm 302: if (m->sgr_type != ' ' && (s->mode & MODE_MOUSE_SGR)) {
1.42 nicm 303: len = xsnprintf(buf, sizeof buf, "\033[<%u;%u;%u%c",
304: m->sgr_b, x + 1, y + 1, m->sgr_type);
1.59 nicm 305: } else if (s->mode & MODE_MOUSE_UTF8) {
1.55 nicm 306: if (m->b > 0x7ff - 32 || x > 0x7ff - 33 || y > 0x7ff - 33)
307: return;
1.51 nicm 308: len = xsnprintf(buf, sizeof buf, "\033[M");
1.54 nicm 309: len += input_split2(m->b + 32, &buf[len]);
310: len += input_split2(x + 33, &buf[len]);
311: len += input_split2(y + 33, &buf[len]);
1.42 nicm 312: } else {
313: if (m->b > 223)
314: return;
315: len = xsnprintf(buf, sizeof buf, "\033[M");
316: buf[len++] = m->b + 32;
317: buf[len++] = x + 33;
318: buf[len++] = y + 33;
1.1 nicm 319: }
1.44 nicm 320: log_debug("writing mouse %.*s to %%%u", (int)len, buf, wp->id);
1.42 nicm 321: bufferevent_write(wp->event, buf, len);
1.1 nicm 322: }