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       tickit_pen_clone()  creates  a new TickitPen instance. It initially has
27       the same attributes values set as the one given by orig.
28
29       The reference count of a newly-constructed pen instance  will  be  one.
30       This  can  be  incremented  or  decremented using tickit_pen_ref(3) and
31       tickit_pen_unref(3). When  its  reference  count  reaches  zero  it  is
32       destroyed.
33

RETURN VALUE

35       If    successful,    tickit_pen_new(),    tickit_pen_new_attrs()    and
36       tickit_pen_clone() return a pointer to the new  instance.  On  failure,
37       NULL is returned with errno set to indicate the failure.
38

SEE ALSO

40       tickit_pen_ref(3),    tickit_pen_unref(3),    tickit_pen_bind_event(3),
41       tickit_pen(7), tickit(7)
42
43
44
45                                                             TICKIT_PEN_NEW(3)