dropPointOnLine()

Zusammenfassung

Gibt den Punkt auf der durch startPoint und endPoint definierten Linie zurück, der am nächsten zu einem anderen Punkt p liegt.

Syntax

dropPointOnLine ( p As Point, _
                  startPoint As Point, _
                  endPoint As Point, _
                  Optional useSegment? As Boolean = False ) As Point 
Argument Typ Beschreibung
p Point Der abzulegende Punkt.
startPoint Point Der Anfangspunkt der Linie.
endPoint Point Der Endpunkt der Linie.
useSegment? Boolean Optional. Wenn True, wird der Punkt auf dem durch startPoint und endPoint definierten Liniensegment abgelegt, selbst wenn sich der Ergebnispunkt außerhalb dieses Liniensegments befindet. Vorgabe ist False.

Beispiel 1

Intent >dropPointOnLine(point(1,1,1), point(2,0,0), point(3,0,0)) 
--> Point_(1.0, 0.0, 0.0, WorldFrame()) 
Dieses Beispiel zeigt einen Punkt an Position 1,1,1, der auf einer an der x-Achse ausgerichteten Linie abgelegt wird.

Beispiel 2

Intent >dropPointOnLine(point(1,1,1), point(2,0,0), point(3,0,0), useSegment? := True) 
--> Point_(2.0, 0.0, 0.0, WorldFrame()) 
In diesem Beispiel wird der Punkt von Position 1,1,1 auf demselben Liniensegment wie im vorherigen Beispiel abgelegt. Da useSegment? True ist, und sich der Ablagepunkt außerhalb des Liniensegments befindet, wird der Punkt am nächstliegenden Segmentende abgelegt.