move_regionmove_regionMoveRegionMoveRegionmove_region (Operator)

Name

move_regionmove_regionMoveRegionMoveRegionmove_region — Translate a region.

Signature

move_region(Region : RegionMoved : Row, Column : )

Herror move_region(const Hobject Region, Hobject* RegionMoved, const Hlong Row, const Hlong Column)

Herror T_move_region(const Hobject Region, Hobject* RegionMoved, const Htuple Row, const Htuple Column)

void MoveRegion(const HObject& Region, HObject* RegionMoved, const HTuple& Row, const HTuple& Column)

HRegion HRegion::MoveRegion(Hlong Row, Hlong Column) const

static void HOperatorSet.MoveRegion(HObject region, out HObject regionMoved, HTuple row, HTuple column)

HRegion HRegion.MoveRegion(int row, int column)

def move_region(region: HObject, row: int, column: int) -> HObject

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

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