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
|
/** @file
Terminal control utility functions.
Copyright (C) 2018 Christian Zuckschwerdt
This program is free software; you can redistribute it and/or modify
it under the terms of the GNU General Public License as published by
the Free Software Foundation; either version 2 of the License, or
(at your option) any later version.
*/
#ifndef INCLUDE_TERM_CTL_H_
#define INCLUDE_TERM_CTL_H_
#include <stdio.h>
void *term_init(FILE *fp);
void term_free(void *ctx);
int term_get_columns(void *ctx);
int term_has_color(void *ctx);
void term_ring_bell(void *ctx);
typedef enum term_color {
TERM_COLOR_RESET = 0,
TERM_COLOR_BLACK = 30,
TERM_COLOR_RED = 31,
TERM_COLOR_GREEN = 32,
TERM_COLOR_YELLOW = 33,
TERM_COLOR_BLUE = 34,
TERM_COLOR_MAGENTA = 35,
TERM_COLOR_CYAN = 36,
TERM_COLOR_WHITE = 37,
TERM_COLOR_BRIGHT_BLACK = 90,
TERM_COLOR_BRIGHT_RED = 91,
TERM_COLOR_BRIGHT_GREEN = 92,
TERM_COLOR_BRIGHT_YELLOW = 93,
TERM_COLOR_BRIGHT_BLUE = 94,
TERM_COLOR_BRIGHT_MAGENTA = 95,
TERM_COLOR_BRIGHT_CYAN = 96,
TERM_COLOR_BRIGHT_WHITE = 97,
} term_color_t;
/**
* Sets the terminal text foreground color.
* Always sets the bold font attribute, except for TERM_COLOR_RESET.
*/
void term_set_fg(void *ctx, term_color_t color);
/**
* Sets the terminal background and foreground color.
* Both are optional, use `0` to omit a color.
* Must not be used for TERM_COLOR_RESET.
*/
void term_set_bg(void *ctx, term_color_t bg, term_color_t fg);
/*
* Defined in newer <sal.h> for MSVC.
*/
#ifndef _Printf_format_string_
#define _Printf_format_string_
#endif
/**
* Print to terminal with color-codes inline turned into above colors.
* Takes a var-arg format.
*
* E.g.:
*
* void *term = term_init(stdout);
* term_printf (term, "~4Hello ~2world~0.\n");
*
* will print to stdout with 'Hello' mapped to colour 4
* and 'world' mapped to colour 2. See 'term_set_color_map()' below.
*
* And a 'term_printf (NULL, "~4Hello ~2world~0.\n");'
* will print "Hello world" to stderr' with no colors.
*/
int term_printf(void *ctx, _Printf_format_string_ const char *format, ...)
#if defined(__GNUC__) || defined(__clang__)
__attribute__((format(printf, 2, 3)))
#endif
;
/**
* Print to terminal with markup turned into colors.
* Like 'term_printf()', but with automatic coloring for markup.
*
* Markup:
* = Heading =
* [option argument]
* "quoted"
* 'quoted'
*/
int term_help_fprintf(FILE *fp, _Printf_format_string_ char const *format, ...)
#if defined(__GNUC__) || defined(__clang__)
__attribute__((format(printf, 2, 3)))
#endif
;
/**
* Like 'term_printf()', but no var-arg format.
* Simply takes a 0-terminated buffer.
*/
int term_puts(void *ctx, const char *buf);
/**
* Like 'term_help_fprintf()', but no var-arg format.
* Simply takes a 0-terminated buffer.
*/
int term_help_fputs(void *ctx, const char *buf, FILE *fp);
/**
* Change the default color map.
* By default, the color-codes maps to these foreground colour:
* "~0": always restores terminal-colors; TERM_COLOR_RESET.
* "~1": print using TERM_COLOR_GREEN.
* "~2": print using TERM_COLOR_WHITE.
* "~3": print using TERM_COLOR_BLUE.
* "~4": print using TERM_COLOR_CYAN.
* "~5": print using TERM_COLOR_MAGENTA.
* "~6": print using TERM_COLOR_YELLOW.
* "~7": print using TERM_COLOR_BLACK.
* "~8": print using TERM_COLOR_RED.
*/
int term_set_color_map(int idx, term_color_t color);
/**
* Returns the current color-value ('enum term_color') for color-index.
* 'idx'. This index goes from ASCII '0' to 'X'.
* 'X' = '0' + the dimension of the internal 'color_map[]'.
*/
int term_get_color_map(int idx);
#endif /* INCLUDE_TERM_CTL_H_ */
|
