transpose_regiontranspose_regionTransposeRegionTransposeRegiontranspose_region (Operator)

Name

transpose_regiontranspose_regionTransposeRegionTransposeRegiontranspose_region — Reflect a region about a point.

Signature

transpose_region(Region : Transposed : Row, Column : )

Description

transpose_regiontranspose_regionTransposeRegionTransposeRegionTransposeRegiontranspose_region reflects a region about a point. The fixed point is given by ColumnColumnColumnColumncolumncolumn and RowRowRowRowrowrow. The image P' of a point P is determined by the following requirement:

If P = S, then P' = S, i.e., the point S is the fixed point of the mapping. If , S is the center point of a line segment connecting P and P'. Therefore, the following equations result: If RowRowRowRowrowrow and ColumnColumnColumnColumncolumncolumn are set to the origin, the in morphology often used transposition results. Hence transpose_regiontranspose_regionTransposeRegionTransposeRegionTransposeRegiontranspose_region is often used to reflect (transpose) a structuring element.

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 to be reflected.

TransposedTransposedTransposedTransposedtransposedtransposed (output_object) region(-array) → object

Transposed region.

RowRowRowRowrowrow (input_control) point.y → (integer)

Row coordinate of the reference point.

Default: 0

Suggested values: 0, 64, 128, 256, 512

Value range: 0 ≤ Row Row Row Row row row ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumncolumncolumn (input_control) point.x → (integer)

Column coordinate of the reference point.

Default: 0

Suggested values: 0, 64, 128, 256, 512

Value range: 0 ≤ Column Column Column Column column column ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

Complexity

Let F be the area of the input region. Then the runtime complexity for one region is

Result

transpose_regiontranspose_regionTransposeRegionTransposeRegionTransposeRegiontranspose_region returns 2 ( H_MSG_TRUE) if all parameters are correct. The behavior in case of empty or no input region can be set via:

Otherwise, an exception is raised.

Possible Successors

reduce_domainreduce_domainReduceDomainReduceDomainReduceDomainreduce_domain, select_shapeselect_shapeSelectShapeSelectShapeSelectShapeselect_shape, area_centerarea_centerAreaCenterAreaCenterAreaCenterarea_center, connectionconnectionConnectionConnectionConnectionconnection

Module

Foundation

Operators