color.h File Reference

Color and attribute parsing. More...

#include "config.h"
#include <regex.h>
#include <stdbool.h>
#include <stdint.h>
#include "mutt/mutt.h"
#include "mutt_commands.h"

Include dependency graph for color.h:

This graph shows which files directly or indirectly include this file:

Go to the source code of this file.

Data Structures
struct	ColorLine
	A regular expression and a color to highlight a line. More...
struct	ColorList
	A set of colors. More...
struct	Colors
struct	EventColor
	An Event that happened to an Colour. More...

Enumerations
enum	ColorId {   MT_COLOR_NONE = 50, MT_COLOR_ATTACHMENT, MT_COLOR_ATTACH_HEADERS, MT_COLOR_BODY,   MT_COLOR_BOLD, MT_COLOR_COMPOSE_HEADER, MT_COLOR_COMPOSE_SECURITY_BOTH, MT_COLOR_COMPOSE_SECURITY_ENCRYPT,   MT_COLOR_COMPOSE_SECURITY_NONE, MT_COLOR_COMPOSE_SECURITY_SIGN, MT_COLOR_ERROR, MT_COLOR_HDRDEFAULT,   MT_COLOR_HEADER, MT_COLOR_INDICATOR, MT_COLOR_MARKERS, MT_COLOR_MESSAGE,   MT_COLOR_MESSAGE_LOG, MT_COLOR_NORMAL, MT_COLOR_OPTIONS, MT_COLOR_PROGRESS,   MT_COLOR_PROMPT, MT_COLOR_QUOTED, MT_COLOR_SEARCH, MT_COLOR_SIDEBAR_DIVIDER,   MT_COLOR_SIDEBAR_FLAGGED, MT_COLOR_SIDEBAR_HIGHLIGHT, MT_COLOR_SIDEBAR_INDICATOR, MT_COLOR_SIDEBAR_NEW,   MT_COLOR_SIDEBAR_ORDINARY, MT_COLOR_SIDEBAR_SPOOLFILE, MT_COLOR_SIDEBAR_UNREAD, MT_COLOR_SIGNATURE,   MT_COLOR_STATUS, MT_COLOR_TILDE, MT_COLOR_TREE, MT_COLOR_UNDERLINE,   MT_COLOR_WARNING, MT_COLOR_INDEX, MT_COLOR_INDEX_AUTHOR, MT_COLOR_INDEX_FLAGS,   MT_COLOR_INDEX_SUBJECT, MT_COLOR_INDEX_TAG, MT_COLOR_INDEX_COLLAPSED, MT_COLOR_INDEX_DATE,   MT_COLOR_INDEX_LABEL, MT_COLOR_INDEX_NUMBER, MT_COLOR_INDEX_SIZE, MT_COLOR_INDEX_TAGS,   MT_COLOR_MAX }
	List of all colored objects. More...

Functions
	STAILQ_HEAD (ColorLineList, ColorLine)
int	mutt_color_alloc (struct Colors *c, uint32_t fg, uint32_t bg)
int	mutt_color_combine (struct Colors *c, uint32_t fg_attr, uint32_t bg_attr)
void	mutt_color_free (struct Colors *c, uint32_t fg, uint32_t bg)
	Free a colour. More...
struct Colors *	mutt_colors_new (void)
	Create new colours. More...
void	mutt_colors_free (struct Colors **ptr)
	Free all the colours. More...
enum CommandResult	mutt_parse_color (struct Buffer *buf, struct Buffer *s, unsigned long data, struct Buffer *err)
enum CommandResult	mutt_parse_mono (struct Buffer *buf, struct Buffer *s, unsigned long data, struct Buffer *err)
	Parse the 'mono' command - Implements command_t. More...
enum CommandResult	mutt_parse_uncolor (struct Buffer *buf, struct Buffer *s, unsigned long data, struct Buffer *err)
enum CommandResult	mutt_parse_unmono (struct Buffer *buf, struct Buffer *s, unsigned long data, struct Buffer *err)
	Parse the 'unmono' command - Implements command_t. More...

Detailed Description

Color and attribute parsing.

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 color.h.

Enumeration Type Documentation

ColorId

enum ColorId

List of all colored objects.

This enumeration starts at 50 to avoid any of the values being 37 (ASCII %). Inserting colour codes into expando strings, when one of the colour codes was '', was causing formatting problems.

Enumerator
MT_COLOR_NONE
MT_COLOR_ATTACHMENT	MIME attachments text (entire line)
MT_COLOR_ATTACH_HEADERS	MIME attachment test (takes a pattern)
MT_COLOR_BODY	Pager: highlight body of message (takes a pattern)
MT_COLOR_BOLD	Bold text.
MT_COLOR_COMPOSE_HEADER	Header labels, e.g. From:
MT_COLOR_COMPOSE_SECURITY_BOTH	Mail will be encrypted and signed.
MT_COLOR_COMPOSE_SECURITY_ENCRYPT	Mail will be encrypted.
MT_COLOR_COMPOSE_SECURITY_NONE	Mail will not be encrypted or signed.
MT_COLOR_COMPOSE_SECURITY_SIGN	Mail will be signed.
MT_COLOR_ERROR	Error message.
MT_COLOR_HDRDEFAULT	Header default colour.
MT_COLOR_HEADER	Message headers (takes a pattern)
MT_COLOR_INDICATOR	Selected item in list.
MT_COLOR_MARKERS	Pager: markers, line continuation.
MT_COLOR_MESSAGE	Informational message.
MT_COLOR_MESSAGE_LOG	Menu showing log messages.
MT_COLOR_NORMAL	Plain text.
MT_COLOR_OPTIONS	Options in prompt.
MT_COLOR_PROGRESS	Progress bar.
MT_COLOR_PROMPT	Question/user input.
MT_COLOR_QUOTED	Pager: quoted text.
MT_COLOR_SEARCH	Pager: search matches.
MT_COLOR_SIDEBAR_DIVIDER	Line dividing sidebar from the index/pager.
MT_COLOR_SIDEBAR_FLAGGED	Mailbox with flagged messages.
MT_COLOR_SIDEBAR_HIGHLIGHT	Select cursor.
MT_COLOR_SIDEBAR_INDICATOR	Current open mailbox.
MT_COLOR_SIDEBAR_NEW	Mailbox with new mail.
MT_COLOR_SIDEBAR_ORDINARY	Mailbox with no new or flagged messages.
MT_COLOR_SIDEBAR_SPOOLFILE	$spoolfile (Spool mailbox)
MT_COLOR_SIDEBAR_UNREAD	Mailbox with unread mail.
MT_COLOR_SIGNATURE	Pager: signature lines.
MT_COLOR_STATUS	Status bar (takes a pattern)
MT_COLOR_TILDE	Pager: empty lines after message.
MT_COLOR_TREE	Index: tree-drawing characters.
MT_COLOR_UNDERLINE	Underlined text.
MT_COLOR_WARNING	Warning messages.
MT_COLOR_INDEX	Index: default colour (takes a pattern)
MT_COLOR_INDEX_AUTHOR	Index: author field (takes a pattern)
MT_COLOR_INDEX_FLAGS	Index: flags field (takes a pattern)
MT_COLOR_INDEX_SUBJECT	Index: subject field (takes a pattern)
MT_COLOR_INDEX_TAG	Index: tag field (g, takes a pattern)
MT_COLOR_INDEX_COLLAPSED	Index: number of messages in collapsed thread.
MT_COLOR_INDEX_DATE	Index: date field.
MT_COLOR_INDEX_LABEL	Index: label field.
MT_COLOR_INDEX_NUMBER	Index: index number.
MT_COLOR_INDEX_SIZE	Index: size field.
MT_COLOR_INDEX_TAGS	Index: tags field (g, J)
MT_COLOR_MAX

Definition at line 59 of file color.h.

{
  MT_COLOR_NONE = 50,
  MT_COLOR_ATTACHMENT,               
  MT_COLOR_ATTACH_HEADERS,           
  MT_COLOR_BODY,                     
  MT_COLOR_BOLD,                     
  MT_COLOR_COMPOSE_HEADER,           
  MT_COLOR_COMPOSE_SECURITY_BOTH,    
  MT_COLOR_COMPOSE_SECURITY_ENCRYPT, 
  MT_COLOR_COMPOSE_SECURITY_NONE,    
  MT_COLOR_COMPOSE_SECURITY_SIGN,    
  MT_COLOR_ERROR,                    
  MT_COLOR_HDRDEFAULT,               
  MT_COLOR_HEADER,                   
  MT_COLOR_INDICATOR,                
  MT_COLOR_MARKERS,                  
  MT_COLOR_MESSAGE,                  
  MT_COLOR_MESSAGE_LOG,              
  MT_COLOR_NORMAL,                   
  MT_COLOR_OPTIONS,                  
  MT_COLOR_PROGRESS,                 
  MT_COLOR_PROMPT,                   
  MT_COLOR_QUOTED,                   
  MT_COLOR_SEARCH,                   
#ifdef USE_SIDEBAR
  MT_COLOR_SIDEBAR_DIVIDER,          
  MT_COLOR_SIDEBAR_FLAGGED,          
  MT_COLOR_SIDEBAR_HIGHLIGHT,        
  MT_COLOR_SIDEBAR_INDICATOR,        
  MT_COLOR_SIDEBAR_NEW,              
  MT_COLOR_SIDEBAR_ORDINARY,         
  MT_COLOR_SIDEBAR_SPOOLFILE,        
  MT_COLOR_SIDEBAR_UNREAD,           
#endif
  MT_COLOR_SIGNATURE,                
  MT_COLOR_STATUS,                   
  MT_COLOR_TILDE,                    
  MT_COLOR_TREE,                     
  MT_COLOR_UNDERLINE,                
  MT_COLOR_WARNING,                  
  /* please no non-MT_COLOR_INDEX objects after this point */
  MT_COLOR_INDEX,                    
  MT_COLOR_INDEX_AUTHOR,             
  MT_COLOR_INDEX_FLAGS,              
  MT_COLOR_INDEX_SUBJECT,            
  MT_COLOR_INDEX_TAG,                
  /* below here - only index coloring stuff that doesn't have a pattern */
  MT_COLOR_INDEX_COLLAPSED,          
  MT_COLOR_INDEX_DATE,               
  MT_COLOR_INDEX_LABEL,              
  MT_COLOR_INDEX_NUMBER,             
  MT_COLOR_INDEX_SIZE,               
  MT_COLOR_INDEX_TAGS,               
  MT_COLOR_MAX,
};

