Name
polar_trans_region_invpolar_trans_region_invPolarTransRegionInvpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv — Transform a region in polar coordinates back to cartesian
coordinates.
polar_trans_region_inv(PolarRegion : XYTransRegion : Row, Column, AngleStart, AngleEnd, RadiusStart, RadiusEnd, WidthIn, HeightIn, Width, Height, Interpolation : )
Herror polar_trans_region_inv(const Hobject PolarRegion, Hobject* XYTransRegion, double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, const Hlong WidthIn, const Hlong HeightIn, const Hlong Width, const Hlong Height, const char* Interpolation)
Herror T_polar_trans_region_inv(const Hobject PolarRegion, Hobject* XYTransRegion, const Htuple Row, const Htuple Column, const Htuple AngleStart, const Htuple AngleEnd, const Htuple RadiusStart, const Htuple RadiusEnd, const Htuple WidthIn, const Htuple HeightIn, const Htuple Width, const Htuple Height, const Htuple Interpolation)
Herror polar_trans_region_inv(Hobject PolarRegion, Hobject* XYTransRegion, const HTuple& Row, const HTuple& Column, const HTuple& AngleStart, const HTuple& AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, const HTuple& WidthIn, const HTuple& HeightIn, const HTuple& Width, const HTuple& Height, const HTuple& Interpolation)
HRegion HRegion::PolarTransRegionInv(const HTuple& Row, const HTuple& Column, const HTuple& AngleStart, const HTuple& AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, const HTuple& WidthIn, const HTuple& HeightIn, const HTuple& Width, const HTuple& Height, const HTuple& Interpolation) const
HRegionArray HRegionArray::PolarTransRegionInv(const HTuple& Row, const HTuple& Column, const HTuple& AngleStart, const HTuple& AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, const HTuple& WidthIn, const HTuple& HeightIn, const HTuple& Width, const HTuple& Height, const HTuple& Interpolation) const
void PolarTransRegionInv(const HObject& PolarRegion, HObject* XYTransRegion, const HTuple& Row, const HTuple& Column, const HTuple& AngleStart, const HTuple& AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, const HTuple& WidthIn, const HTuple& HeightIn, const HTuple& Width, const HTuple& Height, const HTuple& Interpolation)
HRegion HRegion::PolarTransRegionInv(const HTuple& Row, const HTuple& Column, double AngleStart, double AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, Hlong WidthIn, Hlong HeightIn, Hlong Width, Hlong Height, const HString& Interpolation) const
HRegion HRegion::PolarTransRegionInv(double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, Hlong WidthIn, Hlong HeightIn, Hlong Width, Hlong Height, const HString& Interpolation) const
HRegion HRegion::PolarTransRegionInv(double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, Hlong WidthIn, Hlong HeightIn, Hlong Width, Hlong Height, const char* Interpolation) const
void HOperatorSetX.PolarTransRegionInv(
[in] IHUntypedObjectX* PolarRegion, [out] IHUntypedObjectX** XYTransRegion, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT AngleStart, [in] VARIANT AngleEnd, [in] VARIANT RadiusStart, [in] VARIANT RadiusEnd, [in] VARIANT WidthIn, [in] VARIANT HeightIn, [in] VARIANT Width, [in] VARIANT Height, [in] VARIANT Interpolation)
IHRegionX* HRegionX.PolarTransRegionInv(
[in] VARIANT Row, [in] VARIANT Column, [in] double AngleStart, [in] double AngleEnd, [in] VARIANT RadiusStart, [in] VARIANT RadiusEnd, [in] Hlong WidthIn, [in] Hlong HeightIn, [in] Hlong Width, [in] Hlong Height, [in] BSTR Interpolation)
static void HOperatorSet.PolarTransRegionInv(HObject polarRegion, out HObject XYTransRegion, HTuple row, HTuple column, HTuple angleStart, HTuple angleEnd, HTuple radiusStart, HTuple radiusEnd, HTuple widthIn, HTuple heightIn, HTuple width, HTuple height, HTuple interpolation)
HRegion HRegion.PolarTransRegionInv(HTuple row, HTuple column, double angleStart, double angleEnd, HTuple radiusStart, HTuple radiusEnd, int widthIn, int heightIn, int width, int height, string interpolation)
HRegion HRegion.PolarTransRegionInv(double row, double column, double angleStart, double angleEnd, double radiusStart, double radiusEnd, int widthIn, int heightIn, int width, int height, string interpolation)
polar_trans_region_invpolar_trans_region_invPolarTransRegionInvpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv transforms the polar coordinate
representation of a region, stored in PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion, back
onto an annular arc in cartesian coordinates, described by the radii
RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart and RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd and the angles
AngleStartAngleStartAngleStartAngleStartAngleStartangleStart and AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd with the center point
located at (RowRowRowRowRowrow, ColumnColumnColumnColumnColumncolumn). All of these values can
be chosen as real numbers. In addition, the dimensions of the
virtual image containing the region PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion must be
given in WidthInWidthInWidthInWidthInWidthInwidthIn and
HeightInHeightInHeightInHeightInHeightInheightIn. WidthInWidthInWidthInWidthInWidthInwidthIn-1 is the column coordinate
corresponding to AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd and HeightInHeightInHeightInHeightInHeightInheightIn-1 is the
row coordinate corresponding to
RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd. AngleStartAngleStartAngleStartAngleStartAngleStartangleStart and RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart
correspond to column and row coordinate 0. Furthermore,
the dimensions WidthWidthWidthWidthWidthwidth and HeightHeightHeightHeightHeightheight of the virtual
output image containing the transformed region
XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegion are required.
The angles and radii are inclusive, which means that the row
coordinate 0 in PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion will be mapped onto a
a circle with a distance of RadiusStartRadiusStartRadiusStartRadiusStartRadiusStartradiusStart pixels from the
specified center and the row with the coordinate
HeightInHeightInHeightInHeightInHeightInheightIn-1 will be mapped onto a circle of radius
RadiusEndRadiusEndRadiusEndRadiusEndRadiusEndradiusEnd. This applies to AngleStartAngleStartAngleStartAngleStartAngleStartangleStart,
AngleEndAngleEndAngleEndAngleEndAngleEndangleEnd, and WidthInWidthInWidthInWidthInWidthInwidthIn in an analogous way. If the
width of the input region PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion corresponds to an
angle interval greater than 2pi, the region is cropped such that
length of this interval is 2pi.
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.
polar_trans_region_invpolar_trans_region_invPolarTransRegionInvpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv is the inverse function of
polar_trans_regionpolar_trans_regionPolarTransRegionpolar_trans_regionPolarTransRegionPolarTransRegion.
The call sequence:
polar_trans_region(Region, PolarRegion, Row, Column, rad(360), 0, 0,
Radius, Width, Height, 'nearest_neighbor')
polar_trans_region_inv(PolarRegion, XYTransRegion, Row, Column, rad(360), 0,
0, Radius, Width, Height, Width, Height,
'nearest_neighbor')
returns the region Region, restricted to the circle around
(Row, Column) with radius Radius, as its
output region XYTransRegion.
If more than one region is passed in PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion, their
cartesian transformations are computed individually and stored as a
tuple in XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegion. 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 'false'"false""false""false""false""false"
(see set_systemset_systemSetSystemset_systemSetSystemSetSystem). Otherwise empty output regions are
discarded and the length of the input tuple PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion is
most likely not equal to the length of the output tuple
XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegion.
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_systemSetSystemset_systemSetSystemSetSystem). Otherwise, an output region that does not lie
within the dimensions of the current image can produce an error
message.
- 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 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
Typical range of values: 0
≤
Row
Row
Row
Row
Row
row
≤
32767
Restriction: Row >= -131068 && Row <= 131068
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
column
≤
32767
Restriction: Column >= -131068 && Column <= 131068
Width of the virtual input image.
Default value: 512
Suggested values: 256, 320, 512, 640, 800, 1024
Typical range of values: 2
≤
WidthIn
WidthIn
WidthIn
WidthIn
WidthIn
widthIn
≤
32767
Height of the virtual input image.
Default value: 512
Suggested values: 240, 256, 480, 512, 600, 1024
Typical range of values: 2
≤
HeightIn
HeightIn
HeightIn
HeightIn
HeightIn
heightIn
≤
32767
Width of the virtual output image.
Default value: 512
Suggested values: 256, 320, 512, 640, 800, 1024
Typical range of values: 1
≤
Width
Width
Width
Width
Width
width
≤
32767
Height of the virtual output image.
Default value: 512
Suggested values: 240, 256, 480, 512, 600, 1024
Typical range of values: 1
≤
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_extpolar_trans_image_extPolarTransImageExtpolar_trans_image_extPolarTransImageExtPolarTransImageExt,
polar_trans_image_invpolar_trans_image_invPolarTransImageInvpolar_trans_image_invPolarTransImageInvPolarTransImageInv,
polar_trans_regionpolar_trans_regionPolarTransRegionpolar_trans_regionPolarTransRegionPolarTransRegion,
polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXld,
polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInv
Foundation