mirror_regionmirror_regionMirrorRegionMirrorRegion (Operator)

Name

mirror_regionmirror_regionMirrorRegionMirrorRegion — Reflect a region about an axis.

Signature

mirror_region(Region : RegionMirror : Mode, WidthHeight : )

Description

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

For ModeModeModeModemode = 'row'"row""row""row""row" or 'column'"column""column""column""column" the parameter WidthHeightWidthHeightWidthHeightWidthHeightwidthHeight specifies two times the coordinate of the axis of symmetry. Hence, if RegionRegionRegionRegionregion 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, WidthHeightWidthHeightWidthHeightWidthHeightwidthHeight corresponds to one of the dimensions of this image (according to ModeModeModeModemode). If ModeModeModeModemode = 'diagonal'"diagonal""diagonal""diagonal""diagonal", the parameter WidthHeightWidthHeightWidthHeightWidthHeightwidthHeight 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

RegionRegionRegionRegionregion (input_object) region(-array) → object

Region(s) to be reflected.

RegionMirrorRegionMirrorRegionMirrorRegionMirrorregionMirror (output_object) region(-array) → object

Reflected region(s).

Number of elements: RegionMirror == Region

ModeModeModeModemode (input_control) string → (string)

Axis of symmetry.

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

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

WidthHeightWidthHeightWidthHeightWidthHeightwidthHeight (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 ≤ 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

thresholdthresholdThresholdThresholdThreshold, connectionconnectionConnectionConnectionConnection, regiongrowingregiongrowingRegiongrowingRegiongrowingRegiongrowing, pouringpouringPouringPouringPouring

Possible Successors

select_shapeselect_shapeSelectShapeSelectShapeSelectShape, disp_regiondisp_regionDispRegionDispRegionDispRegion

Alternatives

hom_mat2d_reflecthom_mat2d_reflectHomMat2dReflectHomMat2dReflectHomMat2dReflect, affine_trans_regionaffine_trans_regionAffineTransRegionAffineTransRegionAffineTransRegion

Module

Foundation

Operators