ui_notcurses_draw.c File Reference

NotCurses UI backend — drawing functions. More...

#include "ui_backend.h"
#include "ui_notcurses_internal.h"
#include <notcurses/notcurses.h>
#include <stddef.h>
#include <stdlib.h>
#include <string.h>

Include dependency graph for ui_notcurses_draw.c:

Go to the source code of this file.

Macros
#define	_GNU_SOURCE
#define	_XOPEN_SOURCE_EXTENDED   1

Functions
int	mk_chimera (UiCell *cell, char c)
	create a cell with specified character, using background cell style and channels
struct ncvisual *	ui_display_image (struct notcurses *nc, UiMultiMedia *mm, const char *image_file, int y, int x, int begy, int begx)
	display an image on the terminal using NotCurses
int	ui_draw_ch (UiSurface *s, ss_t w, char c)
	on specified window, at current location, add character
int	ui_draw_ch_yx (UiSurface *s, ss_t w, uint y, uint x, char c)
	on specified window, move to y, x, add character
int	ui_draw_text (UiSurface *s, ss_t w, uint y, uint x, const char *text)
	on specified window, move to y, x, add string
int	ui_draw_text_fill (UiSurface *s, ss_t w, uint y, uint x, const char *text, int m)
	on specified window, move to y, x, add string, at most m columns, fill with spaces if text is shorter than m
int	ui_draw_text_n (UiSurface *s, ss_t w, uint y, uint x, const char *text, int m)
	on specified window, move to y, x, add string, at most m columns
int	ui_mvwadd_wch (UiSurface *s, ss_t w, uint y, uint x, const UiCell *cell)
	on specified window, move to y, x, add cell
int	ui_mvwadd_wchnstr (UiSurface *s, ss_t w, uint y, uint x, const UiCell *cell, uint m)
	on specified window, move to y, x, add cell string, at most m columns
int	ui_mvwadd_wchstr (UiSurface *s, ss_t w, uint y, uint x, const UiCell *cell)
	on specified window, move to y, x, add cell string
int	ui_mvwaddch (UiSurface *s, ss_t w, uint y, uint x, const char c)
	on specified window, move to y, x, add character
int	ui_mvwaddnstr (UiSurface *s, ss_t w, uint y, uint x, const char *text, int m)
	on specified window, move to y, x, add string, at most m columns
int	ui_mvwaddnwstr (UiSurface *s, ss_t w, uint y, uint x, const wchar_t *wstr, int m)
	on specified window, move to y, x, add string, at most m columns
int	ui_mvwaddstr (UiSurface *s, ss_t w, uint y, uint x, const char *text)
	on specified window, move to y, x, add string
int	ui_mvwaddstr_fill (UiSurface *s, ss_t w, uint y, uint x, const char *text, int m)
	on specified window, move to y, x, add string, at most m columns, fill with spaces if text is shorter than m
int	ui_mvwaddwstr (UiSurface *s, ss_t w, uint y, uint x, const wchar_t *wstr)
	on specified window, move to y, x, add wchar_t string
void	ui_restore_wins ()
	Restore the state of all windows in the UI. This function refreshes the standard screen and all surface windows, ensuring that their contents are displayed correctly.
int	ui_wadd_wch (UiSurface *s, ss_t w, const UiCell *cell)
	on specified window, at current location, add cell
int	ui_wadd_wchnstr (UiSurface *s, ss_t w, const UiCell *cell, uint m)
	on specified window, add cell string, at most m columns
int	ui_wadd_wchstr (UiSurface *s, ss_t w, const UiCell *cell)
	on specified window, at current location, add cell string
int	ui_waddch (UiSurface *s, ss_t w, const char c)
	on specified window, at current location, add character
int	ui_waddnstr (UiSurface *s, ss_t w, const char *text, int m)
	on specified window, at current location, add string, at most m columns
int	ui_waddnwstr (UiSurface *s, ss_t w, const wchar_t *wstr, int m)
	on specified window, at current location, add wchar_t string, at most m columns
int	ui_waddstr (UiSurface *s, ss_t w, const char *text)
	on specified window, at current location, add string
int	ui_waddwstr (UiSurface *s, ss_t w, const wchar_t *wstr)
	on specified window, at current location, add wchar_t string
int	ui_wclrtobot (UiSurface *s, ss_t w)
	clear from current cursor position to bottom of window
int	ui_wclrtoeol (UiSurface *s, ss_t w)
	clear the window from the current cursor position to the end of the window

Detailed Description

NotCurses UI backend — drawing functions.

Implements the drawing operations declared in ui_backend.h using the NotCurses API.

Definition in file ui_notcurses_draw.c.

Macro Definition Documentation

_GNU_SOURCE

#define _GNU_SOURCE

Definition at line 8 of file ui_notcurses_draw.c.

_XOPEN_SOURCE_EXTENDED

#define _XOPEN_SOURCE_EXTENDED   1

Definition at line 9 of file ui_notcurses_draw.c.

Function Documentation

mk_chimera()

int mk_chimera	(	UiCell *	cell,
		char	c )

create a cell with specified character, using background cell style and channels

Parameters

cell	pointer to UiCell
c	character

Returns

0 on success, -1 on error

Definition at line 66 of file ui_notcurses_draw.c.

                                     {
    cell->gcluster = c;
    cell->gcluster_backstop = 0;
    cell->stylemask = bkgd_cell.stylemask;
    cell->channels = bkgd_cell.channels;
    return 0;
}

ui_display_image()

struct ncvisual * ui_display_image	(	struct notcurses *	nc,
		UiMultiMedia *	mm,
		const char *	image_file,
		int	y,
		int	x,
		int	begy,
		int	begx )

display an image on the terminal using NotCurses

Parameters

nc	NotCurses context
mm	UiMultiMedia structure to hold the image and surface
image_file	path to the image file
y	height of the image display area (or -1 for full height)
x	width of the image display area (or -1 for full width)
begy	starting row for the image display area (or -1 for top)
begx	starting column for the image display area (or -1 for left)

Returns

pointer to the ncvisual structure on success, nullptr on error

Definition at line 466 of file ui_notcurses_draw.c.

                                                                                                                                    {
    struct ncplane *stdn = notcurses_stdplane(nc);
    unsigned term_rows, term_cols;
    ncplane_dim_yx(stdn, &term_rows, &term_cols);
    mm->ncv = ncvisual_from_file(image_file);
    if (!mm->ncv) {
        fprintf(stderr, "Error: Could not load image file.\n");
        return nullptr;
    }
    struct ncvgeom geom;
    if (ncvisual_geom(nc, mm->ncv, NULL, &geom) < 0) {
        ncvisual_destroy(mm->ncv);
        return nullptr;
    }
    if (begy == -1)
        begy = 0;
    if (begx == -1)
        begx = 0;
    if (y == -1)
        y = (int)term_rows - begy;
    if (x == -1)
        x = (int)term_cols - begx;
    if (begy + y > (int)term_rows)
        y = (int)term_rows - begy;
    if (begx + x > (int)term_cols)
        x = (int)term_cols - begx;
    int max_rows = y - 2;
    int max_cols = x - 2;
    if (max_rows <= 0) {
        ncvisual_destroy(mm->ncv);
        return nullptr;
    }
    struct ncvisual_options vopts_calc = {
        .scaling = NCSCALE_SCALE_HIRES,
        .blitter = NCBLIT_PIXEL,
    };
    struct ncplane_options nopts = {
        .y = begy,
        .x = x,
        .rows = max_rows,
        .cols = max_cols,
    };
    struct ncplane *tmp_bound_plane = ncplane_create(stdn, &nopts);
    if (!tmp_bound_plane) {
        ncvisual_destroy(mm->ncv);
        return nullptr;
    }
    vopts_calc.n = tmp_bound_plane;
    if (ncvisual_geom(nc, mm->ncv, &vopts_calc, &geom) < 0) {
        ncplane_destroy(tmp_bound_plane);
        ncvisual_destroy(mm->ncv);
        return nullptr;
    }
    unsigned rows = geom.rcelly;
    unsigned cols = geom.rcellx;
    // dimensions
    ncplane_destroy(tmp_bound_plane);
    mm->sfc = ui_surface_box(stdsfc, BOX, rows + 2, cols + 2, begy, 0, image_file);
    ui_surface_addwin(mm->sfc, WIN, BOX, rows, cols, 1, 1);
    struct ncvisual_options vopts = {
        .n = mm->sfc->mplane[WIN],
        .scaling = NCSCALE_SCALE_HIRES,
        .blitter = NCBLIT_PIXEL,
    };
    ncvisual_blit(nc, mm->ncv, &vopts);
    notcurses_render(nc);
    return mm->ncv;
}

