NAME

       tickit_renderbuffer_clip, tickit_renderbuffer_mask - restrict the drawing area of output functions

SYNOPSIS

       #include <tickit.h>

       void tickit_renderbuffer_clip(TickitRenderBuffer *rb, TickitRect *rect);
       void tickit_renderbuffer_mask(TickitRenderBuffer *rb, TickitRect *mask);

       Link with -ltickit.

DESCRIPTION

       tickit_renderbuffer_clip()  restricts  the  clipping  rectangle  to the limits given, within the existing
       limits already set. This function cannot make the clipping region larger than it already was.

       tickit_renderbuffer_mask() applies a rectangular mask within the clipping region, masking off extra cells
       that  can  no longer be modified by the output functions. Unlike tickit_renderbuffer_clip() these regions
       can be arbitrarily positioned and discontinuous; each new call adds another masking region,  rather  than
       affecting the existing ones.

       To  undo  the  effects  of  any  of  these functions, they should be used within nested pairs of calls to
       tickit_renderbuffer_save(3) and tickit_renderbuffer_restore(3). Both functions only affect the subsequent
       drawing   operations;   they   do   not   affect   existing   stored   content,   nor  the  behaviour  of
       tickit_renderbuffer_flush_to_term(3).

RETURN VALUE

       These functions return no value.

SEE ALSO

       tickit_renderbuffer_new(3), tickit_renderbuffer_translate(3), tickit_renderbuffer(7), tickit(7)

                                                                                     TICKIT_RENDERBUFFER_CLIP(3)