popup.c File Reference

Go to the source code of this file.

Macros
#define	UI_POPUP_RENDERED_BUFFER_SIZE   1024

Functions
asciichat_error_t	ui_popup_rule (frame_buffer_t *out, int width, ui_popup_edge_t edge, bool double_border, bool unicode, log_color_t color)
asciichat_error_t	ui_popup_frame (frame_buffer_t *out, int row, int col, int width, int height, log_color_t color)
asciichat_error_t	ui_popup_frame_titled (frame_buffer_t *out, int row, int col, int width, int height, log_color_t color, const char *title)
bool	ui_popup_render (frame_buffer_t *output, terminal_size_t size, const ui_popup_t *box)

Macro Definition Documentation

UI_POPUP_RENDERED_BUFFER_SIZE

#define UI_POPUP_RENDERED_BUFFER_SIZE   1024

Definition at line 3 of file popup.c.

Referenced by ui_popup_frame_titled(), and ui_popup_render().

Function Documentation

ui_popup_frame()

asciichat_error_t ui_popup_frame	(	frame_buffer_t *	out,
		int	row,
		int	col,
		int	width,
		int	height,
		log_color_t	color )

Definition at line 28 of file popup.c.

                                                                                                                  {
  if (!out || row < 1 || col < 1 || width < 2 || height < 2)
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid popup frame output or rectangle");
  frame_buffer_printf(out, "\033[%d;%dH", row, col);
  ui_popup_rule(out, width, UI_POPUP_TOP, false, terminal_should_use_utf8(GET_OPTION(force_utf8)), color);
  const char *vertical = terminal_should_use_utf8(GET_OPTION(force_utf8)) ? "│" : "|";
  for (int i = 1; i < height - 1; ++i)
    frame_buffer_printf(out, "\033[%d;%dH%s%*s%s", row + i, col, colored_string(color, vertical), width - 2, "",
                        colored_string(color, vertical));
  frame_buffer_printf(out, "\033[%d;%dH", row + height - 1, col);
  return ui_popup_rule(out, width, UI_POPUP_BOTTOM, false, terminal_should_use_utf8(GET_OPTION(force_utf8)), color);
}

References colored_string(), ERROR_INVALID_PARAM, frame_buffer_printf(), GET_OPTION, height, out, SET_ERRNO, UI_POPUP_BOTTOM, ui_popup_rule(), UI_POPUP_TOP, and width.

Referenced by ui_error_popup_render(), ui_popup_frame_titled(), and ui_popup_render().

ui_popup_frame_titled()

asciichat_error_t ui_popup_frame_titled	(	frame_buffer_t *	output,
		int	row,
		int	column,
		int	width,
		int	height,
		log_color_t	color,
		const char *	title )

Draw a frame with a centered, clipped title embedded in its top border.

Definition at line 41 of file popup.c.

                                                           {
  if (!title || width < 5)
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid popup title or width");
  asciichat_error_t result = ui_popup_frame(out, row, col, width, height, color);
  if (result != ASCIICHAT_OK)
    return result;
  char rendered[UI_POPUP_RENDERED_BUFFER_SIZE];
  truncate_with_ellipsis(title, rendered, sizeof(rendered), width - 4);
  int title_width = display_width(rendered);
  frame_buffer_printf(out, "\033[%d;%dH %s ", row, col + (width - title_width - 2) / 2,
                      colored_string(LOG_COLOR_RESET, rendered));
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK, colored_string(), display_width(), ERROR_INVALID_PARAM, frame_buffer_printf(), height, LOG_COLOR_RESET, out, SET_ERRNO, truncate_with_ellipsis(), ui_popup_frame(), UI_POPUP_RENDERED_BUFFER_SIZE, and width.

ui_popup_render()

bool ui_popup_render	(	frame_buffer_t *	output,
		terminal_size_t	size,
		const ui_popup_t *	box )

Draw a centered box without clearing the frame beneath it.

Definition at line 56 of file popup.c.

                                                                                          {
  if (!output || !box || !box->title || (box->line_count && !box->lines) || box->top_margin < 0) {
    SET_ERRNO(ERROR_INVALID_PARAM, "Invalid popup output, content or margins");
    return false;
  }
  if (size.cols < 8 || size.rows < 5)
    return false;
  int content_width = display_width(box->title);
  for (size_t i = 0; i < box->line_count; ++i) {
    int width = display_width(box->lines[i]);
    if (width > content_width)
      content_width = width;
  }
  if (box->footer && display_width(box->footer) > content_width)
    content_width = display_width(box->footer);
  int width = content_width + 4;
  if (width < box->minimum_width)
    width = box->minimum_width;
  if (width > size.cols - 2)
    width = size.cols - 2;
  int height = (int)box->line_count + (box->footer ? 5 : 4);
  if (height > size.rows - 2 - box->top_margin)
    return false;
  int left = (size.cols - width) / 2 + 1;
  int top = box->top_margin + (size.rows - box->top_margin - height) / 2 + 1;
  if (ui_popup_frame(output, top, left, width, height, LOG_COLOR_RESET) != ASCIICHAT_OK)
    return false;
  char rendered[UI_POPUP_RENDERED_BUFFER_SIZE];
  truncate_with_ellipsis(box->title, rendered, sizeof(rendered), width - 4);
  const char *colored_title = colored_string(LOG_COLOR_RESET, rendered);
  frame_buffer_printf(output, "\033[%d;%dH\033[1m%s\033[0m", top + 1, left + 2, colored_title);
  for (size_t i = 0; i < box->line_count; ++i) {
    truncate_with_ellipsis(box->lines[i], rendered, sizeof(rendered), width - 4);
    frame_buffer_printf(output, "\033[%d;%dH%s", top + 2 + (int)i, left + 2, rendered);
  }
  if (box->footer) {
    truncate_with_ellipsis(box->footer, rendered, sizeof(rendered), width - 4);
    frame_buffer_printf(output, "\033[%d;%dH\033[2m%s\033[0m", top + height - 2, left + 2, rendered);
  }
  return true;
}

References ASCIICHAT_OK, colored_string(), display_width(), ERROR_INVALID_PARAM, ui_popup_t::footer, frame_buffer_printf(), height, ui_popup_t::line_count, ui_popup_t::lines, LOG_COLOR_RESET, ui_popup_t::minimum_width, SET_ERRNO, ui_popup_t::title, ui_popup_t::top_margin, truncate_with_ellipsis(), ui_popup_frame(), UI_POPUP_RENDERED_BUFFER_SIZE, and width.

Referenced by ui_help_menu_render().

ui_popup_rule()

asciichat_error_t ui_popup_rule	(	frame_buffer_t *	output,
		int	width,
		ui_popup_edge_t	edge,
		bool	double_border,
		bool	unicode,
		log_color_t	color )

Shared chrome for streaming notices and nested dialog panels. No newline.

Definition at line 12 of file popup.c.

                                                   {
  if (!out || width < 2 || edge < UI_POPUP_TOP || edge > UI_POPUP_RULE)
    return SET_ERRNO(ERROR_INVALID_PARAM, "Invalid popup rule output, width or edge");
  static const char *single[][2] = {{"┌", "┐"}, {"├", "┤"}, {"└", "┘"}, {"", ""}};
  static const char *dual[][2] = {{"╔", "╗"}, {"╠", "╣"}, {"╚", "╝"}, {"", ""}};
  const char *left = edge == UI_POPUP_RULE ? "" : !unicode ? "+" : double_border ? dual[edge][0] : single[edge][0];
  const char *right = edge == UI_POPUP_RULE ? "" : !unicode ? "+" : double_border ? dual[edge][1] : single[edge][1];
  const char *horizontal = !unicode ? "-" : double_border ? "═" : "─";
  frame_buffer_printf(out, "%s", colored_string(color, left));
  for (int i = 0; i < width - (edge == UI_POPUP_RULE ? 0 : 2); ++i)
    frame_buffer_printf(out, "%s", colored_string(color, horizontal));
  frame_buffer_printf(out, "%s", colored_string(color, right));
  return ASCIICHAT_OK;
}

References ASCIICHAT_OK, colored_string(), ERROR_INVALID_PARAM, frame_buffer_printf(), out, SET_ERRNO, UI_POPUP_RULE, and width.

Referenced by ui_error_popup_preserve(), and ui_popup_frame().