References UiMultiMedia::ncv, UiMultiMedia::sfc, stdsfc, ui_surface_addwin(), and ui_surface_box().

Here is the call graph for this function:

ui_draw_ch()

int ui_draw_ch	(	UiSurface *	s,
		ss_t	w,
		char	c )

on specified window, at current location, add character

Draw a character in a surface window.

Parameters

s	surface
w	window
c	character

Returns

0 on success, -1 on error

Definition at line 79 of file ui_notcurses_draw.c.

                                             {
    if (!s || !c)
        return -1;
    nccell cell = CELL_INITIALIZER(c, s->meta[w].bkgd_cell.stylemask, s->meta[w].bkgd_cell.channels);
    ncplane_putc_yx(s->mplane[w], -1, -1, &cell);
    return 0;
}

ui_draw_ch_yx()

int ui_draw_ch_yx	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		char	c )

on specified window, move to y, x, add character

Draw a character at a specific position in a surface window.

Parameters

s	surface
w	window
y	row
x	column
c	character

Returns

0 on success, -1 on error

Definition at line 94 of file ui_notcurses_draw.c.

                                                                {
    if (!s || !c)
        return -1;
    nccell cell = CELL_INITIALIZER(c, s->meta[w].bkgd_cell.stylemask, s->meta[w].bkgd_cell.channels);
    ncplane_putc_yx(s->mplane[w], y, x, &cell);
    return 0;
}

Referenced by menu_cmd_processor().

Here is the caller graph for this function:

ui_draw_text()

int ui_draw_text	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const char *	text )

on specified window, move to y, x, add string

Parameters

s	surface
w	window
y	row
x	column
text	string

Returns

0 on success, -1 on error

Definition at line 109 of file ui_notcurses_draw.c.

                                                                         {
    if (!s || !text)
        return -1;
    ncplane_putstr_yx(s->mplane[w], y, x, text);
    return 0;
}

Referenced by ui_action_disposition(), ui_answer_yn(), ui_display_error(), ui_perror(), ui_timeout_prompt(), and ui_update_timeout_prompt().

Here is the caller graph for this function:

ui_draw_text_fill()

int ui_draw_text_fill	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const char *	text,
		int	m )

on specified window, move to y, x, add string, at most m columns, fill with spaces if text is shorter than m

Draw a text string at a specific position in a surface window, filling the remaining space with spaces if the string is shorter than n.

Parameters

s	surface
w	window
y	row
x	column
text	string
m	maximum number of columns to write

Returns

0 on success, -1 on error

Definition at line 139 of file ui_notcurses_draw.c.

                                                                                     {
    if (!s || !text)
        return -1;
    char tmp_str[MAXLEN];
    strncpy(tmp_str, text, m);
    int l = strlen(text);
    for (int i = l; i < m; i++) {
        tmp_str[i] = ' ';
    }
    tmp_str[m] = '\0';
    ncplane_putnstr_yx(s->mplane[w], y, x, m, tmp_str);
    ui_render();
    return 0;
}

References ui_render().

Referenced by menu_cmd_processor(), and menu_engine().

Here is the call graph for this function:

Here is the caller graph for this function:

ui_draw_text_n()

int ui_draw_text_n	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const char *	text,
		int	m )

on specified window, move to y, x, add string, at most m columns

Draw a text string at a specific position in a surface window.

Parameters

s	surface
w	window
y	row
x	column
text	string
m	maximum number of columns to write

Returns

0 on success, -1 on error

Definition at line 124 of file ui_notcurses_draw.c.

                                                                                  {
    if (!s || !text)
        return -1;
    ncplane_putnstr_yx(s->mplane[w], y, x, m, text);
    return 0;
}

ui_mvwadd_wch()

int ui_mvwadd_wch	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const UiCell *	cell )

on specified window, move to y, x, add cell

Parameters

s	surface
w	window
y	row
x	column
cell	cell string

Returns

0 on success, -1 on error

Definition at line 363 of file ui_notcurses_draw.c.

                                                                            {
    if (!s)
        return -1;
    ncplane_putc_yx(s->mplane[w], y, x, cell);
    return 0;
}

ui_mvwadd_wchnstr()

int ui_mvwadd_wchnstr	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const UiCell *	cell,
		uint	m )

on specified window, move to y, x, add cell string, at most m columns

Parameters

s	surface
w	window
y	row
x	column
cell	cell string
m	maximum number of columns to write

Returns

0 on success, -1 on error

Definition at line 430 of file ui_notcurses_draw.c.

                                                                                        {
    if (!s)
        return -1;
    ui_wmove(s, w, y, x);
    uint cols = 0;
    while (cell->gcluster != 0 && cols < m) {
        ncplane_putc(s->mplane[w], cell);
        cols += cell->width;
        cell++;
    }
    return 0;
}

References ui_wmove().

Here is the call graph for this function:

ui_mvwadd_wchstr()

int ui_mvwadd_wchstr	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const UiCell *	cell )

on specified window, move to y, x, add cell string

Parameters

s	surface
w	window
y	row
x	column
cell	cell string

Returns

0 on success, -1 on error

Definition at line 393 of file ui_notcurses_draw.c.

                                                                               {
    if (!s)
        return -1;
    ui_wmove(s, w, y, x);
    while (cell->gcluster != 0) {
        ncplane_putc(s->mplane[w], cell);
        cell++;
    }
    return 0;
}

References ui_wmove().

Here is the call graph for this function:

ui_mvwaddch()

int ui_mvwaddch	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const char	c )

on specified window, move to y, x, add character

Parameters

s	surface
w	window
y	row
x	column
c	character

Returns

0 on success, -1 on error

Definition at line 175 of file ui_notcurses_draw.c.

                                                                    {
    if (!s || !c)
        return -1;
    nccell cell = CELL_INITIALIZER(c, s->meta[w].bkgd_cell.stylemask, s->meta[w].bkgd_cell.channels);
    ncplane_putc_yx(s->mplane[w], y, x, &cell);
    return 0;
}

ui_mvwaddnstr()

int ui_mvwaddnstr	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const char *	text,
		int	m )

on specified window, move to y, x, add string, at most m columns

Parameters

s	surface
w	window
y	row
x	column
text	string
m	maximum number of columns to write

Returns

0 on success, -1 on error

Definition at line 230 of file ui_notcurses_draw.c.

                                                                                 {
    if (!s || !text)
        return -1;
    ncplane_putnstr_yx(s->mplane[w], y, x, m, text);
    return 0;
}

ui_mvwaddnwstr()

int ui_mvwaddnwstr	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const wchar_t *	wstr,
		int	m )

on specified window, move to y, x, add string, at most m columns

Parameters

s	surface
w	window
y	row
x	column
wchar_t	string
m	maximum number of columns to write

Returns

0 on success, -1 on error

Definition at line 324 of file ui_notcurses_draw.c.

                                                                                     {
    if (!s || !wstr)
        return -1;
    int cols = 0;
    int width;
    while (*wstr != L'\0') {
        width = wcwidth(*wstr);
        if (width < 0)
            width = 0;
        if (cols + width > m)
            break;
        ncplane_putwc_yx(s->mplane[w], y, x++, *wstr++);
        cols += wcwidth(*wstr);
    }
    return 0;
}

ui_mvwaddstr()

int ui_mvwaddstr	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const char *	text )

on specified window, move to y, x, add string

Parameters

s	surface
w	window
y	row
x	column
text	string

Returns

0 on success, -1 on error

Definition at line 215 of file ui_notcurses_draw.c.

                                                                         {
    if (!s || !text)
        return -1;
    ncplane_putstr_yx(s->mplane[w], y, x, text);
    return 0;
}

ui_mvwaddstr_fill()

int ui_mvwaddstr_fill	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const char *	text,
		int	m )

on specified window, move to y, x, add string, at most m columns, fill with spaces if text is shorter than m

Parameters

s	surface
w	window
y	row
x	column
text	string
m	maximum number of columns to write

Returns

0 on success, -1 on error

