/*
 *  util.c
 *
 *  ORIGINAL AUTHOR: Savio Lam (lam836@cs.cuhk.hk)
 *  MODIFIED FOR LINUX KERNEL CONFIG BY: William Roadcap (roadcap@cfw.com)
 *
 *  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.
 *
 *  This program is distributed in the hope that it will be useful,
 *  but WITHOUT ANY WARRANTY; without even the implied warranty of
 *  MERCHANTABILITY or FITNESS FOR A PARTICULAR PURPOSE.  See the
 *  GNU General Public License for more details.
 *
 *  You should have received a copy of the GNU General Public License
 *  along with this program; if not, write to the Free Software
 *  Foundation, Inc., 675 Mass Ave, Cambridge, MA 02139, USA.
 */

#include <stdarg.h>

#include "dialog.h"

/* Needed in signal handler in mconf.c */
int saved_x, saved_y;

struct dialog_info dlg;

static void set_mono_theme(void)
{
	dlg.screen.atr = A_NORMAL;
	dlg.shadow.atr = A_NORMAL;
	dlg.dialog.atr = A_NORMAL;
	dlg.title.atr = A_BOLD;
	dlg.border.atr = A_NORMAL;
	dlg.button_active.atr = A_REVERSE;
	dlg.button_inactive.atr = A_DIM;
	dlg.button_key_active.atr = A_REVERSE;
	dlg.button_key_inactive.atr = A_BOLD;
	dlg.button_label_active.atr = A_REVERSE;
	dlg.button_label_inactive.atr = A_NORMAL;
	dlg.inputbox.atr = A_NORMAL;
	dlg.inputbox_border.atr = A_NORMAL;
	dlg.searchbox.atr = A_NORMAL;
	dlg.searchbox_title.atr = A_BOLD;
	dlg.searchbox_border.atr = A_NORMAL;
	dlg.position_indicator.atr = A_BOLD;
	dlg.menubox.atr = A_NORMAL;
	dlg.menubox_border.atr = A_NORMAL;
	dlg.item.atr = A_NORMAL;
	dlg.item_selected.atr = A_REVERSE;
	dlg.tag.atr = A_BOLD;
	dlg.tag_selected.atr = A_REVERSE;
	dlg.tag_key.atr = A_BOLD;
	dlg.tag_key_selected.atr = A_REVERSE;
	dlg.check.atr = A_BOLD;
	dlg.check_selected.atr = A_REVERSE;
	dlg.uarrow.atr = A_BOLD;
	dlg.darrow.atr = A_BOLD;
}

#define DLG_COLOR(dialog, f, b, h) \
do {                               \
	dlg.dialog.fg = (f);       \
	dlg.dialog.bg = (b);       \
	dlg.dialog.hl = (h);       \
} while (0)

static void set_classic_theme(void)
{
	DLG_COLOR(screen,                COLOR_CYAN,   COLOR_BLUE,   true);
	DLG_COLOR(shadow,                COLOR_BLACK,  COLOR_BLACK,  true);
	DLG_COLOR(dialog,                COLOR_BLACK,  COLOR_WHITE,  false);
	DLG_COLOR(title,                 COLOR_YELLOW, COLOR_WHITE,  true);
	DLG_COLOR(border,                COLOR_WHITE,  COLOR_WHITE,  true);
	DLG_COLOR(button_active,         COLOR_WHITE,  COLOR_BLUE,   true);
	DLG_COLOR(button_inactive,       COLOR_BLACK,  COLOR_WHITE,  false);
	DLG_COLOR(button_key_active,     COLOR_WHITE,  COLOR_BLUE,   true);
	DLG_COLOR(button_key_inactive,   COLOR_RED,    COLOR_WHITE,  false);
	DLG_COLOR(button_label_active,   COLOR_YELLOW, COLOR_BLUE,   true);
	DLG_COLOR(button_label_inactive, COLOR_BLACK,  COLOR_WHITE,  true);
	DLG_COLOR(inputbox,              COLOR_BLACK,  COLOR_WHITE,  false);
	DLG_COLOR(inputbox_border,       COLOR_BLACK,  COLOR_WHITE,  false);
	DLG_COLOR(searchbox,             COLOR_BLACK,  COLOR_WHITE,  false);
	DLG_COLOR(searchbox_title,       COLOR_YELLOW, COLOR_WHITE,  true);
	DLG_COLOR(searchbox_border,      COLOR_WHITE,  COLOR_WHITE,  true);
	DLG_COLOR(position_indicator,    COLOR_YELLOW, COLOR_WHITE,  true);
	DLG_COLOR(menubox,               COLOR_BLACK,  COLOR_WHITE,  false);
	DLG_COLOR(menubox_border,        COLOR_WHITE,  COLOR_WHITE,  true);
	DLG_COLOR(item,                  COLOR_BLACK,  COLOR_WHITE,  false);
	DLG_COLOR(item_selected,         COLOR_WHITE,  COLOR_BLUE,   true);
	DLG_COLOR(tag,                   COLOR_YELLOW, COLOR_WHITE,  true);
	DLG_COLOR(tag_selected,          COLOR_YELLOW, COLOR_BLUE,   true);
	DLG_COLOR(tag_key,               COLOR_YELLOW, COLOR_WHITE,  true);
	DLG_COLOR(tag_key_selected,      COLOR_YELLOW, COLOR_BLUE,   true);
	DLG_COLOR(check,                 COLOR_BLACK,  COLOR_WHITE,  false);
	DLG_COLOR(check_selected,        COLOR_WHITE,  COLOR_BLUE,   true);
	DLG_COLOR(uarrow,                COLOR_GREEN,  COLOR_WHITE,  true);
	DLG_COLOR(darrow,                COLOR_GREEN,  COLOR_WHITE,  true);
}

