polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionpolar_trans_region (算子)

名称

polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionpolar_trans_region — 将环形弧内的区域变换为极坐标。

签名

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)

def polar_trans_region(region: HObject, row: Union[int, float], column: Union[int, float], angle_start: float, angle_end: float, radius_start: Union[int, float], radius_end: Union[int, float], width: int, height: int, interpolation: str) -> HObject

描述

polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionPolarTransRegionpolar_trans_region transforms a RegionRegionRegionRegionregionregion within the annular arc specified by the center point (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn), the radii RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start and RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end and the angles AngleStartAngleStartAngleStartAngleStartangleStartangle_start and AngleEndAngleEndAngleEndAngleEndangleEndangle_end to its polar coordinate version in a virtual image of the dimensions WidthWidthWidthWidthwidthwidth x HeightHeightHeightHeightheightheight

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 RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn) 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 RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start and AngleStartAngleStartAngleStartAngleStartangleStartangle_start. Analogously, the coordinate (HeightHeightHeightHeightheightheight-1, WidthWidthWidthWidthwidthwidth-1) corresponds to the point in the input region that is specified by RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end and AngleEndAngleEndAngleEndAngleEndangleEndangle_end. In the usual mode (AngleStartAngleStartAngleStartAngleStartangleStartangle_start < AngleEndAngleEndAngleEndAngleEndangleEndangle_end and RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start < RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end), 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., AngleStartAngleStartAngleStartAngleStartangleStartangle_start > AngleEndAngleEndAngleEndAngleEndangleEndangle_end or RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start > RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end), 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 RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end and RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start equals HeightHeightHeightHeightheightheight-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 RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start and the last row contains the circle with radius RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end. For complete circles, where the difference between AngleStartAngleStartAngleStartAngleStartangleStartangle_start and AngleEndAngleEndAngleEndAngleEndangleEndangle_end 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 InterpolationInterpolationInterpolationInterpolationinterpolationinterpolation is used to select the interpolation method 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear" or 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor". Setting InterpolationInterpolationInterpolationInterpolationinterpolationinterpolation to 'bilinear'"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 RegionRegionRegionRegionregionregion, their polar transformations are computed individually and stored as a tuple in PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegionpolar_trans_region. 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""store_empty_regions" is set to 'true'"true""true""true""true""true" (see set_systemset_systemSetSystemSetSystemSetSystemset_system). Otherwise empty output regions are discarded and the length of the input tuple RegionRegionRegionRegionregionregion is most likely not equal to the length of the output tuple PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegionpolar_trans_region

更多信息

有关 HALCON 中使用的不同二维坐标系的说明,请参阅 变换 / 二维变换 一章的引言。

注意

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

执行信息

参数

RegionRegionRegionRegionregionregion (输入对象)  region(-array) objectHRegionHObjectHRegionHobject

Input region.

PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegionpolar_trans_region (输出对象)  region(-array) objectHRegionHObjectHRegionHobject *

Output region.

RowRowRowRowrowrow (输入控制)  number HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Row coordinate of the center of the arc.

默认值: 256

建议值: 0, 16, 32, 64, 128, 240, 256, 480, 512

ColumnColumnColumnColumncolumncolumn (输入控制)  number HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column coordinate of the center of the arc.

默认值: 256

建议值: 0, 16, 32, 64, 128, 256, 320, 512, 640

AngleStartAngleStartAngleStartAngleStartangleStartangle_start (输入控制)  angle.rad HTuplefloatHTupleHtuple (real) (double) (double) (double)

Angle of the ray to be mapped to column coordinate 0 of PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegionpolar_trans_region

默认值: 0.0

建议值: 0.0, 0.78539816, 1.57079632, 3.141592654, 6.2831853, 12.566370616

值范围: -6.2831853 ≤ AngleStart AngleStart AngleStart AngleStart angleStart angle_start ≤ 6.2831853

AngleEndAngleEndAngleEndAngleEndangleEndangle_end (输入控制)  angle.rad HTuplefloatHTupleHtuple (real) (double) (double) (double)

Angle of the ray to be mapped to column coordinate WidthWidthWidthWidthwidthwidth-1 of PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegionpolar_trans_region

默认值: 6.2831853

建议值: 0.0, 0.78539816, 1.57079632, 3.141592654, 6.2831853, 12.566370616

值范围: -6.2831853 ≤ AngleEnd AngleEnd AngleEnd AngleEnd angleEnd angle_end ≤ 6.2831853

RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start (输入控制)  number HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Radius of the circle to be mapped to row coordinate 0 of PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegionpolar_trans_region

默认值: 0

建议值: 0, 16, 32, 64, 100, 128, 256, 512

值范围: 0 ≤ RadiusStart RadiusStart RadiusStart RadiusStart radiusStart radius_start ≤ 32767

RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end (输入控制)  number HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Radius of the circle to be mapped to row coordinate HeightHeightHeightHeightheightheight-1 of PolarTransRegionPolarTransRegionPolarTransRegionPolarTransRegionpolarTransRegionpolar_trans_region

默认值: 100

建议值: 0, 16, 32, 64, 100, 128, 256, 512

值范围: 0 ≤ RadiusEnd RadiusEnd RadiusEnd RadiusEnd radiusEnd radius_end ≤ 32767

WidthWidthWidthWidthwidthwidth (输入控制)  extent.x HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Width of the virtual output image.

默认值: 512

建议值: 256, 320, 512, 640, 800, 1024

值范围: 2 ≤ Width Width Width Width width width ≤ 32767

HeightHeightHeightHeightheightheight (输入控制)  extent.y HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of the virtual output image.

默认值: 512

建议值: 240, 256, 480, 512, 600, 1024

值范围: 2 ≤ Height Height Height Height height height ≤ 32767

InterpolationInterpolationInterpolationInterpolationinterpolationinterpolation (输入控制)  string HTuplestrHTupleHtuple (string) (string) (HString) (char*)

Interpolation method for the transformation.

默认值: 'nearest_neighbor' "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" "nearest_neighbor" "nearest_neighbor"

值列表: 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear", 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor"

另见

polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExtpolar_trans_image_ext, polar_trans_image_invpolar_trans_image_invPolarTransImageInvPolarTransImageInvPolarTransImageInvpolar_trans_image_inv, polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvPolarTransRegionInvpolar_trans_region_inv, polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXldPolarTransContourXldpolar_trans_contour_xld, polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvPolarTransContourXldInvpolar_trans_contour_xld_inv

模块

基础