distance_pldistance_plDistancePlDistancePl (Operator)
Name
distance_pldistance_plDistancePlDistancePl — Calculate the distance between one point and one line.
Signature
Herror distance_pl(double Row, double Column, double Row1, double Column1, double Row2, double Column2, double* Distance)
Herror T_distance_pl(const Htuple Row, const Htuple Column, const Htuple Row1, const Htuple Column1, const Htuple Row2, const Htuple Column2, Htuple* Distance)
void DistancePl(const HTuple& Row, const HTuple& Column, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2, HTuple* Distance)
static HTuple HMisc::DistancePl(const HTuple& Row, const HTuple& Column, const HTuple& Row1, const HTuple& Column1, const HTuple& Row2, const HTuple& Column2)
static double HMisc::DistancePl(double Row, double Column, double Row1, double Column1, double Row2, double Column2)
static void HOperatorSet.DistancePl(HTuple row, HTuple column, HTuple row1, HTuple column1, HTuple row2, HTuple column2, out HTuple distance)
static HTuple HMisc.DistancePl(HTuple row, HTuple column, HTuple row1, HTuple column1, HTuple row2, HTuple column2)
static double HMisc.DistancePl(double row, double column, double row1, double column1, double row2, double column2)
Description
The operator distance_pldistance_plDistancePlDistancePlDistancePl calculates the orthogonal distance
between points (RowRowRowRowrow,ColumnColumnColumnColumncolumn) and lines,
given by two arbitrary points on the line.
The result is passed in DistanceDistanceDistanceDistancedistance.
distance_pldistance_plDistancePlDistancePlDistancePl calculates the distances between a set of n points
and one line as well as the distances between a set of n points and n
lines.
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
RowRowRowRowrow (input_control) point.y(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Row coordinate of the point.
ColumnColumnColumnColumncolumn (input_control) point.x(-array) → HTupleHTupleHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong)
Column of the point.
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.
DistanceDistanceDistanceDistancedistance (output_control) real(-array) → HTupleHTupleHtuple (real) (double) (double) (double)
Distance between the points.
Example (HDevelop)
dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
draw_point (WindowHandle, Row, Column)
gen_cross_contour_xld (Cross, Row, Column, 15, 0)
draw_line (WindowHandle, Row1, Column1, Row2, Column2)
gen_contour_polygon_xld (Contour, [Row1,Row2], [Column1,Column2])
distance_pl (Row, Column, Row1, Column1, Row2, Column2, Distance)
Example (C)
double row,column,row1,column1,row2,column2,distance;
draw_point(WindowHandle,&row,&column);
draw_line(WindowHandle,&row1,&column1,&row2,&column2);
distance_pl(row,column,row1,column1,row2,column2,&distance);
Example (HDevelop)
dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
draw_point (WindowHandle, Row, Column)
gen_cross_contour_xld (Cross, Row, Column, 15, 0)
draw_line (WindowHandle, Row1, Column1, Row2, Column2)
gen_contour_polygon_xld (Contour, [Row1,Row2], [Column1,Column2])
distance_pl (Row, Column, Row1, Column1, Row2, Column2, Distance)
Example (HDevelop)
dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
draw_point (WindowHandle, Row, Column)
gen_cross_contour_xld (Cross, Row, Column, 15, 0)
draw_line (WindowHandle, Row1, Column1, Row2, Column2)
gen_contour_polygon_xld (Contour, [Row1,Row2], [Column1,Column2])
distance_pl (Row, Column, Row1, Column1, Row2, Column2, Distance)
Example (HDevelop)
dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
draw_point (WindowHandle, Row, Column)
gen_cross_contour_xld (Cross, Row, Column, 15, 0)
draw_line (WindowHandle, Row1, Column1, Row2, Column2)
gen_contour_polygon_xld (Contour, [Row1,Row2], [Column1,Column2])
distance_pl (Row, Column, Row1, Column1, Row2, Column2, Distance)
Result
distance_pldistance_plDistancePlDistancePlDistancePl returns 2 (H_MSG_TRUE).
Alternatives
distance_psdistance_psDistancePsDistancePsDistancePs
See also
distance_ppdistance_ppDistancePpDistancePpDistancePp,
distance_prdistance_prDistancePrDistancePrDistancePr
Module
Foundation