NAME

       tickit_rectset_rects, tickit_rectset_get_rects - obtain the regions from a rectangle set

SYNOPSIS

       #include <tickit.h>

       size_t tickit_rectset_rects(const TickitRectSet *trs);
       size_t tickit_rectset_get_rect(const TickitRectSet *trs,
           size_t i, TickitRect *rect);
       size_t tickit_rectset_get_rects(const TickitRectSet *trs,
           TickitRect rects[], size_t n);

       Link with -ltickit.

DESCRIPTION

       tickit_rectset_rects() returns the number of rectangular regions stored by the rectangle set.

       tickit_rectset_get_rect()  copies  the  region  representing  the  rectangle at index i into the variable
       pointed to by rect, and returns 1. If i is an invalid index for this set then 0 is returned instead.

       tickit_rectset_get_rects() copies at most n regions into the array given by rects, and returns the number
       of regions it copied (which may be fewer than the total stored, if the array was of insufficient size).

RETURN VALUE

       tickit_rectset_rects()  returns an integer giving the number of stored regions. tickit_rectset_get_rect()
       and tickit_rectset_get_rects() return the number of regions copied.

SEE ALSO

       tickit_rectset_new(3), tickit_rectset(7), tickit(7)

                                                                                         TICKIT_RECTSET_RECTS(3)