Skip to content

polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvpolar_trans_contour_xld_invpolar_trans_contour_xld_inv🔗

Short description🔗

polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvpolar_trans_contour_xld_invpolar_trans_contour_xld_inv — Transform a contour in polar coordinates back to Cartesian coordinates

Signature🔗

polar_trans_contour_xld_inv( xld_cont PolarContour, out xld_cont XYTransContour, number Row, number Column, angle.rad AngleStart, angle.rad AngleEnd, number RadiusStart, number RadiusEnd, extent.x WidthIn, extent.y HeightIn, extent.x Width, extent.y Height )polar_trans_contour_xld_inv( PolarContour : XYTransContour : Row, Column, AngleStart, AngleEnd, RadiusStart, RadiusEnd, WidthIn, HeightIn, Width, Height : )void PolarTransContourXldInv( const HObject& PolarContour, HObject* XYTransContour, 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 )static void HOperatorSet.PolarTransContourXldInv( HObject polarContour, out HObject XYTransContour, HTuple row, HTuple column, HTuple angleStart, HTuple angleEnd, HTuple radiusStart, HTuple radiusEnd, HTuple widthIn, HTuple heightIn, HTuple width, HTuple height )def polar_trans_contour_xld_inv( polar_contour: HObject, row: Union[int, float], column: Union[int, float], angle_start: float, angle_end: float, radius_start: Union[int, float], radius_end: Union[int, float], width_in: int, height_in: int, width: int, height: int ) -> HObject

Herror polar_trans_contour_xld_inv( const Hobject PolarContour, Hobject* XYTransContour, double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, const Hlong WidthIn, const Hlong HeightIn, const Hlong Width, const Hlong Height )

Herror T_polar_trans_contour_xld_inv( const Hobject PolarContour, Hobject* XYTransContour, 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 )

HXLDCont HXLDCont::PolarTransContourXldInv( 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

HXLDCont HXLDCont::PolarTransContourXldInv( double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, Hlong WidthIn, Hlong HeightIn, Hlong Width, Hlong Height ) const

HXLDCont HXLDCont.PolarTransContourXldInv( HTuple row, HTuple column, double angleStart, double angleEnd, HTuple radiusStart, HTuple radiusEnd, int widthIn, int heightIn, int width, int height )

HXLDCont HXLDCont.PolarTransContourXldInv( double row, double column, double angleStart, double angleEnd, double radiusStart, double radiusEnd, int widthIn, int heightIn, int width, int height )

Description🔗

polar_trans_contour_xld_invPolarTransContourXldInv transforms the polar coordinate representation of a contour, stored in PolarContourpolarContourpolar_contour, back onto an annular arc in Cartesian coordinates, described by the radii RadiusStartradiusStartradius_start and RadiusEndradiusEndradius_end and the angles AngleStartangleStartangle_start and AngleEndangleEndangle_end with the center point located at (Rowrowrow, Columncolumncolumn). All of these values can be chosen as real numbers. In addition, the dimensions of the virtual image containing the contour PolarContourpolarContourpolar_contour must be given in WidthInwidthInwidth_in and HeightInheightInheight_in. \(\textrm{WidthIn}-1\) is the column coordinate corresponding to AngleEndangleEndangle_end and \(\textrm{HeightIn}-1\) is the row coordinate corresponding to RadiusEndradiusEndradius_end. AngleStartangleStartangle_start and RadiusStartradiusStartradius_start correspond to column and row coordinate 00. Furthermore, the dimensions Widthwidthwidth and Heightheightheight of the virtual output image containing the transformed contour XYTransContourXYTransContourxytrans_contour are required. The output contour is cropped at the borders of this virtual output image.

polar_trans_contour_xld_invPolarTransContourXldInv is the inverse function of polar_trans_contour_xldPolarTransContourXld.

The call sequence:

 
polar_trans_contour_xld(Contour, PolarContour, Row, Column, rad(360), 0, 0, Radius, Width, Height)
polar_trans_contour_xld_inv(PolarContour, XYTransContour, Row, Column, rad(360), 0, 0, Radius, Width, Height, WidthOut, HeightOut)

returns the contour Contourcontourcontour, restricted to the circle around (Rowrowrow, Columncolumncolumn) with radius Radiusradiusradius, as its output contour XYTransContourXYTransContourxytrans_contour.

Note that XYTransContourXYTransContourxytrans_contour can consist of more than one contour because PolarContourpolarContourpolar_contour may be cropped at the borders of the virtual output image given by Widthwidthwidth and Heightheightheight.

If more than one contour is passed in PolarContourpolarContourpolar_contour, their transformations are computed individually and stored as a tuple in XYTransContourXYTransContourxytrans_contour. However, since one contour may be transformed into several contours, there is no relation between the indices of the contours in the input tuple PolarContourpolarContourpolar_contour and the indices in the output tuple XYTransContourXYTransContourxytrans_contour.

Further Information🔗

For an explanation of the different 2D coordinate systems used in HALCON, see the introduction of chapter Transformations / 2D Transformations.

Attention🔗

Only the contour points are transformed. As the polar transformation is not affine, polar_trans_contour_xld_invPolarTransContourXldInv only produces reliable results if the spacing of the contour points is small. Existing attributes are not transformed.

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Automatically parallelized on tuple level.

Parameters🔗

PolarContourpolarContourpolar_contour (input_object) xld_cont(-array) → objectobjectHObjectHXLDContHObjectHobject

Input contour.

XYTransContourXYTransContourxytrans_contour (output_object) xld_cont(-array) → objectobjectHObjectHXLDContHObjectHobject *

Output contour.

Rowrowrow (input_control) number → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[int, float]Htuple (double / Hlong)

Row coordinate of the center of the arc.

Default: 256256
Suggested values: 0, 16, 32, 64, 128, 240, 256, 480, 5120, 16, 32, 64, 128, 240, 256, 480, 512

Columncolumncolumn (input_control) number → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[int, float]Htuple (double / Hlong)

Column coordinate of the center of the arc.

Default: 256256
Suggested values: 0, 16, 32, 64, 128, 256, 320, 512, 6400, 16, 32, 64, 128, 256, 320, 512, 640

AngleStartangleStartangle_start (input_control) angle.rad → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)

