clip_region ( Region : RegionClipped : Row1, Column1, Row2, Column2 : )

Clip a region to a rectangle.

clip_region clips the input regions to the rectangle given by the four control parameters. clip_region is more efficient than calling intersection with a rectangle generated by rectangle1.


Parameters

Region (input_object)
region(-array) -> object
Region to be clipped.

RegionClipped (output_object)
region(-array) -> object
Clipped regions.

Row1 (input_control)
rectangle.origin.y -> integer
Row coordinate of the upper left corner of the rectangle.
Default value: 0
Suggested values: 0, 128, 200, 256
Range of values: 0 <= Row1 <= 511 (lin)
Minimum increment: 1
Recommended increment: 10

Column1 (input_control)
rectangle.origin.x -> integer
Column coordinate of the upper left corner of the rectangle.
Default value: 0
Suggested values: 0, 128, 200, 256
Range of values: 0 <= Column1 <= 511 (lin)
Minimum increment: 1
Recommended increment: 10

Row2 (input_control)
rectangle.corner.y -> integer
Row coordinate of the lower right corner of the rectangle.
Default value: 256
Suggested values: 128, 200, 256, 512
Range of values: 0 <= Row2 <= 511 (lin)
Minimum increment: 1
Recommended increment: 10

Column2 (input_control)
rectangle.corner.x -> integer
Column coordinate of the lower right corner of the rectangle.
Default value: 256
Suggested values: 128, 200, 256, 512
Range of values: 0 <= Column2 <= 511 (lin)
Minimum increment: 1
Recommended increment: 10


Result

clip_region returns TRUE if all parameters are correct. The behavior in case of empty input (no regions given) can be set via set_system(::'no_object_result',<Result>:) and the behavior in case of an empty input region via set_system(::'empty_region_result',<Result>:). If necessary, an exception is raised.


Possible Predecessors

threshold__, connection, regiongrowing__, pouring


Possible Successors

select_shape, disp_region


Alternatives

intersection, rectangle1, clip_rel_region



Copyright © 1996-1997 MVTec Software GmbH