Class Vector3

Stores and manipulates a threedimensional vector comprised of the components x, y and z

Authors

Jascha Karagöl, HFU, 2019 | Jirka Dell'Oro-Friedl, HFU, 2019-2022 | Jonas Plotzky, HFU, 2023

Hierarchy (view full)

Mutable
- Vector3

Implements

Constructors

constructor

new Vector3(_x?, _y?, _z?): Vector3
Parameters
- _x: number = 0
- _y: number = 0
- _z: number = 0
Returns Vector3
Overrides Mutable.constructor
- Defined in Source/Core/Math/Vector3.ts:17

Properties

x

x: number

y

y: number

z

z: number

Accessors

clone

get clone(): Vector3
Creates and returns a clone of this vector.

Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:257

geo

get geo(): Geo3
Returns Geo3
- Defined in Source/Core/Math/Vector3.ts:242
set geo(_geo): void
- get: returns a geographic representation of this vector
- set: adjust the cartesian values of this vector to represent the given as geographic coordinates
Parameters
- _geo: Geo3
Returns void
- Defined in Source/Core/Math/Vector3.ts:237

magnitude

get magnitude(): number
Returns the length of the vector

Returns number
- Defined in Source/Core/Math/Vector3.ts:222

magnitudeSquared

get magnitudeSquared(): number
Returns the square of the magnitude of the vector without calculating a square root. Faster for simple proximity evaluation.

Returns number
- Defined in Source/Core/Math/Vector3.ts:229

type

get type(): string
Retrieves the type of this mutable subclass as the name of the runtime class

Returns string
The type of the mutable
Inherited from Mutable.type
- Defined in Source/Core/Serialization/Mutable.ts:175

Methods

add

add(_addend): Vector3
Adds the given vector to this vector.
Parameters
- _addend: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:311

addEventListener

addEventListener(_type, _handler, _options?): void
See EventTarget.addEventListener for reference. Works with EventListenerUnified and EventUnified
Parameters
- _type: string
- _handler: EventListenerUnified
- Optional _options: boolean | AddEventListenerOptions
Returns void
Inherited from Mutable.addEventListener
- Defined in Source/Core/Event/Event.ts:91

apply

apply(_function): Vector3
Applies the given function to all components of this vector (modifying it) and returns it.
Parameters
- _function: ((_value, _index, _component) => number)
  - - (_value, _index, _component): number
    - Parameters
      _value: number
      _index: number
      _component: "x" | "y" | "z"
      Returns number
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:463

copy

copy(_original): Vector3
Copies the components of the given vector into this vector.
Parameters
- _original: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:265

deserialize

deserialize(_serialization): Promise<Vector3>
Recreates this instance of Serializable with the information from the given Serialization.
Parameters
- _serialization: Serialization
Returns Promise<Vector3>
Implementation of Serializable.deserialize
- Defined in Source/Core/Math/Vector3.ts:486

dispatchEvent

dispatchEvent(_event): boolean
See EventTarget.dispatchEvent for reference. Works with with EventUnified
Parameters
- _event: EventUnified
Returns boolean
Inherited from Mutable.dispatchEvent
- Defined in Source/Core/Event/Event.ts:105

equals

equals(_compare, _tolerance?): boolean
Returns true if the coordinates of this and the given vector are to be considered identical within the given tolerance TODO: examine, if tolerance as criterium for the difference is appropriate with very large coordinate values or if _tolerance should be multiplied by coordinate value
Parameters
- _compare: Vector3
- _tolerance: number = Number.EPSILON
Returns boolean
- Defined in Source/Core/Math/Vector3.ts:277

get

get(): Float32Array
Returns an array of the components of this vector.

Returns Float32Array
- Defined in Source/Core/Math/Vector3.ts:379

getDistance

getDistance(_to): number
Returns the distance bewtween this vector and the given vector
Parameters
- _to: Vector3
Returns number
- Defined in Source/Core/Math/Vector3.ts:424

getMetaAttributeTypes

getMetaAttributeTypes(): MetaAttributeTypes
Retrieves the specified attribute types from the metadata of this instance's class.

Returns MetaAttributeTypes
Inherited from Mutable.getMetaAttributeTypes
- Defined in Source/Core/Serialization/Mutable.ts:265

getMetadata

getMetadata(): Metadata
Retrieves the metadata of this instance's class.

Returns Metadata
Inherited from Mutable.getMetadata
- Defined in Source/Core/Serialization/Mutable.ts:272

getMutator

getMutator(): Mutator
Collect applicable attributes of the instance and copies of their values in a Mutator-object. By default, a mutator cannot be extended, since extensions are not available in the object the mutator belongs to. A mutator may be reduced by the descendants of Mutable to contain only the properties needed.

Returns Mutator
Overrides Mutable.getMutator
- Defined in Source/Core/Math/Vector3.ts:503

getMutatorAttributeTypes

getMutatorAttributeTypes(_mutator): MutatorAttributeTypes
Returns an associative array with the same attributes as the given mutator, but with the corresponding types as string-values. Does not recurse into objects! This will return the decorated meta-type instead of the runtime-type of the object, if available.
Parameters
- _mutator: Mutator
Returns MutatorAttributeTypes
Inherited from Mutable.getMutatorAttributeTypes
- Defined in Source/Core/Serialization/Mutable.ts:242

getMutatorForAnimation

getMutatorForAnimation(_extendable?): MutatorForAnimation
Collect the attributes of the instance and their values applicable for animation. Basic functionality is identical to getMutator, returned mutator should then be reduced by the subclassed instance
Parameters
- _extendable: boolean = false
Returns MutatorForAnimation
Inherited from Mutable.getMutatorForAnimation
- Defined in Source/Core/Serialization/Mutable.ts:219

getMutatorForUserInterface

getMutatorForUserInterface(_extendable?): MutatorForUserInterface
Collect the attributes of the instance and their values applicable for the user interface. Basic functionality is identical to getMutator, returned mutator should then be reduced by the subclassed instance
Parameters
- _extendable: boolean = false
Returns MutatorForUserInterface
Inherited from Mutable.getMutatorForUserInterface
- Defined in Source/Core/Serialization/Mutable.ts:227

isInsideCube

isInsideCube(_corner1, _corner2): boolean
Returns true if the position described by this is within a cube with the opposite corners 1 and 2
Parameters
- _corner1: Vector3
- _corner2: Vector3
Returns boolean
- Defined in Source/Core/Math/Vector3.ts:287

isInsideSphere

isInsideSphere(_center, _radius): boolean
Returns true if the position described by this is within a sphere with the given center and radius
Parameters
- _center: Vector3
- _radius: number
Returns boolean
- Defined in Source/Core/Math/Vector3.ts:303

map

map(_function): Vector3
Uses the standard array.map functionality to perform the given function on all components of this vector and return a new vector with the results
Parameters
- _function: ((_value, _index, _array) => number)
  - - (_value, _index, _array): number
    - Parameters
      _value: number
      _index: number
      _array: ArrayLike<number>
      Returns number
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:454

max

max(_compare): Vector3
For each dimension, moves the component to the maximum of this and the given vector
Parameters
- _compare: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:443

min

min(_compare): Vector3
For each dimension, moves the component to the minimum of this and the given vector
Parameters
- _compare: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:433

mutate

mutate(_mutator): Promise<void>
Updates the attribute values of the instance according to the state of the mutator. The mutation may be restricted to a subset of the mutator and the event dispatching suppressed. Uses mutateBase, but can be overwritten in subclasses
Parameters
- _mutator: Mutator
Returns Promise<void>
Overrides Mutable.mutate
- Defined in Source/Core/Math/Vector3.ts:494

negate

