transpose_regiontranspose_regionTransposeRegionTransposeRegion (Operator)

Name

transpose_regiontranspose_regionTransposeRegionTransposeRegion — Reflect a region about a point.

Signature

transpose_region(Region : Transposed : Row, Column : )

Herror transpose_region(const Hobject Region, Hobject* Transposed, const Hlong Row, const Hlong Column)

Herror T_transpose_region(const Hobject Region, Hobject* Transposed, const Htuple Row, const Htuple Column)

void TransposeRegion(const HObject& Region, HObject* Transposed, const HTuple& Row, const HTuple& Column)

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

static void HOperatorSet.TransposeRegion(HObject region, out HObject transposed, HTuple row, HTuple column)

HRegion HRegion.TransposeRegion(int row, int column)

Description

transpose_regiontranspose_regionTransposeRegionTransposeRegionTransposeRegion reflects a region about a point. The fixed point is given by ColumnColumnColumnColumncolumn and RowRowRowRowrow. 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 RowRowRowRowrow and ColumnColumnColumnColumncolumn are set to the origin, the in morphology often used transposition results. Hence transpose_regiontranspose_regionTransposeRegionTransposeRegionTransposeRegion is often used to reflect (transpose) a structuring element.

Execution Information

Parameters

RegionRegionRegionRegionregion (input_object)  region(-array) objectHRegionHRegionHobject

Region to be reflected.

TransposedTransposedTransposedTransposedtransposed (output_object)  region(-array) objectHRegionHRegionHobject *

Transposed region.

RowRowRowRowrow (input_control)  point.y HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Row coordinate of the reference point.

Default value: 0

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

Typical range of values: 0 ≤ Row Row Row Row row ≤ 511 (lin)

Minimum increment: 1

Recommended increment: 1

ColumnColumnColumnColumncolumn (input_control)  point.x HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Column coordinate of the reference point.

Default value: 0

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

Typical range of values: 0 ≤ 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_regionTransposeRegionTransposeRegionTransposeRegion 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_domainReduceDomainReduceDomainReduceDomain, select_shapeselect_shapeSelectShapeSelectShapeSelectShape, area_centerarea_centerAreaCenterAreaCenterAreaCenter, connectionconnectionConnectionConnectionConnection

See also

dilation1dilation1Dilation1Dilation1Dilation1, openingopeningOpeningOpeningOpening, closingclosingClosingClosingClosing

Module

Foundation