rxvt-unicode/src/rxvtlib.h.in

#ifndef _RXVTLIB_H_             /* include once only */
#define _RXVTLIB_H_

#include <cstdio>
#include <cctype>
#include <cerrno>
@include_stdarg_h@
@include_stdlib_h@
@include_stdint_h@
#include <sys/types.h>
@include_unistd_h@
@include_string_h@
@include_fcntl_h@
@include_util_h@
@include_assert_h@
@include_sys_ioctl_h@
@include_sys_time_h@
@include_time_h@
@include_sys_select_h@
@include_sys_strredir_h@

#include <sys/wait.h>
#include <sys/stat.h>

#if HAVE_CWCHAR
# include <cwchar>
#elif HAVE_WCHAR_H
# include <wchar.h>
#else
// stdlib.h might provide it
#endif

#include "ptytty.h"

extern "C" {
#include <X11/Intrinsic.h>      /* Xlib, Xutil, Xresource, Xfuncproto */
}

/*
 * If we haven't pulled in typedef's like  int16_t  then do them ourself
 * type of (normal and unsigned) basic sizes
 */
@rxvt_int16_typedef@
@rxvt_uint16_typedef@
@rxvt_int32_typedef@
@rxvt_uint32_typedef@

/* whatever normal size corresponds to a integer pointer */
@rxvt_intp_define@
/* whatever normal size corresponds to a unsigned integer pointer */
@rxvt_u_intp_define@

struct rxvt_fontset;
struct rxvt_color;
struct rxvt_vars;               /* defined later on */
struct rxvt_term;
struct rxvt_display;
struct rxvt_im;
struct rxvt_drawable;

typedef struct rxvt_term *rxvt_t;

extern rxvt_t rxvt_current_term;

#define SET_R(r) rxvt_current_term = (r)
#define GET_R rxvt_current_term

#define scrollbar_visible()    scrollBar.state
#define menubar_visible()      menuBar.state

typedef struct {
  int row;
  int col;
} row_col_t;

#if UNICODE_3
typedef uint32_t text_t;
#else
typedef uint16_t text_t; // saves lots of memory
#endif
typedef uint32_t rend_t;
typedef  int32_t tlen_t; // was int16_t, but this result sin smaller code and memory use

#define LINE_CONT -1

struct line_t {
   text_t *t; // terminal the text
   rend_t *r; // rendition, uses RS_ flags
   tlen_t l;  // length of each text line, LINE_CONT == continued on next line

   bool is_longer ()
   {
     return l < 0;
   }

   void set_is_longer ()
   {
     l = LINE_CONT;
   }

   void clear ()
   {
     t = 0;
     r = 0;
     l = 0;
   }
};

/*
 * terminal limits:
 *
 *  width      : 1 <= width
 *  height     : 1 <= height
 *  ncol       : 1 <= ncol       <= MAX(int16_t)
 *  nrow       : 1 <= nrow       <= MAX(int16_t)
 *  saveLines  : 0 <= saveLines  <= MAX(int16_t)
 *  total_rows : nrow + saveLines
 *  nsaved     : 0 <= nsaved     <= saveLines
 *  term_start : 0 <= term_start < saveLines
 *  view_start : 0 <= view_start < saveLines
 *
 *          | most coordinates are stored relative to term_start,
 *  ROW_BUF | which is the first line of the terminal screen
 *  |························= row_buf[0]
 *  |························= row_buf[1]
 *  |························= row_buf[2] etc.
 *  |
 *  +------------+···········= term_start - nsaved
 *  | scrollback |                                      
 *  | scrollback +---------+·= term_start - view_start
 *  | scrollback | display |
 *  | scrollback | display |
 *  +------------+·display·+·= term_start
 *  |  terminal  | display |
 *  |  terminal  +---------+
 *  |  terminal  |
 *  |  terminal  |
 *  +------------+···········= term_stat + nrow - 1
 *  |
 *  |
 *  END······················= total_rows
 */

