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	Punkt	Der abzulegende Punkt.
startPoint	Punkt	Der Anfangs punkt der Linie.
endPoint	Punkt	Der Endpunkt der Linie.
useSegment?	Boolesche Operation	Optional. Wenn True, wird der Punkt auf dem durch startPoint und endPoint definierten Liniensegment abgelegt, selbst wenn sich der Ergebnis punkt 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 Ablage punkt außerhalb des Liniensegments befindet, wird der Punkt am nächstliegenden Segmentende abgelegt.