Class Vec3

A basic 3D Vector class that provides simple algebraic functionality in the form of 3D Vectors.

We use Getters/setters for both principle properties (x & y) as well as virtual properties (rotation, length etc.).

Vec3

Author

Liam Egan liam@wethecollective.com

Version

1.0.0

Created

Jan 07, 2020

Constructors

constructor

new Vec3(...args: number[]): Vec3
The Vector Class constructor
Parameters
- ...args: number[]
Returns Vec3
- Defined in Vec3.ts:25

Accessors

area

get area(): number
(getter) Vector area.

Returns number
- Defined in Vec3.ts:778

array

get array(): number[]
(getter) Returns the basic array representation of this vector.

Returns number[]
- Defined in Vec3.ts:788

depth

get depth(): number
Returns number
- Defined in Vec3.ts:768
set depth(h: number): void
(getter/setter) Vector height. Alias of Vector#x x
Parameters
- h: number
Returns void
- Defined in Vec3.ts:765

height

get height(): number
Returns number
- Defined in Vec3.ts:755
set height(h: number): void
(getter/setter) Vector height. Alias of Vector#x x
Parameters
- h: number
Returns void
- Defined in Vec3.ts:752

length

get length(): number
Returns number
- Defined in Vec3.ts:690
set length(length: number): void
(getter/setter) The length of the vector
Parameters
- length: number
Returns void
Default
```
0
```
- Defined in Vec3.ts:681

lengthSquared

get lengthSquared(): number
Returns number
- Defined in Vec3.ts:671
set lengthSquared(length: number): void
(getter/setter) The length of the vector presented as a square. If you're using length for comparison, this is quicker.
Parameters
- length: number
Returns void
Default
```
0
```
- Defined in Vec3.ts:662

phi

get phi(): number
Returns number
- Defined in Vec3.ts:716
set phi(p: number): void
(getter/setter) Spherical phi. For using a vec3 as spherical coordinates. Alias of Vector#y y
Parameters
- p: number
Returns void
- Defined in Vec3.ts:713

radius

get radius(): number
Returns number
- Defined in Vec3.ts:703
set radius(s: number): void
(getter/setter) Spherical radius. For using a vec3 as spherical coordinates. Alias of Vector#x x
Parameters
- s: number
Returns void
- Defined in Vec3.ts:700

theta

get theta(): number
Returns number
- Defined in Vec3.ts:729
set theta(t: number): void
(getter/setter) Spherical theta. For using a vec3 as spherical coordinates. Alias of Vector#z z
Parameters
- t: number
Returns void
- Defined in Vec3.ts:726

width

get width(): number
Returns number
- Defined in Vec3.ts:742
set width(w: number): void
(getter/setter) Vector width. Alias of Vector#x x
Parameters
- w: number
Returns void
- Defined in Vec3.ts:739

x

get x(): number
Returns number
- Defined in Vec3.ts:615
set x(x: number): void
Parameters
- x: number
Returns void
- Defined in Vec3.ts:608

xx

get xx(): Vec2
(getter/sette) Swizzle XX

Returns Vec2
- Defined in Vec3.ts:909
set xx(v: Vec2Like): void
Parameters
- v: Vec2Like
Returns void
- Defined in Vec3.ts:912

xy

get xy(): Vec2
(getter/sette) Swizzle XY

Returns Vec2
- Defined in Vec3.ts:839
set xy(v: Vec2Like): void
Parameters
- v: Vec2Like
Returns void
- Defined in Vec3.ts:842

xyz

get xyz(): Vec3
(getter/sette) Swizzle XYZ

Returns Vec3
- Defined in Vec3.ts:797
set xyz(v: Vec3Like): void
Parameters
- v: Vec3Like
Returns void
- Defined in Vec3.ts:800

y

get y(): number
Returns number
- Defined in Vec3.ts:633
set y(y: number): void
Parameters
- y: number
Returns void
- Defined in Vec3.ts:626

yx

get yx(): Vec2
(getter/sette) Swizzle YX

Returns Vec2
- Defined in Vec3.ts:881
set yx(v: Vec2Like): void
Parameters
- v: Vec2Like
Returns void
- Defined in Vec3.ts:884

yy

get yy(): Vec2
(getter/sette) Swizzle YY

Returns Vec2
- Defined in Vec3.ts:922
set yy(v: Vec2Like): void
Parameters
- v: Vec2Like
Returns void
- Defined in Vec3.ts:925

yz