struct TermWin_t {
  int            width;         /* window width                    [pixels] */
  int            height;        /* window height                   [pixels] */
  int            fwidth;        /* font width                      [pixels] */
  int            fheight;       /* font height                     [pixels] */
  int            fbase;         /* font ascent (baseline)          [pixels] */
  int            ncol;          /* window columns              [characters] */
  int            nrow;          /* window rows                 [characters] */
  int            focus;         /* window has focus                         */
  int            mapped;        /* window state mapped?                     */
  int            int_bwidth;    /* internal border width                    */
  int            ext_bwidth;    /* external border width                    */
  int            lineSpace;     /* number of extra pixels between rows      */
  int            saveLines;     /* number of lines that fit in scrollback   */
  int            total_rows;    /* total number of rows in this terminal    */
  int            nsaved;        /* number of rows saved to scrollback       */
  int            term_start;    /* term lines start here                    */
  int            view_start;    /* scrollback view starts here              */
  Window         parent[6];     /* parent identifiers - we're parent[0]     */
  Window         vt;            /* vt100 window                             */
  GC             gc;            /* GC for drawing                           */
  Pixmap         pixmap;
  rxvt_drawable *drawable;
  rxvt_fontset  *fontset[4];
};

/*
 * screen accounting:
 * screen_t elements
 *   row:       Cursor row position                   : 0 <= row < nrow
 *   col:       Cursor column position                : 0 <= col < ncol
 *   tscroll:   Scrolling region top row inclusive    : 0 <= row < nrow
 *   bscroll:   Scrolling region bottom row inclusive : 0 <= row < nrow
 *
 * selection_t elements
 *   clicks:    1, 2 or 3 clicks - 4 indicates a special condition of 1 where
 *              nothing is selected
 *   beg:       row/column of beginning of selection  : never past mark
 *   mark:      row/column of initial click           : never past end
 *   end:       row/column of one character past end of selection
 * * Note: -nsaved <= beg.row <= mark.row <= end.row < nrow
 * * Note: col == -1 ==> we're left of screen
 *
 */
typedef struct {
  row_col_t       cur;          /* cursor position on the screen             */
  int             tscroll;      /* top of settable scroll region             */
  int             bscroll;      /* bottom of settable scroll region          */
  unsigned int    charset;      /* character set number [0..3]               */
  unsigned int    flags;        /* see below                                 */
  row_col_t       s_cur;        /* saved cursor position                     */
  unsigned int    s_charset;    /* saved character set number [0..3]         */
  char            s_charset_char;
  rend_t          s_rstyle;     /* saved rendition style                     */
} screen_t;

enum selection_op_t {
  SELECTION_CLEAR = 0,  /* nothing selected                          */
  SELECTION_INIT,       /* marked a point                            */
  SELECTION_BEGIN,      /* started a selection                       */
  SELECTION_CONT,       /* continued selection                       */
  SELECTION_DONE        /* selection put in CUT_BUFFER0              */
};

typedef struct {
  wchar_t          *text;       /* selected text                             */
  unsigned int      len;        /* length of selected text                   */
  unsigned int      screen;     /* screen being used                         */
  unsigned int      clicks;     /* number of clicks                          */
  selection_op_t    op;         /* current operation                         */
  bool              rect;       /* rectangluar selection?                    */
  row_col_t         beg;        /* beginning of selection   <= mark          */
  row_col_t         mark;       /* point of initial click   <= end           */
  row_col_t         end;        /* one character past end point              */
} selection_t;

/* ------------------------------------------------------------------------- */

/* screen_t flags */
#define Screen_Relative          (1<<0)  /* relative origin mode flag         */
#define Screen_VisibleCursor     (1<<1)  /* cursor visible?                   */
#define Screen_Autowrap          (1<<2)  /* auto-wrap flag                    */
#define Screen_Insert            (1<<3)  /* insert mode (vs. overstrike)      */
#define Screen_WrapNext          (1<<4)  /* need to wrap for next char?       */
#define Screen_DefaultFlags      (Screen_VisibleCursor | Screen_Autowrap)

