NAME

       tickit_pen_new - create a new pen instance

SYNOPSIS

       #include <tickit.h>

       TickitPen *tickit_pen_new(void);
       TickitPen *tickit_pen_new_attrs(...);
       TickitPen *tickit_pen_clone(const TickitPen *orig);

       Link with -ltickit.

DESCRIPTION

       tickit_pen_new() creates a new TickitPen instance. It initially has no attributes set.

       tickit_pen_new_attrs()  creates  a new TickitPen instance and populates it with a given list of attribute
       values. The attributes are given as pairs; first a  TickitPenAttr  then  an  integer  giving  its  value,
       terminated by a final 0 or -1.

       Two additional attribute types are recognised here, TICKIT_PEN_FG_DESC and TICKIT_PEN_BG_DESC. These will
       expect   to    receive    a    string    argument    value,    which    will    be    parsed    as    for
       tickit_pen_set_colour_attr_desc(3).

       tickit_pen_clone()  creates  a new TickitPen instance. It initially has the same attributes values set as
       the one given by orig.

       The reference count of a newly-constructed  pen  instance  will  be  one.  This  can  be  incremented  or
       decremented  using tickit_pen_ref(3) and tickit_pen_unref(3). When its reference count reaches zero it is
       destroyed.

RETURN VALUE

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

SEE ALSO

       tickit_pen_ref(3), tickit_pen_unref(3), tickit_pen_bind_event(3), tickit_pen(7), tickit(7)

                                                                                               TICKIT_PEN_NEW(3)