Name
polar_trans_image_extpolar_trans_image_extPolarTransImageExtpolar_trans_image_extPolarTransImageExtPolarTransImageExt — Transform an annular arc in an image to polar coordinates.
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)
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.
For speed reasons, the domain of the input image is ignored. The
output image always has a complete rectangle as its domain.
- Supports OpenCL compute devices.
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Automatically parallelized on tuple level.
- Automatically parallelized on channel level.
- Automatically parallelized on internal data level.
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
Column coordinate of the center of the arc.
Default value: 256
Suggested values: 0, 16, 32, 64, 128, 256, 320, 512, 640
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
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
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
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
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
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
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"
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
Foundation