/* rxvt_vars.options */
#define Opt_console              (1UL<<0)
#define Opt_loginShell           (1UL<<1)
#define Opt_iconic               (1UL<<2)
#define Opt_visualBell           (1UL<<3)
#define Opt_mapAlert             (1UL<<4)
#define Opt_reverseVideo         (1UL<<5)
#define Opt_utmpInhibit          (1UL<<6)
#define Opt_scrollBar            (1UL<<7)
#define Opt_scrollBar_right      (1UL<<8)
#define Opt_scrollBar_floating   (1UL<<9)
#define Opt_meta8                (1UL<<10)
#define Opt_scrollTtyOutput      (1UL<<11)
#define Opt_scrollTtyKeypress    (1UL<<12)
#define Opt_transparent          (1UL<<13)
#define Opt_tripleclickwords     (1UL<<14)
#define Opt_scrollWithBuffer     (1UL<<15)
#define Opt_jumpScroll           (1UL<<16)
#define Opt_mouseWheelScrollPage (1UL<<17)
#define Opt_pointerBlank         (1UL<<18)
#define Opt_cursorBlink          (1UL<<19)
#define Opt_secondaryScreen      (1UL<<20)
#define Opt_secondaryScroll      (1UL<<21)
#define Opt_pastableTabs         (1UL<<22)
#define Opt_cursorUnderline      (1UL<<23)
#if ENABLE_FRILLS
# define Opt_insecure            (1UL<<24) // insecure esc sequences
# define Opt_borderLess          (1UL<<25) // mem borderless hints
#else
# define Opt_insecure            0
# define Opt_borderLess          0
#endif
/* place holder used for parsing command-line options */
#define Opt_Reverse              (1UL<<30)
#define Opt_Boolean              (1UL<<31)

#define DEFAULT_OPTIONS          (Opt_scrollBar | Opt_scrollTtyOutput \
                                  | Opt_jumpScroll | Opt_secondaryScreen \
                                  | Opt_pastableTabs)

/* ------------------------------------------------------------------------- */

typedef struct {
  short           state;
  Window          win;
  struct rxvt_drawable *drawable;
} menuBar_t;

typedef struct {
  char            state;        /* scrollbar state                          */
  char            init;         /* scrollbar has been initialised           */
  unsigned int    beg;          /* slider sub-window begin height           */
  unsigned int    end;          /* slider sub-window end height             */
  unsigned int    top;          /* slider top position                      */
  unsigned int    bot;          /* slider bottom position                   */
  unsigned int    style;        /* style: rxvt, xterm, next                 */
  unsigned int    width;        /* scrollbar width                          */
  Window          win;
  int             (rxvt_term::*update)(int, int, int, int);

  void setIdle()   { state =  1 ; }
  void setMotion() { state = 'm'; }
  void setUp()     { state = 'U'; }
  void setDn()     { state = 'D'; }
} scrollBar_t;

struct rxvt_vars : TermWin_t {
  scrollBar_t     scrollBar;
  menuBar_t       menuBar;
  unsigned long   options;
  XSizeHints      szHint;
  rxvt_display   *display;
  rxvt_color     *pix_colors;
  rxvt_color     *pix_colors_focused;
#ifdef OFF_FOCUS_FADING
  rxvt_color     *pix_colors_unfocused;
#endif
  short           numpix_colors;
  Cursor          TermWin_cursor;       /* cursor for vt window */
  int             sb_shadow;    /* scrollbar shadow width                    */
  rxvt_ptytty     pty;
  int             numlock_state;
  line_t         *row_buf;      // all lines, scrollback + terminal, circular
  line_t         *drawn_buf;    // text on screen
  line_t         *temp_buf;     // temporary buffer
  line_t         *swap_buf;     // lines for swap buffer
  char           *tabs;         /* per location: 1 == tab-stop               */
  screen_t        screen;
  screen_t        swap;
  selection_t     selection;
};

void rxvt_init ();

#endif                          /* _RXVTLIB_H_ */

