angle_llangle_llAngleLlAngleLlangle_ll (Operator)

Name

angle_llangle_llAngleLlAngleLlangle_ll — Calculate the angle between two lines.

Signature

angle_ll( : : RowA1, ColumnA1, RowA2, ColumnA2, RowB1, ColumnB1, RowB2, ColumnB2 : Angle)

Description

The operator angle_llangle_llAngleLlAngleLlangle_ll calculates the angle between two lines. As input the coordinates of two points on the first line (RowA1RowA1RowA1rowA1row_a1,ColumnA1ColumnA1ColumnA1columnA1column_a1, RowA2RowA2RowA2rowA2row_a2,ColumnA2ColumnA2ColumnA2columnA2column_a2) and on the second line (RowB1RowB1RowB1rowB1row_b1,ColumnB1ColumnB1ColumnB1columnB1column_b1, RowB2RowB2RowB2rowB2row_b2,ColumnB2ColumnB2ColumnB2columnB2column_b2) are expected. The calculation is performed as follows: We interpret the lines as vectors with starting points RowA1RowA1RowA1rowA1row_a1,ColumnA1ColumnA1ColumnA1columnA1column_a1 and RowB1RowB1RowB1rowB1row_b1,ColumnB1ColumnB1ColumnB1columnB1column_b1 and end points RowA2RowA2RowA2rowA2row_a2,ColumnA2ColumnA2ColumnA2columnA2column_a2 and RowB2RowB2RowB2rowB2row_b2,ColumnB2ColumnB2ColumnB2columnB2column_b2, respectively. Rotating the vector A counter clockwise onto the vector B (the center of rotation is the intersection point of the two lines) yields the angle. The result depends on the order of the points and on the order of the lines. The parameter AngleAngleAngleangleangle returns the angle in radians, ranging from -pi <= AngleAngleAngleangleangle <= pi.

Parameter Broadcasting

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

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

RowA1RowA1RowA1rowA1row_a1 (input_control) point.y(-array) → (real / integer)

Row coordinate of the first point of the first line.

ColumnA1ColumnA1ColumnA1columnA1column_a1 (input_control) point.x(-array) → (real / integer)

Column coordinate of the first point of the first line.

RowA2RowA2RowA2rowA2row_a2 (input_control) point.y(-array) → (real / integer)

Row coordinate of the second point of the first line.

ColumnA2ColumnA2ColumnA2columnA2column_a2 (input_control) point.x(-array) → (real / integer)

Column coordinate of the second point of the first line.

RowB1RowB1RowB1rowB1row_b1 (input_control) point.y(-array) → (real / integer)

Row coordinate of the first point of the second line.

ColumnB1ColumnB1ColumnB1columnB1column_b1 (input_control) point.x(-array) → (real / integer)

Column coordinate of the first point of the second line.

RowB2RowB2RowB2rowB2row_b2 (input_control) point.y(-array) → (real / integer)

Row coordinate of the second point of the second line.

ColumnB2ColumnB2ColumnB2columnB2column_b2 (input_control) point.x(-array) → (real / integer)

Column coordinate of the second point of the second line.

AngleAngleAngleangleangle (output_control) angle.rad(-array) → (real)

Angle between the lines [rad].

Example (HDevelop)

dev_open_window (0, 0, 512, 512, 'black', WindowHandle)
RowA1 := 255
ColumnA1 := 10
RowA2 := 255
ColumnA2 := 501
gen_contour_polygon_xld (Contour, [RowA1,RowA2], [ColumnA1,ColumnA2])
RowB1 := 255
ColumnB1 := 255
for I := 5 to 360 by 5
  RowB2 := 255 - sin(rad(I)) * 200
  ColumnB2 := 255 + cos(rad(I)) * 200
  gen_contour_polygon_xld (Contour, [RowB1,RowB2], [ColumnB1,ColumnB2])
  angle_ll (RowA1, ColumnA1, RowA2, ColumnA2,\
            RowB1, ColumnB1, RowB2, ColumnB2, Angle)
  AngleDeg := deg(Angle)
endfor

Result

angle_llangle_llAngleLlAngleLlangle_ll returns 2 ( H_MSG_TRUE) .

Alternatives

angle_lxangle_lxAngleLxAngleLxangle_lx

Module

Foundation

Operators