Function Documentation

STAILQ_HEAD()

STAILQ_HEAD	(	ColorLineList	,
		ColorLine
	)

mutt_color_alloc()

int mutt_color_alloc	(	struct Colors *	c,
		uint32_t	fg,
		uint32_t	bg
	)

Here is the caller graph for this function:

mutt_color_combine()

int mutt_color_combine	(	struct Colors *	c,
		uint32_t	fg_attr,
		uint32_t	bg_attr
	)

Here is the caller graph for this function:

mutt_color_free()

void mutt_color_free	(	struct Colors *	c,
		uint32_t	fg,
		uint32_t	bg
	)

Free a colour.

Parameters

c	Colours
fg	Foreground colour ID
bg	Background colour ID

If there are no more users, the resource will be freed.

Definition at line 251 of file color.c.

{
  struct ColorList *q = NULL;

  struct ColorList *p = c->user_colors;
  while (p)
  {
    if ((p->fg == fg) && (p->bg == bg))
    {
      (p->count)--;
      if (p->count > 0)
        return;

      c->num_user_colors--;
      mutt_debug(LL_DEBUG1, "Color pairs used so far: %d\n", c->num_user_colors);

      if (p == c->user_colors)
      {
        c->user_colors = c->user_colors->next;
        FREE(&p);
        return;
      }
      q = c->user_colors;
      while (q)
      {
        if (q->next == p)
        {
          q->next = p->next;
          FREE(&p);
          return;
        }
        q = q->next;
      }
      /* can't get here */
    }
    p = p->next;
  }
}

Here is the caller graph for this function:

mutt_colors_new()

struct Colors* mutt_colors_new

(

void

)

Create new colours.

Return values

ptr	New Colors

Definition at line 373 of file color.c.

{
  struct Colors *c = mutt_mem_calloc(1, sizeof(*c));
  c->notify = notify_new();

  quotes_init(c);
  defs_init(c);

  STAILQ_INIT(&c->attach_list);
  STAILQ_INIT(&c->body_list);
  STAILQ_INIT(&c->hdr_list);
  STAILQ_INIT(&c->index_author_list);
  STAILQ_INIT(&c->index_flags_list);
  STAILQ_INIT(&c->index_list);
  STAILQ_INIT(&c->index_subject_list);
  STAILQ_INIT(&c->index_tag_list);
  STAILQ_INIT(&c->status_list);

#ifdef HAVE_COLOR
  start_color();
#endif

  notify_set_parent(c->notify, NeoMutt->notify);
  return c;
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_colors_free()

void mutt_colors_free

(

struct Colors **

ptr

)

Free all the colours.

Parameters

ptr

Colours

Definition at line 355 of file color.c.

{
  if (!ptr || !*ptr)
    return;

  struct Colors *c = *ptr;

  colors_clear(c);
  defs_free(c);
  quotes_free(c);
  notify_free(&c->notify);
  FREE(ptr);
}

Here is the call graph for this function:

Here is the caller graph for this function:

mutt_parse_color()

enum CommandResult mutt_parse_color	(	struct Buffer *	buf,
		struct Buffer *	s,
		unsigned long	data,
		struct Buffer *	err
	)

Here is the caller graph for this function:

mutt_parse_mono()

enum CommandResult mutt_parse_mono	(	struct Buffer *	buf,
		struct Buffer *	s,
		unsigned long	data,
		struct Buffer *	err
	)

Parse the 'mono' command - Implements command_t.

Definition at line 1370 of file color.c.

{
  bool dry_run = false;

#ifdef HAVE_COLOR
  if (OptNoCurses || has_colors())
    dry_run = true;
#else
  if (OptNoCurses)
    dry_run = true;
#endif

  struct Colors *c = *(struct Colors **) data;
  return parse_color(c, buf, s, err, parse_attr_spec, dry_run, false);
}

Here is the call graph for this function:

mutt_parse_uncolor()

enum CommandResult mutt_parse_uncolor	(	struct Buffer *	buf,
		struct Buffer *	s,
		unsigned long	data,
		struct Buffer *	err
	)

Here is the caller graph for this function:

mutt_parse_unmono()

enum CommandResult mutt_parse_unmono	(	struct Buffer *	buf,
		struct Buffer *	s,
		unsigned long	data,
		struct Buffer *	err
	)

Parse the 'unmono' command - Implements command_t.

Definition at line 932 of file color.c.

{
  return parse_uncolor(buf, s, data, err, false);
}

Here is the call graph for this function: