ClassesClassesClassesClasses | | | | Operators

polar_trans_image_extpolar_trans_image_extPolarTransImageExtpolar_trans_image_extPolarTransImageExtPolarTransImageExt (Operator)

Name

polar_trans_image_extpolar_trans_image_extPolarTransImageExtpolar_trans_image_extPolarTransImageExtPolarTransImageExt — Transform an annular arc in an image to polar coordinates.

Signature

polar_trans_image_ext(Image : PolarTransImage : Row, Column, AngleStart, AngleEnd, RadiusStart, RadiusEnd, Width, Height, Interpolation : )

Herror polar_trans_image_ext(const Hobject Image, Hobject* PolarTransImage, 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_image_ext(const Hobject Image, Hobject* PolarTransImage, 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)

Herror polar_trans_image_ext(Hobject Image, Hobject* PolarTransImage, 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)

HImage HImage::PolarTransImageExt(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) const

HImageArray HImageArray::PolarTransImageExt(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) const

void PolarTransImageExt(const HObject& Image, HObject* PolarTransImage, 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)

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

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

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

void HOperatorSetX.PolarTransImageExt(
[in] IHUntypedObjectX* Image, [out] IHUntypedObjectX*PolarTransImage, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT AngleStart, [in] VARIANT AngleEnd, [in] VARIANT RadiusStart, [in] VARIANT RadiusEnd, [in] VARIANT Width, [in] VARIANT Height, [in] VARIANT Interpolation)

IHImageX* HImageX.PolarTransImageExt(
[in] VARIANT Row, [in] VARIANT Column, [in] double AngleStart, [in] double AngleEnd, [in] VARIANT RadiusStart, [in] VARIANT RadiusEnd, [in] Hlong Width, [in] Hlong Height, [in] BSTR Interpolation)

static void HOperatorSet.PolarTransImageExt(HObject image, out HObject polarTransImage, HTuple row, HTuple column, HTuple angleStart, HTuple angleEnd, HTuple radiusStart, HTuple radiusEnd, HTuple width, HTuple height, HTuple interpolation)

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

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

Description

polar_trans_image_extpolar_trans_image_extPolarTransImageExtpolar_trans_image_extPolarTransImageExtPolarTransImageExt transforms the annular arc specified by the center point (RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn), the radii RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart and RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd and the angles AngleStartAngleStartAngleStartAngleStartAngleStartangleStart and AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd in the image ImageImageImageImageImageimage to its polar coordinate version in the image PolarTransImagePolarTransImagePolarTransImagePolarTransImagePolarTransImagepolarTransImage 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 RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart and AngleStartAngleStartAngleStartAngleStartAngleStartangleStart. Analogously, the lower right pixel in the output image always corresponds to the point in the input image that is specified by RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd and AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd. In the usual mode (AngleStartAngleStartAngleStartAngleStartAngleStartangleStart < AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd and RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart < RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd), 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., AngleStartAngleStartAngleStartAngleStartAngleStartangleStart > AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd or RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart > RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd), 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 RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd and RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart 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 RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart and the last row contains the circle with radius RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd. For complete circles, where the difference between AngleStartAngleStartAngleStartAngleStartAngleStartangleStart and AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd equals 2 * pi (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 2 * pi, but 2 * pi * (1 - 1/WidthWidthWidthWidthWidthwidth) degrees instead.

The call:

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')

The offset of 0.5 is necessary since polar_trans_imagepolar_trans_imagePolarTransImagepolar_trans_imagePolarTransImagePolarTransImage 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_imagePolarTransImagepolar_trans_imagePolarTransImagePolarTransImage does not handle its arguments inclusively. The start angle is bigger than the end angle to make polar_trans_image_extpolar_trans_image_extPolarTransImageExtpolar_trans_image_extPolarTransImageExtPolarTransImageExt go clockwise, just like polar_trans_imagepolar_trans_imagePolarTransImagepolar_trans_imagePolarTransImagePolarTransImage does.

polar_trans_image_extpolar_trans_image_extPolarTransImageExtpolar_trans_image_extPolarTransImageExtPolarTransImageExt 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.

Attention

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

Parallelization

Parameters

ImageImageImageImageImageimage (input_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject (byte* / int2* / uint2* / real*) *allowed for compute devices

Input image.

PolarTransImagePolarTransImagePolarTransImagePolarTransImagePolarTransImagepolarTransImage (output_object)  (multichannel-)image(-array) objectHImageHImageHImageHImageXHobject * (byte / int2 / uint2 / real)

Output image.

RowRowRowRowRowrow (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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

ColumnColumnColumnColumnColumncolumn (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (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

AngleStartAngleStartAngleStartAngleStartAngleStartangleStart (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Angle of the ray to be mapped to the first column of the output image.

Default value: 0.0

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

AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double) (double)

Angle of the ray to be mapped to the last column of the output image.

Default value: 6.2831853

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

RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Radius of the circle to be mapped to the first row of the output image.

Default value: 0

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

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

RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd (input_control)  number HTupleHTupleHTupleVARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Radius of the circle to be mapped to the last row of the output image.

Default value: 100

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

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

WidthWidthWidthWidthWidthwidth (input_control)  number HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Width of the output image.

Default value: 512

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

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

HeightHeightHeightHeightHeightheight (input_control)  number HTupleHTupleHTupleVARIANTHtuple (integer) (int / long) (Hlong) (Hlong) (Hlong) (Hlong)

Height of the output image.

Default value: 512

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

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

InterpolationInterpolationInterpolationInterpolationInterpolationinterpolation (input_control)  string HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Interpolation method for the transformation.

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

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

See also

polar_trans_image_invpolar_trans_image_invPolarTransImageInvpolar_trans_image_invPolarTransImageInvPolarTransImageInv, polar_trans_regionpolar_trans_regionPolarTransRegionpolar_trans_regionPolarTransRegionPolarTransRegion, polar_trans_region_invpolar_trans_region_invPolarTransRegionInvpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv, polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXld, polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInv

Module

Foundation


ClassesClassesClassesClasses | | | | Operators