Scroll to navigation

TICKIT_RECT_SUBTRACT(3) Library Functions Manual TICKIT_RECT_SUBTRACT(3)

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)