Operator Reference

HALCON Operator Reference / XLD / Geometric Transformations
ClassesClasses | | Operators

polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXldpolar_trans_contour_xld (Operator)

polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXldpolar_trans_contour_xld — Transform a contour in an annular arc to polar coordinates.

Signature

Herror polar_trans_contour_xld(const Hobject Contour, Hobject* PolarTransContour, double Row, double Column, double AngleStart, double AngleEnd, double RadiusStart, double RadiusEnd, const Hlong Width, const Hlong Height)

Herror T_polar_trans_contour_xld(const Hobject Contour, Hobject* PolarTransContour, const Htuple Row, const Htuple Column, const Htuple AngleStart, const Htuple AngleEnd, const Htuple RadiusStart, const Htuple RadiusEnd, const Htuple Width, const Htuple Height)

void PolarTransContourXld(const HObject& Contour, HObject* PolarTransContour, const HTuple& Row, const HTuple& Column, const HTuple& AngleStart, const HTuple& AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, const HTuple& Width, const HTuple& Height)

HXLDCont HXLDCont::PolarTransContourXld(const HTuple& Row, const HTuple& Column, double AngleStart, double AngleEnd, const HTuple& RadiusStart, const HTuple& RadiusEnd, Hlong Width, Hlong Height) const

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

static void HOperatorSet.PolarTransContourXld(HObject contour, out HObject polarTransContour, HTuple row, HTuple column, HTuple angleStart, HTuple angleEnd, HTuple radiusStart, HTuple radiusEnd, HTuple width, HTuple height)

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

HXLDCont HXLDCont.PolarTransContourXld(double row, double column, double angleStart, double angleEnd, double radiusStart, double radiusEnd, int width, int height)

def polar_trans_contour_xld(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: int, height: int) -> HObject

Description

polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXldpolar_trans_contour_xld transforms the ContourContourContourcontourcontour in the annular arc specified by the center point (RowRowRowrowrow, ColumnColumnColumncolumncolumn), the radii RadiusStartRadiusStartRadiusStartradiusStartradius_start and RadiusEndRadiusEndRadiusEndradiusEndradius_end and the angles AngleStartAngleStartAngleStartangleStartangle_start and AngleEndAngleEndAngleEndangleEndangle_end to its polar coordinate version PolarTransContourPolarTransContourPolarTransContourpolarTransContourpolar_trans_contour in the virtual image of the dimensions WidthWidthWidthwidthwidth x HeightHeightHeightheightheight. The output contour is cropped at the borders of this virtual image.

The coordinate (0,0) in the output contour always corresponds to the contour point specified by RadiusStartRadiusStartRadiusStartradiusStartradius_start and AngleStartAngleStartAngleStartangleStartangle_start. Analogously, the coordinate (HeightHeightHeightheightheight-1,WidthWidthWidthwidthwidth-1) in the output contour always corresponds to the point in the contour that is specified by RadiusEndRadiusEndRadiusEndradiusEndradius_end and AngleEndAngleEndAngleEndangleEndangle_end, even if the contour does not contain these points. In the usual mode (AngleStartAngleStartAngleStartangleStartangle_start < AngleEndAngleEndAngleEndangleEndangle_end and RadiusStartRadiusStartRadiusStartradiusStartradius_start < RadiusEndRadiusEndRadiusEndradiusEndradius_end), the polar transformation is performed in the mathematically positive orientation (counterclockwise). Furthermore, contour points with smaller radii lie in the upper part of the output contour. By suitably exchanging the values of these parameters (e.g., AngleStartAngleStartAngleStartangleStartangle_start > AngleEndAngleEndAngleEndangleEndangle_end or RadiusStartRadiusStartRadiusStartradiusStartradius_start > RadiusEndRadiusEndRadiusEndradiusEndradius_end), any desired orientation of the output contour PolarTransContourPolarTransContourPolarTransContourpolarTransContourpolar_trans_contour can be achieved.

The angles can be chosen from all real numbers. Center point and radii can be real as well.

