Function: bmatch

Syntax

bmatch (<rect1>,<rect2>)

Type

numeric

Returns

The clash status of two 2-D rectangles. Each rectangle is supplied as a four-element numeric array in the form:

minimum-x, minimum-y, maximum-x, maximum-y.

The returned value is a number with a value 0 through 4 with the following meaning:

• 0 - The rectangles do not clash.

• 1 - The rectangles clash.

• 2 - The rectangles clash and rectangle two totally encloses rectangle one.

• 3 - The rectangles clash and rectangle one totally encloses rectangle two.

• 4 - The rectangles clash and are identical.

Parameters

• <rect1>
  A four-element numeric array.

• <rect2>
  A four-element numeric array.

Examples

The following will print the value 2 since r1 totally encloses r2.

numeric r1[] = <0,0,500,500>
numeric r2[] = <100,100,400,400>
tell bmatch(r1,r2)