Skip to main content

VectorView

A 2D vector on a plane.

Hierarchy

Vector
- VectorView

Index

Constructors

constructor

Properties

EQUALS_EPSILON

Accessors

magnitude
size
x
y
Down
Half
Left
One
Right
Up
Zero

Constructors

constructor

new VectorView(options: VectorViewOptions): VectorView

Overrides Vector.constructor
Parameters
- options: VectorViewOptions
Returns VectorView

Properties

publicstaticEQUALS_EPSILON

EQUALS_EPSILON: number = 0.001

Get or set the vector equals epsilon, by default 0.001 meaning vectors within that tolerance on x or y will be considered equal.

Accessors

publicmagnitude

get magnitude(): number
set magnitude(newMagnitude: number): void

Inherited from Vector.magnitude
The magnitude (length) of the Vector
Returns number
Inherited from Vector.magnitude
Setting the size mutates the current vector
@warning
Can be used to set the size of the vector, be very careful using this, mutating vectors can cause hard to find bugs
Parameters
- newMagnitude: number
Returns void

publicsize

get size(): number
set size(newLength: number): void

Inherited from Vector.size
The size (magnitude) of the Vector
@deprecated
Will be removed in v1, use Vector.magnitude
Returns number
Inherited from Vector.size
Setting the size mutates the current vector
@warning
Can be used to set the size of the vector, be very careful using this, mutating vectors can cause hard to find bugs
@deprecated
Will be removed in v1, use Vector.magnitude
Parameters
- newLength: number
Returns void

publicx

get x(): number
set x(val: number): void

Overrides Vector.x
Get the x component of the vector
Returns number
Overrides Vector.x
Set the x component, THIS MUTATES the current vector. It is usually better to create a new vector.
@warning
Be very careful setting components on shared vectors, mutating shared vectors can cause hard to find bugs
Parameters
- val: number
Returns void

publicy

get y(): number
set y(val: number): void

Overrides Vector.y
Get the y component of the vector
Returns number
Overrides Vector.y
Set the y component, THIS MUTATES the current vector. It is usually better to create a new vector.
@warning
Be very careful setting components on shared vectors, mutating shared vectors can cause hard to find bugs
Parameters
- val: number
Returns void

publicstaticDown

get Down(): Vector

Inherited from Vector.Down
A unit vector pointing down (0, 1)
Returns Vector

publicstaticHalf

get Half(): Vector

Inherited from Vector.Half
A (0.5, 0.5) vector
Returns Vector

publicstaticLeft

get Left(): Vector

Inherited from Vector.Left
A unit vector pointing left (-1, 0)
Returns Vector

publicstaticOne

get One(): Vector

Inherited from Vector.One
A (1, 1) vector
Returns Vector

publicstaticRight

get Right(): Vector

Inherited from Vector.Right
A unit vector pointing right (1, 0)
Returns Vector

publicstaticUp

get Up(): Vector

Inherited from Vector.Up
A unit vector pointing up (0, -1)
Returns Vector

publicstaticZero

get Zero(): Vector

Inherited from Vector.Zero
A (0, 0) vector
Returns Vector

Methods

publicadd

add(v: Vector, dest?: Vector): Vector

Inherited from Vector.add
Adds one vector to another
Parameters
- v: Vector
  The vector to add
- optionaldest: Vector
  Optionally copy the result into a provided vector
Returns Vector

publicaddEqual

addEqual(v: Vector): Vector

Inherited from Vector.addEqual
Adds one vector to this one modifying the original
@warning
Be very careful using this, mutating vectors can cause hard to find bugs
Parameters
- v: Vector
  The vector to add
Returns Vector

publicangleBetween

angleBetween(angle: number, rotationType: RotationType): number

Inherited from Vector.angleBetween
Returns the difference in radians between the angle of this vector and given angle, using the given rotation type.
Parameters
- angle: number
  in radians to which the vector has to be rotated, using rotate
- rotationType: RotationType
  what RotationType to use for the rotation
Returns number
the angle by which the vector needs to be rotated to match the given angle

publicaverage

average(vec: Vector): Vector

Inherited from Vector.average
Returns the average (midpoint) between the current point and the specified
Parameters
- vec: Vector
Returns Vector

publicclampMagnitude

clampMagnitude(magnitude: number): Vector

Inherited from Vector.clampMagnitude
Clamps the current vector's magnitude mutating it
Parameters
- magnitude: number
Returns Vector

publicclone

clone(dest?: Vector): Vector

Inherited from Vector.clone
Creates new vector that has the same values as the previous.
Parameters
- optionaldest: Vector
Returns Vector

publiccross

cross(v: number): Vector
cross(v: Vector): number

Inherited from Vector.cross
Performs a 2D cross product with scalar. 2D cross products with a scalar return a vector.
Parameters
- v: number
  The scalar to cross
Returns Vector

publicdistance

distance(v?: Vector): number

Inherited from Vector.distance
The distance to another vector. If no other Vector is specified, this will return the magnitude.
Parameters
- optionalv: Vector
  The other vector. Leave blank to use origin vector.
Returns number

publicdot

dot(v: Vector): number

Inherited from Vector.dot
Performs a dot product with another vector
Parameters
- v: Vector
  The vector to dot
Returns number

publicequals

equals(vector: Vector, tolerance?: number): boolean

Inherited from Vector.equals
Compares this point against another and tests for equality
Parameters
- vector: Vector
  The other point to compare to
- tolerance: number = Vector.EQUALS_EPSILON
  Amount of euclidean distance off we are willing to tolerate
Returns boolean

publicnegate

negate(): Vector

Inherited from Vector.negate
Negate the current vector
Returns Vector

publicnormal

normal(): Vector

Inherited from Vector.normal
Returns the normal vector to this one, same as the perpendicular of length 1
Returns Vector

publicnormalize

normalize(): Vector

Inherited from Vector.normalize
Normalizes a non-zero vector to have a magnitude of 1. Zero vectors return a new zero vector.
Returns Vector

publicperpendicular

perpendicular(): Vector

Inherited from Vector.perpendicular
Returns the perpendicular vector to this one
Returns Vector

publicrotate

rotate(angle: number, anchor?: Vector, dest?: Vector): Vector

Inherited from Vector.rotate
Rotates the current vector around a point by a certain angle in radians. Positive angle means rotation clockwise.
Parameters
- angle: number
- optionalanchor: Vector
- optionaldest: Vector
Returns Vector

publicscale

scale(scale: Vector, dest?: Vector): Vector
scale(size: number, dest?: Vector): Vector

Inherited from Vector.scale
Scales a vector's by a factor of size
Parameters
- scale: Vector
- optionaldest: Vector
  Optionally provide a destination vector for the result
Returns Vector

publicscaleEqual

scaleEqual(size: number): Vector

Inherited from Vector.scaleEqual
Scales this vector by a factor of size and modifies the original
@warning
Be very careful using this, mutating vectors can cause hard to find bugs
Parameters
- size: number
Returns Vector

setTo

setTo(x: number, y: number): void

Inherited from Vector.setTo
Sets the x and y components at once, THIS MUTATES the current vector. It is usually better to create a new vector.
@warning
Be very careful using this, mutating vectors can cause hard to find bugs
Parameters
- x: number
- y: number
Returns void

publicsquareDistance

squareDistance(v?: Vector): number

Inherited from Vector.squareDistance
Parameters
- optionalv: Vector
Returns number

publicsub

sub(v: Vector, dest?: Vector): Vector

Inherited from Vector.sub
Subtracts a vector from another, if you subtract vector B.sub(A) the resulting vector points from A -> B
Parameters
- v: Vector
  The vector to subtract
- optionaldest: Vector
Returns Vector

publicsubEqual

subEqual(v: Vector): Vector

Inherited from Vector.subEqual
Subtracts a vector from this one modifying the original
@warning
Be very careful using this, mutating vectors can cause hard to find bugs
Parameters
- v: Vector
  The vector to subtract
Returns Vector

publictoAngle

toAngle(): number

Inherited from Vector.toAngle
Returns the angle of this vector, in range [0, 2*PI)
Returns number

publictoString

toString(fixed?: number): string

Inherited from Vector.toString
Returns a string representation of the vector.
Parameters
- optionalfixed: number
Returns string

staticcross

cross(num: number, vec: Vector): Vector

Inherited from Vector.cross
Parameters
- num: number
- vec: Vector
Returns Vector

publicstaticdistance

distance(vec1: Vector, vec2: Vector): number

Inherited from Vector.distance
Calculates distance between two Vectors
Parameters
- vec1: Vector
- vec2: Vector
Returns number

publicstaticfromAngle

fromAngle(angle: number): Vector

Inherited from Vector.fromAngle
Returns a vector of unit length in the direction of the specified angle in Radians.
Parameters
- angle: number
  The angle to generate the vector
Returns Vector

publicstaticisValid

isValid(vec: Vector): boolean

Inherited from Vector.isValid
Checks if vector is not null, undefined, or if any of its components are NaN or Infinity.
Parameters
- vec: Vector
Returns boolean

publicstaticmax

max(vec1: Vector, vec2: Vector): Vector

Inherited from Vector.max
Parameters
- vec1: Vector
- vec2: Vector
Returns Vector

publicstaticmin

min(vec1: Vector, vec2: Vector): Vector

Inherited from Vector.min
Parameters
- vec1: Vector
- vec2: Vector
Returns Vector

Page Options

Hide Inherited