Package pi.graphics.geom

Class DirectedLineSegment

java.lang.Object
pi.graphics.geom.DirectedLineSegment
public class DirectedLineSegment extends Object
Eine gerichtete Strecke.

Diese Strecke ist definiert durch zwei Punkte: den Ursprung und das Ziel. Sie liegt auf einer Linie, die durch diese beiden Punkte festgelegt ist.

Since:
0.42.0
Author:
Josef Friedrich

  • Constructor Details

    • DirectedLineSegment

      public DirectedLineSegment(Vector from, Vector to)

  • Method Details

    • from

      @Getter public Vector from()
      Gibt den Ursprung (steht auch für die Zahl 0) zurück.
      Returns:
      Der Ursprung (steht auch für die Zahl 0).

    • from

      @Setter public DirectedLineSegment from(Vector from)
      Setzt den Ursprung (steht auch für die Zahl 0).
      Parameters:
      from - Der Ursprung (steht auch für die Zahl 0).
      Returns:
      Eine Referenz auf die eigene Instanz der gerichteten Strecke, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Strecke durch aneinander gekettete Setter festgelegt werden können, z. B. lineSegment.from(..).to(..).

    • to

      @Getter public Vector to()
      Gibt das Ziel (steht auch für die Zahl 1) zurück.
      Returns:
      Das Ziel (steht auch für die Zahl 1).

    • to

      @Setter public DirectedLineSegment to(Vector to)
      Setzt das Ziel (steht auch für die Zahl 1).
      Parameters:
      to - Das Ziel (steht auch für die Zahl 1).
      Returns:
      Eine Referenz auf die eigene Instanz der gerichteten Strecke, damit nach dem Erbauer/Builder-Entwurfsmuster die Eigenschaften der Strecke durch aneinander gekettete Setter festgelegt werden können, z. B. lineSegment.from(..).to(..).

    • difference

      public Vector difference()
      Gibt den Differenzvektor von Urspung zum Ziel zurück.
      Returns:
      Der Differenzvektor von Urspung zum Ziel.
      Since:
      0.42.0

    • proportionalPoint

      public Vector proportionalPoint(double factor)
      Berechnet einen Punkt auf der Linie, dessen Lage im Verhältnis zu den beiden Punkten der Strecke festgelegt ist.
      Parameters:
      factor - Bei dem Faktor 0 liegt der berechnete Punkt auf dem Ursprung, bei 1 auf dem Ziel.
      Returns:
      Ein Punkt auf der Linie, dessen Lage im Verhältnis zu den beiden Punkten der Strecke festgelegt ist.
      Since:
      0.42.0

    • distancePoint

      public Vector distancePoint(double distance)
      Berechnet einen Punkt auf der Linie, der sich in einer bestimmten Entfernung zum Ursprung befindet.

      Positive Entfernungen liegen in der Richtung des Ziels.

      Parameters:
      distance - Der Abstand vom Ursprung.
      Returns:
      Ein Punkt auf der Linie, der sich in einer bestimmten Entfernung vom Ursprung befindet.
      Since:
      0.42.0

    • distancePoint

      public Vector distancePoint(double distance, double deltaAngle)
      Berechnet einen Punkt auf einer Linie, die zur Strecke um einen Winkel gedreht ist.
      Parameters:
      distance - Der Abstand vom Ursprung. Positive Entfernungen liegen in der Richtung des Ziels.
      deltaAngle - Der Winkel, um den die Linie gedreht wird. Positive Werte drehen die Linien gegen den Uhrzeigersinn.
      Returns:
      Ein Punkt auf der Linie, der sich in einer bestimmten Entfernung vom Ursprung befindet.
      Since:
      0.42.0

    • angle

      @Getter public double angle()
      Gibt den Winkel dieser gerichteten Strecke zurück.

      Zeigt die gerichtete Strecke nach ...

      • rechts: 0 Grad
      • oben: 90 Grad
      • links: 180 Grad
      • unten: -90 Grad
      Returns:
      der Winkel dieser gerichteten Strecke in Grad.
      Since:
      0.42.0

    • length

      @Getter public double length()
      Gibt die Länge der Strecke zurück.
      Returns:
      Die Länge der Strecke.
      Since:
      0.42.0

    • negate

      public DirectedLineSegment negate()
      Gibt eine in die andere Richtung verlaufende Strecke zurück.
      Returns:
      Eine in die andere Richtung verlaufende Strecke.
      Since:
      0.42.0