HALCON Reference Manual 10.0.2
Table of Contents / XLD / Creation ClassesClassesClasses | | | Operators

gen_circle_contour_xldgen_circle_contour_xldgen_circle_contour_xldGenCircleContourXldGenCircleContourXld (Operator)

Name

gen_circle_contour_xldgen_circle_contour_xldgen_circle_contour_xldGenCircleContourXldGenCircleContourXld — Create XLD contours corresponding to circles or circular arcs.

Signature

gen_circle_contour_xld( : ContCircle : Row, Column, Radius, StartPhi, EndPhi, PointOrder, Resolution : )

Herror gen_circle_contour_xld(Hobject* ContCircle, double Row, double Column, double Radius, double StartPhi, double EndPhi, const char* PointOrder, double Resolution)

Herror T_gen_circle_contour_xld(Hobject* ContCircle, const Htuple Row, const Htuple Column, const Htuple Radius, const Htuple StartPhi, const Htuple EndPhi, const Htuple PointOrder, const Htuple Resolution)

Herror gen_circle_contour_xld(Hobject* ContCircle, const HTuple& Row, const HTuple& Column, const HTuple& Radius, const HTuple& StartPhi, const HTuple& EndPhi, const HTuple& PointOrder, const HTuple& Resolution)

HXLDCont HXLDCont::GenCircleContourXld(const HTuple& Row, const HTuple& Column, const HTuple& Radius, const HTuple& StartPhi, const HTuple& EndPhi, const HTuple& PointOrder, const HTuple& Resolution)

HXLDContArray HXLDContArray::GenCircleContourXld(const HTuple& Row, const HTuple& Column, const HTuple& Radius, const HTuple& StartPhi, const HTuple& EndPhi, const HTuple& PointOrder, const HTuple& Resolution)

void HOperatorSetX.GenCircleContourXld(
[out] IHUntypedObjectX** ContCircle, [in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Radius, [in] VARIANT StartPhi, [in] VARIANT EndPhi, [in] VARIANT PointOrder, [in] VARIANT Resolution)

void HXLDContX.GenCircleContourXld(
[in] VARIANT Row, [in] VARIANT Column, [in] VARIANT Radius, [in] VARIANT StartPhi, [in] VARIANT EndPhi, [in] VARIANT PointOrder, [in] double Resolution)

static void HOperatorSet.GenCircleContourXld(out HObject contCircle, HTuple row, HTuple column, HTuple radius, HTuple startPhi, HTuple endPhi, HTuple pointOrder, HTuple resolution)

void HXLDCont.GenCircleContourXld(HTuple row, HTuple column, HTuple radius, HTuple startPhi, HTuple endPhi, HTuple pointOrder, double resolution)

void HXLDCont.GenCircleContourXld(double row, double column, double radius, double startPhi, double endPhi, string pointOrder, double resolution)

Description

gen_circle_contour_xldgen_circle_contour_xldgen_circle_contour_xldGenCircleContourXldGenCircleContourXld creates one or more circular arcs or closed circles. Circles are specified by their center (RowRowRowRowrow, ColumnColumnColumnColumncolumn) and their RadiusRadiusRadiusRadiusradius. In addition to that, circular arcs are characterized by the angle of the start point StartPhiStartPhiStartPhiStartPhistartPhi, the angle of the end point EndPhiEndPhiEndPhiEndPhiendPhi, and the PointOrderPointOrderPointOrderPointOrderpointOrder along the boundary. The resolution of the resulting contours ContCircleContCircleContCircleContCirclecontCircle is controlled via ResolutionResolutionResolutionResolutionresolution containing the Euclidean distance in pixel between neighboring contour points. In general, the distance between the second to last and the last point is smaller than ResolutionResolutionResolutionResolutionresolution.

Parallelization

Parameters

ContCircleContCircleContCircleContCirclecontCircle (output_object)  xld_cont(-array) → objectHXLDContHXLDContHXLDContXHobject *

Resulting contours.

RowRowRowRowrow (input_control)  circle.center.y(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Row coordinate of the center of the circles or circular arcs.

Default value: 200.0

ColumnColumnColumnColumncolumn (input_control)  circle.center.x(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Column coordinate of the center of the circles or circular arcs.

Default value: 200.0

RadiusRadiusRadiusRadiusradius (input_control)  circle.radius(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Radius of the circles or circular arcs.

Default value: 100.0

Restriction: Radius > 0

StartPhiStartPhiStartPhiStartPhistartPhi (input_control)  real(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Angle of the start points of the circles or circular arcs [rad].

Default value: 0.0

EndPhiEndPhiEndPhiEndPhiendPhi (input_control)  real(-array) → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Angle of the end points of the circles or circular arcs [rad].

Default value: 6.28318

PointOrderPointOrderPointOrderPointOrderpointOrder (input_control)  string(-array) → HTupleHTupleVARIANTHtuple (string) (string) (char*) (BSTR) (char*)

Point order along the circles or circular arcs.

Default value: 'positive' "positive" "positive" "positive" "positive"

List of values: 'positive'"positive""positive""positive""positive", 'negative'"negative""negative""negative""negative"

ResolutionResolutionResolutionResolutionresolution (input_control)  real → HTupleHTupleVARIANTHtuple (real) (double) (double) (double) (double)

Distance between neighboring contour points.

Default value: 1.0

Restriction: Resolution >= 0.00001

Example (HDevelop)

draw_circle (WindowHandle, Row, Column, Radius)
gen_circle_contour_xld (ContCircle, Row, Column, Radius, 0, \
                        rad(360) , 'positive', 1.0)
gen_region_contour_xld (ContCircle, Region, 'filled')

Result

gen_circle_contour_xldgen_circle_contour_xldgen_circle_contour_xldGenCircleContourXldGenCircleContourXld returns 2 (H_MSG_TRUE) if all parameter values are correct. If necessary, an exception is raised.

Possible Predecessors

draw_circledraw_circledraw_circleDrawCircleDrawCircle

Possible Successors

disp_xlddisp_xlddisp_xldDispXldDispXld

Alternatives

gen_ellipse_contour_xldgen_ellipse_contour_xldgen_ellipse_contour_xldGenEllipseContourXldGenEllipseContourXld

Module

Foundation

Table of Contents / XLD / Creation ClassesClassesClasses | | | Operators
HALCON Reference Manual 10.0.2 Copyright © 1996-2011 MVTec Software GmbH