sys/teken/teken.h

   1 /*-
   2  * Copyright (c) 2008-2009 Ed Schouten <ed@FreeBSD.org>
   3  * All rights reserved.
   4  *
   5  * Redistribution and use in source and binary forms, with or without
   6  * modification, are permitted provided that the following conditions
   7  * are met:
   8  * 1. Redistributions of source code must retain the above copyright
   9  *    notice, this list of conditions and the following disclaimer.
  10  * 2. Redistributions in binary form must reproduce the above copyright
  11  *    notice, this list of conditions and the following disclaimer in the
  12  *    documentation and/or other materials provided with the distribution.
  13  *
  14  * THIS SOFTWARE IS PROVIDED BY THE AUTHOR AND CONTRIBUTORS ``AS IS'' AND
  15  * ANY EXPRESS OR IMPLIED WARRANTIES, INCLUDING, BUT NOT LIMITED TO, THE
  16  * IMPLIED WARRANTIES OF MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE
  17  * ARE DISCLAIMED.  IN NO EVENT SHALL THE AUTHOR OR CONTRIBUTORS BE LIABLE
  18  * FOR ANY DIRECT, INDIRECT, INCIDENTAL, SPECIAL, EXEMPLARY, OR CONSEQUENTIAL
  19  * DAMAGES (INCLUDING, BUT NOT LIMITED TO, PROCUREMENT OF SUBSTITUTE GOODS
  20  * OR SERVICES; LOSS OF USE, DATA, OR PROFITS; OR BUSINESS INTERRUPTION)
  21  * HOWEVER CAUSED AND ON ANY THEORY OF LIABILITY, WHETHER IN CONTRACT, STRICT
  22  * LIABILITY, OR TORT (INCLUDING NEGLIGENCE OR OTHERWISE) ARISING IN ANY WAY
  23  * OUT OF THE USE OF THIS SOFTWARE, EVEN IF ADVISED OF THE POSSIBILITY OF
  24  * SUCH DAMAGE.
  25  *
  26  * $FreeBSD$
  27  */
  28
  29 #ifndef _TEKEN_H_
  30 #define _TEKEN_H_
  31
  32 /*
  33  * libteken: terminal emulation library.
  34  *
  35  * This library converts an UTF-8 stream of bytes to terminal drawing
  36  * commands.
  37  */
  38
  39 typedef uint32_t teken_char_t;
  40 typedef unsigned short teken_unit_t;
  41 typedef unsigned char teken_format_t;
  42 #define TF_BOLD         0x01
  43 #define TF_UNDERLINE    0x02
  44 #define TF_BLINK        0x04
  45 #define TF_REVERSE      0x08
  46 typedef unsigned char teken_color_t;
  47 #define TC_BLACK        0
  48 #define TC_RED          1
  49 #define TC_GREEN        2
  50 #define TC_BROWN        3
  51 #define TC_BLUE         4
  52 #define TC_MAGENTA      5
  53 #define TC_CYAN         6
  54 #define TC_WHITE        7
  55 #define TC_NCOLORS      8
  56
  57 typedef struct {
  58         teken_unit_t    tp_row;
  59         teken_unit_t    tp_col;
  60 } teken_pos_t;
  61 typedef struct {
  62         teken_pos_t     tr_begin;
  63         teken_pos_t     tr_end;
  64 } teken_rect_t;
  65 typedef struct {
  66         teken_format_t  ta_format;
  67         teken_color_t   ta_fgcolor;
  68         teken_color_t   ta_bgcolor;
  69 } teken_attr_t;
  70 typedef struct {
  71         teken_unit_t    ts_begin;
  72         teken_unit_t    ts_end;
  73 } teken_span_t;
  74
  75 typedef struct __teken teken_t;
  76
  77 typedef void teken_state_t(teken_t *, teken_char_t);
  78
  79 /*
  80  * Drawing routines supplied by the user.
  81  */
  82
  83 typedef void tf_bell_t(void *);
  84 typedef void tf_cursor_t(void *, const teken_pos_t *);
  85 typedef void tf_putchar_t(void *, const teken_pos_t *, teken_char_t,
  86     const teken_attr_t *);
  87 typedef void tf_fill_t(void *, const teken_rect_t *, teken_char_t,
  88     const teken_attr_t *);
  89 typedef void tf_copy_t(void *, const teken_rect_t *, const teken_pos_t *);
  90 typedef void tf_param_t(void *, int, unsigned int);
  91 #define TP_SHOWCURSOR   0
  92 #define TP_KEYPADAPP    1
  93 #define TP_AUTOREPEAT   2
  94 #define TP_SWITCHVT     3
  95 #define TP_132COLS      4
  96 #define TP_SETBELLPD    5
  97 #define TP_SETBELLPD_PITCH(pd)          ((pd) >> 16)
  98 #define TP_SETBELLPD_DURATION(pd)       ((pd) & 0xffff)
  99 #define TP_MOUSE        6
 100 typedef void tf_respond_t(void *, const void *, size_t);
 101
 102 typedef struct {
 103         tf_bell_t       *tf_bell;
 104         tf_cursor_t     *tf_cursor;
 105         tf_putchar_t    *tf_putchar;
 106         tf_fill_t       *tf_fill;
 107         tf_copy_t       *tf_copy;
 108         tf_param_t      *tf_param;
 109         tf_respond_t    *tf_respond;
 110 } teken_funcs_t;
 111
 112 typedef teken_char_t teken_scs_t(teken_t *, teken_char_t);
 113
 114 /*
 115  * Terminal state.
 116  */
 117
 118 struct __teken {
 119         const teken_funcs_t *t_funcs;
 120         void            *t_softc;
 121
 122         teken_state_t   *t_nextstate;
 123         unsigned int     t_stateflags;
 124
 125 #define T_NUMSIZE       8
 126         unsigned int     t_nums[T_NUMSIZE];
 127         unsigned int     t_curnum;
 128
 129         teken_pos_t      t_cursor;
 130         teken_attr_t     t_curattr;
 131         teken_pos_t      t_saved_cursor;
 132         teken_attr_t     t_saved_curattr;
 133
 134         teken_attr_t     t_defattr;
 135         teken_pos_t      t_winsize;
 136
 137         /* For DECSTBM. */
 138         teken_span_t     t_scrollreg;
 139         /* For DECOM. */
 140         teken_span_t     t_originreg;
 141
 142 #define T_NUMCOL        160
 143         unsigned int     t_tabstops[T_NUMCOL / (sizeof(unsigned int) * 8)];
 144
 145         unsigned int     t_utf8_left;
 146         teken_char_t     t_utf8_partial;
 147
 148         unsigned int     t_curscs;
 149         teken_scs_t     *t_saved_curscs;
 150         teken_scs_t     *t_scs[2];
 151 };
 152
 153 /* Initialize teken structure. */
 154 void    teken_init(teken_t *, const teken_funcs_t *, void *);
 155
 156 /* Deliver character input. */
 157 void    teken_input(teken_t *, const void *, size_t);
 158
 159 /* Get/set teken attributes. */
 160 const teken_pos_t *teken_get_cursor(teken_t *);
 161 const teken_attr_t *teken_get_curattr(teken_t *);
 162 const teken_attr_t *teken_get_defattr(teken_t *);
 163 void    teken_get_defattr_cons25(teken_t *, int *, int *);
 164 const teken_pos_t *teken_get_winsize(teken_t *);
 165 void    teken_set_cursor(teken_t *, const teken_pos_t *);
 166 void    teken_set_curattr(teken_t *, const teken_attr_t *);
 167 void    teken_set_defattr(teken_t *, const teken_attr_t *);
 168 void    teken_set_winsize(teken_t *, const teken_pos_t *);
 169
 170 /* Key input escape sequences. */
 171 #define TKEY_UP         0x00
 172 #define TKEY_DOWN       0x01
 173 #define TKEY_LEFT       0x02
 174 #define TKEY_RIGHT      0x03
 175
 176 #define TKEY_HOME       0x04
 177 #define TKEY_END        0x05
 178 #define TKEY_INSERT     0x06
 179 #define TKEY_DELETE     0x07
 180 #define TKEY_PAGE_UP    0x08
 181 #define TKEY_PAGE_DOWN  0x09
 182
 183 #define TKEY_F1         0x0a
 184 #define TKEY_F2         0x0b
 185 #define TKEY_F3         0x0c
 186 #define TKEY_F4         0x0d
 187 #define TKEY_F5         0x0e
 188 #define TKEY_F6         0x0f
 189 #define TKEY_F7         0x10
 190 #define TKEY_F8         0x11
 191 #define TKEY_F9         0x12
 192 #define TKEY_F10        0x13
 193 #define TKEY_F11        0x14
 194 #define TKEY_F12        0x15
 195 const char *teken_get_sequence(teken_t *, unsigned int);
 196
 197 /* Legacy features. */
 198 void    teken_set_8bit(teken_t *);
 199 void    teken_set_cons25(teken_t *);
 200
 201 /* Color conversion. */
 202 teken_color_t teken_256to8(teken_color_t);
 203
 204 #endif /* !_TEKEN_H_ */