HALCON Website / HALCON Operator Reference / XLD / Geometric Transformations
ClassesClassesClassesClasses | | | | Operators

polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInv (Operator)

Name

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

Signature

polar_trans_contour_xld_inv(PolarContour : XYTransContour : Row, Column, AngleStart, AngleEnd, RadiusStart, RadiusEnd, WidthIn, HeightIn, Width, Height : )

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)

Herror polar_trans_contour_xld_inv(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, 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

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

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)

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

void HOperatorSetX.PolarTransContourXldInv(
[in] IHUntypedObjectX* PolarContour, [out] IHUntypedObjectX** XYTransContour, [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)

IHXLDContX* HXLDContX.PolarTransContourXldInv(
[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)

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)

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_invpolar_trans_contour_xld_invPolarTransContourXldInvpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInv transforms the polar coordinate representation of a contour, stored in PolarContourPolarContourPolarContourPolarContourPolarContourpolarContour, 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 contour PolarContourPolarContourPolarContourPolarContourPolarContourpolarContour 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 contour XYTransContourXYTransContourXYTransContourXYTransContourXYTransContourXYTransContour are required. The output contour is cropped at the borders of this virtual output image.

polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInv is the inverse function of polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXld.

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 Contour, restricted to the circle around (Row, Column) with radius Radius, as its output contour XYTransContourXYTransContourXYTransContourXYTransContourXYTransContourXYTransContour.

Note that XYTransContourXYTransContourXYTransContourXYTransContourXYTransContourXYTransContour can consist of more than one contour because PolarContourPolarContourPolarContourPolarContourPolarContourpolarContour may be cropped at the borders of the virtual output image given by WidthWidthWidthWidthWidthwidth and HeightHeightHeightHeightHeightheight.

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

Attention

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

Parallelization

Parameters

PolarContourPolarContourPolarContourPolarContourPolarContourpolarContour (input_object)  xld_cont(-array) → objectHXLDContHXLDContHXLDContHXLDContXHobject

Input contour.

XYTransContourXYTransContourXYTransContourXYTransContourXYTransContourXYTransContour (output_object)  xld_cont(-array) → objectHXLDContHXLDContHXLDContHXLDContXHobject *

Output contour.

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 PolarContourPolarContourPolarContourPolarContourPolarContourpolarContour 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 PolarContourPolarContourPolarContourPolarContourPolarContourpolarContour 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 PolarContourPolarContourPolarContourPolarContourPolarContourpolarContour 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 PolarContourPolarContourPolarContourPolarContourPolarContourpolarContour 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: 0 ≤ 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: 0 ≤ 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: 0 ≤ 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: 0 ≤ Height Height Height Height Height height ≤ 32767

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_region_invpolar_trans_region_invPolarTransRegionInvpolar_trans_region_invPolarTransRegionInvPolarTransRegionInv, polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXld

Module

Foundation

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 12.0.2 Copyright © 1996-2016 MVTec Software GmbH