Revision:	1.52
Committed:	Wed Dec 21 19:50:17 2005 UTC (18 years, 5 months ago) by root
Branch:	MAIN
Changes since 1.51:	+40 -32 lines
Log Message:	* empty log message *
#	Content
1	#ifndef _RXVTLIB_H_ /* include once only */
2	#define _RXVTLIB_H_
3
4	#include <cstdio>
5	#include <cctype>
6	#include <cerrno>
7	@include_stdarg_h@
8	@include_stdlib_h@
9	@include_stdint_h@
10	#include <sys/types.h>
11	@include_unistd_h@
12	@include_string_h@
13	@include_fcntl_h@
14	@include_util_h@
15	@include_assert_h@
16	@include_sys_ioctl_h@
17	@include_sys_time_h@
18	@include_time_h@
19	@include_sys_select_h@
20	@include_sys_strredir_h@
21
22	#include <sys/wait.h>
23	#include <sys/stat.h>
24
25	#if HAVE_CWCHAR
26	# include <cwchar>
27	#elif HAVE_WCHAR_H
28	# include <wchar.h>
29	#else
30	// stdlib.h might provide it
31	#endif
32
33	#include "ptytty.h"
34
35	extern "C" {
36	#include <X11/Intrinsic.h> /* Xlib, Xutil, Xresource, Xfuncproto */
37	}
38
39	/*
40	* If we haven't pulled in typedef's like int16_t then do them ourself
41	* type of (normal and unsigned) basic sizes
42	*/
43	@rxvt_int16_typedef@
44	@rxvt_uint16_typedef@
45	@rxvt_int32_typedef@
46	@rxvt_uint32_typedef@
47
48	/* whatever normal size corresponds to a integer pointer */
49	@rxvt_intp_define@
50	/* whatever normal size corresponds to a unsigned integer pointer */
51	@rxvt_u_intp_define@
52
53	struct rxvt_fontset;
54	struct rxvt_color;
55	struct rxvt_vars; /* defined later on */
56	struct rxvt_term;
57	struct rxvt_display;
58	struct rxvt_im;
59	struct rxvt_drawable;
60
61	typedef struct rxvt_term *rxvt_t;
62
63	extern rxvt_t rxvt_current_term;
64
65	#define SET_R(r) rxvt_current_term = (r)
66	#define GET_R rxvt_current_term
67
68	#define scrollbar_visible() scrollBar.state
69	#define menubar_visible() menuBar.state
70
71	typedef struct {
72	int row;
73	int col;
74	} row_col_t;
75
76	#if UNICODE_3
77	typedef uint32_t text_t;
78	#else
79	typedef uint16_t text_t; // saves lots of memory
80	#endif
81	typedef uint32_t rend_t;
82	typedef int32_t tlen_t; // was int16_t, but this result sin smaller code and memory use
83
84	#define LINE_CONT -1
85
86	struct line_t {
87	text_t *t; // terminal the text
88	rend_t *r; // rendition, uses RS_ flags
89	tlen_t l; // length of each text line, LINE_CONT == continued on next line
90
91	bool is_longer ()
92	{
93	return l < 0;
94	}
95
96	void set_is_longer ()
97	{
98	l = LINE_CONT;
99	}
100
101	void clear ()
102	{
103	t = 0;
104	r = 0;
105	l = 0;
106	}
107	};
108
109	/*
110	* terminal limits:
111	*
112	* width : 1 <= width
113	* height : 1 <= height
114	* ncol : 1 <= ncol <= MAX(int16_t)
115	* nrow : 1 <= nrow <= MAX(int16_t)
116	* saveLines : 0 <= saveLines <= MAX(int16_t)
117	* total_rows : nrow + saveLines
118	* nsaved : 0 <= nsaved <= saveLines
119	* term_start : 0 <= term_start < saveLines
120	* view_start : 0 <= view_start < saveLines
121	*
122	* \| most coordinates are stored relative to term_start,
123	* ROW_BUF \| which is the first line of the terminal screen
124	* \|························= row_buf[0]
125	* \|························= row_buf[1]
126	* \|························= row_buf[2] etc.
127	* \|
128	* +------------+···········= term_start - nsaved
129	* \| scrollback \|
130	* \| scrollback +---------+·= term_start - view_start
131	* \| scrollback \| display \|
132	* \| scrollback \| display \|
133	* +------------+·display·+·= term_start
134	* \| terminal \| display \|
135	* \| terminal +---------+
136	* \| terminal \|
137	* \| terminal \|
138	* +------------+···········= term_stat + nrow - 1
139	* \|
140	* \|
141	* END······················= total_rows
142	*/
143
144	struct TermWin_t {
145	int width; /* window width [pixels] */
146	int height; /* window height [pixels] */
147	int fwidth; /* font width [pixels] */
148	int fheight; /* font height [pixels] */
149	int fbase; /* font ascent (baseline) [pixels] */
150	int ncol; /* window columns [characters] */
151	int nrow; /* window rows [characters] */
152	int focus; /* window has focus */
153	int mapped; /* window state mapped? */
154	int int_bwidth; /* internal border width */
155	int ext_bwidth; /* external border width */
156	int lineSpace; /* number of extra pixels between rows */
157	int saveLines; /* number of lines that fit in scrollback */
158	int total_rows; /* total number of rows in this terminal */
159	int nsaved; /* number of rows saved to scrollback */
160	int term_start; /* term lines start here */
161	int view_start; /* scrollback view starts here */
162	Window parent[6]; /* parent identifiers - we're parent[0] */
163	Window vt; /* vt100 window */
164	GC gc; /* GC for drawing */
165	Pixmap pixmap;
166	rxvt_drawable *drawable;
167	rxvt_fontset *fontset[4];
168	};
169
170	/*
171	* screen accounting:
172	* screen_t elements
173	* row: Cursor row position : 0 <= row < nrow
174	* col: Cursor column position : 0 <= col < ncol
175	* tscroll: Scrolling region top row inclusive : 0 <= row < nrow
176	* bscroll: Scrolling region bottom row inclusive : 0 <= row < nrow
177	*
178	* selection_t elements
179	* clicks: 1, 2 or 3 clicks - 4 indicates a special condition of 1 where
180	* nothing is selected
181	* beg: row/column of beginning of selection : never past mark
182	* mark: row/column of initial click : never past end
183	* end: row/column of one character past end of selection
184	* * Note: -nsaved <= beg.row <= mark.row <= end.row < nrow
185	* * Note: col == -1 ==> we're left of screen
186	*
187	*/
188	typedef struct {
189	row_col_t cur; /* cursor position on the screen */
190	int tscroll; /* top of settable scroll region */
191	int bscroll; /* bottom of settable scroll region */
192	unsigned int charset; /* character set number [0..3] */
193	unsigned int flags; /* see below */
194	row_col_t s_cur; /* saved cursor position */
195	unsigned int s_charset; /* saved character set number [0..3] */
196	char s_charset_char;
197	rend_t s_rstyle; /* saved rendition style */
198	} screen_t;
199
200	enum selection_op_t {
201	SELECTION_CLEAR = 0, /* nothing selected */
202	SELECTION_INIT, /* marked a point */
203	SELECTION_BEGIN, /* started a selection */
204	SELECTION_CONT, /* continued selection */
205	SELECTION_DONE /* selection put in CUT_BUFFER0 */
206	};
207
208	typedef struct {
209	wchar_t text; / selected text */
210	unsigned int len; /* length of selected text */
211	unsigned int screen; /* screen being used */
212	unsigned int clicks; /* number of clicks */
213	selection_op_t op; /* current operation */
214	bool rect; /* rectangluar selection? */
215	row_col_t beg; /* beginning of selection <= mark */
216	row_col_t mark; /* point of initial click <= end */
217	row_col_t end; /* one character past end point */
218	} selection_t;
219
220	/* ------------------------------------------------------------------------- */
221
222	/* screen_t flags */
223	#define Screen_Relative (1<<0) /* relative origin mode flag */
224	#define Screen_VisibleCursor (1<<1) /* cursor visible? */
225	#define Screen_Autowrap (1<<2) /* auto-wrap flag */
226	#define Screen_Insert (1<<3) /* insert mode (vs. overstrike) */
227	#define Screen_WrapNext (1<<4) /* need to wrap for next char? */
228	#define Screen_DefaultFlags (Screen_VisibleCursor \| Screen_Autowrap)
229
230	/* rxvt_vars.options */
231	#define Opt_console (1UL<<0)
232	#define Opt_loginShell (1UL<<1)
233	#define Opt_iconic (1UL<<2)
234	#define Opt_visualBell (1UL<<3)
235	#define Opt_mapAlert (1UL<<4)
236	#define Opt_reverseVideo (1UL<<5)
237	#define Opt_utmpInhibit (1UL<<6)
238	#define Opt_scrollBar (1UL<<7)
239	#define Opt_scrollBar_right (1UL<<8)
240	#define Opt_scrollBar_floating (1UL<<9)
241	#define Opt_meta8 (1UL<<10)
242	#define Opt_scrollTtyOutput (1UL<<11)
243	#define Opt_scrollTtyKeypress (1UL<<12)
244	#define Opt_transparent (1UL<<13)
245	#define Opt_tripleclickwords (1UL<<14)
246	#define Opt_scrollWithBuffer (1UL<<15)
247	#define Opt_jumpScroll (1UL<<16)
248	#define Opt_mouseWheelScrollPage (1UL<<17)
249	#define Opt_pointerBlank (1UL<<18)
250	#define Opt_cursorBlink (1UL<<19)
251	#define Opt_secondaryScreen (1UL<<20)
252	#define Opt_secondaryScroll (1UL<<21)
253	#define Opt_pastableTabs (1UL<<22)
254	#define Opt_cursorUnderline (1UL<<23)
255	#if ENABLE_FRILLS
256	# define Opt_insecure (1UL<<24) // insecure esc sequences
257	# define Opt_borderLess (1UL<<25) // mem borderless hints
258	#else
259	# define Opt_insecure 0
260	# define Opt_borderLess 0
261	#endif
262	/* place holder used for parsing command-line options */
263	#define Opt_Reverse (1UL<<30)
264	#define Opt_Boolean (1UL<<31)
265
266	#define DEFAULT_OPTIONS (Opt_scrollBar \| Opt_scrollTtyOutput \
267	\| Opt_jumpScroll \| Opt_secondaryScreen \
268	\| Opt_pastableTabs)
269
270	/* ------------------------------------------------------------------------- */
271
272	typedef struct {
273	short state;
274	Window win;
275	struct rxvt_drawable *drawable;
276	} menuBar_t;
277
278	typedef struct {
279	char state; /* scrollbar state */
280	char init; /* scrollbar has been initialised */
281	unsigned int beg; /* slider sub-window begin height */
282	unsigned int end; /* slider sub-window end height */
283	unsigned int top; /* slider top position */
284	unsigned int bot; /* slider bottom position */
285	unsigned int style; /* style: rxvt, xterm, next */
286	unsigned int width; /* scrollbar width */
287	Window win;
288	int (rxvt_term::*update)(int, int, int, int);
289
290	void setIdle() { state = 1 ; }
291	void setMotion() { state = 'm'; }
292	void setUp() { state = 'U'; }
293	void setDn() { state = 'D'; }
294	} scrollBar_t;
295
296	struct rxvt_vars : TermWin_t {
297	scrollBar_t scrollBar;
298	menuBar_t menuBar;
299	unsigned long options;
300	XSizeHints szHint;
301	rxvt_display *display;
302	rxvt_color *pix_colors;
303	rxvt_color *pix_colors_focused;
304	#ifdef OFF_FOCUS_FADING
305	rxvt_color *pix_colors_unfocused;
306	#endif
307	short numpix_colors;
308	Cursor TermWin_cursor; /* cursor for vt window */
309	int sb_shadow; /* scrollbar shadow width */
310	rxvt_ptytty pty;
311	int numlock_state;
312	line_t *row_buf; // all lines, scrollback + terminal, circular
313	line_t *drawn_buf; // text on screen
314	line_t *temp_buf; // temporary buffer
315	line_t *swap_buf; // lines for swap buffer
316	char tabs; / per location: 1 == tab-stop */
317	screen_t screen;
318	screen_t swap;
319	selection_t selection;
320	};
321
322	void rxvt_init ();
323
324	#endif /* _RXVTLIB_H_ */
325