TWindowBackend
[fanfix.git] / src / jexer / backend / Backend.java
CommitLineData
daa4106c 1/*
df8de03f
KL
2 * Jexer - Java Text User Interface
3 *
e16dda65 4 * The MIT License (MIT)
df8de03f 5 *
a2018e99 6 * Copyright (C) 2017 Kevin Lamonte
df8de03f 7 *
e16dda65
KL
8 * Permission is hereby granted, free of charge, to any person obtaining a
9 * copy of this software and associated documentation files (the "Software"),
10 * to deal in the Software without restriction, including without limitation
11 * the rights to use, copy, modify, merge, publish, distribute, sublicense,
12 * and/or sell copies of the Software, and to permit persons to whom the
13 * Software is furnished to do so, subject to the following conditions:
df8de03f 14 *
e16dda65
KL
15 * The above copyright notice and this permission notice shall be included in
16 * all copies or substantial portions of the Software.
df8de03f 17 *
e16dda65
KL
18 * THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
19 * IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
20 * FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL
21 * THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
22 * LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING
23 * FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER
24 * DEALINGS IN THE SOFTWARE.
7b5261bc
KL
25 *
26 * @author Kevin Lamonte [kevin.lamonte@gmail.com]
27 * @version 1
df8de03f
KL
28 */
29package jexer.backend;
30
b1589621 31import java.util.List;
05dbb28d 32
df8de03f 33import jexer.event.TInputEvent;
df8de03f
KL
34
35/**
42873e30
KL
36 * This interface provides a screen, keyboard, and mouse to TApplication. It
37 * also exposes session information as gleaned from lower levels of the
38 * communication stack.
df8de03f 39 */
42873e30 40public interface Backend {
df8de03f
KL
41
42 /**
42873e30
KL
43 * Get a SessionInfo, which exposes text width/height, language,
44 * username, and other information from the communication stack.
7b5261bc
KL
45 *
46 * @return the SessionInfo
47 */
42873e30 48 public SessionInfo getSessionInfo();
df8de03f
KL
49
50 /**
42873e30 51 * Get a Screen, which displays the text cells to the user.
7b5261bc
KL
52 *
53 * @return the Screen
df8de03f 54 */
42873e30 55 public Screen getScreen();
df8de03f
KL
56
57 /**
42873e30
KL
58 * Classes must provide an implementation that syncs the logical screen
59 * to the physical device.
df8de03f 60 */
42873e30 61 public void flushScreen();
df8de03f
KL
62
63 /**
42873e30 64 * Classes must provide an implementation to get keyboard, mouse, and
df8de03f
KL
65 * screen resize events.
66 *
623a1bd1 67 * @param queue list to append new events to
df8de03f 68 */
42873e30 69 public void getEvents(List<TInputEvent> queue);
df8de03f
KL
70
71 /**
42873e30
KL
72 * Classes must provide an implementation that closes sockets, restores
73 * console, etc.
df8de03f 74 */
42873e30 75 public void shutdown();
df8de03f 76
55d2b2c2 77 /**
42873e30 78 * Classes must provide an implementation that sets the window title.
55d2b2c2
KL
79 *
80 * @param title the new title
81 */
42873e30 82 public void setTitle(final String title);
55d2b2c2 83
88a99379
KL
84 /**
85 * Set listener to a different Object.
86 *
87 * @param listener the new listening object that run() wakes up on new
88 * input
89 */
90 public void setListener(final Object listener);
91
df8de03f 92}