polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegion (Operator)

Name

polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegion — Transform a region within an annular arc to polar coordinates.

Signature

polar_trans_region(Region : PolarTransRegion : Row, Column, AngleStart, AngleEnd, RadiusStart, RadiusEnd, Width, Height, Interpolation : )

Herror polar_trans_region(const Hobject Region, Hobject* PolarTransRegion, double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, const Hlong Width, const Hlong Height, const char* Interpolation)

Herror T_polar_trans_region(const Hobject Region, Hobject* PolarTransRegion, const Htuple Row, const Htuple Column, const Htuple AngleStart, const Htuple AngleEnd, const Htuple RadiusStart, const Htuple RadiusEnd, const Htuple Width, const Htuple Height, const Htuple Interpolation)

void PolarTransRegion(const HObject& Region, HObject* PolarTransRegion, const HTuple& Row, const HTuple& Column, const HTuple& AngleStart, const HTuple& AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, const HTuple& Width, const HTuple& Height, const HTuple& Interpolation)

HRegion HRegion::PolarTransRegion(const HTuple& Row, const HTuple& Column, double AngleStart, double AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, Hlong Width, Hlong Height, const HString& Interpolation) const

HRegion HRegion::PolarTransRegion(double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, Hlong Width, Hlong Height, const HString& Interpolation) const

HRegion HRegion::PolarTransRegion(double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, Hlong Width, Hlong Height, const char* Interpolation) const

HRegion HRegion::PolarTransRegion(double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, Hlong Width, Hlong Height, const wchar_t* Interpolation) const   (Windows only)

static void HOperatorSet.PolarTransRegion(HObject region, out HObject polarTransRegion, HTuple row, HTuple column, HTuple angleStart, HTuple angleEnd, HTuple radiusStart, HTuple radiusEnd, HTuple width, HTuple height, HTuple interpolation)

HRegion HRegion.PolarTransRegion(HTuple row, HTuple column, double angleStart, double angleEnd, HTuple radiusStart, HTuple radiusEnd, int width, int height, string interpolation)

HRegion HRegion.PolarTransRegion(double row, double column, double angleStart, double angleEnd, double radiusStart, double radiusEnd, int width, int height, string interpolation)

Description

polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionPolarTransRegion transforms a RegionRegionRegionRegionregion within the annular arc specified by the center point (RowRowRowRowrow, ColumnColumnColumnColumncolumn), the radii RadiusStartRadiusStartRadiusStartRadiusStartradiusStart and RadiusEndRadiusEndRadiusEndRadiusEndradiusEnd and the angles AngleStartAngleStartAngleStartAngleStartangleStart and AngleEndAngleEndAngleEndAngleEndangleEnd to its polar coordinate version in a virtual image of the dimensions WidthWidthWidthWidthwidth x HeightHeightHeightHeightheight.

The polar transformation is a change of the coordinate system. Instead of a row and a column coordinate, each point's position is expressed by its radius r (i.e. the distance to the center point RowRowRowRowrow, ColumnColumnColumnColumncolumn) and the angle phi between the column axis (through the center point) and the line from the center point towards the point. Note that this transformation is not affine.

The coordinate (0,0) in the output region always corresponds to the point in the input region that is specified by RadiusStartRadiusStartRadiusStartRadiusStartradiusStart and AngleStartAngleStartAngleStartAngleStartangleStart. Analogously, the coordinate (HeightHeightHeightHeightheight-1, WidthWidthWidthWidthwidth-1) corresponds to the point in the input region that is specified by RadiusEndRadiusEndRadiusEndRadiusEndradiusEnd and AngleEndAngleEndAngleEndAngleEndangleEnd. In the usual mode (AngleStartAngleStartAngleStartAngleStartangleStart < AngleEndAngleEndAngleEndAngleEndangleEnd and RadiusStartRadiusStartRadiusStartRadiusStartradiusStart < RadiusEndRadiusEndRadiusEndRadiusEndradiusEnd), the polar transformation is performed in the mathematically positive orientation (counterclockwise). Furthermore, points with smaller radii lie in the upper part of the output region. By suitably exchanging the values of these parameters (e.g., AngleStartAngleStartAngleStartAngleStartangleStart > AngleEndAngleEndAngleEndAngleEndangleEnd or RadiusStartRadiusStartRadiusStartRadiusStartradiusStart > RadiusEndRadiusEndRadiusEndRadiusEndradiusEnd), any desired orientation of the output region can be achieved.

The angles can be chosen from all real numbers. Center point and radii can be real as well. However, if they are both integers and the difference of RadiusEndRadiusEndRadiusEndRadiusEndradiusEnd and RadiusStartRadiusStartRadiusStartRadiusStartradiusStart equals HeightHeightHeightHeightheight-1, calculation will be sped up through an optimized routine.

The radii and angles are inclusive, which means that the first row of the virtual target image contains the circle with radius RadiusStartRadiusStartRadiusStartRadiusStartradiusStart and the last row contains the circle with radius RadiusEndRadiusEndRadiusEndRadiusEndradiusEnd. For complete circles, where the difference between AngleStartAngleStartAngleStartAngleStartangleStart and AngleEndAngleEndAngleEndAngleEndangleEnd equals (360 degrees), this also means that the first column of the target image will be the same as the last.

To avoid this, do not make this difference , but degrees instead.