get yz(): Vec2
(getter/sette) Swizzle YZ

Returns Vec2
- Defined in Vec3.ts:853
set yz(v: Vec2Like): void
Parameters
- v: Vec2Like
Returns void
- Defined in Vec3.ts:856

yzx

get yzx(): Vec3
(getter/sette) Swizzle YZX

Returns Vec3
- Defined in Vec3.ts:815
set yzx(v: Vec3Like): void
Parameters
- v: Vec3Like
Returns void
- Defined in Vec3.ts:818

z

get z(): number
Returns number
- Defined in Vec3.ts:651
set z(z: number): void
Parameters
- z: number
Returns void
- Defined in Vec3.ts:644

zx

get zx(): Vec2
(getter/sette) Swizzle zx

Returns Vec2
- Defined in Vec3.ts:867
set zx(v: Vec2Like): void
Parameters
- v: Vec2Like
Returns void
- Defined in Vec3.ts:870

zxy

get zxy(): Vec3
(getter/sette) Swizzle ZXY

Returns Vec3
- Defined in Vec3.ts:827
set zxy(v: Vec3Like): void
Parameters
- v: Vec3Like
Returns void
- Defined in Vec3.ts:830

zy

get zy(): Vec2
(getter/sette) Swizzle ZY

Returns Vec2
- Defined in Vec3.ts:895
set zy(v: Vec2Like): void
Parameters
- v: Vec2Like
Returns void
- Defined in Vec3.ts:898

zz

get zz(): Vec2
(getter/sette) Swizzle ZZ

Returns Vec2
- Defined in Vec3.ts:935
set zz(v: Vec2Like): void
Parameters
- v: Vec2Like
Returns void
- Defined in Vec3.ts:938

Methods

[iterator]

"[iterator]"(): {
next(): | { done: boolean; value: number }
| { done: boolean; value?: undefined };
}
Adds iteration to the object, allowing it to be destructured and iterated upon in various useful ways.

Returns {
next(): | { done: boolean; value: number }
| { done: boolean; value?: undefined };
}
- Defined in Vec3.ts:1082

add

add(vector: Vec3): Vec3
Adds one vector to another.
Parameters
- vector: Vec3
  The vector to add to this one
Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:83

addNew

addNew(vector: Vec3): Vec3
Clones the vector and adds the vector to it instead
Parameters
- vector: Vec3
  The vector to add to this one
Returns Vec3
Returns the clone of itself, modified

Chainable
- Defined in Vec3.ts:97

addScalar

addScalar(scalar: number): Vec3
Adds a scalar to the vector, modifying both the x and y
Parameters
- scalar: number
  The scalar to add to the vector
Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:109

addScalarNew

addScalarNew(scalar: number): Vec3
Clones the vector and adds the scalar to it instead
Parameters
- scalar: number
  The scalar to add to the vector
Returns Vec3
Returns the clone of itself, modified

Chainable
- Defined in Vec3.ts:120

ceil

ceil(): Vec3
Returns Vec3
- Defined in Vec3.ts:553

ceilNew

ceilNew(): Vec3
Returns Vec3
- Defined in Vec3.ts:560

clone

clone(): Vec3
Clones the vector

Returns Vec3
The cloned vector
- Defined in Vec3.ts:71

cross

cross(vector: Vec3): Vec3
Calculates the cross product between this and the supplied vector.
Parameters
- vector: Vec3
  The vector object against which to calculate the cross product
Returns Vec3
The cross product of the two vectors
Example
```
// returns -2
new Vector(2, -3).cross(new Vector(-4, 2))
new Vector(-4, 2).cross(new Vector(2, -3))
// returns 2
new Vector(2, -4).cross(new Vector(-3, 2))
```
- Defined in Vec3.ts:541

crossNew

crossNew(vector: Vec3): Vec3
Parameters
- vector: Vec3
Returns Vec3
- Defined in Vec3.ts:549

distance

distance(vector: Vec3): number
Calculates the distance between this and the supplied vector
Parameters
- vector: Vec3
  The vector to calculate the distance from
Returns number
The distance between this and the supplied vector
- Defined in Vec3.ts:478

distanceX

distanceX(vector: Vec3): number
Calculates the distance on the X axis between this and the supplied vector
Parameters
- vector: Vec3
  The vector to calculate the distance from
Returns number
The distance, along the x axis, between this and the supplied vector
- Defined in Vec3.ts:488

distanceY