negate(): Vector3
Negates this vector by flipping the signs of its components

Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:348

normalize

normalize(_length?): Vector3
Normalizes this to the given length, 1 by default
Parameters
- _length: number = 1
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:341

project

project(_on): Vector3
Projects this vector onto the given vector
Parameters
- _on: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:358

recycle

recycle(): void
Recycles the object for the next reuse by setting its properties to their default states.

Returns void
Implementation of Recycable.recycle
- Defined in Source/Core/Math/Vector3.ts:269

reflect

reflect(_normal): Vector3
Reflects this vector at a given normal. See Vector3.REFLECTION
Parameters
- _normal: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:405

removeEventListener

removeEventListener(_type, _handler, _options?): void
See EventTarget.removeEventListener for reference. Works with EventListenerUnified and EventUnified
Parameters
- _type: string
- _handler: EventListenerUnified
- Optional _options: boolean | AddEventListenerOptions
Returns void
Inherited from Mutable.removeEventListener
- Defined in Source/Core/Event/Event.ts:98

scale

scale(_scalar): Vector3
Scales this vector by the given scalar.
Parameters
- _scalar: number
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:331

serialize

serialize(): Serialization
Returns a Serialization of this object.

Returns Serialization
Implementation of Serializable.serialize
- Defined in Source/Core/Math/Vector3.ts:479

set

set(_x?, _y?, _z?): Vector3
Sets the components of this vector and returns it.
Parameters
- _x: number = 0
- _y: number = 0
- _z: number = 0
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:369

shuffle

shuffle(): Vector3
Shuffles the components of this vector

Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:415

subtract

subtract(_subtrahend): Vector3
Subtracts the given vector from this vector.
Parameters
- _subtrahend: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:321

toString

toString(): string
Returns a formatted string representation of this vector

Returns string
- Defined in Source/Core/Math/Vector3.ts:473

toVector2

toVector2(): Vector2
Drops the z-component and returns a Vector2 consisting of the x- and y-components

Returns Vector2
- Defined in Source/Core/Math/Vector3.ts:398

transform

transform(_transform, _includeTranslation?): Vector3
Transforms this vector by the given matrix or rotation quaternion. Including or exluding the translation if a matrix is passed. Including is the default, excluding will only rotate and scale this vector.
Parameters
- _transform: Matrix4x4 | Quaternion
- _includeTranslation: boolean = true
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:388

updateMutator

updateMutator(_mutator): void
Updates the values of the given mutator according to the current state of the instance
Parameters
- _mutator: Mutator
Returns void
Inherited from Mutable.updateMutator
- Defined in Source/Core/Serialization/Mutable.ts:280

`Static` ANGLE

ANGLE(_from, _to): number
Return the angle in degrees between the two given vectors
Parameters
- _from: Vector3
- _to: Vector3
Returns number
- Defined in Source/Core/Math/Vector3.ts:205

`Static` CROSS

CROSS(_a, _b): Vector3
Computes the crossproduct of 2 vectors.
Parameters
- _a: Vector3
- _b: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:150

`Static` DIFFERENCE

DIFFERENCE(_minuend, _subtrahend): Vector3
Returns the result of the subtraction of two vectors.
Parameters
- _minuend: Vector3
- _subtrahend: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:132

`Static` DOT

DOT(_a, _b): number
Computes the dotproduct of 2 vectors.
Parameters
- _a: Vector3
- _b: Vector3
Returns number
- Defined in Source/Core/Math/Vector3.ts:162

`Static` GEO

GEO(_longitude?, _latitude?, _magnitude?): Vector3
Creates a cartesian vector from geographic coordinates
Parameters
- _longitude: number = 0
- _latitude: number = 0
- _magnitude: number = 1
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:193

`Static` NORMALIZATION

NORMALIZATION(_vector, _length?): Vector3
Creates and returns a vector which is a copy of the given vector scaled to the given length
Parameters
- _vector: Vector3
- _length: number = 1
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:110

