polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtpolar_trans_image_ext (算子)

名称

polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtpolar_trans_image_ext — 将图像中的环形弧变换为极坐标。

签名

描述

polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExtpolar_trans_image_ext transforms 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 in the image ImageImageImageImageimageimage to its polar coordinate version in the image PolarTransImagePolarTransImagePolarTransImagePolarTransImagepolarTransImagepolar_trans_image of the dimensions WidthWidthWidthWidthwidthwidth x HeightHeightHeightHeightheightheight。

The upper left pixel in the output image always corresponds to the point in the input image that is specified by RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start and AngleStartAngleStartAngleStartAngleStartangleStartangle_start. Analogously, the lower right pixel in the output image always corresponds to the point in the input image 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 image. 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 image can be achieved.

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". With 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor", the gray value of a pixel in the output image is determined by the gray value of the closest pixel in the input image. With 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear", the gray value of a pixel in the output image is determined by bilinear interpolation of the gray values of the four closest pixels in the input image. The mode 'bilinear'"bilinear""bilinear""bilinear""bilinear""bilinear" results in images of better quality, but is slower than the mode 'nearest_neighbor'"nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor""nearest_neighbor".

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 the height HeightHeightHeightHeightheightheight of the destination image, calculation will be sped up through an optimized routine.

The radii and angles are inclusive, which means that the first row of the 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 call polar_trans_image(Image, PolarTransImage, Row, Column, Width, Height)polar_trans_image(Image, PolarTransImage, Row, Column, Width, Height)PolarTransImage(Image, PolarTransImage, Row, Column, Width, Height)PolarTransImage(Image, PolarTransImage, Row, Column, Width, Height)PolarTransImage(Image, PolarTransImage, Row, Column, Width, Height)polar_trans_image(Image, PolarTransImage, Row, Column, Width, Height) produces the same result as the call polar_trans_image_ext(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, 'nearest_neighbor')polar_trans_image_ext(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, "nearest_neighbor")PolarTransImageExt(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, "nearest_neighbor")PolarTransImageExt(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, "nearest_neighbor")PolarTransImageExt(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, "nearest_neighbor")polar_trans_image_ext(Image, PolarTransImage, Row-0.5, Column-0.5, 6.2831853, 6.2831853/Width, 0, Height-1, Width, Height, "nearest_neighbor").

The offset of 0.5 is necessary since polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImagepolar_trans_image does not do exact nearest neighbor interpolation and the radii and angles can be calculated using the information in the above paragraph and knowing that polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImagepolar_trans_image does not handle its arguments inclusively. The start angle is bigger than the end angle to make polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExtpolar_trans_image_ext go clockwise, just like polar_trans_imagepolar_trans_imagePolarTransImagePolarTransImagePolarTransImagepolar_trans_image does.

polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtPolarTransImageExtpolar_trans_image_ext can be executed on an OpenCL device if the input image does not exceed the maximum size of image objects of the selected device. Due to numerical reasons, there can be slight differences in the output compared to the execution on the CPU.

Additionally, for images of type 'byte'"byte""byte""byte""byte""byte", 'int2'"int2""int2""int2""int2""int2" or 'uint2'"uint2""uint2""uint2""uint2""uint2" the system parameter 'int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming""int_zooming" selects between fast calculation in fixed point arithmetics ('int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming""int_zooming" = 'true'"true""true""true""true""true") and highly accurate calculation in floating point arithmetics ('int_zooming'"int_zooming""int_zooming""int_zooming""int_zooming""int_zooming" = 'false'"false""false""false""false""false"). Fixed point calculation can lead to minor gray value deviations and pixels with undefined gray values.

更多信息

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

注意

For speed reasons, the domain of the input image is ignored. The output image always has a complete rectangle as its domain.

执行信息

• 支持 OpenCL 计算设备。
• 多线程类型：可重入（与非独占算子并行运行）。
• 多线程作用域：全局（可从任何线程调用）。
• 在元组级别上自动并行化。
• 在通道级别上自动并行化。
• 在内部数据级别上自动并行化。

参数

另见

polar_trans_image_invpolar_trans_image_invPolarTransImageInvPolarTransImageInvPolarTransImageInvpolar_trans_image_inv, polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionPolarTransRegionpolar_trans_region, 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

模块

基础

---