distanceY(vector: Vec3): number
Calculated the distance on the Y axis between this and the supplied vector
Parameters
- vector: Vec3
  The vector to calculate the distance from
Returns number
The distance, along the y axis, between this and the supplied vector
- Defined in Vec3.ts:498

distanceZ

distanceZ(vector: Vec3): number
Calculated the distance on the Z axis between this and the supplied vector
Parameters
- vector: Vec3
  The vector to calculate the distance from
Returns number
The distance, along the y axis, between this and the supplied vector
- Defined in Vec3.ts:508

divide

divide(vector: Vec3): Vec3
Divides one vector by another.
Parameters
- vector: Vec3
  The vector to divide this by
Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:181

divideNew

divideNew(vector: Vec3): Vec3
Clones the vector and divides it by the vector instead
Parameters
- vector: Vec3
  The vector to divide the clone by
Returns Vec3
Returns the clone of itself, modified

Chainable
- Defined in Vec3.ts:207

divideScalar

divideScalar(scalar: number): Vec3
Divides the vector by a scalar.
Parameters
- scalar: number
  The scalar to divide both x and y by
Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:219

divideScalarNew

divideScalarNew(scalar: number): Vec3
Clones the vector and divides it by the provided scalar.
Parameters
- scalar: number
  The scalar to divide both x and y by
Returns Vec3
Returns the clone of itself, modified

Chainable
- Defined in Vec3.ts:231

dot

dot(vector: Vec3): number
Calculates the dot product between this and a supplied vector
Parameters
- vector: Vec3
  The vector object against which to calculate the dot product
Returns number
The dot product of the two vectors
Example
```
// returns -14
new Vector(2, -3).dot(new Vector(-4, 2))
new Vector(-4, 2).dot(new Vector(2, -3))
new Vector(2, -4).dot(new Vector(-3, 2))
```
- Defined in Vec3.ts:524

floor

floor(): Vec3
Returns Vec3
- Defined in Vec3.ts:564

floorNew

floorNew(): Vec3
Returns Vec3
- Defined in Vec3.ts:571

fract

fract(): Vec3
Returns Vec3
- Defined in Vec3.ts:586

fractNew

fractNew(): Vec3
Returns Vec3
- Defined in Vec3.ts:593

inverse

inverse(): Vec3
Inverses the vector.

Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:429

inverseNew

inverseNew(): Vec3
Clones the vector and then inverses it.

Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:443

multiply

multiply(vector: Vec3): Vec3
Multiplies one vector by another.
Parameters
- vector: Vec3
  The vector to multiply this by
Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:243

multiplyNew

multiplyNew(vector: Vec3): Vec3
Clones the vector and multiplies it by the vector instead
Parameters
- vector: Vec3
  The vector to multiply the clone by
Returns Vec3
Returns the clone of itself, modified

Chainable
- Defined in Vec3.ts:257

multiplyScalar

multiplyScalar(scalar: number): Vec3
Multiplies the vector by a scalar.
Parameters
- scalar: number
  The scalar to multiply both x and y by
Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:269

multiplyScalarNew

multiplyScalarNew(scalar: number): Vec3
Clones the vector and multiplies it by the provided scalar.
Parameters
- scalar: number
  The scalar to multiply both x and y by
Returns Vec3
Returns the clone of itself, modified

Chainable
- Defined in Vec3.ts:281

negate

negate(): Vec3
Negates the vector.

Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:407

negateNew

negateNew(): Vec3
Clones the vector and negates it.

Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:418

normalise

normalise(): Vec3
Normalises the vector down to a length of 1 unit

Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:458

normaliseNew

normaliseNew(): Vec3
Clones the vector and normalises it

Returns Vec3
Returns a clone of itself, modified

Chainable
- Defined in Vec3.ts:468

reset

reset(...args: number[]): Vec3
Resets the vector coordinates
Parameters
- ...args: number[]
Returns Vec3
Chainable
- Defined in Vec3.ts:38

resetToVector

resetToVector(v: Vec3): Vec3
Resets the vector coordinates to another vector object
Parameters
- v: Vec3
  The vector object to use to reset the coordinates
Returns Vec3
Chainable
- Defined in Vec3.ts:56

rotateX

rotateX(origin: Vec3, radian: number): Vec3
Parameters
- origin: Vec3
- radian: number
Returns Vec3
- Defined in Vec3.ts:298

rotateXNew

rotateXNew(origin: Vec3, radian: number): Vec3
Parameters
- origin: Vec3
- radian: number
Returns Vec3
- Defined in Vec3.ts:311

