HALCON 17.12 / HALCON Operator Reference / Tools / Geometry
ClassesClasses | | Operators

intersection_line_circleintersection_line_circleIntersectionLineCircleIntersectionLineCircle (Operator)

Name

intersection_line_circleintersection_line_circleIntersectionLineCircleIntersectionLineCircle — Calculate the intersection points of a line and a circle or circular arc

Signature

intersection_line_circle( : : LineRow1, LineColumn1, LineRow2, LineColumn2, CircleRow, CircleColumn, CircleRadius, CircleStartPhi, CircleEndPhi, CirclePointOrder : Row, Column)

Herror intersection_line_circle(double LineRow1, double LineColumn1, double LineRow2, double LineColumn2, double CircleRow, double CircleColumn, double CircleRadius, double CircleStartPhi, double CircleEndPhi, const char* CirclePointOrder, double* Row, double* Column)

Herror T_intersection_line_circle(const Htuple LineRow1, const Htuple LineColumn1, const Htuple LineRow2, const Htuple LineColumn2, const Htuple CircleRow, const Htuple CircleColumn, const Htuple CircleRadius, const Htuple CircleStartPhi, const Htuple CircleEndPhi, const Htuple CirclePointOrder, Htuple* Row, Htuple* Column)

void IntersectionLineCircle(const HTuple& LineRow1, const HTuple& LineColumn1, const HTuple& LineRow2, const HTuple& LineColumn2, const HTuple& CircleRow, const HTuple& CircleColumn, const HTuple& CircleRadius, const HTuple& CircleStartPhi, const HTuple& CircleEndPhi, const HTuple& CirclePointOrder, HTuple* Row, HTuple* Column)

static void HOperatorSet.IntersectionLineCircle(HTuple lineRow1, HTuple lineColumn1, HTuple lineRow2, HTuple lineColumn2, HTuple circleRow, HTuple circleColumn, HTuple circleRadius, HTuple circleStartPhi, HTuple circleEndPhi, HTuple circlePointOrder, out HTuple row, out HTuple column)

Description

intersection_line_circleintersection_line_circleIntersectionLineCircleIntersectionLineCircleIntersectionLineCircle calculates the intersection points of a line and a circle or circular arc. The line is defined by the points (LineRow1LineRow1LineRow1LineRow1lineRow1,LineColumn1LineColumn1LineColumn1LineColumn1lineColumn1) and (LineRow2LineRow2LineRow2LineRow2lineRow2,LineColumn2LineColumn2LineColumn2LineColumn2lineColumn2). The circle is defined by its center (CircleRowCircleRowCircleRowCircleRowcircleRow,CircleColumnCircleColumnCircleColumnCircleColumncircleColumn) and its radius CircleRadiusCircleRadiusCircleRadiusCircleRadiuscircleRadius. In addition to that, a circular arc is characterized by the angle of the start point CircleStartPhiCircleStartPhiCircleStartPhiCircleStartPhicircleStartPhi, the angle of the end point CircleEndPhiCircleEndPhiCircleEndPhiCircleEndPhicircleEndPhi, and the point order CirclePointOrderCirclePointOrderCirclePointOrderCirclePointOrdercirclePointOrder along the boundary. If CirclePointOrderCirclePointOrderCirclePointOrderCirclePointOrdercirclePointOrder is set to 'positive'"positive""positive""positive""positive", the circular arc is defined counterclockwise. If CirclePointOrderCirclePointOrderCirclePointOrderCirclePointOrdercirclePointOrder is set to 'negative'"negative""negative""negative""negative", the circular arc is defined clockwise. The intersection points, if any, are returned in (RowRowRowRowrow,ColumnColumnColumnColumncolumn).

Execution Information

Parameters

LineRow1LineRow1LineRow1LineRow1lineRow1 (input_control)  point.y → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Row coordinate of the first point of the line.

LineColumn1LineColumn1LineColumn1LineColumn1lineColumn1 (input_control)  point.x → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column coordinate of the first point of the line.

LineRow2LineRow2LineRow2LineRow2lineRow2 (input_control)  point.y → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Row coordinate of the second point of the line.

LineColumn2LineColumn2LineColumn2LineColumn2lineColumn2 (input_control)  point.x → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column coordinate of the second point of the line.

CircleRowCircleRowCircleRowCircleRowcircleRow (input_control)  circle.center.y → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Row coordinate of the center of the circle or circular arc.

CircleColumnCircleColumnCircleColumnCircleColumncircleColumn (input_control)  circle.center.x → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Column coordinate of the center of the circle or circular arc.

CircleRadiusCircleRadiusCircleRadiusCircleRadiuscircleRadius (input_control)  circle.radius → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Radius of the circle or circular arc.

CircleStartPhiCircleStartPhiCircleStartPhiCircleStartPhicircleStartPhi (input_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

Angle of the start point of the circle or circular arc [rad].

Default value: 0.0

CircleEndPhiCircleEndPhiCircleEndPhiCircleEndPhicircleEndPhi (input_control)  real → HTupleHTupleHtuple (real) (double) (double) (double)

Angle of the end point of the circle or circular arc [rad].

Default value: 6.28318

CirclePointOrderCirclePointOrderCirclePointOrderCirclePointOrdercirclePointOrder (input_control)  string → HTupleHTupleHtuple (string) (string) (HString) (char*)

Point order along the circle or circular arc.

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

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

RowRowRowRowrow (output_control)  point.y(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Row coordinates of the intersection points.

ColumnColumnColumnColumncolumn (output_control)  point.x(-array) → HTupleHTupleHtuple (real) (double) (double) (double)

Column coordinates of the intersection points.

Result

If the parameters are valid, the operator intersection_line_circleintersection_line_circleIntersectionLineCircleIntersectionLineCircleIntersectionLineCircle returns the value 2 (H_MSG_TRUE).

See also

intersection_segment_circleintersection_segment_circleIntersectionSegmentCircleIntersectionSegmentCircleIntersectionSegmentCircle, intersection_circle_contour_xldintersection_circle_contour_xldIntersectionCircleContourXldIntersectionCircleContourXldIntersectionCircleContourXld

Module

Foundation

ClassesClasses | | Operators
HALCON Operator Reference 17.12 Copyright © 1996-2017 MVTec Software GmbH