Package de.gurkenlabs.litiengine.util.geom

Class GeometricUtilities

java.lang.Object
de.gurkenlabs.litiengine.util.geom.GeometricUtilities
public class GeometricUtilities extends Object

  • Method Details

    • calcRotationAngleInDegrees

      public static double calcRotationAngleInDegrees(double centerX, double centerY, double targetX, double targetY)

    • calcRotationAngleInDegrees

      public static double calcRotationAngleInDegrees(Point2D centerPt, Point2D targetPt)
      Calculates the angle from centerPt to targetPt in degrees. The return should range from [0,360), rotating CLOCKWISE, 0 and 360 degrees represents NORTH, 90 degrees represents EAST, etc...

      Assumes all points are in the same coordinate space. If they are not, you will need to call SwingUtilities.convertPointToScreen or equivalent on all arguments before passing them to this function.

      Parameters:
      centerPt - Point we are rotating around.
      targetPt - Point we want to calcuate the angle to.
      Returns:
      angle in degrees. This is the angle from centerPt to targetPt.

    • contains

      public static boolean contains(Rectangle2D rectangle, Point2D p)
      Contains.
      Parameters:
      rectangle - the rectangle
      p - the p
      Returns:
      true, if successful

    • distance

      public static double distance(double p1X, double p1Y, double p2X, double p2Y)

    • distance

      public static double distance(Point2D p1, Point2D p2)

    • distance

      public static double distance(Rectangle2D rect, Point2D p)
      Distance.
      Parameters:
      rect - the rect
      p - the p
      Returns:
      the double

    • extrude

      public static Rectangle2D extrude(Rectangle2D rect, double ext)

    • equals

      public static boolean equals(Point2D point1, Point2D point2, double epsilon)

    • getConnectingLines

      public static Line2D[] getConnectingLines(Point2D point, Point2D[] rectPoints)

    • getConstrainingLines

      public static List<Line2D.Double> getConstrainingLines(Area area)

    • getDeltaX

      public static float getDeltaX(double angle)

    • getDeltaY

      public static float getDeltaY(double angle)

    • getDeltaX

      public static double getDeltaX(double angle, double delta)

    • getDeltaY

      public static double getDeltaY(double angle, double delta)

    • getIntersectionPoint

      public static Point2D getIntersectionPoint(Line2D lineA, Line2D lineB)
      Gets the intersection point.
      Parameters:
      lineA - the line a
      lineB - the line b
      Returns:
      the intersection point

    • getIntersectionPoint

      public static Point2D getIntersectionPoint(Line2D line, Rectangle2D rectangle)
      Intersects.
      Parameters:
      line - the line
      rectangle - the rectangle
      Returns:
      the point2 d

    • getIntersectionPoints

      public static List<Point2D> getIntersectionPoints(Line2D line, Rectangle2D rectangle)
      Gets the intersection points.
      Parameters:
      line - the line
      rectangle - the rectangle
      Returns:
      the intersection points

    • getLines

      public static Line2D[] getLines(Rectangle2D rectangle)
      Gets the lines.
      Parameters:
      rectangle - the rectangle
      Returns:
      the lines

    • getDiagonal

      public static double getDiagonal(Rectangle2D rect)

    • getCenter

      public static Point2D getCenter(Line2D line)

    • getCenter

      public static Point2D getCenter(Point2D p1, Point2D p2)

    • getCenter

      public static Point2D getCenter(double x1, double y1, double x2, double y2)

    • getCenter

      public static Point2D getCenter(RectangularShape shape)
      Returns the center of a shape whose geometry is defined by a rectangular frame.

      Works for any subclass of RectuangularShape, including:

      Arc2D
      Ellipse2D
      Rectangle2D
      RoundRectangle2D

      Parameters:
      shape - the shape to retrieve the center of
      Returns:
      a Point2D representing the center of the shape
      See Also:

    • getCircle

      public static Ellipse2D getCircle(Point2D center, double radius)

    • getAverageLocation

      public static Point2D getAverageLocation(Collection<Point2D> points)

    • getAverageLocation

      public static Point2D getAverageLocation(Point2D... points)

    • getPerpendicularIntersection

      public static Point2D getPerpendicularIntersection(Point2D point, Line2D line)
      Gets the perpendicular intersection.
      Parameters:
      point - the point
      line - the line
      Returns:
      the perpendicular intersection

    • getPointOnCircle

      public static Point2D getPointOnCircle(Point2D center, double radius, double angle)

    • getPoints

      public static List<Point2D> getPoints(Path2D path)

    • getPoints

      public static List<Point2D> getPoints(Rectangle2D rectangle)
      Gets the points.
      Parameters:
      rectangle - the rectangle
      Returns:
      the points

    • getPointsBetweenPoints

      public static List<Point2D> getPointsBetweenPoints(Point2D point1, Point2D point2)
      Gets the points between the specified points using the Bresenham algorithm.
      Parameters:
      point1 - the point1
      point2 - the point2
      Returns:
      the points between points

    • intersects

      public static boolean intersects(Rectangle2D a, Rectangle2D b)

    • intersects

      public static boolean intersects(Ellipse2D a, Ellipse2D b)

    • project

      public static Point2D project(Point2D start, double angle, double delta)
      Project a line from a point with a given length and angle, return the point where the line ends.
      Parameters:
      start - The starting point of the projection.
      angle - The angle of the projection in degrees.
      delta - The distance between starting point and end point.
      Returns:
      The Point2D where the projection ends.

    • project

      public static Point2D project(Point2D start, Point2D end, double scalar)
      Projects a point from end along the vector (end - start) by the given scalar amount.
      Parameters:
      start - the start
      end - the end
      scalar - the scalar
      Returns:
      the point2 d. double

    • rayCastPoints

      public static Point2D[] rayCastPoints(Point2D point, Rectangle2D rectangle)

    • scaleRect

      public static Shape scaleRect(Rectangle2D shape, int max)

    • scaleWithRatio

      public static Dimension2D scaleWithRatio(double width, double height, int max)

    • scaleShape

      public static Shape scaleShape(Shape shape, double scale)

    • shapeIntersects

      public static boolean shapeIntersects(Shape shapeA, Shape shapeB)
      Shape intersects. WARNING: USE THIS METHOD WITH CAUTION BECAUSE IT IS A VERY SLOW WAY OF CALCULATING INTERSECTIONS.
      Parameters:
      shapeA - the shape a
      shapeB - the shape b
      Returns:
      true, if successful

    • translateShape

      public static Shape translateShape(Shape shape, Point2D newLocation)

    • normalizeAngle

      public static double normalizeAngle(double angle)
      Normalizes the specified angle to the range between 0-360 degree.
      Parameters:
      angle - The angle that will be normalized.
      Returns:
      The normalized angle.