rotateY

rotateY(origin: Vec3, radian: number): Vec3
Parameters
- origin: Vec3
- radian: number
Returns Vec3
- Defined in Vec3.ts:315

rotateYNew

rotateYNew(origin: Vec3, radian: number): Vec3
Parameters
- origin: Vec3
- radian: number
Returns Vec3
- Defined in Vec3.ts:328

rotateZ

rotateZ(origin: Vec3, radian: number): Vec3
Parameters
- origin: Vec3
- radian: number
Returns Vec3
- Defined in Vec3.ts:332

rotateZNew

rotateZNew(origin: Vec3, radian: number): Vec3
Parameters
- origin: Vec3
- radian: number
Returns Vec3
- Defined in Vec3.ts:345

round

round(): Vec3
Returns Vec3
- Defined in Vec3.ts:575

roundNew

roundNew(): Vec3
Returns Vec3
- Defined in Vec3.ts:582

scale

scale(scalar: number): Vec3
Alias of Vector#multiplyScalar__anchor multiplyScalar
Parameters
- scalar: number
Returns Vec3
- Defined in Vec3.ts:288

scaleNew

scaleNew(scalar: number): Vec3
Alias of Vector#multiplyScalarNew__anchor multiplyScalarNew
Parameters
- scalar: number
Returns Vec3
- Defined in Vec3.ts:294

subtract

subtract(vector: Vec3): Vec3
Subtracts one vector from another.
Parameters
- vector: Vec3
  The vector to subtract from this one
Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:132

subtractNew

subtractNew(vector: Vec3): Vec3
Clones the vector and subtracts the vector from it instead
Parameters
- vector: Vec3
  The vector to subtract from this one
Returns Vec3
Returns the clone of itself, modified

Chainable
- Defined in Vec3.ts:146

subtractScalar

subtractScalar(scalar: number): Vec3
Subtracts a scalar from the vector, modifying both the x and y
Parameters
- scalar: number
  The scalar to subtract from the vector
Returns Vec3
Returns itself, modified

Chainable
- Defined in Vec3.ts:158

subtractScalarNew

subtractScalarNew(scalar: number): Vec3
Clones the vector and subtracts the scalar from it instead
Parameters
- scalar: number
  The scalar to add to the vector
Returns Vec3
Returns the clone of itself, modified

Chainable
- Defined in Vec3.ts:169

transformByMat3

transformByMat3(m: Mat3Like): Vec3
Parameters
- m: Mat3Like
Returns Vec3
- Defined in Vec3.ts:363

transformByMat3New

transformByMat3New(m: Mat3Like): Vec3
Parameters
- m: Mat3Like
Returns Vec3
- Defined in Vec3.ts:372

transformByMat4

transformByMat4(m: Mat4Like): Vec3
Parameters
- m: Mat4Like
Returns Vec3
- Defined in Vec3.ts:349

transformByMat4New

transformByMat4New(m: Mat4Like): Vec3
Parameters
- m: Mat4Like
Returns Vec3
- Defined in Vec3.ts:359

transformByQuat

transformByQuat(q: Vec4Like): Vec3
Parameters
- q: Vec4Like
Returns Vec3
- Defined in Vec3.ts:376

transformByQuatNew

transformByQuatNew(q: Vec4Like): Vec3
Parameters
- q: Vec4Like
Returns Vec3
- Defined in Vec3.ts:396

`Static`fromRotationMatrix

fromRotationMatrix(m: Mat4Like, order?: string): Vec3
Parameters
- m: Mat4Like
- order: string = "YXZ"
Returns Vec3
- Defined in Vec3.ts:1016

`Static`getAngle

getAngle(a: Vec3, b: Vec3): number
Parameters
- a: Vec3
- b: Vec3
Returns number
- Defined in Vec3.ts:998

`Static`interpolate

interpolate(v: string | number | Vec3Like): Vec3
Iterpolates a provided anonymous value into a vew Vec3
Parameters
- v: string | number | Vec3Like
  The value to interpolate
Returns Vec3
out
- Defined in Vec3.ts:952

`Static`lerp

lerp(v1: Vec3, v2: Vec3, d: number): Vec3
Performs a linear interpolation between two Vec3's
Parameters
- v1: Vec3
  the first operand
- v2: Vec3
  the second operand
- d: number
  interpolation amount in the range of 0 - 1
Returns Vec3
- Defined in Vec3.ts:990