line_orientation ( : : RowBegin, ColBegin, RowEnd, ColEnd : Phi )

Calculate the orientation of lines.

The operator line_orientation returns the orientation (-pi/2 < Phi <= pi/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) -> real / integer
Row coordinates of the starting points of the input lines.

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

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

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

Phi (output_control)
angle.rad(-array) -> real
Orientation of the input lines.


Result

line_orientation always returns the value 2 (H_MSG_TRUE).


Parallelization Information

line_orientation is reentrant and processed without parallelization.


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-2005 MVTec Software GmbH