gen_region_hline ( : Regions : Orientation, Distance : )

Store input lines described in Hesse normal shape as regions.

The operator gen_region_hline stores the lines described in Hesse normal shape as regions. A line is determined by the distance from the line to the origin (Distance, corresponds to the length of the normal vector) and the direction of the normal vector (Orientation, corresponds to the orientation of the line +/- pi/2). The directions were defined in such a way that at Orientation = 0 the normal vector lies in the direction of the X axis, which corresponds to a vertical line. At Orientation = pi/2 the normal vector points in the direction of the Y axis, i.e. a horizontal line is described.


Attention

The lines are clipped to the current maximum image format.


Parameters

Regions (output_object)
region(-array) -> object
Created regions (one for every line), clipped to maximum image format.
Number of elements: Regions == Distance

Orientation (input_control)
hesseline.angle.rad(-array) -> real / integer
Orientation of the normal vector in radians.
Default value: 0.0
Suggested values: -0.78, 0.0, 0.78, 1.57
Typical range of values: -oo <= Orientation <= -oo (lin)
Recommended increment: 0.02
Number of elements: Orientation == Distance

Distance (input_control)
hesseline.distance(-array) -> real / integer
Distance from the line to the coordinate origin (0.0).
Default value: 200
Suggested values: 10, 50, 100, 200, 300, 400
Typical range of values: -oo <= Distance <= -oo (lin)
Recommended increment: 1


Result

The operator gen_region_hline always returns the value 2 (H_MSG_TRUE).


Parallelization Information

gen_region_hline is reentrant and processed without parallelization.


Alternatives

gen_region_line


See also

hough_lines


Module

Region processing



Copyright © 1996-2005 MVTec Software GmbH