move_regionmove_regionMoveRegionMoveRegionmove_region (Operator)
Name
move_regionmove_regionMoveRegionMoveRegionmove_region — Translate a region.
Signature
Description
move_regionmove_regionMoveRegionMoveRegionMoveRegionmove_region translates the input regions by the vector given by
(RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn). If necessary, the resulting
regions are clipped with the current image format.
Execution Information
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
Parameters
RegionRegionRegionRegionregionregion (input_object) region(-array) → objectHRegionHObjectHRegionHobject
Region(s) to be moved.
RegionMovedRegionMovedRegionMovedRegionMovedregionMovedregion_moved (output_object) region(-array) → objectHRegionHObjectHRegionHobject *
Translated region(s).
Number of elements: RegionMoved == Region
RowRowRowRowrowrow (input_control) point.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
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
Typical range of values: -512
≤
Row
Row
Row
Row
row
row
≤
512 (lin)
Minimum increment: 1
Recommended increment: 10
ColumnColumnColumnColumncolumncolumn (input_control) point.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)
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
Typical range of values: -512
≤
Column
Column
Column
Column
column
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_regionmove_regionMoveRegionMoveRegionMoveRegionmove_region 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>)set_system("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)SetSystem("no_object_result",<Result>)set_system("no_object_result",<Result>),
the behavior in case of an empty input region via
set_system('empty_region_result',<Result>)set_system("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)SetSystem("empty_region_result",<Result>)set_system("empty_region_result",<Result>),
and the behavior in case of an empty result region via
set_system('store_empty_region',<'2 (H_MSG_TRUE)'/'3 (H_MSG_FALSE)'>)set_system("store_empty_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)SetSystem("store_empty_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)SetSystem("store_empty_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)SetSystem("store_empty_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">)set_system("store_empty_region",<"2 (H_MSG_TRUE)"/"3 (H_MSG_FALSE)">).
If necessary, an exception is raised.
Possible Predecessors
thresholdthresholdThresholdThresholdThresholdthreshold,
connectionconnectionConnectionConnectionConnectionconnection,
regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing,
pouringpouringPouringPouringPouringpouring
Possible Successors
select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape,
disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region
See also
affine_trans_imageaffine_trans_imageAffineTransImageAffineTransImageAffineTransImageaffine_trans_image,
mirror_regionmirror_regionMirrorRegionMirrorRegionMirrorRegionmirror_region,
zoom_regionzoom_regionZoomRegionZoomRegionZoomRegionzoom_region
Module
Foundation