Class Line

constructor

• new Line(...args): Line

• Parameters

  • Rest...args:
        | []
        | [Point, Point]
        | [Point, Vector]
        | [Vector, Point]

    Line may be constructed by point and normal vector or by two points that a line passes through

  Returns Line

norm

pt

box

• get box(): Box

• Line has infinite box

  Returns Box

  infinite box

end

• get end(): undefined

• Line has no end point

  Returns undefined

  undefined

length

• get length(): number

• Line has infinite length

  Returns number

  positive infinity number

middle

• get middle(): undefined

• Line has no middle point

  Returns undefined

  undefined

name

• get name(): string

• Shape name

  Returns string

  name of the shape

slope

• get slope(): number

• Slope of the line - angle in radians between line and axe x from 0 to 2PI

  Returns number

  slope of the line

standard

• get standard(): [number, number, number]

• Get coefficients [A,B,C] of a standard line equation in the form Ax + By = C

  [A, B, C] = line.standard
  Copy

  Returns [number, number, number]

  coefficients [A,B,C]

start

• get start(): undefined

• Line has no start point

  Returns undefined

  undefined

clone

• clone(): Line

• Return new cloned instance of line

  Returns Line

  cloned line

contains

• contains(pt): boolean

• Check if point belongs to line

  Parameters

  • pt: Point

    Query point

  Returns boolean

  true if point belongs to line

coord

• coord(pt): number

• Return coordinate of the point that lies on the line in the transformed coordinate system where center is the projection of the point(0,0) to the line and axe y is collinear to the normal vector.
  This method assumes that point lies on the line and does not check it

  Parameters

  • pt: Point

    point on a line

  Returns number

distanceTo

• distanceTo(shape): [number, Segment]

• Calculate distance and shortest segment from line to shape and returns array [distance, shortestSegment]

  Parameters

  • shape: Shape<any> | Polygon

    Shape of the one of the types Point, Circle, Segment, Arc, Polygon

  Returns [number, Segment]

incidentTo

• incidentTo(l): boolean

• Check if line is incident to other line

  Parameters

  • l: Line

    line to check

  Returns boolean

  Returns true if incident to other line

intersect

• intersect(shape): Point[]

• Returns array of intersection points

  Parameters

  • shape: Shape<any>

    shape to intersect with

  Returns Point[]

parallelTo

• parallelTo(l): boolean

• Check if line is parallel to other line

  Parameters

  • l: Line

    line to check

  Returns boolean

  true if parallel or incident to other line

rotate

• rotate(angle, center?): Line

• Rotate line by angle and center point.

  Parameters

  • angle: number

    angle in radians
  • center: Point = ...

    center of rotation

  Returns Line

  rotated line

sortPoints

• sortPoints(pts): Point[]

• Sort given array of points that lay on a line with respect to coordinate on a line The method assumes that points lay on the line and does not check this

  Parameters

  • pts: Point[]

    array of points

  Returns Point[]

  new array sorted

split

• split(pt): (Ray | Segment)[]

• Split line with a point or array of points and return array of shapes Assumed (but not checked) that all points lay on the line

  Parameters

  • pt: Point

  Returns (Ray | Segment)[]

transform

• transform(m): Line

• Transform line with given affine transformation matrix.

  Parameters

  • m: Matrix

    affine transformation matrix (a,b,c,d,tx,ty)

  Returns Line

  transformed line

Staticpoints2norm

• points2norm(pt1, pt2): Vector

• Parameters

  • pt1: Point
  • pt2: Point

  Returns Vector