static void set_blackbg_theme(void)
{
	DLG_COLOR(screen, COLOR_RED,   COLOR_BLACK, true);
	DLG_COLOR(shadow, COLOR_BLACK, COLOR_BLACK, false);
	DLG_COLOR(dialog, COLOR_WHITE, COLOR_BLACK, false);
	DLG_COLOR(title,  COLOR_RED,   COLOR_BLACK, false);
	DLG_COLOR(border, COLOR_BLACK, COLOR_BLACK, true);

	DLG_COLOR(button_active,         COLOR_YELLOW, COLOR_RED,   false);
	DLG_COLOR(button_inactive,       COLOR_YELLOW, COLOR_BLACK, false);
	DLG_COLOR(button_key_active,     COLOR_YELLOW, COLOR_RED,   true);
	DLG_COLOR(button_key_inactive,   COLOR_RED,    COLOR_BLACK, false);
	DLG_COLOR(button_label_active,   COLOR_WHITE,  COLOR_RED,   false);
	DLG_COLOR(button_label_inactive, COLOR_BLACK,  COLOR_BLACK, true);

	DLG_COLOR(inputbox,         COLOR_YELLOW, COLOR_BLACK, false);
	DLG_COLOR(inputbox_border,  COLOR_YELLOW, COLOR_BLACK, false);

	DLG_COLOR(searchbox,        COLOR_YELLOW, COLOR_BLACK, false);
	DLG_COLOR(searchbox_title,  COLOR_YELLOW, COLOR_BLACK, true);
	DLG_COLOR(searchbox_border, COLOR_BLACK,  COLOR_BLACK, true);

	DLG_COLOR(position_indicator, COLOR_RED, COLOR_BLACK,  false);

	DLG_COLOR(menubox,          COLOR_YELLOW, COLOR_BLACK, false);
	DLG_COLOR(menubox_border,   COLOR_BLACK,  COLOR_BLACK, true);

	DLG_COLOR(item,             COLOR_WHITE, COLOR_BLACK, false);
	DLG_COLOR(item_selected,    COLOR_WHITE, COLOR_RED,   false);

	DLG_COLOR(tag,              COLOR_RED,    COLOR_BLACK, false);
	DLG_COLOR(tag_selected,     COLOR_YELLOW, COLOR_RED,   true);
	DLG_COLOR(tag_key,          COLOR_RED,    COLOR_BLACK, false);
	DLG_COLOR(tag_key_selected, COLOR_YELLOW, COLOR_RED,   true);

	DLG_COLOR(check,            COLOR_YELLOW, COLOR_BLACK, false);
	DLG_COLOR(check_selected,   COLOR_YELLOW, COLOR_RED,   true);

	DLG_COLOR(uarrow, COLOR_RED, COLOR_BLACK, false);
	DLG_COLOR(darrow, COLOR_RED, COLOR_BLACK, false);
}

static void set_bluetitle_theme(void)
{
	set_classic_theme();
	DLG_COLOR(title,               COLOR_BLUE,   COLOR_WHITE, true);
	DLG_COLOR(button_key_active,   COLOR_YELLOW, COLOR_BLUE,  true);
	DLG_COLOR(button_label_active, COLOR_WHITE,  COLOR_BLUE,  true);
	DLG_COLOR(searchbox_title,     COLOR_BLUE,   COLOR_WHITE, true);
	DLG_COLOR(position_indicator,  COLOR_BLUE,   COLOR_WHITE, true);
	DLG_COLOR(tag,                 COLOR_BLUE,   COLOR_WHITE, true);
	DLG_COLOR(tag_key,             COLOR_BLUE,   COLOR_WHITE, true);

}

/*
 * Select color theme
 */
static int set_theme(const char *theme)
{
	int use_color = 1;
	if (!theme)
		set_bluetitle_theme();
	else if (strcmp(theme, "classic") == 0)
		set_classic_theme();
	else if (strcmp(theme, "bluetitle") == 0)
		set_bluetitle_theme();
	else if (strcmp(theme, "blackbg") == 0)
		set_blackbg_theme();
	else if (strcmp(theme, "mono") == 0)
		use_color = 0;

	return use_color;
}

