NAME

       TickitRectSet - store a collection of rectangular areas

SYNOPSIS

       #include <tickit.h>

       typedef struct TickitRectSet;

DESCRIPTION

       A  TickitRectSet  instance  stores  a  collection  of rectangular areas as non-overlapping
       regions. Mutation operations allow areas to be added or subtracted. Query operations allow
       testing for area containment, intersection, or iterating the stored regions.

FUNCTIONS

       A  new  TickitRectSet  instance  is  created using the tickit_rectset_new(3) function, and
       destroyed using tickit_rectset_destroy(3).

       Rectangular  areas  can  be  added  using  tickit_rectset_add(3)  and   subtracted   using
       tickit_rectset_subtract(3).  The TickitRectSet can be emptied of regions entirely by using
       tickit_rectset_clear(3).  The  entire  set  of  regions  can  be  uniformly  moved   using
       tickit_rectset_translate(3).

       The    stored    regions   can   be   queried   by   using   tickit_rectset_rects(3)   and
       tickit_rectset_get_rects(3). An area can be tested to see if it is entirely  contained  in
       the   set   using   tickit_rectset_contains(3),   or  that  it  intersects  at  all  using
       tickit_rectset_intersects(3).

                                                                                TICKIT_RECTSET(7)