NAME

       tickit_renderbuffer_setpen - change the stored rendering pen

SYNOPSIS

       #include <tickit.h>

       void tickit_renderbuffer_setpen(TickitRenderBuffer *rb, const TickitPen *pen);

       Link with -ltickit.

DESCRIPTION

       tickit_renderbuffer_setpen() changes the attributes of the stored pen in the buffer to those in the given
       TickitPen() instance, removing any that are not present in pen. The instance passed in the  pen  argument
       is not stored by the render buffer, nor is it modified by it.

       If there is a stored pen in the previous stack level, then the attributes in that pen will be merged into
       the current one, before the passed one is applied. In effect, the actual pen used by drawing functions is
       merged from the pen argument passed to tickit_renderbuffer_setpen(), and the combined stored pen from the
       previous stack level (which was itself merged from the pen argument and the stored pen of the stack level
       below that, and so on).

RETURN VALUE

       This function returns nothing.

SEE ALSO

       tickit_renderbuffer_new(3),           tickit_renderbuffer_text(3),           tickit_renderbuffer_save(3),
       tickit_renderbuffer(7), tickit_pen(7), tickit(7)

                                                                                   TICKIT_RENDERBUFFER_SETPEN(3)