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