## table of contents

other versions

- buster 0.2-5
- testing 0.3.5-1
- unstable 0.3.5-1
- experimental 0.4.0~rc4-1

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(TickitRectdst[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*.