1TICKIT_PEN_NEW(3) Library Functions Manual TICKIT_PEN_NEW(3)
2
3
4
6 tickit_pen_new - create a new pen instance
7
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
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
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
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)