NAME

AndRectRegion: Perform 2d AND operation of rectangle with region, leaving result in region.

SYNOPSIS

AndRectRegion(region,rectangle)

a0 a1

BOOL AndRectRegion( struct Region *, struct Rectangle * );

FUNCTION

Clip away any portion of the region that exists outside of the rectangle. Leave the result in region.

INPUTS

region: pointer to Region structure
rectangle: pointer to Rectangle structure

RESULT

a boolean success indicator. In case the result is FALSE, the region remained untouched.

NOTES

Unlike the other rect-region primitives, AndRectRegion() cannot fail.

BUGS

Releases up to V40 did not return a success indicator, but may have failed in out-of-memory situation nevertheless. V40 releases and before may have left the region in an inconsistent state in case of failure.