Note that PolarTransContourPolarTransContourPolarTransContourpolarTransContourpolar_trans_contour can consist of more than one contour because ContourContourContourcontourcontour may be split at AngleStartAngleStartAngleStartangleStartangle_start respectively AngleEndAngleEndAngleEndangleEndangle_end or the size of the angle interval [AngleStartAngleStartAngleStartangleStartangle_start,AngleEndAngleEndAngleEndangleEndangle_end] may be greater than one 2pi period.

If more than one contour is passed in ContourContourContourcontourcontour, their polar transformations are computed individually and stored as a tuple in PolarTransContourPolarTransContourPolarTransContourpolarTransContourpolar_trans_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 ContourContourContourcontourcontour and the indices in the output tuple PolarTransContourPolarTransContourPolarTransContourpolarTransContourpolar_trans_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_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXldpolar_trans_contour_xld only produces reliable results if the spacing of the contour points is small. Existing attributes are not transformed.

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

ContourContourContourcontourcontour (input_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject

Input contour.

PolarTransContourPolarTransContourPolarTransContourpolarTransContourpolar_trans_contour (output_object)  xld_cont(-array) → objectHXLDContHObjectHObjectHobject *

Output contour.

RowRowRowrowrow (input_control)  number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Row coordinate of the center of the arc.

Default: 256

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

ColumnColumnColumncolumncolumn (input_control)  number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column coordinate of the center of the arc.

Default: 256

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

AngleStartAngleStartAngleStartangleStartangle_start (input_control)  angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Angle of the ray to be mapped to the column coordinate 0 of PolarTransContourPolarTransContourPolarTransContourpolarTransContourpolar_trans_contour.

Default: 0.0

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

Value range: -6.2831853 ≤ AngleStart AngleStart AngleStart angleStart angle_start ≤ 6.2831853

AngleEndAngleEndAngleEndangleEndangle_end (input_control)  angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)

Angle of the ray to be mapped to the column coordinate WidthWidthWidthwidthwidth-1 of PolarTransContourPolarTransContourPolarTransContourpolarTransContourpolar_trans_contour to.

Default: 6.2831853

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

Value range: -6.2831853 ≤ AngleEnd AngleEnd AngleEnd angleEnd angle_end ≤ 6.2831853

RadiusStartRadiusStartRadiusStartradiusStartradius_start (input_control)  number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Radius of the circle to be mapped to the row coordinate 0 of PolarTransContourPolarTransContourPolarTransContourpolarTransContourpolar_trans_contour.

Default: 0

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

Value range: 0 ≤ RadiusStart RadiusStart RadiusStart radiusStart radius_start ≤ 32767

RadiusEndRadiusEndRadiusEndradiusEndradius_end (input_control)  number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Radius of the circle to be mapped to the row coordinate HeightHeightHeightheightheight-1 of PolarTransContourPolarTransContourPolarTransContourpolarTransContourpolar_trans_contour.

Default: 100

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

Value range: 0 ≤ RadiusEnd RadiusEnd RadiusEnd radiusEnd radius_end ≤ 32767

WidthWidthWidthwidthwidth (input_control)  extent.x → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Width of the virtual output image.

Default: 512

Suggested values: 256, 320, 512, 640, 800, 1024

Value range: 0 ≤ Width Width Width width width ≤ 32767

HeightHeightHeightheightheight (input_control)  extent.y → HTupleintHTupleHtuple (integer) (int / long) (Hlong) (Hlong)

Height of the virtual output image.

Default: 512

Suggested values: 240, 256, 480, 512, 600, 1024

Value range: 0 ≤ Height Height Height height height ≤ 32767

See also

polar_trans_image_extpolar_trans_image_extPolarTransImageExtPolarTransImageExtpolar_trans_image_ext, polar_trans_image_invpolar_trans_image_invPolarTransImageInvPolarTransImageInvpolar_trans_image_inv, polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionpolar_trans_region, polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvpolar_trans_region_inv, polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvpolar_trans_contour_xld_inv

Module

Foundation

ClassesClasses | | Operators