1
2
3
4
5
6
7
8
9
10
11
12
13
14
15
16
17
18
19
20
21
22
23
24
25
26
27
28
29
30
31
32
33
34
35
36
37
38
39
40
41
42
43
44
45
46
47
48
49
50
51
52
53
54
55
56
57
58
59
60
61
62
63
64
65
66
67
68
69
70
71
72
73
74
75
76
77
78
79
80
81
82
83
84
85
86
87
88
89
90
91
92
93
94
95
96
97
98
99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
123
124
125
126
127
128
129
130
131
132
133
134
135
136
137
138
139
140
141
142
143
144
145
146
147
148
|
/*
* Asterisk -- An open source telephony toolkit.
*
* Copyright (C) 1999 - 2005, Digium, Inc.
*
* Mark Spencer <markster@digium.com>
*
* See http://www.asterisk.org for more information about
* the Asterisk project. Please do not directly contact
* any of the maintainers of this project for assistance;
* the project provides a web site, mailing lists and IRC
* channels for your use.
*
* This program is free software, distributed under the terms of
* the GNU General Public License Version 2. See the LICENSE file
* at the top of the source tree.
*/
/*! \file
* \brief Handy terminal functions for vt* terms
*/
#ifndef _ASTERISK_TERM_H
#define _ASTERISK_TERM_H
#if defined(__cplusplus) || defined(c_plusplus)
extern "C" {
#endif
#define ESC 0x1b
/*! \name Terminal Attributes
*/
/*@{ */
#define ATTR_RESET 0
#define ATTR_BRIGHT 1
#define ATTR_DIM 2
#define ATTR_UNDER 4
#define ATTR_BLINK 5
#define ATTR_REVER 7
#define ATTR_HIDDEN 8
/*@} */
/*! \name Terminal Colors
*/
/*@{ */
#define COLOR_BLACK 30
#define COLOR_GRAY (30 | 128)
#define COLOR_RED 31
#define COLOR_BRRED (31 | 128)
#define COLOR_GREEN 32
#define COLOR_BRGREEN (32 | 128)
#define COLOR_BROWN 33
#define COLOR_YELLOW (33 | 128)
#define COLOR_BLUE 34
#define COLOR_BRBLUE (34 | 128)
#define COLOR_MAGENTA 35
#define COLOR_BRMAGENTA (35 | 128)
#define COLOR_CYAN 36
#define COLOR_BRCYAN (36 | 128)
#define COLOR_WHITE 37
#define COLOR_BRWHITE (37 | 128)
/*@} */
/*! \brief Shortcut macros for coloring a set of text
*/
#define COLORIZE_FMT "%s%s%s"
#define COLORIZE(fg, bg, str) ast_term_color(fg,bg),str,ast_term_reset()
/*! \brief Maximum number of characters needed for a color escape sequence,
* and another one for a trailing reset, plus a null char */
#define AST_TERM_MAX_ESCAPE_CHARS 23
#define AST_TERM_MAX_ROTATING_BUFFERS 15
/*! \brief Colorize a specified string by adding terminal color codes
*
* \param outbuf Result buffer
* \param inbuf Starting string
* \param fgcolor Foreground color, specified as one of the constants in include/asterisk/term.h. Use '0' if the want the normal terminal foreground color.
* \param bgcolor Background color, specified as one of the constants in include/asterisk/term.h. Use '0' if you want the normal terminal background color.
* \param maxout Maximum size of outbuf
*
* \return outbuf
*
* \deprecated Due to the necessity of pre-sizing a result buffer, new code should avoid using this function in preference to ast_term_color_code() or ast_term_color().
*/
char *term_color(char *outbuf, const char *inbuf, int fgcolor, int bgcolor, int maxout);
/*!
* \brief Append a color sequence to an ast_str
*
* \param str The string to append to
* \param fgcolor foreground color
* \param bgcolor background color
*
* \retval 0 success
* \retval -1 failure
*/
int ast_term_color_code(struct ast_str **str, int fgcolor, int bgcolor);
/*!
* \brief Return a color sequence string
* \param fgcolor foreground color
* \param bgcolor background color
* \note This function may be called up to 15 times within the arguments to a single function without the danger of overwriting a common buffer.
*
* \return A color sequence string, or the empty string, on error
*/
const char *ast_term_color(int fgcolor, int bgcolor);
/*!
* \brief Returns the terminal reset code
* \return String which, when sent to the screen, resets the terminal colors
*/
const char *ast_term_reset(void);
/*!
* \brief Write a color sequence to a string
*
* \param outbuf the location to write to
* \param fgcolor foreground color
* \param bgcolor background color
* \param maxout maximum number of characters to write
* \deprecated You should use ast_term_color_code or ast_term_color, instead.
*
* \return outbuf
*/
char *term_color_code(char *outbuf, int fgcolor, int bgcolor, int maxout);
/*!
* \brief Remove colorings from a specified string
* \param outbuf the location to write to
* \param inbuf the original string
* \param maxout the available size of outbuf
* \return outbuf
*/
char *term_strip(char *outbuf, const char *inbuf, int maxout);
void term_filter_escapes(char *line);
const char *term_end(void);
const char *term_quit(void);
#if defined(__cplusplus) || defined(c_plusplus)
}
#endif
#endif /* _ASTERISK_TERM_H */
|
