Manage View Display

Manage the View Display. More...

Functions
void	resize_page (Init *init)
	Resize Viewing Page.
int	pad_refresh (View *view)
	Refresh Pad and Line Number Window.
void	view_display_page (View *view)
	Display Current Page.
void	display_line (View *view)
	Display Line on Padparam View *view data structure.
int	fmt_line (View *view)
	Format Line for Display.
void	parse_ansi_str (char *ansi_str, attr_t *attr, int *cpx)
	Parse ANSI SGR Escape Sequence.
int	display_prompt (View *view, char *s)
	Display Command Line Prompt.
void	view_display_help (Init *init)
	Display View Help File.

Detailed Description

Manage the View Display.

Function Documentation

display_line()

void display_line

(

View *

view

)

Display Line on Padparam View *view data structure.

This function displays a single line of text on the ncurses pad.

Note

If line numbering is enabled (view->f_ln), it is formatted and displayed at the beginning of the line with the specified attributes and color pair.

Because get_next_char calls increment_ln upon encountering a line feed and increment_ln advances view->ln after updating the line table, the line number displayed is one greater than the index to the line table. That means the line counter begins with 1, while the table origin is 0.

Definition at line 1624 of file view_engine.c.

                              {
    char ln_s[16];
 
    if (view->cury < 0)
        view->cury = 0;
    if (view->cury > view->scroll_lines - 1)
        view->cury = view->scroll_lines - 1;
    if (view->f_ln) {
        ssnprintf(ln_s, 7, "%6jd", view->ln);
        wmove(view->ln_win, view->cury, 0);
        wclrtoeol(view->ln_win);
        mvwaddstr(view->ln_win, view->cury, 0, ln_s);
    }
    wmove(view->pad, view->cury, 0);
    wclrtoeol(view->pad);
    wadd_wchstr(view->pad, view->cmplx_buf);
    view->cury++;
}

References View::cmplx_buf, View::cury, View::f_ln, View::ln, View::ln_win, View::pad, View::scroll_lines, and ssnprintf().

Referenced by scroll_down_n_lines(), scroll_up_n_lines(), search(), and view_display_page().

Here is the call graph for this function:

Here is the caller graph for this function:

display_prompt()

int display_prompt	(	View *	view,
		char *	s )

Display Command Line Prompt.

Parameters

view	is the current view data structure
s	is the prompt string

Definition at line 1899 of file view_engine.c.

                                        {
    char message_str[PAD_COLS + 1];
    int l;
    l = strnz__cpy(message_str, s, PAD_COLS);
    wmove(view->win, view->cmd_line, 0);
    if (l != 0) {
        wclrtoeol(view->win);
        wattron(view->win, WA_REVERSE);
        waddstr(view->win, " ");
        waddstr(view->win, message_str);
        waddstr(view->win, " ");
        wattroff(view->win, WA_REVERSE);
        waddstr(view->win, " ");
        view->curx = l + 2;
        wmove(view->win, view->cmd_line, view->curx);
    }
    return (view->curx);
}

References View::cmd_line, View::curx, strnz__cpy(), and View::win.

Referenced by lp(), and view_cmd_processor().

Here is the call graph for this function:

Here is the caller graph for this function:

fmt_line()

int fmt_line

(

View *

view

)

Format Line for Display.

Parameters

view	pointer to View structure containing line input and output buffers

Returns

length of formatted line in characters

This function processes the input line from view->line_in_s, handling ANSI escape sequences for text attributes and colors, as well as multi-byte characters. It converts the input line into a formatted line suitable for display in the terminal, storing the result in view->cmplx_buf and view->stripped_line_out. The function returns the length of the formatted line in characters, which may be used for tracking the maximum column width of the displayed content.