`Static` ONE

ONE(_scale?): Vector3
Creates and returns a vector of the given size on each of the three axis
Parameters
- _scale: number = 1
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:62

`Static` PROJECTION

PROJECTION(_a, _b): Vector3
Return the projection of a onto b
Parameters
- _a: Vector3
- _b: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:213

`Static` RATIO

RATIO(_dividend, _divisor): Vector3
Divides the dividend by the divisor component by component and returns the result
Parameters
- _dividend: Vector3
- _divisor: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:184

`Static` REFLECTION

REFLECTION(_incoming, _normal): Vector3
Calculates and returns the reflection of the incoming vector at the given normal vector. The length of normal should be 1. __________________ /|
incoming / | \ reflection / | \
normal
Parameters
- _incoming: Vector3
- _normal: Vector3
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:175

`Static` SCALE

SCALE(_vector, _scaling): Vector3
Returns a new vector representing the given vector scaled by the given scaling factor
Parameters
- _vector: Vector3
- _scaling: number
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:141

`Static` SUM

SUM(..._vectors): Vector3
Returns the resulting vector attained by addition of all given vectors.
Parameters
- Rest ..._vectors: Vector3[]
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:122

`Static` TRANSFORMATION

TRANSFORMATION(_vector, _transform, _includeTranslation?): Vector3
Creates and returns a vector through transformation of the given vector by the given matrix or rotation quaternion.
Parameters
- _vector: Vector3
- _transform: Matrix4x4 | Quaternion
- _includeTranslation: boolean = true
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:71

`Static` X

X(_scale?): Vector3
Creates and returns a vector with the given length pointing in x-direction
Parameters
- _scale: number = 1
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:26

`Static` Y

Y(_scale?): Vector3
Creates and returns a vector with the given length pointing in y-direction
Parameters
- _scale: number = 1
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:35

`Static` Z

Z(_scale?): Vector3
Creates and returns a vector with the given length pointing in z-direction
Parameters
- _scale: number = 1
Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:44

`Static` ZERO

ZERO(): Vector3
Creates and returns a vector with the value 0 on each axis

Returns Vector3
- Defined in Source/Core/Math/Vector3.ts:53

`Static` getMutatorFromPath

getMutatorFromPath(_mutator, _path): Mutator
Decorator allows to attach Mutable functionality to existing classes.
Parameters
- _mutator: Mutator
- _path: string[]
Returns Mutator
Inherited from Mutable.getMutatorFromPath
- Defined in Source/Core/Serialization/Mutable.ts:160

Class Vector3

Authors

Hierarchy (view full)

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns Vector3

Properties

x

y

z

Accessors

clone

Returns Vector3

geo

Returns Geo3

Parameters

Returns void

magnitude

Returns number

magnitudeSquared

Returns number

type

Returns string

Methods

add

Parameters

Returns Vector3

addEventListener

Parameters

Returns void

apply

Parameters

Parameters

Returns number

Returns Vector3

copy

Parameters

Returns Vector3

deserialize

Parameters

Returns Promise<Vector3>

dispatchEvent

Parameters

Returns boolean

equals

Parameters

Returns boolean

get

Returns Float32Array

getDistance

Parameters

Returns number

getMetaAttributeTypes

Returns MetaAttributeTypes

getMetadata

Returns Metadata

getMutator

Returns Mutator

getMutatorAttributeTypes

Parameters

Returns MutatorAttributeTypes

getMutatorForAnimation

Parameters

Returns MutatorForAnimation

getMutatorForUserInterface

Parameters

Returns MutatorForUserInterface

isInsideCube

Parameters

Returns boolean

isInsideSphere

Parameters

Returns boolean

`Static` ANGLE

`Static` CROSS

`Static` DIFFERENCE

`Static` DOT

`Static` GEO

`Static` NORMALIZATION