gen_region_hlinegen_region_hlineGenRegionHlineGenRegionHline (Operator)


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


gen_region_hline( : Regions : Orientation, Distance : )

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

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

void GenRegionHline(HObject* Regions, const HTuple& Orientation, const HTuple& Distance)

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

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

static void HOperatorSet.GenRegionHline(out HObject regions, HTuple orientation, HTuple distance)

void HRegion.GenRegionHline(HTuple orientation, HTuple distance)

void HRegion.GenRegionHline(double orientation, double distance)


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


The lines are clipped to the current maximum image format.

Execution Information


RegionsRegionsRegionsRegionsregions (output_object)  region(-array) objectHRegionHRegionHobject *

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

Number of elements: Regions == Distance

OrientationOrientationOrientationOrientationorientation (input_control)  hesseline.angle.rad(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

Orientation of the normal vector in radians.

Number of elements: Orientation == Distance

Default value: 0.0

Suggested values: -0.78, 0.0, 0.78, 1.57

Typical range of values: Orientation Orientation Orientation Orientation orientation (lin)

Recommended increment: 0.02

DistanceDistanceDistanceDistancedistance (input_control)  hesseline.distance(-array) HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)

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: Distance Distance Distance Distance distance (lin)

Recommended increment: 1


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



See also