Angle of the ray to map the column coordinate 00 of PolarContourpolarContourpolar_contour to.

Default: 0.00.0
Suggested values: 0.0, 0.78539816, 1.57079632, 3.141592654, 6.28318530.0, 0.78539816, 1.57079632, 3.141592654, 6.2831853
Value range: -6.2831853 ≤ AngleStart ≤ 6.2831853

AngleEndangleEndangle_end (input_control) angle.rad → (real)(real)HTuple (double)HTuple (double)floatHtuple (double)

Angle of the ray to map the column coordinate \(\textrm{WidthIn}-1\) of PolarContourpolarContourpolar_contour to.

Default: 6.28318536.2831853
Suggested values: 0.0, 0.78539816, 1.57079632, 3.141592654, 6.28318530.0, 0.78539816, 1.57079632, 3.141592654, 6.2831853
Value range: -6.2831853 ≤ AngleEnd ≤ 6.2831853

RadiusStartradiusStartradius_start (input_control) number → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[int, float]Htuple (double / Hlong)

Radius of the circle to map the row coordinate 00 of PolarContourpolarContourpolar_contour to.

Default: 00
Suggested values: 0, 16, 32, 64, 100, 128, 256, 5120, 16, 32, 64, 100, 128, 256, 512
Value range: 0 ≤ RadiusStart ≤ 32767

RadiusEndradiusEndradius_end (input_control) number → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)Union[int, float]Htuple (double / Hlong)

Radius of the circle to map the row coordinate \(\textrm{HeightIn}-1\) of PolarContourpolarContourpolar_contour to.

Default: 100100
Suggested values: 0, 16, 32, 64, 100, 128, 256, 5120, 16, 32, 64, 100, 128, 256, 512
Value range: 0 ≤ RadiusEnd ≤ 32767

WidthInwidthInwidth_in (input_control) extent.x → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Width of the virtual input image.

Default: 512512
Suggested values: 256, 320, 512, 640, 800, 1024256, 320, 512, 640, 800, 1024
Value range: 0 ≤ WidthIn ≤ 32767

HeightInheightInheight_in (input_control) extent.y → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Height of the virtual input image.

Default: 512512
Suggested values: 240, 256, 480, 512, 600, 1024240, 256, 480, 512, 600, 1024
Value range: 0 ≤ HeightIn ≤ 32767

Widthwidthwidth (input_control) extent.x → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Width of the virtual output image.

Default: 512512
Suggested values: 256, 320, 512, 640, 800, 1024256, 320, 512, 640, 800, 1024
Value range: 0 ≤ Width ≤ 32767

Heightheightheight (input_control) extent.y → (integer)(integer)HTuple (Hlong)HTuple (int / long)intHtuple (Hlong)

Height of the virtual output image.

Default: 512512
Suggested values: 240, 256, 480, 512, 600, 1024240, 256, 480, 512, 600, 1024
Value range: 0 ≤ Height ≤ 32767

Combinations with other operators🔗

Combinations

See also

polar_trans_image_extPolarTransImageExt, polar_trans_image_invPolarTransImageInv, polar_trans_regionPolarTransRegion, polar_trans_region_invPolarTransRegionInv, polar_trans_contour_xldPolarTransContourXld

Module🔗

Foundation