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)