Skip to content

gen_region_hlinegen_region_hlineGenRegionHlineGenRegionHlinegen_region_hlinegen_region_hline🔗

Short description🔗

gen_region_hlinegen_region_hlineGenRegionHlineGenRegionHlinegen_region_hlinegen_region_hline — Store input lines described in Hesse normal form as regions.

Signature🔗

gen_region_hline( out region Regions, hesseline.angle.rad Orientation, hesseline.distance Distance )gen_region_hline( : Regions : Orientation, Distance : )void GenRegionHline( HObject* Regions, const HTuple& Orientation, const HTuple& Distance )static void HOperatorSet.GenRegionHline( out HObject regions, HTuple orientation, HTuple distance )def gen_region_hline( orientation: MaybeSequence[Union[int, float]], distance: MaybeSequence[Union[int, float]] ) -> HObject

Herror gen_region_hline( Hobject* Regions, double Orientation, double Distance )

Herror T_gen_region_hline( Hobject* Regions, const Htuple Orientation, const Htuple Distance )

void HRegion::GenRegionHline( const HTuple& Orientation, const HTuple& Distance )

void HRegion::GenRegionHline( double Orientation, double Distance )

void HRegion.GenRegionHline( HTuple orientation, HTuple distance )

void HRegion.GenRegionHline( double orientation, double distance )

Description🔗

The operator gen_region_hlineGenRegionHline stores the lines described in Hesse normal form as regions. A line is determined by the distance from the line to the origin (Distancedistancedistance, corresponds to the length of the normal vector) and the direction of the normal vector (Orientationorientationorientation, corresponds to the orientation of the line \(\pm \pi/2\)). The directions were defined in such a way that at Orientationorientationorientation = 0 the normal vector lies in the direction of the X axis, which corresponds to a vertical line. At Orientationorientationorientation = \(\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 global image size.

Execution information🔗

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

Parameters🔗

Regionsregionsregions (output_object) region(-array) → objectobjectHObjectHRegionHObjectHobject *

Created regions (one for every line), clipped to maximum image format.

Number of elements: Regions == Distance

Orientationorientationorientation (input_control) hesseline.angle.rad(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[int, float]]Htuple (double / Hlong)

Orientation of the normal vector in radians.

Number of elements: Orientation == Distance
Default: 0.00.0
Suggested values: -0.78, 0.0, 0.78, 1.57-0.78, 0.0, 0.78, 1.57
Value range: Orientation (lin)
Recommended increment: 0.02

Distancedistancedistance (input_control) hesseline.distance(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[int, float]]Htuple (double / Hlong)

Distance from the line to the coordinate origin (0.0).

Default: 200200
Suggested values: 10, 50, 100, 200, 300, 40010, 50, 100, 200, 300, 400
Value range: Distance (lin)
Recommended increment: 1

Result🔗

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

Combinations with other operators🔗

Combinations

Alternatives

gen_region_lineGenRegionLine

See also

hough_linesHoughLines

Module🔗

Foundation