distance_slDistanceSlDistanceSldistance_sldistance_sl🔗

Short description🔗

distance_slDistanceSlDistanceSldistance_sldistance_sl — Calculate the distances between a line segment and a line.

Signature🔗

distance_sl( point.y RowA1, point.x ColumnA1, point.y RowA2, point.x ColumnA2, point.y RowB1, point.x ColumnB1, point.y RowB2, point.x ColumnB2, out real DistanceMin, out real DistanceMax )

Description🔗

The operator distance_slDistanceSl calculates the minimum and maximum orthogonal distance between a line segment and a line. As input the coordinates of two points on the line segment (RowA1rowA1row_a1,ColumnA1columnA1column_a1,RowA2rowA2row_a2,ColumnA2columnA2column_a2) and on the line (RowB1rowB1row_b1,ColumnB1columnB1column_b1,RowB2rowB2row_b2,ColumnB2columnB2column_b2) are expected. The parameters DistanceMindistanceMindistance_min and DistanceMaxdistanceMaxdistance_max return the result of the calculation. If the line segments are intersecting, DistanceMindistanceMindistance_min returns zero.

Parameter Broadcasting🔗

This operator supports parameter broadcasting. This means that each parameter can be given as a tuple of length 1 or N. Parameters with tuple length 1 will be repeated internally such that the number of computed distances is always N.

Execution information🔗

Execution information

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Automatically parallelized on internal data level.

Parameters🔗

RowA1rowA1row_a1 (input_control) point.y(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Row coordinate of the first point of the line segment.

ColumnA1columnA1column_a1 (input_control) point.x(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Column coordinate of the first point of the line segment.

RowA2rowA2row_a2 (input_control) point.y(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Row coordinate of the second point of the line segment.

ColumnA2columnA2column_a2 (input_control) point.x(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Column coordinate of the second point of the line segment.

RowB1rowB1row_b1 (input_control) point.y(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Row coordinate of the first point of the line.

ColumnB1columnB1column_b1 (input_control) point.x(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Column coordinate of the first point of the line.

RowB2rowB2row_b2 (input_control) point.y(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Row coordinate of the second point of the line.

ColumnB2columnB2column_b2 (input_control) point.x(-array) → (real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)

Column coordinate of the second point of the line.

DistanceMindistanceMindistance_min (output_control) real(-array) → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Minimum distance between the line segment and the line.

DistanceMaxdistanceMaxdistance_max (output_control) real(-array) → (real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)

Maximum distance between the line segment and the line.

Example🔗

(HDevelop)


dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
Row1 := 300
Column1 := 200
Row2 := 100
Column2 := 400
gen_contour_polygon_xld (Line1, [Row1,Row2], [Column1,Column2])
dev_display (Line1)
Column := 50
Row := 100
Offset := 0
for RowEnd := 100 to 500 by 100
  gen_contour_polygon_xld (Line2, [Row,RowEnd], \
                           [Column+Offset,Column+Offset])
  dev_display (Line1)
  distance_sl (Row, Column+Offset, RowEnd, Column+Offset, Row1, Column1, \
               Row2, Column2,DistanceMin, DistanceMax)
  Offset := Offset+40
endfor

(C)

create_tuple(&RowA1, 1)\;
set_i(RowA1, 8, 0)\;
create_tuple(&ColumnA1, 1)\;
set_i(ColumnA1, 7, 0)\;
create_tuple(&RowA2, 1)\;
set_i(RowA2, 15, 0)\;
create_tuple(&ColumnA2, 1)\;
set_i(ColumnA2, 11, 0)\;
create_tuple(&RowB1, 1)\;
set_i(RowB1, 2, 0)\;
create_tuple(&ColumnB1, 1)\;
set_i(ColumnB1, 4, 0)\;
create_tuple(&RowB2, 1)\;
set_i(RowB2, 6, 0)\;
create_tuple(&ColumnB2, 1)\;
set_i(ColumnB2, 10, 0)\;
T_distance_sl(RowA1,ColumnA1,RowA2,ColumnA2,RowB1,ColumnB1,RowB2,ColumnB2,
              &distance_min,&distance_max)\;
aa_min = get_d(distance_min,0)\;
aa_max = get_d(distance_max,0)\;

Result🔗

distance_slDistanceSl returns 2 (H_MSG_TRUE).

Combinations with other operators🔗

Combinations

Alternatives

distance_plDistancePl

Module🔗

Foundation