2 * Internals of the Terminal structure, for those other modules
3 * which need to look inside it. It would be nice if this could be
4 * folded back into terminal.c in future, with an abstraction layer
5 * to handle everything that other modules need to know about it;
6 * but for the moment, this will do.
9 #ifndef PUTTY_TERMINAL_H
10 #define PUTTY_TERMINAL_H
15 struct beeptime *next;
23 #ifdef OPTIMISE_SCROLL
25 struct scrollregion *next;
26 int topline; /* Top line of scroll region. */
27 int botline; /* Bottom line of scroll region. */
28 int lines; /* Number of lines to scroll by - +ve is forwards. */
30 #endif /* OPTIMISE_SCROLL */
32 typedef struct termchar termchar;
33 typedef struct termline termline;
37 * Any code in terminal.c which definitely needs to be changed
38 * when extra fields are added here is labelled with a comment
39 * saying FULL-TERMCHAR.
45 * The cc_next field is used to link multiple termchars
46 * together into a list, so as to fit more than one character
47 * into a character cell (Unicode combining characters).
49 * cc_next is a relative offset into the current array of
50 * termchars. I.e. to advance to the next character in a list,
51 * one does `tc += tc->next'.
53 * Zero means end of list.
60 int cols; /* number of real columns on the line */
61 int size; /* number of allocated termchars
62 * (cc-lists may make this > cols) */
63 int temporary; /* TRUE if decompressed from scrollback */
64 int cc_free; /* offset to first cc in free list */
65 struct termchar *chars;
68 struct bidi_cache_entry {
70 struct termchar *chars;
75 int compatibility_level;
77 tree234 *scrollback; /* lines scrolled off top of screen */
78 tree234 *screen; /* lines on primary screen */
79 tree234 *alt_screen; /* lines on alternate screen */
80 int disptop; /* distance scrolled back (0 or -ve) */
81 int tempsblines; /* number of lines in temporary
84 termline **disptext; /* buffer of text on real screen */
85 int dispcursx, dispcursy; /* location of cursor on real screen */
86 int curstype; /* type of cursor on real screen */
88 #define VBELL_TIMEOUT (TICKSPERSEC/10) /* visual bell lasts 1/10 sec */
90 struct beeptime *beephead, *beeptail;
95 #define TTYPE termchar
96 #define TSIZE (sizeof(TTYPE))
98 #ifdef OPTIMISE_SCROLL
99 struct scrollregion *scrollhead, *scrolltail;
100 #endif /* OPTIMISE_SCROLL */
102 int default_attr, curr_attr, save_attr;
103 termchar basic_erase_char, erase_char;
105 bufchain inbuf; /* terminal input buffer */
106 pos curs; /* cursor */
107 pos savecurs; /* saved cursor position */
108 int marg_t, marg_b; /* scroll margins */
109 int dec_om; /* DEC origin mode flag */
110 int wrap, wrapnext; /* wrap flags */
111 int insert; /* insert-mode flag */
112 int cset; /* 0 or 1: which char set */
113 int save_cset, save_csattr; /* saved with cursor position */
114 int save_utf, save_wnext; /* saved with cursor position */
115 int rvideo; /* global reverse video flag */
116 unsigned long rvbell_startpoint; /* for ESC[?5hESC[?5l vbell */
117 int cursor_on; /* cursor enabled flag */
118 int reset_132; /* Flag ESC c resets to 80 cols */
119 int use_bce; /* Use Background coloured erase */
120 int cblinker; /* When blinking is the cursor on ? */
121 int tblinker; /* When the blinking text is on */
122 int blink_is_real; /* Actually blink blinking text */
123 int term_echoing; /* Does terminal want local echo? */
124 int term_editing; /* Does terminal want local edit? */
125 int sco_acs, save_sco_acs; /* CSI 10,11,12m -> OEM charset */
126 int vt52_bold; /* Force bold on non-bold colours */
127 int utf; /* Are we in toggleable UTF-8 mode? */
128 int utf_state; /* Is there a pending UTF-8 character */
129 int utf_char; /* and what is it so far. */
130 int utf_size; /* The size of the UTF character. */
131 int printing, only_printing; /* Are we doing ANSI printing? */
132 int print_state; /* state of print-end-sequence scan */
133 bufchain printer_buf; /* buffered data for printer */
134 printer_job *print_job;
136 int rows, cols, savelines;
140 int app_cursor_keys, app_keypad_keys, vt52_mode;
141 int repeat_off, cr_lf_return;
145 int xterm_mouse; /* send mouse messages to app */
146 int mouse_is_down; /* used while tracking mouse buttons */
151 * Saved settings on the alternate screen.
153 int alt_x, alt_y, alt_om, alt_wrap, alt_wnext, alt_ins;
154 int alt_cset, alt_sco_acs, alt_utf;
157 int alt_sblines; /* # of lines on alternate screen that should be used for scrollback. */
159 #define ARGS_MAX 32 /* max # of esc sequence arguments */
160 #define ARG_DEFAULT 0 /* if an arg isn't specified */
161 #define def(a,d) ( (a) == ARG_DEFAULT ? (d) : (a) )
162 int esc_args[ARGS_MAX];
165 #define ANSI(x,y) ((x)+((y)<<8))
166 #define ANSI_QUE(x) ANSI(x,TRUE)
168 #define OSC_STR_MAX 2048
170 char osc_string[OSC_STR_MAX + 1];
173 char id_string[1024];
187 OSC_STRING, OSC_MAYBE_ST,
196 NO_SELECTION, ABOUT_TO, DRAGGING, SELECTED
199 LEXICOGRAPHIC, RECTANGULAR
202 SM_CHAR, SM_WORD, SM_LINE
204 pos selstart, selend, selanchor;
208 /* Mask of attributes to pay attention to when painting. */
211 wchar_t *paste_buffer;
212 int paste_len, paste_pos, paste_hold;
215 void (*resize_fn)(void *, int, int);
224 struct unicode_data *ucsdata;
227 * We maintain a full _copy_ of a Config structure here, not
228 * merely a pointer to it. That way, when we're passed a new
229 * one for reconfiguration, we can check the differences and
230 * adjust the _current_ setting of (e.g.) auto wrap mode rather
231 * than only the default.
236 * from_backend calls term_out, but it can also be called from
237 * the ldisc if the ldisc is called _within_ term_out. So we
238 * have to guard against re-entrancy - if from_backend is
239 * called recursively like this, it will simply add data to the
240 * end of the buffer term_out is in the process of working
246 * We schedule a window update shortly after receiving terminal
247 * data. This tracks whether one is currently pending.
249 int window_update_pending;
253 * Track pending blinks and tblinks.
255 int tblink_pending, cblink_pending;
256 long next_tblink, next_cblink;
259 * These are buffers used by the bidi and Arabic shaping code.
263 bidi_char *wcFrom, *wcTo;
265 struct bidi_cache_entry *pre_bidi_cache, *post_bidi_cache;
269 #define in_utf(term) ((term)->utf || (term)->ucsdata->line_codepage==CP_UTF8)