Class Vector2

Stores and manipulates a twodimensional vector comprised of the components x and y

           +y
            |__ +x

Authors

Lukas Scheuerle, Jirka Dell'Oro-Friedl, HFU, 2019

Hierarchy (view full)

Mutable
- Vector2

Implements

Constructors

constructor

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

Properties

x

x: number

y

y: number

Accessors

clone

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

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

geo

get geo(): Geo2
Returns a polar representation of this vector

Returns Geo2
- Defined in Source/Core/Math/Vector2.ts:183
set geo(_geo): void
Adjust the cartesian values of this vector to represent the given as polar coordinates
Parameters
- _geo: Geo2
Returns void
- Defined in Source/Core/Math/Vector2.ts:197

magnitude

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

Returns number
- Defined in Source/Core/Math/Vector2.ts:169

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/Vector2.ts:176

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:142

Methods

add

add(_addend): Vector2
Adds the given vector to the executing vector, changing the executor.
Parameters
- _addend: Vector2
  The vector to add.
Returns Vector2
- Defined in Source/Core/Math/Vector2.ts:235

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

copy

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

deserialize

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

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: Vector2
- _tolerance: number = Number.EPSILON
Returns boolean
- Defined in Source/Core/Math/Vector2.ts:225

get

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

Returns Float32Array
- Defined in Source/Core/Math/Vector2.ts:279

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:231

getMetadata

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

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

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/Vector2.ts:352

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:208

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:185

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:193

map

map(_function): Vector2
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 Vector2
- Defined in Source/Core/Math/Vector2.ts:330

max

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

min

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

mutate

mutate(_mutator, _selection?, _dispatchMutate?): 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
- _selection: string[] = null
- _dispatchMutate: boolean = true
Returns Promise<void>
Inherited from Mutable.mutate
- Defined in Source/Core/Serialization/Mutable.ts:260

normalize

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

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/Vector2.ts:217

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): Vector2
Scales the Vector by the given _scalar.
Parameters
- _scalar: number
Returns Vector2
- Defined in Source/Core/Math/Vector2.ts:254

serialize

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

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

set

set(_x?, _y?): Vector2
Sets the components of this vector.
Parameters
- _x: number = 0
- _y: number = 0
Returns Vector2
- Defined in Source/Core/Math/Vector2.ts:270

subtract

subtract(_subtrahend): Vector2
Subtracts the given vector from the executing vector, changing the executor.
Parameters
- _subtrahend: Vector2
  The vector to subtract.
Returns Vector2
- Defined in Source/Core/Math/Vector2.ts:245

toString

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

Returns string
- Defined in Source/Core/Math/Vector2.ts:321

toVector3

toVector3(_z?): Vector3
Adds a z-component of the given magnitude (default=0) to the vector and returns a new Vector3
Parameters
- _z: number = 0
Returns Vector3
- Defined in Source/Core/Math/Vector2.ts:314

transform

transform(_mtxTransform, _includeTranslation?): Vector2
Transforms this vector by the given matrix, including or exluding the translation. Including is the default, excluding will only rotate and scale this vector.
Parameters
- _mtxTransform: Matrix3x3
- _includeTranslation: boolean = true
Returns Vector2
- Defined in Source/Core/Math/Vector2.ts:287

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:246

`Static` CROSS

CROSS(_a, _b): number
Calculates the cross product of two Vectors. Due to them being only 2 Dimensional, the result is a single number, which implicitly is on the Z axis. It is also the signed magnitude of the result.
Parameters
- _a: Vector2
- _b: Vector2
Returns number
- Defined in Source/Core/Math/Vector2.ts:123

`Static` DIFFERENCE

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

`Static` DOT

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

`Static` GEO

GEO(_angle?, _magnitude?): Vector2
Creates a cartesian vector from polar coordinates
Parameters
- _angle: number = 0
- _magnitude: number = 1
Returns Vector2
- Defined in Source/Core/Math/Vector2.ts:155

`Static` NORMALIZATION

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

`Static` ONE

ONE(_scale?): Vector2
A shorthand for writing new Vector2(_scale, _scale).
Parameters
- _scale: number = 1
  the scale of the vector. Default: 1
Returns Vector2
- Defined in Source/Core/Math/Vector2.ts:34

`Static` ORTHOGONAL

ORTHOGONAL(_vector, _clockwise?): Vector2
Calculates the orthogonal vector to the given vector. Rotates counterclockwise by default.
```
↑ => ← => ↓ => → => ↑
```
Parameters
- _vector: Vector2
  Vector to get the orthogonal equivalent of
- _clockwise: boolean = false
  Should the rotation be clockwise instead of the default counterclockwise? default: false
Returns Vector2
A Vector that is orthogonal to and has the same magnitude as the given Vector.
- Defined in Source/Core/Math/Vector2.ts:143

`Static` SCALE

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

`Static` SUM

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

`Static` TRANSFORMATION

TRANSFORMATION(_vector, _mtxTransform, _includeTranslation?): Vector2
Creates and returns a vector through transformation of the given vector by the given matrix
Parameters
- _vector: Vector2
- _mtxTransform: Matrix3x3
- _includeTranslation: boolean = true
Returns Vector2
- Defined in Source/Core/Math/Vector2.ts:65

`Static` X

X(_scale?): Vector2
A shorthand for writing new Vector2(x, 0).
Parameters
- _scale: number = 1
  The number to write in the x coordinate. Default: 1
Returns Vector2
A new vector with the values (_scale, 0)
- Defined in Source/Core/Math/Vector2.ts:45

`Static` Y

Y(_scale?): Vector2
A shorthand for writing new Vector2(0, y).
Parameters
- _scale: number = 1
  The number to write in the y coordinate. Default: 1
Returns Vector2
A new vector with the values (0, _scale)
- Defined in Source/Core/Math/Vector2.ts:56

`Static` ZERO

ZERO(): Vector2
A shorthand for writing new Vector2(0, 0).

Returns Vector2
A new vector with the values (0, 0)
- Defined in Source/Core/Math/Vector2.ts:24

`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:127

Class Vector2

Authors

Hierarchy (view full)

Implements

Index

Constructors

Properties

Accessors

Methods

Constructors

constructor

Parameters

Returns Vector2

Properties

x

y

Accessors

clone

Returns Vector2

geo

Returns Geo2

Parameters

Returns void

magnitude

Returns number

magnitudeSquared

Returns number

type

Returns string

Methods

add

Parameters

Returns Vector2

addEventListener

Parameters

Returns void

copy

Parameters

Returns Vector2

deserialize

Parameters

Returns Promise<Vector2>

dispatchEvent

Parameters

Returns boolean

equals

Parameters

Returns boolean

get

Returns Float32Array

getMetaAttributeTypes

Returns MetaAttributeTypes

getMetadata

Returns Metadata

getMutator

Returns Mutator

getMutatorAttributeTypes

Parameters

Returns MutatorAttributeTypes

getMutatorForAnimation

Parameters

Returns MutatorForAnimation

getMutatorForUserInterface

Parameters

Returns MutatorForUserInterface

map

Parameters

Parameters

Returns number

Returns Vector2

max

Parameters

Returns Vector2

min

Parameters

Returns Vector2

mutate

Parameters

Returns Promise<void>

normalize

`Static` CROSS

`Static` DIFFERENCE

`Static` DOT

`Static` GEO

`Static` NORMALIZATION

`Static` ONE

`Static` ORTHOGONAL

`Static` SCALE

`Static` SUM

`Static` TRANSFORMATION

`Static` X

`Static` Y

`Static` ZERO

`Static` getMutatorFromPath