NAME

       tickit_rect_subtract - obtain the difference of two rectangles

SYNOPSIS

       #include <tickit.h>

       int tickit_rect_subtract(TickitRect dst[4],
           const TickitRect *orig, const TickitRect *hole);

       Link with -ltickit.

DESCRIPTION

       tickit_rect_subtract()  initialises the rectangle structures given by dst (which must be an array capable
       of containing at least four rectangle structures) with a set of non-overlapping rectangles  covering  the
       same  area as that given by orig without covering hole. Depending on the geometry of the given rectangles
       it will create from zero to four resultant rectangles. It  returns  the  number  of  rectangular  regions
       initialised into the result array.

       If  hole completely covers orig then the result will contain no rectangles. If they do not intersect then
       just orig will be returned. Otherwise, the result will contain non-overlapping horizontal stripes of orig
       without hole.

RETURN VALUE

       tickit_rect_subtract() returns the number of rectangles written to dst.

SEE ALSO

       tickit_rect_init_sized(3),  tickit_rect_init_bounded(3),  tickit_rect_intersect(3),   tickit_rect_add(3),
       tickit_rect(7), tickit(7)

                                                                                         TICKIT_RECT_SUBTRACT(3)