ClassesClassesClassesClasses | | | | Operators

polar_trans_region_invpolar_trans_region_invPolarTransRegionInvpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv (Operator)

Name

polar_trans_region_invpolar_trans_region_invPolarTransRegionInvpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv — Transform a region in polar coordinates back to cartesian coordinates.

Signature

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)

Description

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.

Attention

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.

Parallelization

Parameters

PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion (input_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject

Input region.

XYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegionXYTransRegion (output_object)  region(-array) objectHRegionHRegionHRegionHRegionXHobject *

Output region.

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

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

Typical range of values: 0 ≤ Column Column Column Column Column column ≤ 32767

Restriction: Column >= -131068 && Column <= 131068

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

Angle of the ray to map the column coordinate 0 of PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion to.

Default value: 0.0

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

Typical range of values: -6.2831853 ≤ AngleStart AngleStart AngleStart AngleStart AngleStart angleStart ≤ 6.2831853

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

Angle of the ray to map the column coordinate WidthInWidthInWidthInWidthInWidthInwidthIn-1 of PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion to.

Default value: 6.2831853

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

Typical range of values: -6.2831853 ≤ AngleEnd AngleEnd AngleEnd AngleEnd AngleEnd angleEnd ≤ 6.2831853

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

Radius of the circle to map the row coordinate 0 of PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion to.

Default value: 0

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

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

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

Radius of the circle to map the row coordinate HeightInHeightInHeightInHeightInHeightInheightIn-1 of PolarRegionPolarRegionPolarRegionPolarRegionPolarRegionpolarRegion to.

Default value: 100

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

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

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

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

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

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

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

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

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

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

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_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

Module

Foundation


ClassesClassesClassesClasses | | | | Operators