Definition at line 1655 of file view_engine.c.

                         {
    char ansi_tok[MAXLEN];
    int i = 0, j = 0;
    int len = 0;
    const char *s;
    attr_t attr = WA_NORMAL;
    int cpx = cp_win;
    cchar_t cc = {0};
    wchar_t wstr[2] = {L'\0', L'\0'};
 
    char *in_str = view->line_in_s;
    cchar_t *cmplx_buf = view->cmplx_buf;
 
    rtrim(view->line_out_s);
    mbstate_t mbstate;
    memset(&mbstate, 0, sizeof(mbstate));
    while (in_str[i] != '\0') {
        if (in_str[i] == '\033' && in_str[i + 1] == '[') {
            len = strcspn(&in_str[i], "mK ") + 1;
            memcpy(ansi_tok, &in_str[i], len + 1);
            ansi_tok[len] = '\0';
            if (ansi_tok[0] == '\0') {
                if (i + 2 < MAXLEN)
                    i += 2;
                continue;
            }
            if (len == 0 || in_str[i + len - 1] == ' ') {
                i += 2;
                continue;
            } else if (in_str[i + len - 1] == 'K') {
                i += len;
                continue;
            }
            parse_ansi_str(ansi_tok, &attr, &cpx);
            i += len;
        } else {
            if (in_str[i] == '\033') {
                i++;
                continue;
            }
            s = &in_str[i];
            if (*s == '\t') {
                do {
                    wstr[1] = L'\0';
                    setcchar(&cc, wstr, attr, cpx, nullptr);
                    view->stripped_line_out[j] = ' ';
                    cmplx_buf[j++] = cc;
                } while ((j < PAD_COLS - 2) && (j % view->tab_stop != 0));
                i++;
            } else {
                wstr[1] = L'\0';
                len = mbrtowc(wstr, s, MB_CUR_MAX, &mbstate);
                if (len <= 0) {
                    wstr[0] = L'?';
                    wstr[1] = L'\0';
                    len = 1;
                }
                if (setcchar(&cc, wstr, attr, cpx, nullptr) != ERR) {
                    if (len > 0 && (j + len) < PAD_COLS - 1) {
                        view->stripped_line_out[j] = *s;
                        cmplx_buf[j++] = cc;
                    }
                }
                i += len;
            }
        }
    }
    if (j > view->maxcol)
        view->maxcol = j;
    wstr[0] = '\0';
    wstr[1] = '\0';
    setcchar(&cc, wstr, WA_NORMAL, cpx, nullptr);
    cmplx_buf[j] = cc;
    view->stripped_line_out[j] = '\0';
    return j;
}

References View::cmplx_buf, cp_win, View::line_in_s, View::line_out_s, View::maxcol, parse_ansi_str(), rtrim(), View::stripped_line_out, and View::tab_stop.

Referenced by scroll_down_n_lines(), scroll_up_n_lines(), search(), and view_display_page().

Here is the call graph for this function:

Here is the caller graph for this function:

pad_refresh()

int pad_refresh

(

View *

view

)

Refresh Pad and Line Number Window.

Parameters

view	data structure

Returns

OK on success, ERR on failure

Definition at line 1179 of file view_engine.c.

                            {
    int rc;
    if (view->f_ln)
        rc = prefresh(view->pad, view->pminrow, view->pmincol, view->sminrow,
                      view->smincol + 7, view->smaxrow, view->smaxcol);
    else
        rc = prefresh(view->pad, view->pminrow, view->pmincol, view->sminrow,
                      view->smincol, view->smaxrow, view->smaxcol);
    if (rc == ERR)
        Perror("Error refreshing screen");
    wrefresh(view->win);
    if (view->f_ln)
        wrefresh(view->ln_win);
    return rc;
}

References View::f_ln, View::ln_win, View::pad, Perror(), View::pmincol, View::pminrow, View::smaxcol, View::smaxrow, View::smincol, View::sminrow, and View::win.

Referenced by get_cmd_char(), and view_cmd_processor().

Here is the call graph for this function:

Here is the caller graph for this function:

parse_ansi_str()

void parse_ansi_str	(	char *	ansi_str,
		attr_t *	attr,
		int *	cpx )

Parse ANSI SGR Escape Sequence.

Parameters

ansi_str	is the ANSI escape sequence string to parse
attr	is a pointer to an attr_t variable where the parsed attributes will be stored
cpx	is a pointer to an int variable where the parsed color pair index will be stored

This function parses an ANSI SGR (Select Graphic Rendition) escape sequence and updates the provided attr_t and color pair index based on the attributes specified in the ANSI string.

 This function converts the following SGR specification types to the