Definition at line 245 of file ui_notcurses_draw.c.

                                                                                     {
    if (!s || !text)
        return -1;
    int l = strlen(text);
    if (l <= m) {
        char *tmp_str = (char *)malloc(m + 1);
        if (!tmp_str)
            return -1;
        strcpy(tmp_str, text);
        for (int i = l; i < (int)m; i++) {
            tmp_str[i] = ' ';
        }
        tmp_str[m] = '\0';
        ncplane_putnstr_yx(s->mplane[w], y, x, m, tmp_str);
        free(tmp_str);
    }
    return 0;
}

ui_mvwaddwstr()

int ui_mvwaddwstr	(	UiSurface *	s,
		ss_t	w,
		uint	y,
		uint	x,
		const wchar_t *	wstr )

on specified window, move to y, x, add wchar_t string

Parameters

s	surface
w	window
wchar_t	string

Returns

0 on success, -1 on error

Definition at line 285 of file ui_notcurses_draw.c.

                                                                             {
    if (!s || !wstr)
        return -1;
    while (*wstr != L'\0')
        ncplane_putwc_yx(s->mplane[w], y, x++, *wstr++);
    return 0;
}

ui_restore_wins()

void ui_restore_wins

(

)

Restore the state of all windows in the UI. This function refreshes the standard screen and all surface windows, ensuring that their contents are displayed correctly.

Definition at line 445 of file ui_notcurses_draw.c.

                       {
    //  for (int s = 0; s <= sfc_ptr; s++) {
    //      for (int w = 0; w < 8; w++)
    //          if (ui_surface[s]->mplane[w] != nullptr)
    //      touchwin(ui_surface[s]->mplane[w]);
    //  }
    //  ui_render(ui);
}

References sfc_ptr, SUB_SFC_MAX, ui_render(), and ui_surface.

Referenced by enter_file_spec(), exec_objects(), fork_exec(), form_exec_receiver(), full_screen_shell(), menu_cmd_processor(), menu_engine(), view_cmd_processor(), view_init_input(), and write_view_buffer().

Here is the call graph for this function:

Here is the caller graph for this function:

ui_wadd_wch()

int ui_wadd_wch	(	UiSurface *	s,
		ss_t	w,
		const UiCell *	cell )

on specified window, at current location, add cell

Parameters

s	surface
w	window
cell	cell string

Returns

0 on success, -1 on error

Definition at line 349 of file ui_notcurses_draw.c.

                                                          {
    if (!s)
        return -1;
    ncplane_putc(s->mplane[w], cell);
    return 0;
}

ui_wadd_wchnstr()

int ui_wadd_wchnstr	(	UiSurface *	s,
		ss_t	w,
		const UiCell *	cell,
		uint	m )

on specified window, add cell string, at most m columns

Parameters

s	surface
w	window
cell	cell string
m	maximum number of columns to write

Returns

0 on success, -1 on error

Definition at line 410 of file ui_notcurses_draw.c.

                                                                      {
    if (!s)
        return -1;
    uint cols = 0;
    while (cell->gcluster != 0 && cols < m) {
        ncplane_putc(s->mplane[w], cell);
        cols += cell->width;
        cell++;
    }
    return 0;
}

ui_wadd_wchstr()

int ui_wadd_wchstr	(	UiSurface *	s,
		ss_t	w,
		const UiCell *	cell )

on specified window, at current location, add cell string

Parameters

s	surface
w	window
cell	cell string

Returns

0 on success, -1 on error

Definition at line 376 of file ui_notcurses_draw.c.

                                                             {
    if (!s)
        return -1;
    while (cell->gcluster != 0) {
        ncplane_putc(s->mplane[w], cell);
        cell++;
    }
    return 0;
}

ui_waddch()

int ui_waddch	(	UiSurface *	s,
		ss_t	w,
		const char	c )

on specified window, at current location, add character

Parameters

s	surface
w	window
c	character

Returns

0 on success, -1 on error

Definition at line 160 of file ui_notcurses_draw.c.

                                                  {
    if (!s || !c)
        return -1;
    nccell cell = CELL_INITIALIZER(c, s->meta[w].bkgd_cell.stylemask, s->meta[w].bkgd_cell.channels);
    ncplane_putc_yx(s->mplane[w], -1, -1, &cell);
    return 0;
}

