Next Previous Up Top Contents Index

2.3 DUIM-Geometry Module

region-set-regions

Generic function

Summary

Returns a sequence of the regions in the region set.

Signature

region-set-regions region #key normalize? => regions

Arguments

region
An instance of type <region>.

normalize?
one-of(#f, #"x-banding", "y-banding"). Default value: #f.

Values

regions
An instance of type limited(<sequence>, of: <region>).

Exceptions

Normalizing a region set that is not composed entirely of axis-aligned rectangles using x- or y-banding causes DUIM to signal the <region-set-not-rectangular> error.

Library

duim-geometry

Module

duim-geometry

Description

Returns a sequence of the regions in the region set region. region can be either a region set or a simple region, in which case the result is simply a sequence of one element: region.

For the case of region sets that are unions of axis-aligned rectangles, the rectangles returned by region-set-regions are guaranteed not to overlap. If normalize is supplied, it must be either #"x-banding" or #"y-banding". If it is #"x-banding" and all the regions in region are axis-aligned rectangles, the result is normalized by merging adjacent rectangles with banding done in the x direction. If it is #"y-banding" and all the regions in region are rectangles, the result is normalized with banding done in the y direction.


Functional Developer Library Reference: DUIM - 3 Dec 1998

Next Previous Up Top Contents Index