appropriate curses color pair index for use in the terminal display.

 RGB:

     foreground \033[38;2;r;g;bm
     background \033[48;2;r;g;bm

     Where r, g, b are the red, green, and blue color components
(0-255)

 XTERM 256-color:

     foreground \033[38;5;xm
     background \033[48;5;xm

     Where x is the 256-color index (0-255)

     uses xterm256_idx_to_rgb() to convert the 256-color index to
RGB

 8-color:

     foreground \033[3cm
     background \033[4cm

     Where c is the color code (0 for black, 1 for red, 2 for green, 3
for yellow, 4 for blue, 5 for magenta, 6 for cyan, 7 for white).

 Attributes:

     \033[am

     Where a is the attribute code (1 for bold, 2 for dim, 3 for italic,
4 for underline, 5 for blink, 7 for reverse, 8 for invis). The function
also supports resetting attributes and colors to default using \033[0m.

 @sa xterm256_idx_to_rgb(), rgb_to_curses_clr(), extended_pair_content(),
get_clr_pair()

Definition at line 1786 of file view_engine.c.

                                                            {
    char *tok;
    char t0, t1;
    int len, x_idx;
    int fg, bg;
    int fg_clr, bg_clr;
    char *ansi_p = ansi_str + 2;
    extended_pair_content(*cpx, &fg_clr, &bg_clr);
    fg = fg_clr;
    bg = bg_clr;
    RGB rgb;
    tok = strtok((char *)ansi_p, ";m");
    bool a_toi_error = false;
    while (1) {
        if (tok == nullptr || *tok == '\0')
            break;
        len = strlen(tok);
        if (len == 2) {
            t0 = tok[0];
            t1 = tok[1];
            if (t0 == '3' || t0 == '4') {
                if (t1 == '8') {
                    tok = strtok(nullptr, ";m");
                    if (tok != nullptr) {
                        if (*tok == '5') {
                            tok = strtok(nullptr, ";m");
                            if (tok != nullptr) {
                                x_idx = a_toi(tok, &a_toi_error);
                                rgb = xterm256_idx_to_rgb(x_idx);
                            }
                        } else if (*tok == '2') {
                            tok = strtok(nullptr, ";m");
                            rgb.r = a_toi(tok, &a_toi_error);
                            tok = strtok(nullptr, ";m");
                            rgb.g = a_toi(tok, &a_toi_error);
                            tok = strtok(nullptr, ";m");
                            rgb.b = a_toi(tok, &a_toi_error);
                        }
                    }
                    if (t0 == '3')
                        fg_clr = rgb_to_curses_clr(&rgb);
                    else if (t0 == '4')
                        bg_clr = rgb_to_curses_clr(&rgb);
                } else if (t1 == '9') {
                    if (t0 == '3')
                        fg_clr = CLR_FG;
                    else if (t0 == '4')
                        bg_clr = CLR_BG;
                } else if (t1 >= '0' && t1 <= '7') {
                    if (t0 == '3') {
                        x_idx = a_toi(&t1, &a_toi_error);
                        rgb = xterm256_idx_to_rgb(x_idx);
                        fg_clr = rgb_to_curses_clr(&rgb);
                    } else if (t0 == '4') {
                        x_idx = a_toi(&t1, &a_toi_error);
                        rgb = xterm256_idx_to_rgb(x_idx);
                        bg_clr = rgb_to_curses_clr(&rgb);
                    }
                }
            } else if (t0 == '0') {
                *tok = t1;
                len = 1;
            }
        }
        if (len == 1) {
            if (*tok == '0') {
                *attr = WA_NORMAL;
                fg_clr = CLR_FG;
                bg_clr = CLR_BG;
            } else {
                switch (a_toi(tok, &a_toi_error)) {
                case 1:
                    *attr |= WA_BOLD;
                    break;
                case 2:
                    *attr |= WA_DIM;
                    break;
                case 3:
                    *attr |= WA_ITALIC;
                    break;
                case 4:
                    *attr |= WA_UNDERLINE;
                    break;
                case 5:
                    *attr |= WA_BLINK;
                    break;
                case 7:
                    *attr |= WA_REVERSE;
                    break;
                case 8:
                    *attr |= WA_INVIS;
                    break;
                default:
                    break;
                }
            }
        } else if (len == 0) {
            *attr = WA_NORMAL;
            fg_clr = CLR_FG;
            bg_clr = CLR_BG;
        }
        tok = strtok(nullptr, ";m");
    }
    if (!a_toi_error && (fg_clr != fg || bg_clr != bg)) {
        clr_pair_idx = get_clr_pair(fg_clr, bg_clr);
        *cpx = clr_pair_idx;
    }
    return;
}

References a_toi(), RGB::b, CLR_BG, CLR_FG, clr_pair_idx, RGB::g, get_clr_pair(), RGB::r, rgb_to_curses_clr(), and xterm256_idx_to_rgb().

Referenced by fmt_line().

Here is the call graph for this function:

Here is the caller graph for this function:

resize_page()

void resize_page

(

Init *

init

)

Resize Viewing Page.

Parameters

init	data structure

Definition at line 1145 of file view_engine.c.

                             {
    int scr_lines, scr_cols;
    bool f_resize = false;
    view = init->view;
    if (!view->f_full_screen) {
        getmaxyx(stdscr, scr_lines, scr_cols);
        if (view->begy + view->lines + 2 > scr_lines) {
            view->lines = (scr_lines - view->begy) - 2;
            f_resize = true;
        }
        if (view->begx + view->cols + 2 > scr_cols) {
            view->cols = (scr_cols - view->begx) - 2;
            f_resize = true;
        }
        if (f_resize) {
            view->scroll_lines = view->lines - 1;
            view->cmd_line = 0;
            view->smaxrow = view->lines - 1;
            view->smaxcol = view->cols - 1;
            win_resize(view->lines + 2, view->cols + 2, view->title);
            restore_wins();
            wsetscrreg(view->pad, 0, view->scroll_lines);
        }
    }
    if (f_resize)
        view->f_redisplay_page = true;
    else
        view->f_redisplay_page = false;
}

References View::begx, View::begy, View::cmd_line, View::cols, View::f_full_screen, View::f_redisplay_page, View::lines, View::pad, restore_wins(), View::scroll_lines, View::smaxcol, View::smaxrow, View::title, Init::view, view, and win_resize().

Referenced by view_cmd_processor().

Here is the call graph for this function:

Here is the caller graph for this function:

view_display_help()

void view_display_help

(

Init *

init

)

Display View Help File.

Parameters

init	is the current initialization data structure.

Note

The current View context is set aside by assigning the view structure to "view_save" while the help file is displayed using a new, separate view structure.

The help file is specified by the VIEW_HELP_FILE macro can be set to a default help file path or overridden by the user through an environment variable.

After the help file is closed, the original view is restored and the page is redisplayed.

It may be necessary to reassign view after calling this function because the init->view pointer is temporarily set to nullptr during the help file display, and the original view is restored afterward.

The default screen size for help can be set in the code below. If set to 0, popup_view will determine reasonable maximal size based on the terminal dimensions.

The help file may contain Unicode characters and ANSI escape sequences for formatting, which will be properly handled and displayed by popup_view.

Definition at line 1952 of file view_engine.c.

                                   {
    char tmp_str[MAXLEN];
    int eargc = 0;
    char *eargv[MAXARGS];
    if (view->f_help_spec && view->help_spec[0] != '\0')
        strnz__cpy(tmp_str, view->help_spec, MAXLEN - 1);
    else {
        strnz__cpy(tmp_str, init->mapp_help, MAXLEN - 1);
        strnz__cat(tmp_str, "/", MAXLEN - 1);
        strnz__cat(tmp_str, VIEW_HELP_FILE, MAXLEN - 1);
    }
    eargv[eargc++] = strdup("view");
    eargv[eargc++] = strdup("-N");
    eargv[eargc++] = strdup("f");
    eargv[eargc++] = strdup(tmp_str);
    eargv[eargc] = nullptr;
    init->lines = 48;
    init->cols = 72;
    init->begy = 0;
    init->begx = 0;
    strnz__cpy(init->title, "View Help", MAXLEN - 1);
    popup_view(init, eargc, eargv, init->lines, init->cols, init->begy,
               init->begx);
    destroy_argv(eargc, eargv);
    init->view->f_redisplay_page = true;
}

References Init::begx, Init::begy, Init::cols, destroy_argv(), View::f_help_spec, View::f_redisplay_page, View::help_spec, Init::lines, Init::mapp_help, popup_view(), strnz__cat(), strnz__cpy(), Init::title, Init::view, and view.

Referenced by view_cmd_processor().

Here is the call graph for this function:

Here is the caller graph for this function:

view_display_page()

void view_display_page

(

View *

view

)

Display Current Page.

Parameters

view	data structure

Definition at line 1239 of file view_engine.c.

                                   {
    int i;
    wmove(view->pad, 0, 0);
    if (view->ln_win)
        wmove(view->ln_win, 0, 0);
    view->page_top_ln = view->ln;
    view->page_bot_ln = view->ln;
    view->page_top_pos = view->ln_tbl[view->ln];
    view->file_pos = view->page_top_pos;
    view->page_bot_pos = view->file_pos;
    for (i = 0; i < view->scroll_lines; i++) {
        view->page_bot_pos = get_next_line(view, view->page_bot_pos);
        if (view->f_eod)
            break;
        fmt_line(view);
        display_line(view);
    }
    if (view->cury < view->scroll_lines) {
        wmove(view->ln_win, view->cury, 0);
        wclrtobot(view->ln_win);
        wmove(view->pad, view->cury, 0);
        wclrtobot(view->pad);
    }
    view->page_bot_ln = view->ln;
}

References View::cury, display_line(), View::f_eod, View::file_pos, fmt_line(), get_next_line(), View::ln, View::ln_tbl, View::ln_win, View::pad, View::page_bot_ln, View::page_bot_pos, View::page_top_ln, View::page_top_pos, and View::scroll_lines.

Referenced by next_page(), and view_cmd_processor().

Here is the call graph for this function:

Here is the caller graph for this function: