Class Line

Classdesc

A line consists of two vertices a and b.

This is some refactored code from my 'Morley Triangle' test
https://github.com/IkarosKappler/morleys-trisector-theorem

Requires

Vertex

Hierarchy (view full)

VertTuple<Line>
- Line

Implements

Index

Constructors

constructor

new Line(a, b): Line
Creates an instance of Line.
Parameters
- a: Vertex
  The line's first point.
- b: Vertex
  The line's second point.
Returns Line
Name
Line
Overrides VertTuple.constructor
- Defined in src/ts/Line.ts:51

Properties

a

a: Vertex

Member

Memberof

VertTuple

Instance

b

b: Vertex

Member

Memberof

VertTuple

Instance

`Readonly` className

className: string = "Line"

Required to generate proper CSS classes and other class related IDs.

isDestroyed

isDestroyed: boolean

Member

isDestroyed

Memberof

VertTuple

Instance

`Readonly` uid

uid: string

The UID of this drawable object.

Member

Memberof

VertTuple

Instance

`Static` `Private` vtutils

vtutils: {
dist2: ((v, w) => number);
} = ...

Type declaration

dist2: ((v, w) => number)
- - (v, w): number
  - Parameters
    - v: XYCoords
    - w: XYCoords
    Returns number

Methods

add

add(amount): VertTuple<Line>
Add the given vertex to this line's end points.
Parameters
- amount: XYCoords
  The amount (x,y) to add.
Returns VertTuple<Line>
this

Method
add

Instance
Memberof
VertTuple
Inherited from VertTuple.add
- Defined in src/ts/VertTuple.ts:128

angle

angle(line?): number
Get the angle between this and the passed line (in radians).
Parameters
- Optional line: VertTuple<any>
  (optional) The line to calculate the angle to. If null the baseline (x-axis) will be used.
Returns number
this

Method
angle

Instance
Memberof
VertTuple
Inherited from VertTuple.angle
- Defined in src/ts/VertTuple.ts:186

clone

clone(): Line
Create a deep clone of this instance.

Returns Line
A type safe clone if this instance.

Method
cloneLine

Instance
Memberof
VertTuple
Implementation of PathSegment.clone
Inherited from VertTuple.clone
- Defined in src/ts/VertTuple.ts:326

colinear

colinear(line): boolean
Checks if this and the given line are co-linear.

The constant Vertex.EPSILON is used for tolerance.
Parameters
- line: VertTuple<Line>
Returns boolean
true if both lines are co-linear.

Method
colinear

Instance
Memberof
VertTuple
Inherited from VertTuple.colinear
- Defined in src/ts/VertTuple.ts:241

denominator

denominator(line): number
Get the denominator of this and the given line.

If the denominator is zero (or close to zero) both line are co-linear.
Parameters
- line: VertTuple<Line>
Returns number
Method
denominator

Instance
Memberof
VertTuple
Inherited from VertTuple.denominator
- Defined in src/ts/VertTuple.ts:225

destroy

destroy(): void
This function should invalidate any installed listeners and invalidate this object. After calling this function the object might not hold valid data any more and should not be used.

Returns void
Inherited from VertTuple.destroy
- Defined in src/ts/VertTuple.ts:347

getClosestPoint

getClosestPoint(p): Vertex
Get the closest point on this line to the specified point.
Parameters
- p: Vertex
  The point (vertex) to measre the distance to.
Returns Vertex
The point on the line that is closest to p.

Method
getClosestPoint

Instance
Memberof
VertTuple
Inherited from VertTuple.getClosestPoint
- Defined in src/ts/VertTuple.ts:298

getClosestT

getClosestT(p): number
Get the closest position T from this line to the specified point.

The counterpart for this function is Line.vertAt(Number).
Parameters
- p: XYCoords
  The point (vertex) to measure the distance to.
Returns number
The line position t of minimal distance to p.

Name
getClosetT

Method
getClosestT

Instance
Memberof
VertTuple
Inherited from VertTuple.getClosestT
- Defined in src/ts/VertTuple.ts:257

getEndPoint

getEndPoint(): Vertex
Get the end point of this path segment.

Returns Vertex
The end point of this path segment.

Method
getEndPoint

Memberof
PathSegment
Implementation of PathSegment.getEndPoint
- Defined in src/ts/Line.ts:109

getEndTangent

getEndTangent(): Vertex
Get the tangent's end point at the end point of this segment.

Returns Vertex
The end point of the ending point's tangent.

Method
getEndTangent

Memberof
PathSegment
Implementation of PathSegment.getEndTangent
- Defined in src/ts/Line.ts:131

getStartPoint

getStartPoint(): Vertex
Get the start point of this path segment.

Returns Vertex
The start point of this path segment.

Method
getStartPoint

Memberof
PathSegment
Implementation of PathSegment.getStartPoint
- Defined in src/ts/Line.ts:98

getStartTangent

getStartTangent(): Vertex
Get the tangent's end point at the start point of this segment.

Returns Vertex
The end point of the starting point's tangent.

Method
getStartTangent

Memberof
PathSegment
Implementation of PathSegment.getStartTangent
- Defined in src/ts/Line.ts:120

hasPoint

hasPoint(point, insideBoundsOnly?): boolean
Check if the given point is located on this line. Optionally also check if that point is located between point a and b.
Parameters
- point: XYCoords
  The point to check.
- Optional insideBoundsOnly: boolean
  If set to to true (default=false) the point must be between start and end point of the line.
Returns boolean
True if the given point is on this line.

Method
hasPoint

Instance
Memberof
VertTuple
Inherited from VertTuple.hasPoint
- Defined in src/ts/VertTuple.ts:278

intersection

intersection(line): Vertex
Get the intersection if this line and the specified line.
Parameters
- line: VertTuple<any>
  The second line.
Returns Vertex
The intersection (may lie outside the end-points) or undefined if both lines are parallel.

Method
intersection

Instance
Memberof
Line
- Defined in src/ts/Line.ts:65

length

length(): number
Get the length of this line.

Returns number
Method
length

Instance
Memberof
VertTuple
Inherited from VertTuple.length
- Defined in src/ts/VertTuple.ts:87

moveTo

moveTo(newA): VertTuple<Line>
Move this line to a new location.
Parameters
- newA: Vertex
  The new desired location of 'a'. Vertex 'b' will be moved, too.
Returns VertTuple<Line>
this

Method
moveTo

Instance
Memberof
VertTuple
Inherited from VertTuple.moveTo
- Defined in src/ts/VertTuple.ts:170

normalize

normalize(): VertTuple<Line>
Normalize this line (set to length 1).

Returns VertTuple<Line>
this

Method
normalize

Instance
Memberof
VertTuple
Inherited from VertTuple.normalize
- Defined in src/ts/VertTuple.ts:142

pointDistance

pointDistance(p): number
The the minimal distance between this line and the specified point.
Parameters
- p: Vertex
  The point (vertex) to measre the distance to.
Returns number
The absolute minimal distance.

Method
pointDistance

Instance
Memberof
VertTuple
Inherited from VertTuple.pointDistance
- Defined in src/ts/VertTuple.ts:312

reverse

reverse(): Line
Inverse this path segment (in-place) and return this same instance (useful for chaining).

Returns Line
This path segment instance (for chaining).

Method
reverse

Memberof
PathSegment
Implementation of PathSegment.reverse
- Defined in src/ts/Line.ts:142

scale

scale(factor): VertTuple<Line>
Scale this line by the given factor.
Parameters
- factor: number
  The factor for scaling (1.0 means no scale).
Returns VertTuple<Line>
this

Method
scale

Instance
Memberof
VertTuple
Inherited from VertTuple.scale
- Defined in src/ts/VertTuple.ts:156

setLength

setLength(length): VertTuple<Line>
Set the length of this vector to the given amount. This only works if this vector is not a null vector.
Parameters
- length: number
  The desired length.
Returns VertTuple<Line>
this (for chaining)

Method
setLength

Memberof
VertTuple
Inherited from VertTuple.setLength
- Defined in src/ts/VertTuple.ts:100

sub

sub(amount): VertTuple<Line>
Substract the given vertex from this line's end points.
Parameters
- amount: XYCoords
  The amount (x,y) to substract.
Returns VertTuple<Line>
this

Method
sub

Instance
Memberof
VertTuple
Inherited from VertTuple.sub
- Defined in src/ts/VertTuple.ts:113

toString

toString(): string
Create a string representation of this line.

Returns string
The string representing this line.

Method
totring

Instance
Memberof
VertTuple
Inherited from VertTuple.toString
- Defined in src/ts/VertTuple.ts:338

vertAt

vertAt(t): Vertex
Get line point at position t in [0 ... 1]:
```
[P(0)]=[A]--------------------[P(t)]------[B]=[P(1)]
```
The counterpart of this function is Line.getClosestT(Vertex).
Parameters
- t: number
  The position scalar.
Returns Vertex
The vertex a position t.

Method
vertAt

Instance
Memberof
VertTuple
Inherited from VertTuple.vertAt
- Defined in src/ts/VertTuple.ts:210

Class Line

Classdesc

Requires

Hierarchy (view full)

Implements

Index

Constructors

Properties

Methods

Constructors

constructor

Parameters

Returns Line

Name

Properties

a

Member

Memberof

Instance

b

Member

Memberof

Instance

Readonly className

isDestroyed

Member

Memberof

Instance

Readonly uid

Member

Memberof

Instance

Static Private vtutils

Type declaration

dist2: ((v, w) => number)

Parameters

Returns number

Methods

add

Parameters

Returns VertTuple<Line>

Method

Instance

Memberof

angle

Parameters

Returns number

Method

Instance

Memberof

clone

Returns Line

Method

Instance

Memberof

colinear

Parameters

Returns boolean

Method

Instance

Memberof

denominator

Parameters

Returns number

Method

Instance

Memberof

destroy

Returns void

getClosestPoint

Parameters

Returns Vertex

Method

Instance

Memberof

getClosestT

Parameters

Returns number

Name

Method

`Readonly` className

`Readonly` uid

`Static` `Private` vtutils