The parameter InterpolationInterpolationInterpolationInterpolationinterpolation is used to select the interpolation method 'bilinear'"bilinear""bilinear""bilinear""bilinear" or 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor". Setting InterpolationInterpolationInterpolationInterpolationinterpolation to 'bilinear'"bilinear""bilinear""bilinear""bilinear" leads to smoother region boundaries, especially if regions are enlarged. However, the runtime increases significantly.

If more than one region is passed in RegionRegionRegionRegionregion, their polar transformations are computed individually and stored as a tuple in PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegion. Please note that the indices of an input region and its transformation only correspond if the system variable 'store_empty_regions'"store_empty_regions""store_empty_regions""store_empty_regions""store_empty_regions" is set to 'true'"true""true""true""true" (see set_systemset_systemSetSystemSetSystemSetSystem). Otherwise empty output regions are discarded and the length of the input tuple RegionRegionRegionRegionregion is most likely not equal to the length of the output tuple PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegion.

Further Information

For an explanation of the different 2D coordinate systems used in HALCON, see the introduction of chapter Transformations / 2D Transformations.

Attention

If WidthWidthWidthWidthwidth or HeightHeightHeightHeightheight are chosen greater than the dimensions of the current image, the system variable 'clip_region'"clip_region""clip_region""clip_region""clip_region" should be set to 'false'"false""false""false""false" (see set_systemset_systemSetSystemSetSystemSetSystem). Otherwise, an output region that does not lie within the dimensions of the current image can produce an error message.

Execution Information

Parameters

RegionRegionRegionRegionregion (input_object)  region(-array) objectHRegionHRegionHobject

Input region.

PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegion (output_object)  region(-array) objectHRegionHRegionHobject *

Output region.

RowRowRowRowrow (input_control)  number HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Row coordinate of the center of the arc.

Default value: 256

Suggested values: 0, 16, 32, 64, 128, 240, 256, 480, 512

Typical range of values: 0 ≤ Row Row Row Row row ≤ 32767

Restriction: Row >= -131068 && Row <= 131068

ColumnColumnColumnColumncolumn (input_control)  number HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column coordinate of the center of the arc.

Default value: 256

Suggested values: 0, 16, 32, 64, 128, 256, 320, 512, 640

Typical range of values: 0 ≤ Column Column Column Column column ≤ 32767

Restriction: Column >= -131068 && Column <= 131068

AngleStartAngleStartAngleStartAngleStartangleStart (input_control)  angle.rad HTupleHTupleHtuple (real) (double) (double) (double)

Angle of the ray to be mapped to column coordinate 0 of PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegion.

Default value: 0.0

Suggested values: 0.0, 0.78539816, 1.57079632, 3.141592654, 6.2831853, 12.566370616

Typical range of values: -6.2831853 ≤ AngleStart AngleStart AngleStart AngleStart angleStart ≤ 6.2831853

AngleEndAngleEndAngleEndAngleEndangleEnd (input_control)  angle.rad HTupleHTupleHtuple (real) (double) (double) (double)

Angle of the ray to be mapped to column coordinate WidthWidthWidthWidthwidth-1 of PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegion.

Default value: 6.2831853

Suggested values: 0.0, 0.78539816, 1.57079632, 3.141592654, 6.2831853, 12.566370616

Typical range of values: -6.2831853 ≤ AngleEnd AngleEnd AngleEnd AngleEnd angleEnd ≤ 6.2831853

RadiusStartRadiusStartRadiusStartRadiusStartradiusStart (input_control)  number HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Radius of the circle to be mapped to row coordinate 0 of PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegion.

Default value: 0

Suggested values: 0, 16, 32, 64, 100, 128, 256, 512

Typical range of values: 0 ≤ RadiusStart RadiusStart RadiusStart RadiusStart radiusStart ≤ 32767

RadiusEndRadiusEndRadiusEndRadiusEndradiusEnd (input_control)  number HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Radius of the circle to be mapped to row coordinate HeightHeightHeightHeightheight-1 of PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegion.

Default value: 100

Suggested values: 0, 16, 32, 64, 100, 128, 256, 512

Typical range of values: 0 ≤ RadiusEnd RadiusEnd RadiusEnd RadiusEnd radiusEnd ≤ 32767

WidthWidthWidthWidthwidth (input_control)  extent.x HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Width of the virtual output image.

Default value: 512

Suggested values: 256, 320, 512, 640, 800, 1024

Typical range of values: 2 ≤ Width Width Width Width width ≤ 32767

HeightHeightHeightHeightheight (input_control)  extent.y HTupleHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of the virtual output image.

Default value: 512

Suggested values: 240, 256, 480, 512, 600, 1024

Typical range of values: 2 ≤ Height Height Height Height height ≤ 32767

InterpolationInterpolationInterpolationInterpolationinterpolation (input_control)  string HTupleHTupleHtuple (string) (string) (HString) (char*)

Interpolation method for the transformation.

Default value: 'nearest_neighbor' "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" "nearest_neighbor"

List of values: 'bilinear'"bilinear""bilinear""bilinear""bilinear", 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor"

See also

polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExt, polar_trans_image_invpolar_trans_image_invPolarTransImageInvPolarTransImageInvPolarTransImageInv, polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvPolarTransRegionInv, polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXldPolarTransContourXld, polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvPolarTransContourXldInv

Module

Foundation