static void init_one_color(struct dialog_color *color)
{
	static int pair = 0;

	pair++;
	init_pair(pair, color->fg, color->bg);
	if (color->hl)
		color->atr = A_BOLD | COLOR_PAIR(pair);
	else
		color->atr = COLOR_PAIR(pair);
}

static void init_dialog_colors(void)
{
	init_one_color(&dlg.screen);
	init_one_color(&dlg.shadow);
	init_one_color(&dlg.dialog);
	init_one_color(&dlg.title);
	init_one_color(&dlg.border);
	init_one_color(&dlg.button_active);
	init_one_color(&dlg.button_inactive);
	init_one_color(&dlg.button_key_active);
	init_one_color(&dlg.button_key_inactive);
	init_one_color(&dlg.button_label_active);
	init_one_color(&dlg.button_label_inactive);
	init_one_color(&dlg.inputbox);
	init_one_color(&dlg.inputbox_border);
	init_one_color(&dlg.searchbox);
	init_one_color(&dlg.searchbox_title);
	init_one_color(&dlg.searchbox_border);
	init_one_color(&dlg.position_indicator);
	init_one_color(&dlg.menubox);
	init_one_color(&dlg.menubox_border);
	init_one_color(&dlg.item);
	init_one_color(&dlg.item_selected);
	init_one_color(&dlg.tag);
	init_one_color(&dlg.tag_selected);
	init_one_color(&dlg.tag_key);
	init_one_color(&dlg.tag_key_selected);
	init_one_color(&dlg.check);
	init_one_color(&dlg.check_selected);
	init_one_color(&dlg.uarrow);
	init_one_color(&dlg.darrow);
}

/*
 * Setup for color display
 * 该函数用于设置对话框的颜色主题。
 */
static void color_setup(const char *theme)
{
    // 声明一个整数变量 use_color，用于存储是否使用颜色的主题设置。
    int use_color;

    // 调用 set_theme 函数根据传入的主题字符串设置颜色主题，并将结果赋值给 use_color。
    use_color = set_theme(theme);
    // 如果 use_color 为真且终端支持颜色，则进行颜色初始化。
    if (use_color && has_colors()) {
        // 初始化颜色支持。
        start_color();
        // 调用 init_dialog_colors 函数初始化对话框颜色。
        init_dialog_colors();
    } else
        // 否则，使用单色主题。
        set_mono_theme();
}

/*
 * Set window to attribute 'attr'
 * 该函数用于清空指定窗口并设置其属性。
 */
void attr_clear(WINDOW * win, int height, int width, chtype attr)
{
    // 声明两个整数变量 i 和 j，用于循环遍历窗口的每一行和每一列。
    int i, j;

    // 设置窗口 win 的属性为传入的 attr。
    wattrset(win, attr);
    // 循环遍历窗口的每一行。
    for (i = 0; i < height; i++) {
        // 移动光标到窗口的第 i 行第 0 列。
        wmove(win, i, 0);
        // 循环遍历窗口的每一列。
        for (j = 0; j < width; j++)
            // 在窗口的当前位置添加一个空格字符。
            waddch(win, ' ');
    }
    // 标记窗口的所有内容都需要被刷新。
    touchwin(win);
}

// 定义一个名为 dialog_clear 的函数，用于清空整个对话框并设置背景标题。
void dialog_clear(void)
{
    // 声明两个整数变量 lines 和 columns，用于存储对话框的标准屏幕的高度和宽度。
    int lines, columns;

    // 获取标准屏幕 stdscr 的高度并赋值给 lines。
    lines = getmaxy(stdscr);
    // 获取标准屏幕 stdscr 的宽度并赋值给 columns。
    columns = getmaxx(stdscr);

    // 调用 attr_clear 函数清空标准屏幕 stdscr，并使用 dlg.screen.atr 设置其属性。
    attr_clear(stdscr, lines, columns, dlg.screen.atr);
    // 如果 dlg.backtitle 不为 NULL，则显示背景标题。
    if (dlg.backtitle != NULL) {
        // 声明两个整数变量 i 和 len，以及一个指向 subtitle_list 结构的指针 pos。
        int i, len = 0, skip = 0;
        struct subtitle_list *pos;

        // 设置标准屏幕 stdscr 的属性为 dlg.screen.atr。
        wattrset(stdscr, dlg.screen.atr);
        // 在标准屏幕 stdscr 的第 0 行第 1 列位置添加背景标题字符串。
        mvwaddstr(stdscr, 0, 1, (char *)dlg.backtitle);

        // 遍历 dlg.subtitles 链表，计算所有子标题的总长度加上箭头和空格的长度。
        for (pos = dlg.subtitles; pos != NULL; pos = pos->next) {
            // 3 是用于箭头和空格的长度。
            len += strlen(pos->text) + 3;
        }

        // 移动光标到标准屏幕 stdscr 的第 1 行第 1 列。
        wmove(stdscr, 1, 1);
        // 如果子标题的总长度大于屏幕宽度减去 2，则显示省略号并计算需要跳过的字符数。
        if (len > columns - 2) {
            const char *ellipsis = "[...] ";
            // 在当前位置添加省略号字符串。
            waddstr(stdscr, ellipsis);
            // 计算需要跳过的字符数。
            skip = len - (columns - 2 - strlen(ellipsis));
        }

        // 再次遍历 dlg.subtitles 链表，将子标题添加到屏幕中。
        for (pos = dlg.subtitles; pos != NULL; pos = pos->next) {
            // 如果 skip 为 0，则在当前位置添加一个右箭头字符。
            if (skip == 0)
                waddch(stdscr, ACS_RARROW);
            else
                // 否则，减少 skip 的值。
                skip--;

            // 如果 skip 为 0，则在当前位置添加一个空格字符。
            if (skip == 0)
                waddch(stdscr, ' ');
            else
                // 否则，减少 skip 的值。
                skip--;

            // 如果 skip 小于当前子标题的长度，则从跳过的字符位置开始添加子标题字符串。
            if (skip < strlen(pos->text)) {
                waddstr(stdscr, pos->text + skip);
                // 重置 skip 为 0。
                skip = 0;
            } else
                // 否则，减少 skip 的值。
                skip -= strlen(pos->text);

            // 如果 skip 为 0，则在当前位置添加一个空格字符。
            if (skip == 0)
                waddch(stdscr, ' ');
            else
                // 否则，减少 skip 的值。
                skip--;
        }

        // 在剩余的列中添加水平线字符。
        for (i = len + 1; i < columns - 1; i++)
            waddch(stdscr, ACS_HLINE);
    }
    // 标记标准屏幕 stdscr 的内容已经准备好刷新。
    wnoutrefresh(stdscr);
}

