Herror ::line_orientation (
    const HTuple &RowBegin,
    const HTuple &ColBegin,
    const HTuple &RowEnd,
    const HTuple &ColEnd,
    double *Phi
)
Herror ::line_orientation (
    const HTuple &RowBegin,
    const HTuple &ColBegin,
    const HTuple &RowEnd,
    const HTuple &ColEnd,
    HTuple *Phi
)

Calculate the orientation of lines.

The operator ::line_orientation returns the orientation (-2 < Phi 2) of the given lines. If more than one line is to be treated the line and column indices can be passed as tuples. In this case Phi is, of course, also a tuple and contains the corresponding orientations.

The procedure is typically applied to model lines in order to select parallel image lines, which were found, e.g., by ::detect_edge_segments, via the operator ::select_lines.


Parameters

RowBegin (input_control)
line.begin.y(-array) -> HTuple.double / long
Row coordinates of the starting points of the input lines.

ColBegin (input_control)
line.begin.x(-array) -> HTuple.double / long
Column coordinates of the starting points of the input lines.

RowEnd (input_control)
line.end.y(-array) -> HTuple.double / long
Row coordinates of the ending points of the input lines.

ColEnd (input_control)
line.end.x(-array) -> HTuple.double / long
Column coordinates of the ending points of the input lines.

Phi (output_control)
angle.rad(-array) -> (HTuple.) double *
Orientation of the input lines.


Result

::line_orientation always returns the value H_MSG_TRUE.


Possible Predecessors

::sobel_amp, ::edges_image, ::threshold, ::hysteresis_threshold, ::split_skeleton_region, ::split_skeleton_lines


Possible Successors

::set_line_width, ::disp_line


Alternatives

::line_position, ::select_lines, ::partition_lines


See also

::line_position, ::select_lines, ::partition_lines, ::detect_edge_segments


Module

Region processing



Copyright © 1996-2002 MVTec Software GmbH