Next Previous Up Top Contents Index

2.3 DUIM-Geometry Module

do-regions

Generic function

Summary

Calls a function on each region in a set of regions.

Signature

do-regions function region #key normalize? => ()

Arguments

function
An instance of type <function>.

region
An instance of type <region>.

normalize?
An instance of type <boolean>. Default value: #f.

Values

None

Library

duim-geometry

Module

duim-geometry

Description

Calls function on each region in the region set region. This is often more efficient than calling region-set-regions. function is a function of one argument, a region. Region can be either a region set or a simple region, in which case function is called once on region itself. 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. 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.


Functional Developer Library Reference: DUIM - 3 Dec 1998

Next Previous Up Top Contents Index