alchemist/it.unibo.alchemist.model.implementations.geometry.euclidean2d/SlopeInterceptLine2D

SlopeInterceptLine2D

class SlopeInterceptLine2D<P : Vector2D<P>> : Line2D<P>

A Line2D represented in the slope-intercept form: y = slope * x + yIntercept. Doubles are only compared with MathUtils.fuzzyEquals.

Constructors

SlopeInterceptLine2D

fun <P : Vector2D<P>> SlopeInterceptLine2D(slope: Double, yIntercept: Double, createPoint: (Double, Double) -> P)

Creates a non-vertical line given its slope and yIntercept.

SlopeInterceptLine2D

fun <P : Vector2D<P>> SlopeInterceptLine2D(xIntercept: Double, createPoint: (Double, Double) -> P)

Creates a vertical line given its xIntercept.

Types

object Companion

Functions

fun coincidesWith(other: Line2D<*>): Boolean

Checks if two lines coincide.

open override fun contains(point: P): Boolean

Checks if the point belongs to this line.

open operator override fun equals(other: Any?): Boolean

Checks if other is a Line2D and if it coincidesWith this one.

open override fun findPoint(x: Double): P

Finds the point belonging to the line with the given x-coordinate. Throws an UnsupportedOperationException if the line isVertical.

fun findY(x: Double): Double

Solves the line equation for the given x. Throws an UnsupportedOperationException if the line isVertical.

open override fun hashCode(): Int

Uses slope, yIntercept and xIntercept.

open override fun intersect(other: Line2D<P>): Intersection2D<P>

Intersects two lines.

intersectCircle

open override fun intersectCircle(center: P, radius: Double): Intersection2D<P>

Intersects a line and a circle. Radius must be positive. Intersection is performed by plugging the line equation in the circle equation and solving the resulting quadratic equation. Circle equation: (x - center.x)^2 + (y - center.y)^2 = r^2. Line equation: y = slope * x + yIntercept unless isVertical, x = xIntercept otherwise.

open override fun isParallelTo(other: Line2D<P>): Boolean

Checks if two lines are parallel.

Properties

open override val isHorizontal: Boolean

Indicates if the line is aligned to the x-axis.

open override val isVertical: Boolean

Indicates if the line is aligned to the y-axis.

open override val slope: Double

The slope of the line, if isVertical this is undefined (= Double.NaN).

open override val xIntercept: Double

The x-coordinate of the x-intercept (= the point where the line intersects the x-axis). If isHorizontal there's no x-intercept and this is Double.NaN.

open override val yIntercept: Double

The y-coordinate of the y-intercept (= the point where the line intersects the y-axis). If isVertical there's no y-intercept and this is Double.NaN. The slope-intercept representation (y = mx + b) uses this intercept.