move ( Region : RegionMove : Row, Column : )

Translate a region.

move translates the input regions by the vector given by (Row, Column). If necessary, the resulting regions are clipped with the current image format.


Parameters

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

RegionMove (output_object)
region(-array) -> object
Translated regions.
Number of elements: RegionMove == Region

Row (input_control)
point.y -> integer
Row coordinate of the vector by which the region is to be moved.
Default value: 30
Suggested values: -128, -64, -32, -16, -10, -8, -4, -2, -1, 0, 1, 2, 4, 5, 8, 10, 16, 32, 64, 128
Range of values: -512 <= Row <= 512 (lin)
Minimum increment: 1
Recommended increment: 10

Column (input_control)
point.x -> integer
Row coordinate of the vector by which the region is to be moved.
Default value: 30
Suggested values: -128, -64, -32, -16, -10, -8, -4, -2, -1, 0, 1, 2, 4, 5, 8, 10, 16, 32, 64, 128
Range of values: -512 <= Column <= 512 (lin)
Minimum increment: 1
Recommended increment: 10


Complexity

Let F be the area of the input region. Then the runtime complexity is O(F).


Result

move always returns the value TRUE. The behavior in case of empty input (no regions given) can be set via set_system(::'no_object_result',<Result>:), the behavior in case of an empty input region via set_system(::'empty_region_result',<Result>:), and the behavior in case of an empty result region via set_system(::'store_empty_region',<true/false>:). If necessary, an exception is raised.


Possible Predecessors

threshold__, connection, regiongrowing__, pouring


Possible Successors

select_shape, disp_region


See also

image_transform__, image_translate, rotate_region1, rotate_region2



Copyright © 1996-1997 MVTec Software GmbH