paweld/lazarus
1
0
Fork 0
mirror of https://gitlab.com/freepascal.org/lazarus/lazarus.git synced 2025-04-05 23:58:06 +02:00
Code Issues Packages Projects Releases Wiki Activity

Docs: LazUtils/graphmath. Adds missing content for the overloaded Distance function.

Browse Source 
(cherry picked from commit 9ac757f684)
This commit is contained in:
dsiders 2024-08-28 01:15:36 +01:00
parent a4a8978029
commit a41c051823
1 changed files with 54 additions and 7 deletions
Show Stats Download Patch File Download Diff File Expand all files Collapse all files

61
docs/xml/lazutils/graphmath.xml
View File

@ -501,20 +501,67 @@ Zero degrees is at the 3 o'clock position.
<element name="Distance">
<short>
Get the <var>Distance</var> between any two Points. It is primarily for use
in other routines such as EccentricAngle.
Gets the distance between two points, or the distance of a point from a
specified line.
</short>
<descr/>
<descr>
<p>
<var>Distance</var> is an overloaded function with variants that operate on
either two TPoint coordinates, or on a point (TFloatPoint) and a line defined
by two additional points (TFloatPoint) values. The Distance() function is used
primarily for internal purposes (such as in Bezier2PolyLine and EccentricAngle)
but can be used for any purpose.
</p>
<p>
The return value is an Extended type with the calculated distance between the
argument values.
</p>
<p>
The variant using TPoint arguments calculates the length of a straight line
between the coordinates in PT1 and PT2 using the Pythagorean theorem. The
distance between identical points is always zero (0). The distance is always a
positive value.
</p>
<p>
The variant with TFloatPoint arguments calculates the distance between the
point Pt and the line represented by the points in SP and EP using Euclidean
geometry. The distance is derived by finding the length of an imaginary line
between Pt and the closest point that intersects the slope of the line in SP
and EP. The distance is always a positive value. The distance for a point which
lies on the defined line is always zero (0).
</p>
</descr>
<seealso/>
</element>
<element name="Distance.Result">
<short/>
<short>
Straight-line distance between the specified coordinates or objects.
</short>
</element>
<element name="Distance.PT1">
<short/>
<short>
Starting point for the calculated distance.
</short>
</element>
<element name="Distance.Pt2">
<short/>
<element name="Distance.PT2">
<short>
Ending point for the calculated distance.
</short>
</element>
<element name="Distance.Pt">
<short>
Fixed point for the calculated distance.
</short>
</element>
<element name="Distance.SP">
<short>
Starting point for the line used in the distance calculation.
</short>
</element>
<element name="Distance.WP">
<short>
Ending point for the line used in the distance calculation.
</short>
</element>
<element name="EccentricAngle">