4 Copyright (C) 1999-2000 Timo Sirainen
6 This program is free software; you can redistribute it and/or modify
7 it under the terms of the GNU General Public License as published by
8 the Free Software Foundation; either version 2 of the License, or
9 (at your option) any later version.
11 This program is distributed in the hope that it will be useful,
12 but WITHOUT ANY WARRANTY; without even the implied warranty of
13 MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE. See the
14 GNU General Public License for more details.
16 You should have received a copy of the GNU General Public License
17 along with this program; if not, write to the Free Software
18 Foundation, Inc., 59 Temple Place, Suite 330, Boston, MA 02111-1307 USA
22 #include "module-formats.h"
24 #include "special-vars.h"
30 #include "fe-windows.h"
31 #include "window-items.h"
34 #include "translation.h"
36 static const char *format_backs = "04261537";
37 static const char *format_fores = "kbgcrmyw";
38 static const char *format_boldfores = "KBGCRMYW";
40 static int signal_gui_print_text;
41 static int hide_text_style, hide_server_tags, hide_mirc_colors;
43 static int timestamp_level;
44 static int timestamp_timeout;
46 int format_find_tag(const char *module, const char *tag)
51 formats = g_hash_table_lookup(default_formats, module);
55 for (n = 0; formats[n].def != NULL; n++) {
56 if (formats[n].tag != NULL &&
57 g_strcasecmp(formats[n].tag, tag) == 0)
64 static void format_expand_code(const char **format, GString *out, int *flags)
69 /* flags are being ignored - skip the code */
70 while (**format != ']')
77 while (**format != ']' && **format != '\0') {
80 else if (**format == '-')
82 else switch (**format) {
89 g_string_append_c(out, 4);
90 g_string_append_c(out, FORMAT_STYLE_INDENT_FUNC);
91 while (**format != ']' && **format != '\0' &&
93 g_string_append_c(out, **format);
96 g_string_append_c(out, ',');
101 *flags |= !set ? PRINT_FLAG_UNSET_LINE_START :
102 **format == 's' ? PRINT_FLAG_SET_LINE_START :
103 PRINT_FLAG_SET_LINE_START_IRSSI;
106 *flags |= set ? PRINT_FLAG_SET_TIMESTAMP :
107 PRINT_FLAG_UNSET_TIMESTAMP;
110 *flags |= set ? PRINT_FLAG_SET_SERVERTAG :
111 PRINT_FLAG_UNSET_SERVERTAG;
119 int format_expand_styles(GString *out, const char **format, int *flags)
129 g_string_append_c(out, fmt);
132 /* Underline on/off */
133 g_string_append_c(out, 4);
134 g_string_append_c(out, FORMAT_STYLE_UNDERLINE);
139 g_string_append_c(out, 4);
140 g_string_append_c(out, FORMAT_STYLE_BOLD);
144 g_string_append_c(out, 4);
145 g_string_append_c(out, FORMAT_STYLE_REVERSE);
149 g_string_append_c(out, '\n');
153 g_string_append_c(out, 4);
154 g_string_append_c(out, FORMAT_STYLE_INDENT);
158 g_string_append_c(out, 4);
159 g_string_append_c(out, FORMAT_STYLE_BLINK);
164 g_string_append_c(out, 4);
165 g_string_append_c(out, FORMAT_STYLE_DEFAULTS);
168 /* clear to end of line */
169 g_string_append_c(out, 4);
170 g_string_append_c(out, FORMAT_STYLE_CLRTOEOL);
173 g_string_append_c(out, 4);
174 g_string_append_c(out, FORMAT_STYLE_MONOSPACE);
178 format_expand_code(format, out, flags);
181 /* check if it's a background color */
182 p = strchr(format_backs, fmt);
184 g_string_append_c(out, 4);
185 g_string_append_c(out, FORMAT_COLOR_NOCHANGE);
186 g_string_append_c(out, (char) ((int) (p-format_backs)+'0'));
190 /* check if it's a foreground color */
191 if (fmt == 'p') fmt = 'm';
192 p = strchr(format_fores, fmt);
194 g_string_append_c(out, 4);
195 g_string_append_c(out, (char) ((int) (p-format_fores)+'0'));
196 g_string_append_c(out, FORMAT_COLOR_NOCHANGE);
200 /* check if it's a bold foreground color */
201 if (fmt == 'P') fmt = 'M';
202 p = strchr(format_boldfores, fmt);
204 g_string_append_c(out, 4);
205 g_string_append_c(out, (char) (8+(int) (p-format_boldfores)+'0'));
206 g_string_append_c(out, FORMAT_COLOR_NOCHANGE);
216 void format_read_arglist(va_list va, FORMAT_REC *format,
217 char **arglist, int arglist_size,
218 char *buffer, int buffer_size)
220 int num, len, bufpos;
222 g_return_if_fail(format->params < arglist_size);
225 arglist[format->params] = NULL;
226 for (num = 0; num < format->params; num++) {
227 switch (format->paramtypes[num]) {
229 arglist[num] = (char *) va_arg(va, char *);
230 if (arglist[num] == NULL) {
231 g_warning("format_read_arglist(%s) : parameter %d is NULL", format->tag, num);
236 int d = (int) va_arg(va, int);
238 if (bufpos >= buffer_size) {
243 arglist[num] = buffer+bufpos;
244 len = g_snprintf(buffer+bufpos, buffer_size-bufpos,
250 long l = (long) va_arg(va, long);
252 if (bufpos >= buffer_size) {
257 arglist[num] = buffer+bufpos;
258 len = g_snprintf(buffer+bufpos, buffer_size-bufpos,
264 double f = (double) va_arg(va, double);
266 if (bufpos >= buffer_size) {
271 arglist[num] = buffer+bufpos;
272 len = g_snprintf(buffer+bufpos, buffer_size-bufpos,
281 void format_create_dest(TEXT_DEST_REC *dest,
282 void *server, const char *target,
283 int level, WINDOW_REC *window)
285 format_create_dest_tag(dest, server, NULL, target, level, window);
288 void format_create_dest_tag(TEXT_DEST_REC *dest, void *server,
289 const char *server_tag, const char *target,
290 int level, WINDOW_REC *window)
292 memset(dest, 0, sizeof(TEXT_DEST_REC));
294 dest->server = server;
295 dest->server_tag = server != NULL ? SERVER(server)->tag : server_tag;
296 dest->target = target;
298 dest->window = window != NULL ? window :
299 window_find_closest(server, target, level);
302 /* Return length of text part in string (ie. without % codes) */
303 int format_get_length(const char *str)
308 g_return_val_if_fail(str != NULL, 0);
310 tmp = g_string_new(NULL);
312 while (*str != '\0') {
313 if (*str == '%' && str[1] != '\0') {
316 format_expand_styles(tmp, &str, NULL)) {
321 /* %% or unknown %code, written as-is */
330 g_string_free(tmp, TRUE);
334 /* Return how many characters in `str' must be skipped before `len'
335 characters of text is skipped. Like strip_real_length(), except this
337 int format_real_length(const char *str, int len)
342 g_return_val_if_fail(str != NULL, 0);
343 g_return_val_if_fail(len >= 0, 0);
346 tmp = g_string_new(NULL);
347 while (*str != '\0' && len > 0) {
348 if (*str == '%' && str[1] != '\0') {
351 format_expand_styles(tmp, &str, NULL)) {
356 /* %% or unknown %code, written as-is */
367 g_string_free(tmp, TRUE);
368 return (int) (str-start);
371 char *format_string_expand(const char *text, int *flags)
376 g_return_val_if_fail(text != NULL, NULL);
378 out = g_string_new(NULL);
380 if (flags != NULL) *flags = 0;
382 while (*text != '\0') {
385 if (!format_expand_styles(out, &text, flags)) {
386 g_string_append_c(out, '%');
387 g_string_append_c(out, '%');
388 g_string_append_c(out, *text);
395 g_string_append_c(out, *text);
402 g_string_free(out, FALSE);
406 static char *format_get_text_args(TEXT_DEST_REC *dest,
407 const char *text, char **arglist)
413 out = g_string_new(NULL);
416 while (*text != '\0') {
419 if (!format_expand_styles(out, &text, &dest->flags)) {
420 g_string_append_c(out, '%');
421 g_string_append_c(out, '%');
422 g_string_append_c(out, *text);
425 } else if (code == '$') {
429 ret = parse_special((char **) &text, dest->server,
430 dest->target == NULL ? NULL :
431 window_item_find(dest->server, dest->target),
432 arglist, &need_free, NULL, 0);
435 /* string shouldn't end with \003 or it could
436 mess up the next one or two characters */
438 int len = strlen(ret);
439 while (len > 0 && ret[len-1] == 3) len--;
440 diff = strlen(ret)-len;
442 g_string_append(out, ret);
444 g_string_truncate(out, out->len-diff);
445 if (need_free) g_free(ret);
449 if (*text == '%' || *text == '$')
452 g_string_append_c(out, *text);
459 g_string_free(out, FALSE);
463 char *format_get_text_theme(THEME_REC *theme, const char *module,
464 TEXT_DEST_REC *dest, int formatnum, ...)
470 theme = window_get_theme(dest->window);
472 va_start(va, formatnum);
473 str = format_get_text_theme_args(theme, module, dest, formatnum, va);
479 char *format_get_text_theme_args(THEME_REC *theme, const char *module,
480 TEXT_DEST_REC *dest, int formatnum,
483 char *arglist[MAX_FORMAT_PARAMS];
484 char buffer[DEFAULT_FORMAT_ARGLIST_SIZE];
487 formats = g_hash_table_lookup(default_formats, module);
488 format_read_arglist(va, &formats[formatnum],
489 arglist, sizeof(arglist)/sizeof(char *),
490 buffer, sizeof(buffer));
492 return format_get_text_theme_charargs(theme, module, dest,
496 char *format_get_text_theme_charargs(THEME_REC *theme, const char *module,
497 TEXT_DEST_REC *dest, int formatnum,
500 MODULE_THEME_REC *module_theme;
503 module_theme = g_hash_table_lookup(theme->modules, module);
504 if (module_theme == NULL)
507 text = module_theme->expanded_formats[formatnum];
508 return format_get_text_args(dest, text, args);
511 char *format_get_text(const char *module, WINDOW_REC *window,
512 void *server, const char *target,
520 format_create_dest(&dest, server, target, 0, window);
521 theme = window_get_theme(dest.window);
523 va_start(va, formatnum);
524 str = format_get_text_theme_args(theme, module, &dest, formatnum, va);
530 /* add `linestart' to start of each line in `text'. `text' may contain
531 multiple lines separated with \n. */
532 char *format_add_linestart(const char *text, const char *linestart)
537 if (linestart == NULL)
538 return g_strdup(text);
540 if (strchr(text, '\n') == NULL)
541 return g_strconcat(linestart, text, NULL);
543 str = g_string_new(linestart);
544 while (*text != '\0') {
545 g_string_append_c(str, *text);
547 g_string_append(str, linestart);
552 g_string_free(str, FALSE);
556 char *format_add_lineend(const char *text, const char *linestart)
561 if (linestart == NULL)
562 return g_strdup(text);
564 if (strchr(text, '\n') == NULL)
565 return g_strconcat(text, linestart, NULL);
567 str = g_string_new(NULL);
568 while (*text != '\0') {
570 g_string_append(str, linestart);
571 g_string_append_c(str, *text);
574 g_string_append(str, linestart);
577 g_string_free(str, FALSE);
581 #define LINE_START_IRSSI_LEVEL \
582 (MSGLEVEL_CLIENTERROR | MSGLEVEL_CLIENTNOTICE)
584 #define NOT_LINE_START_LEVEL \
585 (MSGLEVEL_NEVER | MSGLEVEL_LASTLOG | MSGLEVEL_CLIENTCRAP | \
586 MSGLEVEL_MSGS | MSGLEVEL_PUBLIC | MSGLEVEL_DCC | MSGLEVEL_DCCMSGS | \
587 MSGLEVEL_ACTIONS | MSGLEVEL_NOTICES | MSGLEVEL_SNOTES | MSGLEVEL_CTCPS)
589 /* return the "-!- " text at the start of the line */
590 char *format_get_level_tag(THEME_REC *theme, TEXT_DEST_REC *dest)
594 /* check for flags if we want to override defaults */
595 if (dest->flags & PRINT_FLAG_UNSET_LINE_START)
598 if (dest->flags & PRINT_FLAG_SET_LINE_START)
599 format = TXT_LINE_START;
600 else if (dest->flags & PRINT_FLAG_SET_LINE_START_IRSSI)
601 format = TXT_LINE_START_IRSSI;
604 if (dest->level & LINE_START_IRSSI_LEVEL)
605 format = TXT_LINE_START_IRSSI;
606 else if ((dest->level & NOT_LINE_START_LEVEL) == 0)
607 format = TXT_LINE_START;
612 return format_get_text_theme(theme, MODULE_NAME, dest, format);
615 static char *get_timestamp(THEME_REC *theme, TEXT_DEST_REC *dest, time_t t)
617 char *format, str[256];
621 if ((timestamp_level & dest->level) == 0)
624 /* check for flags if we want to override defaults */
625 if (dest->flags & PRINT_FLAG_UNSET_TIMESTAMP)
628 if ((dest->flags & PRINT_FLAG_SET_TIMESTAMP) == 0 &&
629 (dest->level & (MSGLEVEL_NEVER|MSGLEVEL_LASTLOG)) != 0)
633 if (timestamp_timeout > 0) {
634 diff = t - dest->window->last_timestamp;
635 dest->window->last_timestamp = t;
636 if (diff < timestamp_timeout)
641 format = format_get_text_theme(theme, MODULE_NAME, dest,
643 if (strftime(str, sizeof(str), format, tm) <= 0)
646 return g_strdup(str);
649 static char *get_server_tag(THEME_REC *theme, TEXT_DEST_REC *dest)
653 if (dest->server_tag == NULL || hide_server_tags)
656 /* check for flags if we want to override defaults */
657 if (dest->flags & PRINT_FLAG_UNSET_SERVERTAG)
660 if ((dest->flags & PRINT_FLAG_SET_SERVERTAG) == 0) {
661 if (dest->window->active != NULL &&
662 dest->window->active->server == dest->server)
665 if (servers != NULL) {
667 if (servers->next != NULL)
670 if (count < 2 && lookup_servers != NULL) {
672 if (lookup_servers->next != NULL)
680 return format_get_text_theme(theme, MODULE_NAME, dest,
681 TXT_SERVERTAG, dest->server_tag);
684 char *format_get_line_start(THEME_REC *theme, TEXT_DEST_REC *dest, time_t t)
686 char *timestamp, *servertag;
689 timestamp = get_timestamp(theme, dest, t);
690 servertag = get_server_tag(theme, dest);
692 if (timestamp == NULL && servertag == NULL)
695 linestart = g_strconcat(timestamp != NULL ? timestamp : "",
698 g_free_not_null(timestamp);
699 g_free_not_null(servertag);
703 void format_newline(WINDOW_REC *window)
705 g_return_if_fail(window != NULL);
707 signal_emit_id(signal_gui_print_text, 6, window,
708 GINT_TO_POINTER(-1), GINT_TO_POINTER(-1),
709 GINT_TO_POINTER(GUI_PRINT_FLAG_NEWLINE),
713 /* parse ANSI color string */
714 static const char *get_ansi_color(THEME_REC *theme, const char *str,
715 int *fg_ret, int *bg_ret, int *flags_ret)
717 static char ansitab[8] = { 0, 4, 2, 6, 1, 5, 3, 7 };
719 int fg, bg, flags, num;
725 fg = fg_ret == NULL || *fg_ret < 0 ? theme->default_color : *fg_ret;
726 bg = bg_ret == NULL || *bg_ret < 0 ? -1 : *bg_ret;
727 flags = flags_ret == NULL ? 0 : *flags_ret;
731 if (*str == '\0') return start;
733 if (i_isdigit(*str)) {
734 num = num*10 + (*str-'0');
738 if (*str != ';' && *str != 'm')
743 /* reset colors back to default */
744 fg = theme->default_color;
746 flags &= ~GUI_PRINT_FLAG_INDENT;
750 flags |= GUI_PRINT_FLAG_BOLD;
754 flags |= GUI_PRINT_FLAG_BLINK;
758 flags |= GUI_PRINT_FLAG_REVERSE;
761 if (num >= 30 && num <= 37) {
762 if (fg == -1) fg = 0;
763 fg = (fg & 0xf8) | ansitab[num-30];
765 if (num >= 40 && num <= 47) {
766 if (bg == -1) bg = 0;
767 bg = (bg & 0xf8) | ansitab[num-40];
774 if (fg_ret != NULL) *fg_ret = fg;
775 if (bg_ret != NULL) *bg_ret = bg;
776 if (flags_ret != NULL) *flags_ret = flags;
786 /* parse MIRC color string */
787 static void get_mirc_color(const char **str, int *fg_ret, int *bg_ret)
791 fg = fg_ret == NULL ? -1 : *fg_ret;
792 bg = bg_ret == NULL ? -1 : *bg_ret;
794 if (!i_isdigit(**str) && **str != ',') {
798 /* foreground color */
802 if (i_isdigit(**str)) {
803 fg = fg*10 + (**str-'0');
808 /* background color */
810 if (!i_isdigit(**str))
815 if (i_isdigit(**str)) {
816 bg = bg*10 + (**str-'0');
823 if (fg_ret) *fg_ret = fg;
824 if (bg_ret) *bg_ret = bg;
827 #define IS_COLOR_CODE(c) \
828 ((c) == 2 || (c) == 3 || (c) == 4 || (c) == 6 || (c) == 7 || \
829 (c) == 15 || (c) == 22 || (c) == 27 || (c) == 31)
831 /* Return how many characters in `str' must be skipped before `len'
832 characters of text is skipped. */
833 int strip_real_length(const char *str, int len,
834 int *last_color_pos, int *last_color_len)
836 const char *start = str;
838 if (last_color_pos != NULL)
839 *last_color_pos = -1;
840 if (last_color_len != NULL)
841 *last_color_len = -1;
843 while (*str != '\0') {
845 const char *mircstart = str;
847 if (last_color_pos != NULL)
848 *last_color_pos = (int) (str-start);
850 get_mirc_color(&str, NULL, NULL);
851 if (last_color_len != NULL)
852 *last_color_len = (int) (str-mircstart);
854 } else if (*str == 4 && str[1] != '\0') {
855 if (str[1] < FORMAT_STYLE_SPECIAL && str[2] != '\0') {
856 if (last_color_pos != NULL)
857 *last_color_pos = (int) (str-start);
858 if (last_color_len != NULL)
861 } else if (str[1] == FORMAT_STYLE_DEFAULTS) {
862 if (last_color_pos != NULL)
863 *last_color_pos = (int) (str-start);
864 if (last_color_len != NULL)
869 if (!IS_COLOR_CODE(*str)) {
877 return (int) (str-start);
880 char *strip_codes(const char *input)
885 out = str = g_strdup(input);
886 for (p = input; *p != '\0'; p++) {
891 get_mirc_color(&p, NULL, NULL);
896 if (*p == 4 && p[1] != '\0') {
897 if (p[1] >= FORMAT_STYLE_SPECIAL) {
909 if (*p == 27 && p[1] != '\0') {
911 p = get_ansi_color(current_theme, p, NULL, NULL, NULL);
914 if (!IS_COLOR_CODE(*p))
922 /* send a fully parsed text string for GUI to print */
923 void format_send_to_gui(TEXT_DEST_REC *dest, const char *text)
926 char *dup, *str, *ptr, type;
927 int fgcolor, bgcolor;
930 theme = dest->window != NULL && dest->window->theme != NULL ?
931 dest->window->theme : current_theme;
933 dup = str = g_strdup(text);
935 flags = 0; fgcolor = theme->default_color; bgcolor = -1;
936 while (*str != '\0') {
938 for (ptr = str; *ptr != '\0'; ptr++) {
939 if (IS_COLOR_CODE(*ptr) || *ptr == '\n') {
945 *ptr = (char) translation_in[(int) (unsigned char) *ptr];
950 if (settings_get_bool("bell_beeps"))
951 signal_emit("beep", 0);
952 } else if (type == 4 && *ptr == FORMAT_STYLE_CLRTOEOL) {
953 /* clear to end of line */
954 flags |= GUI_PRINT_FLAG_CLRTOEOL;
957 if (*str != '\0' || (flags & GUI_PRINT_FLAG_CLRTOEOL)) {
958 /* send the text to gui handler */
959 signal_emit_id(signal_gui_print_text, 6, dest->window,
960 GINT_TO_POINTER(fgcolor),
961 GINT_TO_POINTER(bgcolor),
962 GINT_TO_POINTER(flags), str,
964 flags &= ~(GUI_PRINT_FLAG_INDENT|GUI_PRINT_FLAG_CLRTOEOL);
968 format_newline(dest->window);
977 if (!hide_text_style)
978 flags ^= GUI_PRINT_FLAG_BOLD;
982 get_mirc_color((const char **) &ptr,
983 hide_mirc_colors || hide_text_style ? NULL : &fgcolor,
984 hide_mirc_colors || hide_text_style ? NULL : &bgcolor);
985 if (!hide_mirc_colors && !hide_text_style)
986 flags |= GUI_PRINT_FLAG_MIRC_COLOR;
989 /* user specific colors */
990 flags &= ~GUI_PRINT_FLAG_MIRC_COLOR;
992 case FORMAT_STYLE_BLINK:
993 flags ^= GUI_PRINT_FLAG_BLINK;
995 case FORMAT_STYLE_UNDERLINE:
996 flags ^= GUI_PRINT_FLAG_UNDERLINE;
998 case FORMAT_STYLE_BOLD:
999 flags ^= GUI_PRINT_FLAG_BOLD;
1001 case FORMAT_STYLE_REVERSE:
1002 flags ^= GUI_PRINT_FLAG_REVERSE;
1004 case FORMAT_STYLE_MONOSPACE:
1005 flags ^= GUI_PRINT_FLAG_MONOSPACE;
1007 case FORMAT_STYLE_INDENT:
1008 flags |= GUI_PRINT_FLAG_INDENT;
1010 case FORMAT_STYLE_INDENT_FUNC: {
1011 const char *start = ptr;
1012 while (*ptr != ',' && *ptr != '\0')
1014 if (*ptr != '\0') *ptr++ = '\0';
1016 signal_emit_id(signal_gui_print_text, 6,
1017 dest->window, NULL, NULL,
1018 GINT_TO_POINTER(GUI_PRINT_FLAG_INDENT_FUNC),
1022 case FORMAT_STYLE_DEFAULTS:
1023 fgcolor = theme->default_color;
1025 flags &= GUI_PRINT_FLAG_INDENT|GUI_PRINT_FLAG_MONOSPACE;
1027 case FORMAT_STYLE_CLRTOEOL:
1030 if (*ptr != FORMAT_COLOR_NOCHANGE) {
1031 fgcolor = (unsigned char) *ptr-'0';
1033 flags &= ~GUI_PRINT_FLAG_BOLD;
1036 if (fgcolor != 8) fgcolor -= 8;
1037 flags |= GUI_PRINT_FLAG_BOLD;
1044 if (*ptr != FORMAT_COLOR_NOCHANGE) {
1047 flags &= ~GUI_PRINT_FLAG_BLINK;
1051 flags |= GUI_PRINT_FLAG_BLINK;
1059 if (!hide_text_style)
1060 flags ^= GUI_PRINT_FLAG_BLINK;
1063 /* remove all styling */
1064 fgcolor = theme->default_color;
1066 flags &= GUI_PRINT_FLAG_INDENT|GUI_PRINT_FLAG_MONOSPACE;
1070 if (!hide_text_style)
1071 flags ^= GUI_PRINT_FLAG_REVERSE;
1075 if (!hide_text_style)
1076 flags ^= GUI_PRINT_FLAG_UNDERLINE;
1079 /* ansi color code */
1081 get_ansi_color(theme, ptr,
1082 hide_text_style ? NULL : &fgcolor,
1083 hide_text_style ? NULL : &bgcolor,
1084 hide_text_style ? NULL : &flags);
1094 static void read_settings(void)
1096 timestamp_level = settings_get_bool("timestamps") ? MSGLEVEL_ALL : 0;
1097 if (timestamp_level > 0) {
1099 level2bits(settings_get_str("timestamp_level"));
1101 timestamp_timeout = settings_get_int("timestamp_timeout");
1103 hide_server_tags = settings_get_bool("hide_server_tags");
1104 hide_text_style = settings_get_bool("hide_text_style");
1105 hide_mirc_colors = settings_get_bool("hide_mirc_colors");
1108 void formats_init(void)
1110 signal_gui_print_text = signal_get_uniq_id("gui print text");
1113 signal_add("setup changed", (SIGNAL_FUNC) read_settings);
1116 void formats_deinit(void)
1118 signal_remove("setup changed", (SIGNAL_FUNC) read_settings);