distance_lrdistance_lrDistanceLrDistanceLr (Operator)
Name
distance_lrdistance_lrDistanceLrDistanceLr — Calculate the distance between a line and a region.
Signature
Herror distance_lr(const Hobject Region, double Row1, double Column1, double Row2, double Column2, double* DistanceMin, double* DistanceMax)
Herror T_distance_lr(const Hobject Region, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2, Htuple* DistanceMin, Htuple* DistanceMax)
void DistanceLr(const HObject& Region, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, HTuple* DistanceMin, HTuple* DistanceMax)
void HRegion::DistanceLr(const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, HTuple* DistanceMin, HTuple* DistanceMax) const
void HRegion::DistanceLr(double Row1, double Column1, double Row2, double Column2, double* DistanceMin, double* DistanceMax) const
static void HOperatorSet.DistanceLr(HObject region, HTuple row1, HTuple column1, HTuple row2, HTuple column2, out HTuple distanceMin, out HTuple distanceMax)
void HRegion.DistanceLr(HTuple row1, HTuple column1, HTuple row2, HTuple column2, out HTuple distanceMin, out HTuple distanceMax)
void HRegion.DistanceLr(double row1, double column1, double row2, double column2, out double distanceMin, out double distanceMax)
Description
The operator distance_lrdistance_lrDistanceLrDistanceLrDistanceLr calculates the orthogonal
distance between a line and one region.
As input the coordinates of two points on a line
(Row1Row1Row1Row1row1,Column1Column1Column1Column1column1,
Row2Row2Row2Row2row2,Column2Column2Column2Column2column2) and one region are expected.
The parameters DistanceMinDistanceMinDistanceMinDistanceMindistanceMin and DistanceMaxDistanceMaxDistanceMaxDistanceMaxdistanceMax
return the result of the calculation.
Attention
Due to efficiency of distance_lrdistance_lrDistanceLrDistanceLrDistanceLr
holes are ignored.
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
RegionRegionRegionRegionregion (input_object) region → objectHRegionHRegionHobject
Input region.
Row1Row1Row1Row1row1 (input_control) point.y(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Row coordinate of the first point of the line.
Column1Column1Column1Column1column1 (input_control) point.x(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Column coordinate of the first point of the line.
Row2Row2Row2Row2row2 (input_control) point.y(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Row coordinate of the second point of the line.
Column2Column2Column2Column2column2 (input_control) point.x(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Column coordinate of the second point of the line.
DistanceMinDistanceMinDistanceMinDistanceMindistanceMin (output_control) real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)
Minimum distance between the line and the region
DistanceMaxDistanceMaxDistanceMaxDistanceMaxdistanceMax (output_control) real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)
Maximum distance between the line and the region
Example (HDevelop)
gen_circle (Circle, 200, 200, 100.5)
Column1 := 300
Column2 := 400
for Row := 50 to 350 by 50
gen_contour_polygon_xld (Line, [Row,Row], [Column1,Column2])
distance_lr (Circle, Row, Column1, Row, Column2, DistanceMin, DistanceMax)
endfor
Result
distance_lrdistance_lrDistanceLrDistanceLrDistanceLr returns 2 (H_MSG_TRUE).
Alternatives
distance_lcdistance_lcDistanceLcDistanceLcDistanceLc,
distance_prdistance_prDistancePrDistancePrDistancePr,
distance_srdistance_srDistanceSrDistanceSrDistanceSr,
diameter_regiondiameter_regionDiameterRegionDiameterRegionDiameterRegion
See also
hamming_distancehamming_distanceHammingDistanceHammingDistanceHammingDistance,
select_region_pointselect_region_pointSelectRegionPointSelectRegionPointSelectRegionPoint,
test_region_pointtest_region_pointTestRegionPointTestRegionPointTestRegionPoint,
smallest_rectangle2smallest_rectangle2SmallestRectangle2SmallestRectangle2SmallestRectangle2
Module
Foundation