mirror_regionmirror_regionMirrorRegionMirrorRegionmirror_region (Operator)

Name

mirror_regionmirror_regionMirrorRegionMirrorRegionmirror_region — Reflect a region about an axis.

Signature

mirror_region(Region : RegionMirror : Mode, WidthHeight : )

Description

mirror_regionmirror_regionMirrorRegionMirrorRegionMirrorRegionmirror_region reflects a region about one of three possible axes. If ModeModeModeModemodemode is set to 'row'"row""row""row""row""row", it is reflected about the horizontal axis, if ModeModeModeModemodemode is set to 'column'"column""column""column""column""column", about the vertical axis, and if ModeModeModeModemodemode is set to 'diagonal'"diagonal""diagonal""diagonal""diagonal""diagonal", about the main diagonal x=y.

For ModeModeModeModemodemode = 'row'"row""row""row""row""row" or 'column'"column""column""column""column""column" the parameter WidthHeightWidthHeightWidthHeightWidthHeightwidthHeightwidth_height specifies two times the coordinate of the axis of symmetry. Hence, if RegionRegionRegionRegionregionregion has been extracted from an image and should be mirrored in a way such as if it had been extracted from a mirrored version of this image, WidthHeightWidthHeightWidthHeightWidthHeightwidthHeightwidth_height corresponds to one of the dimensions of this image (according to ModeModeModeModemodemode). If ModeModeModeModemodemode = 'diagonal'"diagonal""diagonal""diagonal""diagonal""diagonal", the parameter WidthHeightWidthHeightWidthHeightWidthHeightwidthHeightwidth_height is not used.

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) → object

Region(s) to be reflected.

RegionMirrorRegionMirrorRegionMirrorRegionMirrorregionMirrorregion_mirror (output_object) region(-array) → object

Reflected region(s).

Number of elements: RegionMirror == Region

ModeModeModeModemodemode (input_control) string → (string)

Axis of symmetry.

Default value: 'row' "row" "row" "row" "row" "row"

List of values: 'column'"column""column""column""column""column", 'diagonal'"diagonal""diagonal""diagonal""diagonal""diagonal", 'row'"row""row""row""row""row"

WidthHeightWidthHeightWidthHeightWidthHeightwidthHeightwidth_height (input_control) integer → (integer)

Twice the coordinate of the axis of symmetry.

Default value: 512

Suggested values: 128, 256, 512, 525, 768, 1024

Typical range of values: 1 ≤ WidthHeight WidthHeight WidthHeight WidthHeight widthHeight width_height ≤ 1024 (lin)

Minimum increment: 1

Recommended increment: 1

Restriction: WidthHeight > 0

Example (C)

read_image(&Image,"monkey");
threshold(Image,&Seg,128.0,255.0);
mirror_region(Seg,&Mirror,"row",512);
disp_region(Mirror,WindowHandle);

Possible Predecessors

thresholdthresholdThresholdThresholdThresholdthreshold, connectionconnectionConnectionConnectionConnectionconnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowingregiongrowing, pouringpouringPouringPouringPouringpouring

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, disp_regiondisp_regionDispRegionDispRegionDispRegiondisp_region

Alternatives

hom_mat2d_reflecthom_mat2d_reflectHomMat2dReflectHomMat2dReflectHomMat2dReflecthom_mat2d_reflect, affine_trans_regionaffine_trans_regionAffineTransRegionAffineTransRegionAffineTransRegionaffine_trans_region

Module

Foundation

Operators