NAME

       tickit_pen_ref, tickit_pen_unref - adjust the refcount of a pen

SYNOPSIS

       #include <tickit.h>

       TickitPen *tickit_pen_ref(TickitPen *pen);
       void tickit_pen_unref(TickitPen *pen);

       Link with -ltickit.

DESCRIPTION

       tickit_pen_ref()  increments  the  stored  refcount  of  the given pen instance by one. It
       returns the pointer argument itself, so it is useful for chaining.

       tickit_pen_unref() decrements the stored refcount of the given pen instance by one. If the
       refcount  drops  to  zero,  the  instance  is  destroyed.  This will release any resources
       controlled by it and unbind all the bound event handlers, causing handlers to  be  invoked
       with the TICKIT_EV_DESTROY flag if appropriate.

RETURN VALUE

       tickit_pen_ref() returns a pen instance pointer. tickit_pen_unref() returns no value.

SEE ALSO

       tickit_pen_new(3), tickit_pen(7), tickit(7)

                                                                                TICKIT_PEN_REF(3)