*** empty log message ***
[dana/urxvt.git] / src / rxvtlib.h.in
1 #ifndef _RXVTLIB_H_             /* include once only */
2 #define _RXVTLIB_H_
3
4 #include <stdio.h>
5 #include <ctype.h>
6 #include <errno.h>
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 extern "C" {
26 #include <X11/Intrinsic.h>      /* Xlib, Xutil, Xresource, Xfuncproto */
27 }
28
29 /*
30  * If we haven't pulled in typedef's like  int16_t  then do them ourself
31  * type of (normal and unsigned) basic sizes
32  */
33 @rxvt_int16_typedef@
34 @rxvt_uint16_typedef@
35 @rxvt_int32_typedef@
36 @rxvt_uint32_typedef@
37
38 /* whatever normal size corresponds to a integer pointer */
39 @rxvt_intp_define@
40 /* whatever normal size corresponds to a unsigned integer pointer */
41 @rxvt_u_intp_define@
42
43 struct rxvt_fontset;
44 struct rxvt_color;
45 struct rxvt_vars;               /* defined later on */
46 struct rxvt_term;
47 struct rxvt_display;
48 struct rxvt_im;
49
50 typedef struct rxvt_term *rxvt_t;
51
52 extern rxvt_t rxvt_current_term;
53
54 # define SET_R(r) rxvt_current_term = (r)
55 # define GET_R rxvt_current_term
56
57 #define scrollbar_visible()    scrollBar.state
58 #define menubar_visible()      menuBar.state
59
60 typedef struct {
61   int32_t         row;
62   int32_t         col;
63 } row_col_t;
64
65 #if UNICODE3
66 typedef uint32_t text_t;
67 #else
68 typedef uint16_t text_t; // saves lots of memory
69 #endif
70 typedef uint32_t rend_t;
71
72 /*
73  * TermWin elements limits
74  *  width     : 1 <= width
75  *  height    : 1 <= height
76  *  ncol      : 1 <= ncol       <= MAX(int16_t)
77  *  nrow      : 1 <= nrow       <= MAX(int16_t)
78  *  saveLines : 0 <= saveLines  <= MAX(int16_t)
79  *  nscrolled : 0 <= nscrolled  <= saveLines
80  *  view_start: 0 <= view_start <= nscrolled
81  */
82
83 typedef struct {
84   uint16_t       width; /* window width                    [pixels] */
85   uint16_t       height;        /* window height                   [pixels] */
86   uint16_t       fwidth;        /* font width                      [pixels] */
87   uint16_t       fheight;       /* font height                     [pixels] */
88   uint16_t       fbase;      /* font ascent (baseline)          [pixels] */
89   uint16_t       propfont;      /* font proportional flags                  */
90   uint16_t       ncol;  /* window columns              [characters] */
91   uint16_t       nrow;  /* window rows                 [characters] */
92   uint16_t       focus; /* window has focus                         */
93   uint16_t       mapped;        /* window state mapped?                     */
94   uint16_t       int_bwidth; /* internal border width                    */
95   uint16_t       ext_bwidth; /* external border width                    */
96   uint16_t       lineSpace;     /* number of extra pixels between rows      */
97   uint16_t       saveLines;     /* number of lines that fit in scrollback   */
98   uint16_t       nscrolled;     /* number of line actually scrolled         */
99   uint16_t       view_start;    /* scrollback view starts here              */
100   Window         parent[6];     /* parent identifiers - we're parent[0]     */
101   Window         vt;            /* vt100 window                             */
102   GC             gc;            /* GC for drawing                           */
103   Pixmap         pixmap;
104   rxvt_fontset  *fontset;
105 } TermWin_t;
106
107 /*
108  * screen accounting:
109  * screen_t elements
110  *   text:      Contains all text information including the scrollback buffer.
111  *              Each line is length TermWin.ncol
112  *   tlen:      The length of the line or -1 for wrapped lines.
113  *   rend:      Contains rendition information: font, bold, colour, etc.
114  * * Note: Each line for both text and rend are only allocated on demand, and
115  *         text[x] is allocated <=> rend[x] is allocated  for all x.
116  *   row:       Cursor row position                   : 0 <= row < TermWin.nrow
117  *   col:       Cursor column position                : 0 <= col < TermWin.ncol
118  *   tscroll:   Scrolling region top row inclusive    : 0 <= row < TermWin.nrow
119  *   bscroll:   Scrolling region bottom row inclusive : 0 <= row < TermWin.nrow
120  *
121  * selection_t elements
122  *   clicks:    1, 2 or 3 clicks - 4 indicates a special condition of 1 where
123  *              nothing is selected
124  *   beg:       row/column of beginning of selection  : never past mark
125  *   mark:      row/column of initial click           : never past end
126  *   end:       row/column of one character past end of selection
127  * * Note: -TermWin.nscrolled <= beg.row <= mark.row <= end.row < TermWin.nrow
128  * * Note: col == -1 ==> we're left of screen
129  *
130  * Layout of text/rend information in the screen_t text/rend structures:
131  *   Rows [0] ... [TermWin.saveLines - 1]
132  *     scrollback region : we're only here if TermWin.view_start != 0
133  *   Rows [TermWin.saveLines] ... [TermWin.saveLines + TermWin.nrow - 1]
134  *     normal `unscrolled' screen region
135  */
136 typedef struct {
137   int16_t        *tlen; /* length of each text line                  */
138   text_t        **text; /* _all_ the text                            */
139   rend_t        **rend; /* rendition, uses RS_ flags                 */
140   row_col_t       cur;  /* cursor position on the screen             */
141   uint16_t        tscroll;      /* top of settable scroll region             */
142   uint16_t        bscroll;      /* bottom of settable scroll region          */
143   uint16_t        charset;      /* character set number [0..3]               */
144   unsigned int    flags;        /* see below                                 */
145   row_col_t       s_cur;        /* saved cursor position                     */
146   uint16_t        s_charset;    /* saved character set number [0..3]         */
147   char            s_charset_char;
148   rend_t          s_rstyle;     /* saved rendition style                     */
149 } screen_t;
150
151 enum selection_op_t {
152   SELECTION_CLEAR = 0,  /* nothing selected                          */
153   SELECTION_INIT,       /* marked a point                            */
154   SELECTION_BEGIN,      /* started a selection                       */
155   SELECTION_CONT,       /* continued selection                       */
156   SELECTION_DONE        /* selection put in CUT_BUFFER0              */
157 };
158
159 typedef struct {
160   unsigned char  *text;       /* selected text                             */
161   uint32_t        len;        /* length of selected text                   */
162   short           screen;     /* screen being used                         */
163   short           clicks;     /* number of clicks                          */
164   selection_op_t  op;         /* current operation                         */
165   row_col_t       beg;        /* beginning of selection   <= mark          */
166   row_col_t       mark;       /* point of initial click   <= end           */
167   row_col_t       end;        /* one character past end point              */
168 } selection_t;
169
170 typedef enum {
171     OLD_SELECT, OLD_WORD_SELECT, NEW_SELECT
172 } sstyle_t;
173
174 /* ------------------------------------------------------------------------- */
175
176 /* screen_t flags */
177 #define Screen_Relative         (1<<0)  /* relative origin mode flag         */
178 #define Screen_VisibleCursor    (1<<1)  /* cursor visible?                   */
179 #define Screen_Autowrap         (1<<2)  /* auto-wrap flag                    */
180 #define Screen_Insert           (1<<3)  /* insert mode (vs. overstrike)      */
181 #define Screen_WrapNext         (1<<4)  /* need to wrap for next char?       */
182 #define Screen_DefaultFlags     (Screen_VisibleCursor|Screen_Autowrap)
183
184 /* rxvt_vars.Options */
185 #define Opt_console             (1LU<<0)
186 #define Opt_loginShell          (1LU<<1)
187 #define Opt_iconic              (1LU<<2)
188 #define Opt_visualBell          (1LU<<3)
189 #define Opt_mapAlert            (1LU<<4)
190 #define Opt_reverseVideo        (1LU<<5)
191 #define Opt_utmpInhibit         (1LU<<6)
192 #define Opt_scrollBar           (1LU<<7)
193 #define Opt_scrollBar_right     (1LU<<8)
194 #define Opt_scrollBar_floating  (1LU<<9)
195 #define Opt_meta8               (1LU<<10)
196 #define Opt_scrollTtyOutput     (1LU<<11)
197 #define Opt_scrollTtyKeypress   (1LU<<12)
198 #define Opt_transparent         (1LU<<13)
199 #define Opt_transparent_all     (1LU<<14)
200 #define Opt_mc_hack             (1LU<<15)
201 #define Opt_tripleclickwords    (1LU<<16)
202 #define Opt_scrollWithBuffer    (1LU<<17)
203 #define Opt_jumpScroll          (1LU<<18)
204 #define Opt_mouseWheelScrollPage (1LU<<19)
205 #define Opt_pointerBlank        (1LU<<20)
206 #define Opt_cursorBlink         (1LU<<21)
207 /* place holder used for parsing command-line options */
208 #define Opt_Reverse             (1LU<<30)
209 #define Opt_Boolean             (1LU<<31)
210
211 #define DEFAULT_OPTIONS         (Opt_scrollBar | Opt_scrollTtyOutput \
212                                  | Opt_jumpScroll)
213
214 /* ------------------------------------------------------------------------- */
215
216 typedef struct {
217   short           state;
218   Window          win;
219 } menuBar_t;
220
221 typedef struct {
222   char            state;        /* scrollbar state                          */
223   char            init;         /* scrollbar has been initialised           */
224   short           beg;          /* slider sub-window begin height           */
225   short           end;          /* slider sub-window end height             */
226   short           top;          /* slider top position                      */
227   short           bot;          /* slider bottom position                   */
228   short           style;        /* style: rxvt, xterm, next                 */
229   short           width;        /* scrollbar width                          */
230   Window          win;
231   int             (rxvt_term::*update)(int, int, int, int);
232
233   void setIdle()   { state =  1 ; }
234   void setMotion() { state = 'm'; }
235   void setUp()     { state = 'U'; }
236   void setDn()     { state = 'D'; }
237 } scrollBar_t;
238
239 struct rxvt_vars {
240   TermWin_t       TermWin;
241   scrollBar_t     scrollBar;
242   menuBar_t       menuBar;
243   unsigned long   Options;
244   XSizeHints      szHint;
245   rxvt_display   *display;
246   rxvt_color     *PixColors;
247   short           numPixColors;
248   Cursor          TermWin_cursor;       /* cursor for vt window */
249   int             sb_shadow;    /* scrollbar shadow width                    */
250   int             cmd_fd;       /* pty file descriptor; connected to command */
251   int             tty_fd;       /* tty file descriptor; connected to child   */
252   int             numlock_state;
253   text_t        **drawn_text;   /* text drawn on screen (characters)         */
254   rend_t        **drawn_rend;   /* text drawn on screen (rendition)          */
255   text_t        **buf_text;
256   rend_t        **buf_rend;
257   char           *tabs;         /* per location: 1 == tab-stop               */
258   screen_t        screen;
259   screen_t        swap;
260   selection_t     selection;
261   sstyle_t        selection_style;
262 };
263
264 void rxvt_init_signals ();
265 rxvt_t rxvt_init (int argc, const char *const *argv);
266
267 #endif                          /* _RXVTLIB_H_ */
268