msgwin.c File Reference

Message Window. More...

#include "config.h"
#include <stddef.h>
#include <stdbool.h>
#include <string.h>
#include <wchar.h>
#include "mutt/lib.h"
#include "msgwin.h"
#include "color/lib.h"
#include "msgcont.h"
#include "msgwin_wdata.h"
#include "mutt_curses.h"
#include "mutt_window.h"

Include dependency graph for msgwin.c:

Go to the source code of this file.

Functions
void	measure (struct MwCharArray *chars, const char *str, const struct AttrColor *ac_color)
	Measure a string in bytes and cells.
static int	msgwin_recalc (struct MuttWindow *win)
	Recalculate the display of the Message Window - Implements MuttWindow::recalc() -.
int	msgwin_calc_rows (struct MsgWinWindowData *wdata, int cols, const char *str)
	How many rows will a string need?
static int	msgwin_repaint (struct MuttWindow *win)
	Redraw the Message Window - Implements MuttWindow::repaint() -.
static bool	msgwin_recursor (struct MuttWindow *win)
	Recursor the Message Window - Implements MuttWindow::recursor() -.
void	msgwin_set_rows (struct MuttWindow *win, short rows)
	Resize the Message Window.
static int	msgwin_window_observer (struct NotifyCallback *nc)
	Notification that a Window has changed - Implements observer_t -.
struct MuttWindow *	msgwin_new (bool interactive)
	Create the Message Window.
const char *	msgwin_get_text (struct MuttWindow *win)
	Get the text from the Message Window.
void	msgwin_add_text (struct MuttWindow *win, const char *text, const struct AttrColor *ac_color)
	Add text to the Message Window.
void	msgwin_add_text_n (struct MuttWindow *win, const char *text, int bytes, const struct AttrColor *ac_color)
	Add some text to the Message Window.
void	msgwin_set_text (struct MuttWindow *win, const char *text, enum ColorId color)
	Set the text for the Message Window.
void	msgwin_clear_text (struct MuttWindow *win)
	Clear the text in the Message Window.
struct MuttWindow *	msgwin_get_window (void)
	Get the Message Window pointer.

Detailed Description

Message Window.

Authors

• Richard Russon

Copyright

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, see http://www.gnu.org/licenses/.

Definition in file msgwin.c.

Function Documentation

measure()

void measure	(	struct MwCharArray *	chars,
		const char *	str,
		const struct AttrColor *	ac_color
	)

Measure a string in bytes and cells.

Parameters

chars	Results
str	String to measure
ac_color	Colour to associate

Calculate the size of each character in a string in bytes and screen cells.

Definition at line 106 of file msgwin.c.