ui_waddnstr()

int ui_waddnstr	(	UiSurface *	s,
		ss_t	w,
		const char *	text,
		int	m )

on specified window, at current location, add string, at most m columns

Parameters

s	surface
w	window
text	string
m	maximum number of columns to write

Returns

0 on success, -1 on error

Definition at line 201 of file ui_notcurses_draw.c.

                                                               {
    if (!s || !text)
        return -1;
    ncplane_putnstr(s->mplane[w], m, text);
    return 0;
}

ui_waddnwstr()

int ui_waddnwstr	(	UiSurface *	s,
		ss_t	w,
		const wchar_t *	wstr,
		int	m )

on specified window, at current location, add wchar_t string, at most m columns

Parameters

s	surface
w	window
wchar_t	string
m	maximum number of columns to write

Returns

0 on success, -1 on error

Definition at line 300 of file ui_notcurses_draw.c.

                                                                   {
    if (!s || !wstr)
        return -1;
    int cols = 0;
    int width;
    while (*wstr != L'\0') {
        width = wcwidth(*wstr);
        if (width < 0)
            width = 0;
        if (cols + width > m)
            break;
        ncplane_putwc_yx(s->mplane[w], -1, -1, *wstr++);
    }
    return 0;
}

ui_waddstr()

int ui_waddstr	(	UiSurface *	s,
		ss_t	w,
		const char *	text )

on specified window, at current location, add string

Parameters

s	surface
w	window
text	string

Returns

0 on success, -1 on error

Definition at line 188 of file ui_notcurses_draw.c.

                                                       {
    if (!s || !text)
        return -1;
    ncplane_putstr(s->mplane[w], text);
    return 0;
}

ui_waddwstr()

int ui_waddwstr	(	UiSurface *	s,
		ss_t	w,
		const wchar_t *	wstr )

on specified window, at current location, add wchar_t string

Parameters

s	surface
w	window
wchar_t	string

Returns

0 on success, -1 on error

Definition at line 272 of file ui_notcurses_draw.c.

                                                           {
    if (!s || !wstr)
        return -1;
    while (*wstr != L'\0')
        ncplane_putwc_yx(s->mplane[w], -1, -1, *wstr++);
    return 0;
}

ui_wclrtobot()

int ui_wclrtobot	(	UiSurface *	s,
		ss_t	w )

clear from current cursor position to bottom of window

Set the style of a surface window.

Parameters

s	surface
w	window

Returns

0 on success, -1 on error

Definition at line 42 of file ui_notcurses_draw.c.

                                       {
    if (!s)
        return -1;
    uint y, x, ylen, xlen, maxy, maxx;
    ncplane_cursor_yx(s->mplane[w], &y, &x);
    ncplane_dim_yx(s->mplane[w], &maxy, &maxx);
    xlen = maxx - x;
    ylen = 1;
    ncplane_erase_region(s->mplane[w], y, x, ylen, xlen);
    ylen = maxy - y - 1;
    xlen = maxx;
    ncplane_erase_region(s->mplane[w], y + 1, x = 0, ylen, maxx);
    return 0;
}

Referenced by display_line_eod(), scroll_next(), scroll_prev(), and search().

Here is the caller graph for this function:

ui_wclrtoeol()

int ui_wclrtoeol	(	UiSurface *	s,
		ss_t	w )

clear the window from the current cursor position to the end of the window

Clear to the end of the line in a surface window.

Parameters

s	surface
w	window

Returns

0 on success, -1 on error

Definition at line 26 of file ui_notcurses_draw.c.

                                       {
    if (!s)
        return -1;
    uint y, x, ylen, xlen, maxy, maxx;
    ncplane_cursor_yx(s->mplane[w], &y, &x);
    ncplane_dim_yx(s->mplane[w], &maxy, &maxx);
    xlen = maxx - x;
    ylen = 1;
    ncplane_erase_region(s->mplane[w], y, x, ylen, xlen);
    return 0;
}

Referenced by cf_accept(), display_line(), display_prompt(), display_split_line(), form_post(), get_cmd_arg(), get_cmd_char(), pick_engine(), picker(), ui_display_chyron(), and ui_update_timeout_prompt().

Here is the caller graph for this function: