attr.c File Reference

Colour and attributes. More...

#include "config.h"
#include <stddef.h>
#include <stdint.h>
#include "mutt/lib.h"
#include "attr.h"
#include "curses2.h"
#include "debug.h"

Include dependency graph for attr.c:

Go to the source code of this file.

Functions
void	attr_color_clear (struct AttrColor *ac)
	Free the contents of an AttrColor. More...
void	attr_color_free (struct AttrColor **ptr)
	Free an AttrColor. More...
struct AttrColor *	attr_color_new (void)
	Create a new AttrColor. More...
void	attr_color_list_clear (struct AttrColorList *acl)
	Free the contents of an AttrColorList. More...
struct AttrColor *	attr_color_list_find (struct AttrColorList *acl, uint32_t fg, uint32_t bg, int attrs)
	Find an AttrColor in a list. More...
struct AttrColor	attr_color_copy (const struct AttrColor *ac)
	Copy a colour. More...
bool	attr_color_is_set (struct AttrColor *ac)
	Is the object coloured? More...
bool	attr_color_match (struct AttrColor *ac1, struct AttrColor *ac2)
	Do the colours match? More...

Detailed Description

Colour and attributes.

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 attr.c.

Function Documentation

attr_color_clear()

void attr_color_clear

(

struct AttrColor *

ac

)

Free the contents of an AttrColor.

Parameters

ac	AttrColor to empty

Note

The AttrColor object isn't freed

Definition at line 44 of file attr.c.

{
  if (!ac)
    return;
 
  if (ac->curses_color)
    color_debug(LL_DEBUG5, "clear %p\n", ac);
  curses_color_free(&ac->curses_color);
  ac->attrs = 0;
}

Here is the call graph for this function:

Here is the caller graph for this function:

attr_color_free()

void attr_color_free

(

struct AttrColor **

ptr

)

Free an AttrColor.

Parameters

ptr	AttrColor to free

Definition at line 59 of file attr.c.

{
  if (!ptr || !*ptr)
    return;
 
  struct AttrColor *ac = *ptr;
  if (ac->ref_count > 1)
  {
    ac->ref_count--;
    *ptr = NULL;
    return;
  }
 
  attr_color_clear(ac);
  FREE(ptr);
}

Here is the call graph for this function:

Here is the caller graph for this function:

attr_color_new()

struct AttrColor * attr_color_new

(

void

)

Create a new AttrColor.

Return values

ptr	New AttrColor

Definition at line 80 of file attr.c.

{
  struct AttrColor *ac = mutt_mem_calloc(1, sizeof(*ac));
 
  ac->ref_count = 1;
 
  return ac;
}

Here is the call graph for this function:

Here is the caller graph for this function:

attr_color_list_clear()

void attr_color_list_clear

(

struct AttrColorList *

acl

)

Free the contents of an AttrColorList.

Parameters

acl	List to clear

Free each of the AttrColors in a list.

Note

The list object isn't freed, only emptied

Definition at line 97 of file attr.c.

{
  if (!acl)
    return;
 
  struct AttrColor *ac = NULL;
  struct AttrColor *tmp = NULL;
  TAILQ_FOREACH_SAFE(ac, acl, entries, tmp)
  {
    TAILQ_REMOVE(acl, ac, entries);
    attr_color_free(&ac);
  }
}

Here is the call graph for this function:

Here is the caller graph for this function:

attr_color_list_find()

struct AttrColor * attr_color_list_find	(	struct AttrColorList *	acl,
		uint32_t	fg,
		uint32_t	bg,
		int	attrs
	)

Find an AttrColor in a list.

Parameters

acl	List to search
fg	Foreground colour
bg	Background colour
attrs	Attributes, e.g. A_UNDERLINE

Return values

ptr	Matching AttrColor

Definition at line 119 of file attr.c.

{
  if (!acl)
    return NULL;
 
  struct AttrColor *ac = NULL;
  TAILQ_FOREACH(ac, acl, entries)
  {
    if (ac->attrs != attrs)
      continue;
 
    struct CursesColor *cc = ac->curses_color;
    if (!cc)
      continue;
 
    if ((cc->fg == fg) && (cc->bg == bg))
      return ac;
  }
  return NULL;
}

Here is the caller graph for this function:

attr_color_copy()

struct AttrColor attr_color_copy

(

const struct AttrColor *

ac

)

Copy a colour.

Parameters

ac	Colour to copy

Return values

obj	Copy of the colour

Definition at line 146 of file attr.c.

{
  struct AttrColor copy = { 0 };
  if (ac)
    copy = *ac;
 
  return copy;
}

Here is the caller graph for this function:

attr_color_is_set()

bool attr_color_is_set

(

struct AttrColor *

ac

)

Is the object coloured?

Parameters

ac	Colour to check

Return values

true	Yes, a 'color' command has been used on this object

Definition at line 160 of file attr.c.

{
  if (!ac)
    return false;
 
  return ((ac->attrs != 0) || ac->curses_color);
}

Here is the caller graph for this function:

attr_color_match()

bool attr_color_match	(	struct AttrColor *	ac1,
		struct AttrColor *	ac2
	)

Do the colours match?

Parameters

ac1	First colour
ac2	Second colour

Return values

true	The colours and attributes match

Definition at line 174 of file attr.c.

{
  if ((!ac1) ^ (!ac2)) // One is set, but not the other
    return false;
 
  if (!ac1) // Two empty colours match
    return true;
 
  return ((ac1->curses_color == ac2->curses_color) && (ac1->attrs == ac2->attrs));
}

Here is the caller graph for this function: