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.