{
  if (!str || !*str)
    return;
 
  mbstate_t mbstate = { 0 };
  struct MwChar mwc = { 0 };
 
  size_t str_len = mutt_str_len(str);
 
  while (*str && (str_len > 0))
  {
    wchar_t wc = L'\0';
    size_t consumed = mbrtowc(&wc, str, str_len, &mbstate);
    if (consumed == 0)
      break;
 
    if (consumed == ICONV_ILLEGAL_SEQ)
    {
      memset(&mbstate, 0, sizeof(mbstate));
      wc = ReplacementChar;
      consumed = 1;
    }
    else if (consumed == ICONV_BUF_TOO_SMALL)
    {
      wc = ReplacementChar;
      consumed = str_len;
    }
 
    int wchar_width = wcwidth(wc);
    if (wchar_width < 0)
      wchar_width = 1;
 
    if (wc == 0xfe0f) // Emoji variation
    {
      size_t size = ARRAY_SIZE(chars);
      if (size > 0)
      {
        struct MwChar *es_prev = ARRAY_GET(chars, size - 1);
        if (es_prev->width == 1)
          es_prev->width = 2;
      }
    }
 
    mwc = (struct MwChar){ wchar_width, consumed, ac_color };
    ARRAY_ADD(chars, mwc);
 
    str += consumed;
    str_len -= consumed;
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

msgwin_calc_rows()

int msgwin_calc_rows	(	struct MsgWinWindowData *	wdata,
		int	cols,
		const char *	str
	)

How many rows will a string need?

Parameters

wdata	Window data
cols	Columns to wrap at
str	Text to measure

Return values

num	Number of rows required
0	Error

Divide the width of a string by the width of the Message Window.

< Screen width used

< Offset into str

< Current row

Definition at line 178 of file msgwin.c.

{
  if (!wdata || !str || !*str)
    return 0;
 
  for (int i = 0; i < MSGWIN_MAX_ROWS; i++)
  {
    ARRAY_FREE(&wdata->rows[i]);
  }
 
  int width = 0;  
  int offset = 0; 
  int row = 0;    
  bool new_row = false;
 
  struct MwChunk *chunk = NULL;
  struct MwChar *mwc = NULL;
  ARRAY_FOREACH(mwc, &wdata->chars)
  {
    const bool nl = (mwc->bytes == 1) && (str[offset] == '\n');
    if (nl)
    {
      new_row = true;
      offset += mwc->bytes;
      continue;
    }
 
    if (((width + mwc->width) > cols) || new_row)
    {
      // ROW IS FULL
      new_row = false;
 
      row++;
      if (row >= MSGWIN_MAX_ROWS)
      {
        // NO MORE ROOM
        break;
      }
 
      // Start a new row
      struct MwChunk tmp = { offset, mwc->bytes, mwc->width, mwc->ac_color };
 
      mutt_debug(LL_DEBUG5, "row = %d\n", row);
      ARRAY_ADD(&wdata->rows[row], tmp);
      chunk = ARRAY_LAST(&wdata->rows[row]);
 
      width = 0;
    }
    else if (!chunk || (mwc->ac_color != chunk->ac_color))
    {
      // CHANGE OF COLOUR
      struct MwChunk tmp = { offset, mwc->bytes, mwc->width, mwc->ac_color };
      ARRAY_ADD(&wdata->rows[row], tmp);
      chunk = ARRAY_LAST(&wdata->rows[row]);
    }
    else
    {
      // MORE OF THE SAME
      chunk->bytes += mwc->bytes;
      chunk->width += mwc->width;
    }
 
    offset += mwc->bytes;
    width += mwc->width;
  }
 
  mutt_debug(LL_DEBUG5, "msgwin_calc_rows() => %d\n", row + 1);
  return row + 1;
}

Here is the caller graph for this function:

msgwin_set_rows()

void msgwin_set_rows	(	struct MuttWindow *	win,
		short	rows
	)

Resize the Message Window.

Parameters

win	Message Window
rows	Number of rows required

Resize the other Windows to allow a multi-line message to be displayed.

Note

rows will be clamped between 1 and 3 (MSGWIN_MAX_ROWS) inclusive

Definition at line 303 of file msgwin.c.

{
  if (!win)
    win = msgcont_get_msgwin();
  if (!win)
    return;
 
  rows = CLAMP(rows, 1, MSGWIN_MAX_ROWS);
 
  if (rows != win->state.rows)
  {
    win->req_rows = rows;
    mutt_window_reflow(NULL);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

msgwin_new()

struct MuttWindow * msgwin_new

(

bool

interactive

)

Create the Message Window.

Return values

ptr	New Window

Definition at line 371 of file msgwin.c.

{
  struct MuttWindow *win = mutt_window_new(WT_MESSAGE, MUTT_WIN_ORIENT_VERTICAL, MUTT_WIN_SIZE_FIXED,
                                           MUTT_WIN_SIZE_UNLIMITED, 1);
 
  struct MsgWinWindowData *wdata = msgwin_wdata_new();
 
  win->wdata = wdata;
  win->wdata_free = msgwin_wdata_free;
  win->recalc = msgwin_recalc;
  win->repaint = msgwin_repaint;
 
  if (interactive)
    win->recursor = msgwin_recursor;
 
  // Copy the container's dimensions
  win->state = MessageContainer->state;
 
  notify_observer_add(win->notify, NT_WINDOW, msgwin_window_observer, win);
 
  return win;
}

Here is the call graph for this function:

Here is the caller graph for this function:

msgwin_get_text()

const char * msgwin_get_text

(

struct MuttWindow *

win

)

Get the text from the Message Window.

Parameters

win	Message Window

Return values

ptr	Window text

Note

Do not free the returned string

Definition at line 401 of file msgwin.c.

{
  if (!win)
    win = msgcont_get_msgwin();
  if (!win)
    return NULL;
 
  struct MsgWinWindowData *wdata = win->wdata;
 
  return buf_string(wdata->text);
}

Here is the call graph for this function:

Here is the caller graph for this function:

msgwin_add_text()

void msgwin_add_text	(	struct MuttWindow *	win,
		const char *	text,
		const struct AttrColor *	ac_color
	)

Add text to the Message Window.

Parameters

win	Message Window
text	Text to add
ac_color	Colour for text

Definition at line 419 of file msgwin.c.

{
  if (!win)
    win = msgcont_get_msgwin();
  if (!win)
    return;
 
  struct MsgWinWindowData *wdata = win->wdata;
 
  if (text)
  {
    buf_addstr(wdata->text, text);
    measure(&wdata->chars, text, ac_color);
    mutt_debug(LL_DEBUG5, "MW ADD: %zu, %s\n", buf_len(wdata->text),
               buf_string(wdata->text));
  }
  else
  {
    int rows = msgwin_calc_rows(wdata, win->state.cols, buf_string(wdata->text));
    msgwin_set_rows(win, rows);
    win->actions |= WA_RECALC;
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

msgwin_add_text_n()

void msgwin_add_text_n	(	struct MuttWindow *	win,
		const char *	text,
		int	bytes,
		const struct AttrColor *	ac_color
	)

Add some text to the Message Window.

Parameters

win	Message Window
text	Text to add
bytes	Number of bytes of text to add
ac_color	Colour for text

Definition at line 450 of file msgwin.c.

{
  if (!win)
    win = msgcont_get_msgwin();
  if (!win)
    return;
 
  struct MsgWinWindowData *wdata = win->wdata;
 
  if (text)
  {
    const char *dptr = wdata->text->dptr;
    buf_addstr_n(wdata->text, text, bytes);
    measure(&wdata->chars, dptr, ac_color);
    mutt_debug(LL_DEBUG5, "MW ADD: %zu, %s\n", buf_len(wdata->text),
               buf_string(wdata->text));
  }
  else
  {
    int rows = msgwin_calc_rows(wdata, win->state.cols, buf_string(wdata->text));
    msgwin_set_rows(win, rows);
    win->actions |= WA_RECALC;
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

msgwin_set_text()

void msgwin_set_text	(	struct MuttWindow *	win,
		const char *	text,
		enum ColorId	color
	)

Set the text for the Message Window.

Parameters

win	Message Window
text	Text to set
color	Colour for text

Note

The text string will be copied

Definition at line 484 of file msgwin.c.

{
  if (!win)
    win = msgcont_get_msgwin();
  if (!win)
    return;
 
  struct MsgWinWindowData *wdata = win->wdata;
 
  if (mutt_str_equal(buf_string(wdata->text), text))
    return;
 
  buf_strcpy(wdata->text, text);
  ARRAY_FREE(&wdata->chars);
  if (wdata->text)
  {
    const struct AttrColor *ac_color = simple_color_get(color);
    measure(&wdata->chars, buf_string(wdata->text), ac_color);
  }
 
  mutt_debug(LL_DEBUG5, "MW SET: %zu, %s\n", buf_len(wdata->text),
             buf_string(wdata->text));
 
  int rows = msgwin_calc_rows(wdata, win->state.cols, buf_string(wdata->text));
  msgwin_set_rows(win, rows);
  win->actions |= WA_RECALC;
}

Here is the call graph for this function:

Here is the caller graph for this function:

msgwin_clear_text()

void msgwin_clear_text

(

struct MuttWindow *

win

)

Clear the text in the Message Window.

Parameters

win	Message Window

Definition at line 516 of file msgwin.c.

{
  msgwin_set_text(win, NULL, MT_COLOR_NORMAL);
}

Here is the call graph for this function:

Here is the caller graph for this function:

msgwin_get_window()

struct MuttWindow * msgwin_get_window

(

void

)

Get the Message Window pointer.

Return values

ptr	Message Window

Allow some users direct access to the Message Window.

Definition at line 527 of file msgwin.c.

{
  return msgcont_get_msgwin();
}

Here is the call graph for this function:

Here is the caller graph for this function: