merge
[nikiroo-utils.git] / src / jexer / io / AWTTerminal.java
CommitLineData
1ac2ccb1
KL
1/**
2 * Jexer - Java Text User Interface
3 *
4 * License: LGPLv3 or later
5 *
6 * This module is licensed under the GNU Lesser General Public License
7 * Version 3. Please see the file "COPYING" in this directory for more
8 * information about the GNU Lesser General Public License Version 3.
9 *
10 * Copyright (C) 2015 Kevin Lamonte
11 *
12 * This program is free software; you can redistribute it and/or
13 * modify it under the terms of the GNU Lesser General Public License
14 * as published by the Free Software Foundation; either version 3 of
15 * the License, or (at your option) any later version.
16 *
17 * This program is distributed in the hope that it will be useful, but
18 * WITHOUT ANY WARRANTY; without even the implied warranty of
19 * MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the GNU
20 * General Public License for more details.
21 *
22 * You should have received a copy of the GNU Lesser General Public
23 * License along with this program; if not, see
24 * http://www.gnu.org/licenses/, or write to the Free Software
25 * Foundation, Inc., 51 Franklin St, Fifth Floor, Boston, MA
26 * 02110-1301 USA
27 *
28 * @author Kevin Lamonte [kevin.lamonte@gmail.com]
29 * @version 1
30 */
31package jexer.io;
32
30bd4abd
KL
33import java.awt.event.ComponentEvent;
34import java.awt.event.ComponentListener;
84614868 35import java.awt.event.KeyEvent;
30bd4abd
KL
36import java.awt.event.KeyListener;
37import java.awt.event.MouseEvent;
84614868 38import java.awt.event.MouseListener;
30bd4abd
KL
39import java.awt.event.MouseMotionListener;
40import java.awt.event.MouseWheelEvent;
41import java.awt.event.MouseWheelListener;
42import java.awt.event.WindowEvent;
84614868 43import java.awt.event.WindowListener;
1ac2ccb1
KL
44import java.util.List;
45import java.util.LinkedList;
46
47import jexer.TKeypress;
30bd4abd 48import jexer.event.TCommandEvent;
1ac2ccb1
KL
49import jexer.event.TInputEvent;
50import jexer.event.TKeypressEvent;
51import jexer.event.TMouseEvent;
52import jexer.event.TResizeEvent;
53import jexer.session.SessionInfo;
30bd4abd
KL
54import jexer.session.AWTSessionInfo;
55import static jexer.TCommand.*;
1ac2ccb1
KL
56import static jexer.TKeypress.*;
57
58/**
59 * This class reads keystrokes and mouse events from an AWT Frame.
60 */
30bd4abd
KL
61public final class AWTTerminal implements ComponentListener, KeyListener,
62 MouseListener, MouseMotionListener,
63 MouseWheelListener, WindowListener {
84614868
KL
64
65 /**
66 * The backend Screen.
67 */
68 private AWTScreen screen;
1ac2ccb1
KL
69
70 /**
71 * The session information.
72 */
30bd4abd 73 private AWTSessionInfo sessionInfo;
1ac2ccb1
KL
74
75 /**
76 * Getter for sessionInfo.
77 *
78 * @return the SessionInfo
79 */
80 public SessionInfo getSessionInfo() {
81 return sessionInfo;
82 }
83
92554d64
KL
84 /**
85 * The listening object that run() wakes up on new input.
86 */
87 private Object listener;
88
1ac2ccb1
KL
89 /**
90 * The event queue, filled up by a thread reading on input.
91 */
92 private List<TInputEvent> eventQueue;
93
1ac2ccb1
KL
94 /**
95 * The reader thread.
96 */
97 private Thread readerThread;
98
99 /**
100 * true if mouse1 was down. Used to report mouse1 on the release event.
101 */
30bd4abd 102 private boolean mouse1 = false;
1ac2ccb1
KL
103
104 /**
105 * true if mouse2 was down. Used to report mouse2 on the release event.
106 */
30bd4abd 107 private boolean mouse2 = false;
1ac2ccb1
KL
108
109 /**
110 * true if mouse3 was down. Used to report mouse3 on the release event.
111 */
30bd4abd 112 private boolean mouse3 = false;
1ac2ccb1
KL
113
114 /**
115 * Check if there are events in the queue.
116 *
117 * @return if true, getEvents() has something to return to the backend
118 */
119 public boolean hasEvents() {
120 synchronized (eventQueue) {
121 return (eventQueue.size() > 0);
122 }
123 }
124
125 /**
126 * Constructor sets up state for getEvent().
127 *
92554d64
KL
128 * @param listener the object this backend needs to wake up when new
129 * input comes in
84614868 130 * @param screen the top-level AWT frame
1ac2ccb1 131 */
92554d64
KL
132 public AWTTerminal(final Object listener, final AWTScreen screen) {
133 this.listener = listener;
84614868 134 this.screen = screen;
1ac2ccb1
KL
135 mouse1 = false;
136 mouse2 = false;
137 mouse3 = false;
30bd4abd 138 sessionInfo = screen.getSessionInfo();
1ac2ccb1 139 eventQueue = new LinkedList<TInputEvent>();
84614868
KL
140
141 screen.frame.addKeyListener(this);
30bd4abd
KL
142 screen.frame.addWindowListener(this);
143 screen.frame.addComponentListener(this);
144 screen.frame.addMouseListener(this);
145 screen.frame.addMouseMotionListener(this);
146 screen.frame.addMouseWheelListener(this);
1ac2ccb1
KL
147 }
148
149 /**
150 * Restore terminal to normal state.
151 */
152 public void shutdown() {
153 // System.err.println("=== shutdown() ==="); System.err.flush();
84614868 154 screen.frame.dispose();
1ac2ccb1
KL
155 }
156
157 /**
158 * Return any events in the IO queue.
159 *
160 * @param queue list to append new events to
161 */
162 public void getEvents(final List<TInputEvent> queue) {
163 synchronized (eventQueue) {
164 if (eventQueue.size() > 0) {
165 synchronized (queue) {
166 queue.addAll(eventQueue);
167 }
168 eventQueue.clear();
169 }
170 }
171 }
172
84614868
KL
173 /**
174 * Pass AWT keystrokes into the event queue.
175 *
176 * @param key keystroke received
177 */
178 @Override
179 public void keyReleased(final KeyEvent key) {
180 // Ignore release events
181 }
182
183 /**
184 * Pass AWT keystrokes into the event queue.
185 *
186 * @param key keystroke received
187 */
188 @Override
189 public void keyTyped(final KeyEvent key) {
190 // Ignore typed events
191 }
192
193 /**
194 * Pass AWT keystrokes into the event queue.
195 *
196 * @param key keystroke received
197 */
198 @Override
199 public void keyPressed(final KeyEvent key) {
200 boolean alt = false;
201 boolean shift = false;
202 boolean ctrl = false;
203 char ch = ' ';
204 boolean isKey = false;
205 int fnKey = 0;
206 if (key.isActionKey()) {
207 isKey = true;
208 } else {
209 ch = key.getKeyChar();
210 }
211 alt = key.isAltDown();
212 ctrl = key.isControlDown();
213 shift = key.isShiftDown();
214
215 /*
216 System.err.printf("AWT Key: %s\n", key);
217 System.err.printf(" isKey: %s\n", isKey);
218 System.err.printf(" alt: %s\n", alt);
219 System.err.printf(" ctrl: %s\n", ctrl);
220 System.err.printf(" shift: %s\n", shift);
221 System.err.printf(" ch: %s\n", ch);
bd8d51fa 222 */
84614868
KL
223
224 // Special case: not return the bare modifier presses
225 switch (key.getKeyCode()) {
226 case KeyEvent.VK_ALT:
227 return;
228 case KeyEvent.VK_ALT_GRAPH:
229 return;
230 case KeyEvent.VK_CONTROL:
231 return;
232 case KeyEvent.VK_SHIFT:
233 return;
234 case KeyEvent.VK_META:
235 return;
236 default:
237 break;
238 }
239
240 TKeypress keypress = null;
241 if (isKey) {
242 switch (key.getKeyCode()) {
243 case KeyEvent.VK_F1:
244 keypress = new TKeypress(true, TKeypress.F1, ' ',
245 alt, ctrl, shift);
246 break;
247 case KeyEvent.VK_F2:
248 keypress = new TKeypress(true, TKeypress.F2, ' ',
249 alt, ctrl, shift);
250 break;
251 case KeyEvent.VK_F3:
252 keypress = new TKeypress(true, TKeypress.F3, ' ',
253 alt, ctrl, shift);
254 break;
255 case KeyEvent.VK_F4:
256 keypress = new TKeypress(true, TKeypress.F4, ' ',
257 alt, ctrl, shift);
258 break;
259 case KeyEvent.VK_F5:
260 keypress = new TKeypress(true, TKeypress.F5, ' ',
261 alt, ctrl, shift);
262 break;
263 case KeyEvent.VK_F6:
264 keypress = new TKeypress(true, TKeypress.F6, ' ',
265 alt, ctrl, shift);
266 break;
267 case KeyEvent.VK_F7:
268 keypress = new TKeypress(true, TKeypress.F7, ' ',
269 alt, ctrl, shift);
270 break;
271 case KeyEvent.VK_F8:
272 keypress = new TKeypress(true, TKeypress.F8, ' ',
273 alt, ctrl, shift);
274 break;
275 case KeyEvent.VK_F9:
276 keypress = new TKeypress(true, TKeypress.F9, ' ',
277 alt, ctrl, shift);
278 break;
279 case KeyEvent.VK_F10:
280 keypress = new TKeypress(true, TKeypress.F10, ' ',
281 alt, ctrl, shift);
282 break;
283 case KeyEvent.VK_F11:
284 keypress = new TKeypress(true, TKeypress.F11, ' ',
285 alt, ctrl, shift);
286 break;
287 case KeyEvent.VK_F12:
288 keypress = new TKeypress(true, TKeypress.F12, ' ',
289 alt, ctrl, shift);
290 break;
291 case KeyEvent.VK_HOME:
292 keypress = new TKeypress(true, TKeypress.HOME, ' ',
293 alt, ctrl, shift);
294 break;
295 case KeyEvent.VK_END:
296 keypress = new TKeypress(true, TKeypress.END, ' ',
297 alt, ctrl, shift);
298 break;
299 case KeyEvent.VK_PAGE_UP:
300 keypress = new TKeypress(true, TKeypress.PGUP, ' ',
301 alt, ctrl, shift);
302 break;
303 case KeyEvent.VK_PAGE_DOWN:
304 keypress = new TKeypress(true, TKeypress.PGDN, ' ',
305 alt, ctrl, shift);
306 break;
307 case KeyEvent.VK_INSERT:
308 keypress = new TKeypress(true, TKeypress.INS, ' ',
309 alt, ctrl, shift);
310 break;
311 case KeyEvent.VK_DELETE:
30bd4abd 312 keypress = new TKeypress(true, TKeypress.DEL, ' ',
84614868
KL
313 alt, ctrl, shift);
314 break;
315 case KeyEvent.VK_RIGHT:
316 keypress = new TKeypress(true, TKeypress.RIGHT, ' ',
317 alt, ctrl, shift);
318 break;
319 case KeyEvent.VK_LEFT:
320 keypress = new TKeypress(true, TKeypress.LEFT, ' ',
321 alt, ctrl, shift);
322 break;
323 case KeyEvent.VK_UP:
324 keypress = new TKeypress(true, TKeypress.UP, ' ',
325 alt, ctrl, shift);
326 break;
327 case KeyEvent.VK_DOWN:
328 keypress = new TKeypress(true, TKeypress.DOWN, ' ',
329 alt, ctrl, shift);
330 break;
331 case KeyEvent.VK_TAB:
332 // Special case: distinguish TAB vs BTAB
333 if (shift) {
334 keypress = kbShiftTab;
335 } else {
336 keypress = kbTab;
337 }
338 break;
339 case KeyEvent.VK_ENTER:
340 keypress = new TKeypress(true, TKeypress.ENTER, ' ',
341 alt, ctrl, shift);
342 break;
343 case KeyEvent.VK_ESCAPE:
344 keypress = new TKeypress(true, TKeypress.ESC, ' ',
345 alt, ctrl, shift);
346 break;
347 case KeyEvent.VK_BACK_SPACE:
348 // Special case: return it as kbBackspace (Ctrl-H)
349 keypress = new TKeypress(false, 0, 'H', false, true, false);
350 break;
351 default:
352 // Unsupported, ignore
353 return;
354 }
355 }
356
357 if (keypress == null) {
358 switch (ch) {
359 case 0x08:
360 keypress = kbBackspace;
361 break;
362 case 0x0A:
363 keypress = kbEnter;
364 break;
87a17f3c
KL
365 case 0x1B:
366 keypress = kbEsc;
367 break;
84614868
KL
368 case 0x0D:
369 keypress = kbEnter;
370 break;
bd8d51fa
KL
371 case 0x09:
372 keypress = kbTab;
373 break;
30bd4abd
KL
374 case 0x7F:
375 keypress = kbDel;
376 break;
84614868
KL
377 default:
378 if (!alt && ctrl && !shift) {
379 ch = key.getKeyText(key.getKeyCode()).charAt(0);
380 }
381 // Not a special key, put it together
382 keypress = new TKeypress(false, 0, ch, alt, ctrl, shift);
383 }
384 }
385
386 // Save it and we are done.
387 synchronized (eventQueue) {
388 eventQueue.add(new TKeypressEvent(keypress));
389 }
92554d64
KL
390 synchronized (listener) {
391 listener.notifyAll();
30bd4abd
KL
392 }
393 }
394
395 /**
396 * Pass window events into the event queue.
397 *
398 * @param event window event received
399 */
400 @Override
401 public void windowActivated(final WindowEvent event) {
bd8d51fa
KL
402 // Force a total repaint
403 synchronized (screen) {
404 screen.clearPhysical();
405 }
30bd4abd
KL
406 }
407
408 /**
409 * Pass window events into the event queue.
410 *
411 * @param event window event received
412 */
413 @Override
414 public void windowClosed(final WindowEvent event) {
415 // Ignore
416 }
417
418 /**
419 * Pass window events into the event queue.
420 *
421 * @param event window event received
422 */
423 @Override
424 public void windowClosing(final WindowEvent event) {
425 // Drop a cmAbort and walk away
426 synchronized (eventQueue) {
427 eventQueue.add(new TCommandEvent(cmAbort));
428 }
92554d64
KL
429 synchronized (listener) {
430 listener.notifyAll();
30bd4abd
KL
431 }
432 }
433
434 /**
435 * Pass window events into the event queue.
436 *
437 * @param event window event received
438 */
439 @Override
440 public void windowDeactivated(final WindowEvent event) {
441 // Ignore
442 }
443
444 /**
445 * Pass window events into the event queue.
446 *
447 * @param event window event received
448 */
449 @Override
450 public void windowDeiconified(final WindowEvent event) {
451 // Ignore
452 }
453
454 /**
455 * Pass window events into the event queue.
456 *
457 * @param event window event received
458 */
459 @Override
460 public void windowIconified(final WindowEvent event) {
461 // Ignore
462 }
463
464 /**
465 * Pass window events into the event queue.
466 *
467 * @param event window event received
468 */
469 @Override
470 public void windowOpened(final WindowEvent event) {
471 // Ignore
472 }
473
474 /**
475 * Pass component events into the event queue.
476 *
477 * @param event component event received
478 */
479 @Override
480 public void componentHidden(final ComponentEvent event) {
481 // Ignore
482 }
483
484 /**
485 * Pass component events into the event queue.
486 *
487 * @param event component event received
488 */
489 @Override
490 public void componentShown(final ComponentEvent event) {
491 // Ignore
492 }
493
494 /**
495 * Pass component events into the event queue.
496 *
497 * @param event component event received
498 */
499 @Override
500 public void componentMoved(final ComponentEvent event) {
501 // Ignore
502 }
503
504 /**
505 * Pass component events into the event queue.
506 *
507 * @param event component event received
508 */
509 @Override
510 public void componentResized(final ComponentEvent event) {
511 // Drop a new TResizeEvent into the queue
512 sessionInfo.queryWindowSize();
513 synchronized (eventQueue) {
514 TResizeEvent windowResize = new TResizeEvent(TResizeEvent.Type.SCREEN,
515 sessionInfo.getWindowWidth(), sessionInfo.getWindowHeight());
516 eventQueue.add(windowResize);
517 }
92554d64
KL
518 synchronized (listener) {
519 listener.notifyAll();
30bd4abd
KL
520 }
521 }
522
523 /**
524 * Pass mouse events into the event queue.
525 *
526 * @param mouse mouse event received
527 */
528 @Override
529 public void mouseDragged(final MouseEvent mouse) {
530 int modifiers = mouse.getModifiersEx();
531 boolean eventMouse1 = false;
532 boolean eventMouse2 = false;
533 boolean eventMouse3 = false;
534 if ((modifiers & MouseEvent.BUTTON1_DOWN_MASK) != 0) {
535 eventMouse1 = true;
536 }
537 if ((modifiers & MouseEvent.BUTTON2_DOWN_MASK) != 0) {
538 eventMouse2 = true;
539 }
540 if ((modifiers & MouseEvent.BUTTON3_DOWN_MASK) != 0) {
541 eventMouse3 = true;
542 }
543 mouse1 = eventMouse1;
544 mouse2 = eventMouse2;
545 mouse3 = eventMouse3;
87a17f3c
KL
546 int x = screen.textColumn(mouse.getX());
547 int y = screen.textRow(mouse.getY());
30bd4abd
KL
548
549 TMouseEvent mouseEvent = new TMouseEvent(TMouseEvent.Type.MOUSE_MOTION,
550 x, y, x, y, mouse1, mouse2, mouse3, false, false);
551
552 synchronized (eventQueue) {
553 eventQueue.add(mouseEvent);
554 }
92554d64
KL
555 synchronized (listener) {
556 listener.notifyAll();
30bd4abd
KL
557 }
558 }
559
560 /**
561 * Pass mouse events into the event queue.
562 *
563 * @param mouse mouse event received
564 */
565 @Override
566 public void mouseMoved(final MouseEvent mouse) {
87a17f3c
KL
567 int x = screen.textColumn(mouse.getX());
568 int y = screen.textRow(mouse.getY());
30bd4abd
KL
569 TMouseEvent mouseEvent = new TMouseEvent(TMouseEvent.Type.MOUSE_MOTION,
570 x, y, x, y, mouse1, mouse2, mouse3, false, false);
571
572 synchronized (eventQueue) {
573 eventQueue.add(mouseEvent);
574 }
92554d64
KL
575 synchronized (listener) {
576 listener.notifyAll();
30bd4abd 577 }
84614868 578 }
30bd4abd
KL
579
580 /**
581 * Pass mouse events into the event queue.
582 *
583 * @param mouse mouse event received
584 */
585 @Override
586 public void mouseClicked(final MouseEvent mouse) {
587 // Ignore
588 }
589
590 /**
591 * Pass mouse events into the event queue.
592 *
593 * @param mouse mouse event received
594 */
595 @Override
596 public void mouseEntered(final MouseEvent mouse) {
597 // Ignore
598 }
599
600 /**
601 * Pass mouse events into the event queue.
602 *
603 * @param mouse mouse event received
604 */
605 @Override
606 public void mouseExited(final MouseEvent mouse) {
607 // Ignore
608 }
609
610 /**
611 * Pass mouse events into the event queue.
612 *
613 * @param mouse mouse event received
614 */
615 @Override
616 public void mousePressed(final MouseEvent mouse) {
617 int modifiers = mouse.getModifiersEx();
618 boolean eventMouse1 = false;
619 boolean eventMouse2 = false;
620 boolean eventMouse3 = false;
621 if ((modifiers & MouseEvent.BUTTON1_DOWN_MASK) != 0) {
622 eventMouse1 = true;
623 }
624 if ((modifiers & MouseEvent.BUTTON2_DOWN_MASK) != 0) {
625 eventMouse2 = true;
626 }
627 if ((modifiers & MouseEvent.BUTTON3_DOWN_MASK) != 0) {
628 eventMouse3 = true;
629 }
630 mouse1 = eventMouse1;
631 mouse2 = eventMouse2;
632 mouse3 = eventMouse3;
87a17f3c
KL
633 int x = screen.textColumn(mouse.getX());
634 int y = screen.textRow(mouse.getY());
30bd4abd
KL
635
636 TMouseEvent mouseEvent = new TMouseEvent(TMouseEvent.Type.MOUSE_DOWN,
637 x, y, x, y, mouse1, mouse2, mouse3, false, false);
638
639 synchronized (eventQueue) {
640 eventQueue.add(mouseEvent);
641 }
92554d64
KL
642 synchronized (listener) {
643 listener.notifyAll();
30bd4abd
KL
644 }
645 }
646
647 /**
648 * Pass mouse events into the event queue.
649 *
650 * @param mouse mouse event received
651 */
652 @Override
653 public void mouseReleased(final MouseEvent mouse) {
654 int modifiers = mouse.getModifiersEx();
655 boolean eventMouse1 = false;
656 boolean eventMouse2 = false;
657 boolean eventMouse3 = false;
658 if ((modifiers & MouseEvent.BUTTON1_DOWN_MASK) != 0) {
659 eventMouse1 = true;
660 }
661 if ((modifiers & MouseEvent.BUTTON2_DOWN_MASK) != 0) {
662 eventMouse2 = true;
663 }
664 if ((modifiers & MouseEvent.BUTTON3_DOWN_MASK) != 0) {
665 eventMouse3 = true;
666 }
667 if (mouse1) {
668 mouse1 = false;
669 eventMouse1 = true;
670 }
671 if (mouse2) {
672 mouse2 = false;
673 eventMouse2 = true;
674 }
675 if (mouse3) {
676 mouse3 = false;
677 eventMouse3 = true;
678 }
87a17f3c
KL
679 int x = screen.textColumn(mouse.getX());
680 int y = screen.textRow(mouse.getY());
30bd4abd
KL
681
682 TMouseEvent mouseEvent = new TMouseEvent(TMouseEvent.Type.MOUSE_UP,
683 x, y, x, y, eventMouse1, eventMouse2, eventMouse3, false, false);
684
685 synchronized (eventQueue) {
686 eventQueue.add(mouseEvent);
687 }
92554d64
KL
688 synchronized (listener) {
689 listener.notifyAll();
30bd4abd
KL
690 }
691 }
692
693 /**
694 * Pass mouse events into the event queue.
695 *
696 * @param mouse mouse event received
697 */
698 @Override
699 public void mouseWheelMoved(final MouseWheelEvent mouse) {
700 int modifiers = mouse.getModifiersEx();
701 boolean eventMouse1 = false;
702 boolean eventMouse2 = false;
703 boolean eventMouse3 = false;
704 boolean mouseWheelUp = false;
705 boolean mouseWheelDown = false;
706 if ((modifiers & MouseEvent.BUTTON1_DOWN_MASK) != 0) {
707 eventMouse1 = true;
708 }
709 if ((modifiers & MouseEvent.BUTTON2_DOWN_MASK) != 0) {
710 eventMouse2 = true;
711 }
712 if ((modifiers & MouseEvent.BUTTON3_DOWN_MASK) != 0) {
713 eventMouse3 = true;
714 }
715 mouse1 = eventMouse1;
716 mouse2 = eventMouse2;
717 mouse3 = eventMouse3;
87a17f3c
KL
718 int x = screen.textColumn(mouse.getX());
719 int y = screen.textRow(mouse.getY());
30bd4abd
KL
720 if (mouse.getWheelRotation() > 0) {
721 mouseWheelDown = true;
722 }
723 if (mouse.getWheelRotation() < 0) {
724 mouseWheelUp = true;
725 }
726
727 TMouseEvent mouseEvent = new TMouseEvent(TMouseEvent.Type.MOUSE_DOWN,
728 x, y, x, y, mouse1, mouse2, mouse3, mouseWheelUp, mouseWheelDown);
729
730 synchronized (eventQueue) {
731 eventQueue.add(mouseEvent);
732 }
92554d64
KL
733 synchronized (listener) {
734 listener.notifyAll();
30bd4abd
KL
735 }
736 }
737
1ac2ccb1 738}