polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvpolar_trans_contour_xld_inv (Operator)
Name
polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvpolar_trans_contour_xld_inv — Transform a contour in polar coordinates back to Cartesian coordinates
Signature
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)
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
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)
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
Description
polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvPolarTransContourXldInvpolar_trans_contour_xld_inv transforms the polar coordinate
representation of a contour, stored in PolarContourPolarContourPolarContourPolarContourpolarContourpolar_contour, back
onto an annular arc in Cartesian coordinates, described by the radii
RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start and RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end and the angles
AngleStartAngleStartAngleStartAngleStartangleStartangle_start and AngleEndAngleEndAngleEndAngleEndangleEndangle_end 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 PolarContourPolarContourPolarContourPolarContourpolarContourpolar_contour must be
given in WidthInWidthInWidthInWidthInwidthInwidth_in and
HeightInHeightInHeightInHeightInheightInheight_in. WidthInWidthInWidthInWidthInwidthInwidth_in-1 is the column coordinate
corresponding to AngleEndAngleEndAngleEndAngleEndangleEndangle_end and HeightInHeightInHeightInHeightInheightInheight_in-1 is the
row coordinate corresponding to
RadiusEndRadiusEndRadiusEndRadiusEndradiusEndradius_end. AngleStartAngleStartAngleStartAngleStartangleStartangle_start and RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start
correspond to column and row coordinate 0. Furthermore, the
dimensions WidthWidthWidthWidthwidthwidth and HeightHeightHeightHeightheightheight of the virtual output
image containing the transformed contour XYTransContourXYTransContourXYTransContourXYTransContourXYTransContourxytrans_contour are
required. The output contour is cropped at the borders of this
virtual output image.
polar_trans_contour_xld_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvPolarTransContourXldInvpolar_trans_contour_xld_inv is the inverse function of
polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXldPolarTransContourXldpolar_trans_contour_xld.
The call sequence:
polar_trans_contour_xld(Contour, PolarContour, Row, Column, rad(360), 0, 0, Radius, Width, Height)polar_trans_contour_xld(Contour, PolarContour, Row, Column, rad(360), 0, 0, Radius, Width, Height)PolarTransContourXld(Contour, PolarContour, Row, Column, rad(360), 0, 0, Radius, Width, Height)PolarTransContourXld(Contour, PolarContour, Row, Column, rad(360), 0, 0, Radius, Width, Height)PolarTransContourXld(Contour, PolarContour, Row, Column, rad(360), 0, 0, Radius, Width, Height)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)polar_trans_contour_xld_inv(PolarContour, XYTransContour, Row, Column, rad(360), 0, 0, Radius, Width, Height, WidthOut, HeightOut)PolarTransContourXldInv(PolarContour, XYTransContour, Row, Column, rad(360), 0, 0, Radius, Width, Height, WidthOut, HeightOut)PolarTransContourXldInv(PolarContour, XYTransContour, Row, Column, rad(360), 0, 0, Radius, Width, Height, WidthOut, HeightOut)PolarTransContourXldInv(PolarContour, XYTransContour, Row, Column, rad(360), 0, 0, Radius, Width, Height, WidthOut, HeightOut)polar_trans_contour_xld_inv(PolarContour, XYTransContour, Row, Column, rad(360), 0, 0, Radius, Width, Height, WidthOut, HeightOut)
|
ContourContourContourContourcontourcontour, restricted to the circle
around (RowRowRowRowrowrow, ColumnColumnColumnColumncolumncolumn) with radius RadiusRadiusRadiusRadiusradiusradius,
as its output contour XYTransContourXYTransContourXYTransContourXYTransContourXYTransContourxytrans_contour.
Note that XYTransContourXYTransContourXYTransContourXYTransContourXYTransContourxytrans_contour can consist of more than one
contour because PolarContourPolarContourPolarContourPolarContourpolarContourpolar_contour may be cropped at the borders
of the virtual output image given by WidthWidthWidthWidthwidthwidth and
HeightHeightHeightHeightheightheight.
If more than one contour is passed in PolarContourPolarContourPolarContourPolarContourpolarContourpolar_contour, their
transformations are computed individually and stored as a tuple in
XYTransContourXYTransContourXYTransContourXYTransContourXYTransContourxytrans_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 PolarContourPolarContourPolarContourPolarContourpolarContourpolar_contour and
the indices in the output tuple XYTransContourXYTransContourXYTransContourXYTransContourXYTransContourxytrans_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_invpolar_trans_contour_xld_invPolarTransContourXldInvPolarTransContourXldInvPolarTransContourXldInvpolar_trans_contour_xld_inv 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
PolarContourPolarContourPolarContourPolarContourpolarContourpolar_contour (input_object) xld_cont(-array) → objectHXLDContHObjectHXLDContHobject
Input contour.
XYTransContourXYTransContourXYTransContourXYTransContourXYTransContourxytrans_contour (output_object) xld_cont(-array) → objectHXLDContHObjectHXLDContHobject *
Output contour.
RowRowRowRowrowrow (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 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 → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (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
AngleStartAngleStartAngleStartAngleStartangleStartangle_start (input_control) angle.rad → HTuplefloatHTupleHtuple (real) (double) (double) (double)
Angle of the ray to map the column coordinate 0
of PolarContourPolarContourPolarContourPolarContourpolarContourpolar_contour 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
angle_start
≤
6.2831853
RadiusStartRadiusStartRadiusStartRadiusStartradiusStartradius_start (input_control) number → HTupleUnion[int, float]HTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Radius of the circle to map the row coordinate
0 of PolarContourPolarContourPolarContourPolarContourpolarContourpolar_contour to.
Default value: 0
Suggested values: 0, 16, 32, 64, 100, 128, 256, 512
Typical range of values: 0
≤
RadiusStart
RadiusStart
RadiusStart
RadiusStart
radiusStart
radius_start
≤
32767
WidthInWidthInWidthInWidthInwidthInwidth_in (input_control) extent.x → HTupleintHTupleHtuple (integer) (int / long) (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
width_in
≤
32767
HeightInHeightInHeightInHeightInheightInheight_in (input_control) extent.y → HTupleintHTupleHtuple (integer) (int / long) (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
height_in
≤
32767
WidthWidthWidthWidthwidthwidth (input_control) extent.x → HTupleintHTupleHtuple (integer) (int / long) (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) extent.y → HTupleintHTupleHtuple (integer) (int / long) (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_extPolarTransImageExtPolarTransImageExtPolarTransImageExtpolar_trans_image_ext,
polar_trans_image_invpolar_trans_image_invPolarTransImageInvPolarTransImageInvPolarTransImageInvpolar_trans_image_inv,
polar_trans_regionpolar_trans_regionPolarTransRegionPolarTransRegionPolarTransRegionpolar_trans_region,
polar_trans_region_invpolar_trans_region_invPolarTransRegionInvPolarTransRegionInvPolarTransRegionInvpolar_trans_region_inv,
polar_trans_contour_xldpolar_trans_contour_xldPolarTransContourXldPolarTransContourXldPolarTransContourXldpolar_trans_contour_xld
Module
Foundation