/*
 * Do some initialization for dialog
 * 该函数用于初始化对话框。
 */
int init_dialog(const char *backtitle)
{
    // 声明两个整数变量 height 和 width，用于存储对话框的标准屏幕的高度和宽度。
    int height, width;

    // 初始化 curses 模式。
    initscr();		/* Init curses */

    // 获取当前光标位置并保存到 saved_y 和 saved_x，以便信号处理函数使用。
    getyx(stdscr, saved_y, saved_x);

    // 获取标准屏幕 stdscr 的高度和宽度。
    getmaxyx(stdscr, height, width);
    // 如果高度或宽度小于最小要求，则结束 curses 模式并返回错误码。
    if (height < WINDOW_HEIGTH_MIN || width < WINDOW_WIDTH_MIN) {
        endwin();
        return -ERRDISPLAYTOOSMALL;
    }

    // 设置对话框的背景标题为传入的 backtitle。
    dlg.backtitle = backtitle;
    // 根据环境变量 MENUCONFIG_COLOR 设置颜色主题。
    color_setup(getenv("MENUCONFIG_COLOR"));

    // 启用标准屏幕 stdscr 的功能键识别。
    keypad(stdscr, TRUE);
    // 设置标准屏幕 stdscr 为 cbreak 模式，即每次按键后立即返回，不缓冲。
    cbreak();
    // 禁止回显输入的字符。
    noecho();
    // 清空对话框并设置背景标题。
    dialog_clear();

    // 返回 0 表示初始化成功。
    return 0;
}

// 定义一个函数 set_dialog_backtitle，用于设置对话框的背景标题。
void set_dialog_backtitle(const char *backtitle)
{
    // 设置对话框的背景标题为传入的 backtitle。
    dlg.backtitle = backtitle;
}

// 定义一个函数 set_dialog_subtitles，用于设置对话框的子标题。
void set_dialog_subtitles(struct subtitle_list *subtitles)
{
    // 将传入的 subtitles 链表赋值给 dlg.subtitles。
    dlg.subtitles = subtitles;
}

/*
 * End using dialog functions.
 * 该函数用于结束使用对话框函数并清理相关资源。
 */
void end_dialog(int x, int y)
{
    // 将光标移动到原始位置 (y, x)。
    move(y, x);
    // 刷新屏幕以显示光标移动。
    refresh();
    // 结束 curses 模式。
    endwin();
}

/* Print the title of the dialog. Center the title and truncate
 * tile if wider than dialog (- 2 chars).
 * 该函数用于在对话框中打印标题，标题居中显示，如果标题长度超过对话框宽度减去 2，则截断。
 **/
void print_title(WINDOW *dialog, const char *title, int width)
{
    // 如果标题不为空。
    if (title) {
        // 计算标题长度，不超过 width - 2。
        int tlen = MIN(width - 2, strlen(title));
        // 设置对话框窗口的属性为 dlg.title.atr。
        wattrset(dialog, dlg.title.atr);
        // 在对话框窗口的第 0 行，居中位置的前一个字符处添加一个空格。
        mvwaddch(dialog, 0, (width - tlen) / 2 - 1, ' ');
        // 在对话框窗口的第 0 行，居中位置添加标题字符串，最多添加 tlen 个字符。
        mvwaddnstr(dialog, 0, (width - tlen) / 2, title, tlen);
        // 在标题字符串的末尾添加一个空格。
        waddch(dialog, ' ');
    }
}

/*
 * Print a string of text in a window, automatically wrap around to the
 * next line if the string is too long to fit on one line. Newline
 * characters '\n' are properly processed.  We start on a new line
 * if there is no room for at least 4 nonblanks following a double-space.
 * 该函数用于在窗口中自动换行打印字符串，处理换行符，并在双空格后自动换行。
 */
void print_autowrap(WINDOW * win, const char *prompt, int width, int y, int x)
{
    // 声明变量用于控制换行和光标位置。
    int newl, cur_x, cur_y;
    // 计算提示字符串的长度。
    int prompt_len, room, wlen;
    // 声明一个临时字符串 tempstr 和相关指针。
    char tempstr[MAX_LEN + 1], *word, *sp, *sp2, *newline_separator = 0;

    // 将提示字符串 prompt 复制到临时字符串 tempstr。
    strcpy(tempstr, prompt);

    // 获取提示字符串的长度。
    prompt_len = strlen(tempstr);

    // 如果提示字符串长度小于等于 width - x * 2，则提示字符串较短，可以直接居中显示。
    if (prompt_len <= width - x * 2) {	/* If prompt is short */
        // 移动光标到窗口的第 y 行，居中位置。
        wmove(win, y, (width - prompt_len) / 2);
        // 添加提示字符串。
        waddstr(win, tempstr);
    } else {
        // 否则，提示字符串较长，需要自动换行。
        cur_x = x;    // 当前光标列位置。
        cur_y = y;    // 当前光标行位置。
        newl = 1;     // 标记是否为新行。
        word = tempstr; // 当前处理的单词指针。

        // 循环处理每一个单词。
        while (word && *word) {
            // 查找单词中的换行符或空格。
            sp = strpbrk(word, "\n ");
            if (sp && *sp == '\n')
                // 如果找到换行符，设置 newline_separator 为当前位置。
                newline_separator = sp;

            if (sp)
                // 将找到的换行符或空格替换为字符串结束符，并将 sp 指向下一个字符。
                *sp++ = 0;

            /* Wrap to next line if either the word does not fit,
               or it is the first word of a new sentence, and it is
               short, and the next word does not fit. */
            // 计算当前行剩余的空间。
            room = width - cur_x;
            // 获取当前单词的长度。
            wlen = strlen(word);
            // 如果当前单词长度大于剩余空间，或者当前单词是新句子的第一个单词且长度小于 4，并且下一个单词也不适合当前行，则换行。
            if (wlen > room ||
                (newl && wlen < 4 && sp
                 && wlen + 1 + strlen(sp) > room
                 && (!(sp2 = strpbrk(sp, "\n "))
                     || wlen + 1 + (sp2 - sp) > room))) {
                cur_y++;    // 移动到下一行。
                cur_x = x;    // 重置当前列位置为 x。
            }
            // 移动光标到当前处理位置。
            wmove(win, cur_y, cur_x);
            // 添加当前单词。
            waddstr(win, word);
            // 获取当前光标位置。
            getyx(win, cur_y, cur_x);

            /* Move to the next line if the word separator was a newline */
            // 如果 newline_separator 不为 NULL，则表示找到了换行符，换行。
            if (newline_separator) {
                cur_y++;    // 移动到下一行。
                cur_x = x;    // 重置当前列位置为 x。
                newline_separator = 0;  // 重置 newline_separator。
            } else
                // 否则，增加当前列位置。
                cur_x++;

            // 如果 sp 指向的字符是空格。
            if (sp && *sp == ' ') {
                cur_x++;    // 增加当前列位置以处理双空格。
                // 跳过所有连续的空格。
                while (*++sp == ' ') ;
                newl = 1;     // 标记为新行。
            } else
                newl = 0;     // 否则，不标记为新行。
            word = sp;    // 更新 word 指针为下一个单词的起始位置。
        }
    }
}


// 定义一个函数 set_dialog_subtitles，用于设置对话框的子标题。
void set_dialog_subtitles(struct subtitle_list *subtitles)
{
    // 将传入的 subtitles 链表赋值给 dlg.subtitles。
    dlg.subtitles = subtitles;
}

/*
 * End using dialog functions.
 * 该函数用于结束使用对话框函数并清理相关资源。
 */
void end_dialog(int x, int y)
{
    // 将光标移动到原始位置 (y, x)。
    move(y, x);
    // 刷新屏幕以显示光标移动。
    refresh();
    // 结束 curses 模式。
    endwin();
}

/* Print the title of the dialog. Center the title and truncate
 * tile if wider than dialog (- 2 chars).
 * 该函数用于在对话框中打印标题，标题居中显示，如果标题长度超过对话框宽度减去 2，则截断。
 **/
void print_title(WINDOW *dialog, const char *title, int width)
{
    // 如果标题不为空。
    if (title) {
        // 计算标题长度，不超过 width - 2。
        int tlen = MIN(width - 2, strlen(title));
        // 设置对话框窗口的属性为 dlg.title.atr。
        wattrset(dialog, dlg.title.atr);
        // 在对话框窗口的第 0 行，居中位置的前一个字符处添加一个空格。
        mvwaddch(dialog, 0, (width - tlen) / 2 - 1, ' ');
        // 在对话框窗口的第 0 行，居中位置添加标题字符串，最多添加 tlen 个字符。
        mvwaddnstr(dialog, 0, (width - tlen) / 2, title, tlen);
        // 在标题字符串的末尾添加一个空格。
        waddch(dialog, ' ');
    }
}

/*
 * Print a string of text in a window, automatically wrap around to the
 * next line if the string is too long to fit on one line. Newline
 * characters '\n' are properly processed.  We start on a new line
 * if there is no room for at least 4 nonblanks following a double-space.
 * 该函数用于在窗口中自动换行打印字符串，处理换行符，并在双空格后自动换行。
 */
void print_autowrap(WINDOW * win, const char *prompt, int width, int y, int x)
{
    // 声明变量用于控制换行和光标位置。
    int newl, cur_x, cur_y;
    // 计算提示字符串的长度。
    int prompt_len, room, wlen;
    // 声明一个临时字符串 tempstr 和相关指针。
    char tempstr[MAX_LEN + 1], *word, *sp, *sp2, *newline_separator = 0;

    // 将提示字符串 prompt 复制到临时字符串 tempstr。
    strcpy(tempstr, prompt);

    // 获取提示字符串的长度。
    prompt_len = strlen(tempstr);

    // 如果提示字符串长度小于等于 width - x * 2，则提示字符串较短，可以直接居中显示。
    if (prompt_len <= width - x * 2) {	/* If prompt is short */
        // 移动光标到窗口的第 y 行，居中位置。
        wmove(win, y, (width - prompt_len) / 2);
        // 添加提示字符串。
        waddstr(win, tempstr);
    } else {
        // 否则，提示字符串较长，需要自动换行。
        cur_x = x;    // 当前光标列位置。
        cur_y = y;    // 当前光标行位置。
        newl = 1;     // 标记是否为新行。
        word = tempstr; // 当前处理的单词指针。

        // 循环处理每一个单词。
        while (word && *word) {
            // 查找单词中的换行符或空格。
            sp = strpbrk(word, "\n ");
            // 如果找到换行符，设置 newline_separator 为当前位置。
            if (sp && *sp == '\n')
                newline_separator = sp;

            if (sp)
                // 将找到的换行符或空格替换为字符串结束符，并将 sp 指向下一个字符。
                *sp++ = 0;

            /* Wrap to next line if either the word does not fit,
               or it is the first word of a new sentence, and it is
               short, and the next word does not fit. */
            // 计算当前行剩余的空间。
            room = width - cur_x;
            // 获取当前单词的长度。
            wlen = strlen(word);
            // 如果当前单词长度大于剩余空间，或者当前单词是新句子的第一个单词且长度小于 4，并且下一个单词也不适合当前行，则换行。
            if (wlen > room ||
                (newl && wlen < 4 && sp
                 && wlen + 1 + strlen(sp) > room
                 && (!(sp2 = strpbrk(sp, "\n "))
                     || wlen + 1 + (sp2 - sp) > room))) {
                cur_y++;    // 移动到下一行。
                cur_x = x;    // 重置当前列位置为 x。
            }
            // 移动光标到当前处理位置。
            wmove(win, cur_y, cur_x);
            // 添加当前单词。
            waddstr(win, word);
            // 获取当前光标位置。
            getyx(win, cur_y, cur_x);

            /* Move to the next line if the word separator was a newline */
            // 如果 newline_separator 不为 NULL，则表示找到了换行符，换行。
            if (newline_separator) {
                cur_y++;    // 移动到下一行。
                cur_x = x;    // 重置当前列位置为 x。
                newline_separator = 0;  // 重置 newline_separator。
            } else
                // 否则，增加当前列位置。
                cur_x++;

            // 如果 sp 指向的字符是空格。
            if (sp && *sp == ' ') {
                cur_x++;    // 增加当前列位置以处理双空格。
                // 跳过所有连续的空格。
                while (*++sp == ' ') ;
                newl = 1;     // 标记为新行。
            } else
                newl = 0;     // 否则，不标记为新行。
            word = sp;    // 更新 word 指针为下一个单词的起始位置。
        }
    }
}

// 定义一个函数 set_dialog_subtitles，用于设置对话框的子标题。
void set_dialog_subtitles(struct subtitle_list *subtitles)
{
    // 将传入的 subtitles 链表赋值给 dlg.subtitles。
    dlg.subtitles = subtitles;
}

/*
 * End using dialog functions.
 * 该函数用于结束使用对话框函数并清理相关资源。
 */
void end_dialog(int x, int y)
{
    // 将光标移动到原始位置 (y, x)。
    move(y, x);
    // 刷新屏幕以显示光标移动。
    refresh();
    // 结束 curses 模式。
    endwin();
}

/* Print the title of the dialog. Center the title and truncate
 * title if wider than dialog (- 2 chars).
 * 该函数用于在对话框中打印标题，标题居中显示，如果标题长度超过对话框宽度减去 2，则截断。
 **/
void print_title(WINDOW *dialog, const char *title, int width)
{
    // 如果标题不为空。
    if (title) {
        // 计算标题长度，不超过 width - 2。
        int tlen = MIN(width - 2, strlen(title));
        // 设置对话框窗口的属性为 dlg.title.atr。
        wattrset(dialog, dlg.title.atr);
        // 在对话框窗口的第 0 行，居中位置的前一个字符处添加一个空格。
        mvwaddch(dialog, 0, (width - tlen) / 2 - 1, ' ');
        // 在对话框窗口的第 0 行，居中位置添加标题字符串，最多添加 tlen 个字符。
        mvwaddnstr(dialog, 0, (width - tlen) / 2, title, tlen);
        // 在标题字符串的末尾添加一个空格。
        waddch(dialog, ' ');
    }
}

/*
 * Print a string of text in a window, automatically wrap around to the
 * next line if the string is too long to fit on one line. Newline
 * characters '\n' are properly processed.  We start on a new line
 * if there is no room for at least 4 nonblanks following a double-space.
 * 该函数用于在窗口中自动换行打印字符串，处理换行符，并在双空格后自动换行。
 */
void print_autowrap(WINDOW * win, const char *prompt, int width, int y, int x)
{
    // 声明变量用于控制换行和光标位置。
    int newl, cur_x, cur_y;
    // 计算提示字符串的长度。
    int prompt_len, room, wlen;
    // 声明一个临时字符串 tempstr 和相关指针。
    char tempstr[MAX_LEN + 1], *word, *sp, *sp2, *newline_separator = 0;

    // 将提示字符串 prompt 复制到临时字符串 tempstr。
    strcpy(tempstr, prompt);

    // 获取提示字符串的长度。
    prompt_len = strlen(tempstr);

    // 如果提示字符串长度小于等于 width - x * 2，则提示字符串较短，可以直接居中显示。
    if (prompt_len <= width - x * 2) {	/* If prompt is short */
        // 移动光标到窗口的第 y 行，居中位置。
        wmove(win, y, (width - prompt_len) / 2);
        // 添加提示字符串。
        waddstr(win, tempstr);
    } else {
        // 否则，提示字符串较长，需要自动换行。
        cur_x = x;    // 当前光标列位置。
        cur_y = y;    // 当前光标行位置。
        newl = 1;     // 标记是否为新行。
        word = tempstr; // 当前处理的单词指针。

        // 循环处理每一个单词。
        while (word && *word) {
            // 查找单词中的换行符或空格。
            sp = strpbrk(word, "\n ");
            // 如果找到换行符，设置 newline_separator 为当前位置。
            if (sp && *sp == '\n')
                newline_separator = sp;

            if (sp)
                // 将找到的换行符或空格替换为字符串结束符，并将 sp 指向下一个字符。
                *sp++ = 0;

            // 计算当前行剩余的空间。
            room = width - cur_x;
            // 获取当前单词的长度。
            wlen = strlen(word);
            // 如果当前单词长度大于剩余空间，或者当前单词是新句子的第一个单词且长度小于 4，并且下一个单词也不适合当前行，则换行。
            if (wlen > room ||
                (newl && wlen < 4 && sp
                 && wlen + 1 + strlen(sp) > room
                 && (!(sp2 = strpbrk(sp, "\n "))
                     || wlen + 1 + (sp2 - sp) > room))) {
                cur_y++;    // 移动到下一行。
                cur_x = x;    // 重置当前列位置为 x。
            }
            // 移动光标到当前处理位置。
            wmove(win, cur_y, cur_x);
            // 添加当前单词。
            waddstr(win, word);
            // 获取当前光标位置。
            getyx(win, cur_y, cur_x);

            // 如果 newline_separator 不为 NULL，则表示找到了换行符，换行。
            if (newline_separator) {
                cur_y++;    // 移动到下一行。
                cur_x = x;    // 重置当前列位置为 x。
                newline_separator = 0;  // 重置 newline_separator。
            } else
                // 否则，增加当前列位置。
                cur_x++;

            // 如果 sp 指向的字符是空格。
            if (sp && *sp == ' ') {
                cur_x++;    // 增加当前列位置以处理双空格。
                // 跳过所有连续的空格。
                while (*++sp == ' ') ;
                newl = 1;     // 标记为新行。
            } else
                newl = 0;     // 否则，不标记为新行。
            word = sp;    // 更新 word 指针为下一个单词的起始位置。
        }
    }
}


// 定义一个函数 set_dialog_subtitles，用于设置对话框的子标题。
void set_dialog_subtitles(struct subtitle_list *subtitles)
{
    // 将传入的 subtitles 链表赋值给 dlg.subtitles。
    dlg.subtitles = subtitles;
}

/*
 * End using dialog functions.
 * 该函数用于结束使用对话框函数并清理相关资源。
 */
