1TICKIT_PEN_NEW(3)          Library Functions Manual          TICKIT_PEN_NEW(3)
2
3
4

NAME

6       tickit_pen_new - create a new pen instance
7

SYNOPSIS

9       #include <tickit.h>
10
11       TickitPen *tickit_pen_new(void);
12       TickitPen *tickit_pen_new_attrs(...);
13       TickitPen *tickit_pen_clone(const TickitPen *orig);
14
15       Link with -ltickit.
16

DESCRIPTION

18       tickit_pen_new()  creates a new TickitPen instance. It initially has no
19       attributes set.
20
21       tickit_pen_new_attrs() creates a new TickitPen instance  and  populates
22       it  with  a given list of attribute values. The attributes are given as
23       pairs; first a TickitPenAttr then an integer giving its  value,  termi‐
24       nated by a final 0 or -1.
25
26       Two  additional attribute types are recognised here, TICKIT_PEN_FG_DESC
27       and TICKIT_PEN_BG_DESC. These will expect to receive a string  argument
28       value, which will be parsed as for tickit_pen_set_colour_attr_desc(3).
29
30       tickit_pen_clone()  creates  a new TickitPen instance. It initially has
31       the same attributes values set as the one given by orig.
32
33       The reference count of a newly-constructed pen instance  will  be  one.
34       This  can  be  incremented  or  decremented using tickit_pen_ref(3) and
35       tickit_pen_unref(3). When its reference count reaches zero  it  is  de‐
36       stroyed.
37

RETURN VALUE

39       If    successful,    tickit_pen_new(),    tickit_pen_new_attrs()    and
40       tickit_pen_clone() return a pointer to the new  instance.  On  failure,
41       NULL is returned with errno set to indicate the failure.
42

SEE ALSO

44       tickit_pen_ref(3),    tickit_pen_unref(3),    tickit_pen_bind_event(3),
45       tickit_pen(7), tickit(7)
46
47
48
49                                                             TICKIT_PEN_NEW(3)
Impressum