Annotation of src/usr.bin/tmux/input-keys.c, Revision 1.69
1.69 ! nicm 1: /* $OpenBSD: input-keys.c,v 1.68 2020/03/16 06:12:42 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.69 ! nicm 152: /* Translate a key code into an output key sequence for a pane. */
! 153: int
! 154: input_key_pane(struct window_pane *wp, key_code key, struct mouse_event *m)
! 155: {
! 156: log_debug("writing key 0x%llx (%s) to %%%u", key,
! 157: key_string_lookup_key(key), wp->id);
! 158:
! 159: if (KEYC_IS_MOUSE(key)) {
! 160: if (m != NULL && m->wp != -1 && (u_int)m->wp == wp->id)
! 161: input_key_mouse(wp, m);
! 162: return (0);
! 163: }
! 164: return (input_key(wp, wp->screen, wp->event, key));
! 165: }
! 166:
1.8 nicm 167: /* Translate a key code into an output key sequence. */
1.67 nicm 168: int
1.69 ! nicm 169: input_key(struct window_pane *wp, struct screen *s, struct bufferevent *bev,
! 170: key_code key)
1.1 nicm 171: {
1.46 nicm 172: const struct input_key_ent *ike;
173: u_int i;
174: size_t dlen;
175: char *out;
1.66 nicm 176: key_code justkey, newkey;
1.47 nicm 177: struct utf8_data ud;
1.1 nicm 178:
1.69 ! nicm 179: /* Mouse keys need a pane. */
! 180: if (KEYC_IS_MOUSE(key))
1.67 nicm 181: return (0);
1.64 nicm 182:
183: /* Literal keys go as themselves (can't be more than eight bits). */
184: if (key & KEYC_LITERAL) {
185: ud.data[0] = (u_char)key;
1.69 ! nicm 186: bufferevent_write(bev, &ud.data[0], 1);
1.67 nicm 187: return (0);
1.65 nicm 188: }
189:
190: /* Is this backspace? */
191: if ((key & KEYC_MASK_KEY) == KEYC_BSPACE) {
1.66 nicm 192: newkey = options_get_number(global_options, "backspace");
193: if (newkey >= 0x7f)
194: newkey = '\177';
195: key = newkey|(key & KEYC_MASK_MOD);
1.42 nicm 196: }
1.1 nicm 197:
1.8 nicm 198: /*
199: * If this is a normal 7-bit key, just send it, with a leading escape
1.46 nicm 200: * if necessary. If it is a UTF-8 key, split it and send it.
1.8 nicm 201: */
1.62 nicm 202: justkey = (key & ~(KEYC_XTERM|KEYC_ESCAPE));
1.52 nicm 203: if (justkey <= 0x7f) {
1.2 nicm 204: if (key & KEYC_ESCAPE)
1.69 ! nicm 205: bufferevent_write(bev, "\033", 1);
1.47 nicm 206: ud.data[0] = justkey;
1.69 ! nicm 207: bufferevent_write(bev, &ud.data[0], 1);
1.67 nicm 208: return (0);
1.46 nicm 209: }
1.52 nicm 210: if (justkey > 0x7f && justkey < KEYC_BASE) {
1.48 nicm 211: if (utf8_split(justkey, &ud) != UTF8_DONE)
1.67 nicm 212: return (-1);
1.46 nicm 213: if (key & KEYC_ESCAPE)
1.69 ! nicm 214: bufferevent_write(bev, "\033", 1);
! 215: bufferevent_write(bev, ud.data, ud.size);
1.67 nicm 216: return (0);
1.12 nicm 217: }
218:
1.18 nicm 219: /*
1.12 nicm 220: * Then try to look this up as an xterm key, if the flag to output them
221: * is set.
222: */
1.69 ! nicm 223: if (wp == NULL || options_get_number(wp->window->options, "xterm-keys")) {
1.58 nicm 224: if ((out = xterm_keys_lookup(key)) != NULL) {
1.69 ! nicm 225: bufferevent_write(bev, out, strlen(out));
1.26 nicm 226: free(out);
1.67 nicm 227: return (0);
1.12 nicm 228: }
1.1 nicm 229: }
1.60 nicm 230: key &= ~KEYC_XTERM;
1.1 nicm 231:
1.8 nicm 232: /* Otherwise look the key up in the table. */
1.1 nicm 233: for (i = 0; i < nitems(input_keys); i++) {
234: ike = &input_keys[i];
235:
1.69 ! nicm 236: if ((ike->flags & INPUTKEY_KEYPAD) && (~s->mode & MODE_KKEYPAD))
1.1 nicm 237: continue;
1.69 ! nicm 238: if ((ike->flags & INPUTKEY_CURSOR) && (~s->mode & MODE_KCURSOR))
1.1 nicm 239: continue;
240:
1.2 nicm 241: if ((key & KEYC_ESCAPE) && (ike->key | KEYC_ESCAPE) == key)
1.1 nicm 242: break;
243: if (ike->key == key)
244: break;
245: }
246: if (i == nitems(input_keys)) {
1.46 nicm 247: log_debug("key 0x%llx missing", key);
1.67 nicm 248: return (-1);
1.1 nicm 249: }
250: dlen = strlen(ike->data);
1.46 nicm 251: log_debug("found key 0x%llx: \"%s\"", key, ike->data);
1.1 nicm 252:
1.9 nicm 253: /* Prefix a \033 for escape. */
1.2 nicm 254: if (key & KEYC_ESCAPE)
1.69 ! nicm 255: bufferevent_write(bev, "\033", 1);
! 256: bufferevent_write(bev, ike->data, dlen);
1.67 nicm 257: return (0);
1.1 nicm 258: }
259:
1.8 nicm 260: /* Translate mouse and output. */
1.56 nicm 261: static void
1.42 nicm 262: input_key_mouse(struct window_pane *wp, struct mouse_event *m)
1.1 nicm 263: {
1.59 nicm 264: struct screen *s = wp->screen;
265: char buf[40];
266: size_t len;
267: u_int x, y;
1.42 nicm 268:
1.68 nicm 269: /* Ignore events if no mouse mode or the pane is not visible. */
270: if (m->ignore || (s->mode & ALL_MOUSE_MODES) == 0)
1.42 nicm 271: return;
1.63 nicm 272: if (cmd_mouse_at(wp, m, &x, &y, 0) != 0)
273: return;
1.42 nicm 274: if (!window_pane_visible(wp))
1.24 nicm 275: return;
276:
1.59 nicm 277: /* If this pane is not in button or all mode, discard motion events. */
1.68 nicm 278: if (MOUSE_DRAG(m->b) && (s->mode & MOTION_MOUSE_MODES) == 0)
1.59 nicm 279: return;
280:
281: /*
282: * If this event is a release event and not in all mode, discard it.
283: * In SGR mode we can tell absolutely because a release is normally
284: * shown by the last character. Without SGR, we check if the last
285: * buttons was also a release.
286: */
287: if (m->sgr_type != ' ') {
288: if (MOUSE_DRAG(m->sgr_b) &&
289: MOUSE_BUTTONS(m->sgr_b) == 3 &&
1.68 nicm 290: (~s->mode & MODE_MOUSE_ALL))
1.59 nicm 291: return;
292: } else {
293: if (MOUSE_DRAG(m->b) &&
294: MOUSE_BUTTONS(m->b) == 3 &&
295: MOUSE_BUTTONS(m->lb) == 3 &&
1.68 nicm 296: (~s->mode & MODE_MOUSE_ALL))
1.59 nicm 297: return;
298: }
1.42 nicm 299:
300: /*
301: * Use the SGR (1006) extension only if the application requested it
302: * and the underlying terminal also sent the event in this format (this
303: * is because an old style mouse release event cannot be converted into
304: * the new SGR format, since the released button is unknown). Otherwise
305: * pretend that tmux doesn't speak this extension, and fall back to the
1.51 nicm 306: * UTF-8 (1005) extension if the application requested, or to the
1.42 nicm 307: * legacy format.
308: */
1.59 nicm 309: if (m->sgr_type != ' ' && (s->mode & MODE_MOUSE_SGR)) {
1.42 nicm 310: len = xsnprintf(buf, sizeof buf, "\033[<%u;%u;%u%c",
311: m->sgr_b, x + 1, y + 1, m->sgr_type);
1.59 nicm 312: } else if (s->mode & MODE_MOUSE_UTF8) {
1.55 nicm 313: if (m->b > 0x7ff - 32 || x > 0x7ff - 33 || y > 0x7ff - 33)
314: return;
1.51 nicm 315: len = xsnprintf(buf, sizeof buf, "\033[M");
1.54 nicm 316: len += input_split2(m->b + 32, &buf[len]);
317: len += input_split2(x + 33, &buf[len]);
318: len += input_split2(y + 33, &buf[len]);
1.42 nicm 319: } else {
320: if (m->b > 223)
321: return;
322: len = xsnprintf(buf, sizeof buf, "\033[M");
323: buf[len++] = m->b + 32;
324: buf[len++] = x + 33;
325: buf[len++] = y + 33;
1.1 nicm 326: }
1.44 nicm 327: log_debug("writing mouse %.*s to %%%u", (int)len, buf, wp->id);
1.42 nicm 328: bufferevent_write(wp->event, buf, len);
1.1 nicm 329: }