void end_dialog(int x, int y)
{
    // 将光标移动到原始位置 (y, x)。
    move(y, x);
    // 刷新屏幕以显示光标移动。
    refresh();
    // 结束 curses 模式。
    endwin();
}

/* Print the title of the dialog. Center the title and truncate
 * title if wider than dialog (- 2 chars).
 * 该函数用于在对话框中打印标题，标题居中显示，如果标题长度超过对话框宽度减去 2，则截断。
 **/
void print_title(WINDOW *dialog, const char *title, int width)
{
    // 如果标题不为空。
    if (title) {
        // 计算标题长度，不超过 width - 2。
        int tlen = MIN(width - 2, strlen(title));
        // 设置对话框窗口的属性为 dlg.title.atr。
        wattrset(dialog, dlg.title.atr);
        // 在对话框窗口的第 0 行，居中位置的前一个字符处添加一个空格。
        mvwaddch(dialog, 0, (width - tlen) / 2 - 1, ' ');
        // 在对话框窗口的第 0 行，居中位置添加标题字符串，最多添加 tlen 个字符。
        mvwaddnstr(dialog, 0, (width - tlen) / 2, title, tlen);
        // 在标题字符串的末尾添加一个空格。
        waddch(dialog, ' ');
    }
}

/*
 * Print a string of text in a window, automatically wrap around to the
 * next line if the string is too long to fit on one line. Newline
 * characters '\n' are properly processed.  We start on a new line
 * if there is no room for at least 4 nonblanks following a double-space.
 * 该函数用于在窗口中自动换行打印字符串，处理换行符，并在双空格后自动换行。
 */
void print_autowrap(WINDOW * win, const char *prompt, int width, int y, int x)
{
    // 声明变量用于控制换行和光标位置。
    int newl, cur_x, cur_y;
    // 计算提示字符串的长度。
    int prompt_len, room, wlen;
    // 声明一个临时字符串 tempstr 和相关指针。
    char tempstr[MAX_LEN + 1], *word, *sp, *sp2, *newline_separator = 0;

    // 将提示字符串 prompt 复制到临时字符串 tempstr。
    strcpy(tempstr, prompt);

    // 获取提示字符串的长度。
    prompt_len = strlen(tempstr);

    // 如果提示字符串长度小于等于 width - x * 2，则提示字符串较短，可以直接居中显示。
    if (prompt_len <= width - x * 2) {	/* If prompt is short */
        // 移动光标到窗口的第 y 行，居中位置。
        wmove(win, y, (width - prompt_len) / 2);
        // 添加提示字符串。
        waddstr(win, tempstr);
    } else {
        // 否则，提示字符串较长，需要自动换行。
        cur_x = x;    // 当前光标列位置初始化为 x。
        cur_y = y;    // 当前光标行位置初始化为 y。
        newl = 1;     // 标记是否为新行，初始为 1 表示是新行。
        word = tempstr; // 当前处理的单词指针初始化为 tempstr 的起始位置。

        // 循环处理每一个单词。
        while (word && *word) {
            // 查找单词中的换行符或空格。
            sp = strpbrk(word, "\n ");
            // 如果找到换行符，设置 newline_separator 为当前位置。
            if (sp && *sp == '\n')
                newline_separator = sp;

            if (sp)
                // 将找到的换行符或空格替换为字符串结束符，并将 sp 指向下一个字符。
                *sp++ = 0;

            // 计算当前行剩余的空间。
            room = width - cur_x;
            // 获取当前单词的长度。
            wlen = strlen(word);
            // 如果当前单词长度大于剩余空间，或者当前单词是新句子的第一个单词且长度小于 4，并且下一个单词也不适合当前行，则换行。
            if (wlen > room ||
                (newl && wlen < 4 && sp
                 && wlen + 1 + strlen(sp) > room
                 && (!(sp2 = strpbrk(sp, "\n "))
                     || wlen + 1 + (sp2 - sp) > room))) {
                cur_y++;    // 移动到下一行。
                cur_x = x;    // 重置当前列位置为 x。
            }
            // 移动光标到当前处理位置。
            wmove(win, cur_y, cur_x);
            // 添加当前单词。
            waddstr(win, word);
            // 获取当前光标位置。
            getyx(win, cur_y, cur_x);

            // 如果 newline_separator 不为 NULL，则表示找到了换行符，换行。
            if (newline_separator) {
                cur_y++;    // 移动到下一行。
                cur_x = x;    // 重置当前列位置为 x。
                newline_separator = 0;  // 重置 newline_separator。
            } else
                // 否则，增加当前列位置。
                cur_x++;

            // 如果 sp 指向的字符是空格。
            if (sp && *sp == ' ') {
                cur_x++;    // 增加当前列位置以处理双空格。
                // 跳过所有连续的空格。
                while (*++sp == ' ') ;
                newl = 1;     // 标记为新行。
            } else
                newl = 0;     // 否则，不标记为新行。
            word = sp;    // 更新 word 指针为下一个单词的起始位置。
        }
    }
}

