Class Vec3
Hierarchy
- Float32Array
- Vec3
Index
Accessors
Color Components
Constructor
Methods
Other
Static
Vector Components
Accessors
mag
- get mag(): number
Alias for Vec3.magnitude
Returns number
magnitude
- get magnitude(): number
The magnitude (length) of this. Equivalent to
Vec3.magnitude(this);Magnitude is used because the
lengthattribute is already defined by TypedArrays to mean the number of elements in the array.Returns number
sqrMag
- get sqrMag(): number
Alias for Vec3.squaredMagnitude
Returns number
squaredMagnitude
- get squaredMagnitude(): number
The squared magnitude (length) of
this. Equivalent toVec3.squaredMagnitude(this);Returns number
str
- get str(): string
A string representation of
thisEquivalent toVec3.str(this);Returns string
Color Components
b
- get b(): number
The b component of the vector. Equivalent to
this[2];Returns number
- set b(value): void
Parameters
- value: number
Returns void
g
- get g(): number
The g component of the vector. Equivalent to
this[1];Returns number
- set g(value): void
Parameters
- value: number
Returns void
r
- get r(): number
The r component of the vector. Equivalent to
this[0];Returns number
- set r(value): void
Parameters
- value: number
Returns void
Methods
abs
add
- add(b): this
Adds a Vec3 to
this. Equivalent toVec3.add(this, this, b);Returns this
this
copy
- copy(a): this
Copy the values from another Vec3 into
this.Returns this
this
dist
- dist(b): number
Alias for Vec3.distance
Returns number
distance
- distance(b): number
Calculates the Euclidean distance between another Vec3 and
this. Equivalent toVec3.distance(this, b);Returns number
Distance between
thisandb
div
- div(b): this
Alias for Vec3.divide
Returns this
divide
- divide(b): this
Divides
thisby a Vec3. Equivalent toVec3.divide(this, this, b);Returns this
this
dot
- dot(b): number
Calculates the dot product of this and another Vec3. Equivalent to
Vec3.dot(this, b);Returns number
Dot product of
thisandb
invert
mul
- mul(b): this
Alias for Vec3.multiply
Returns this
multiply
- multiply(b): this
Multiplies
thisby a Vec3. Equivalent toVec3.multiply(this, this, b);Returns this
this
negate
normalize
scale
scaleAndAdd
sqrDist
- sqr
Dist (b): number Alias for Vec3.squaredDistance
Returns number
squaredDistance
- squared
Distance (b): number Calculates the squared Euclidean distance between another Vec3 and
this. Equivalent toVec3.squaredDistance(this, b);Returns number
Squared distance between
thisandb
sub
- sub(b): this
Alias for Vec3.subtract
Returns this
subtract
- subtract(b): this
Subtracts a Vec3 from
this. Equivalent toVec3.subtract(this, this, b);Returns this
this
Other
Readonly[toStringTag]
Readonlybuffer
The ArrayBuffer instance referenced by the array.
ReadonlybyteLength
The length in bytes of the array.
ReadonlybyteOffset
The offset in bytes of the array.
ReadonlyBYTES_PER_ELEMENT
The size in bytes of each element in the array.
Readonlylength
The length of the array.
Static ReadonlyBYTES_PER_ELEMENT
The size in bytes of each element in the array.
[iterator]
- [iterator](): ArrayIterator<number>
Returns ArrayIterator<number>
at
copyWithin
- copy
Within (target, start, end?): this Returns the this object after copying a section of the array identified by start and end to the same array starting at position target
Parameters
- target: number
If target is negative, it is treated as length+target where length is the length of the array.
- start: number
If start is negative, it is treated as length+start. If end is negative, it is treated as length+end.
Optionalend: numberIf not specified, length of the this object is used as its default value.
Returns this
- target: number
entries
- entries(): ArrayIterator<[number, number]>
Returns an array of key, value pairs for every entry in the array
Returns ArrayIterator<[number, number]>
every
- every(predicate, thisArg?): boolean
Determines whether all the members of an array satisfy the specified test.
Parameters
- predicate: ((value: number, index: number, array: Float32Array) => unknown)
A function that accepts up to three arguments. The every method calls the predicate function for each element in the array until the predicate returns a value which is coercible to the Boolean value false, or until the end of the array.
- (value, index, array): unknown
Parameters
- value: number
- index: number
- array: Float32Array
Returns unknown
OptionalthisArg: anyAn object to which the this keyword can refer in the predicate function. If thisArg is omitted, undefined is used as the this value.
Returns boolean
- predicate: ((value: number, index: number, array: Float32Array) => unknown)
fill
- fill(value, start?, end?): this
Changes all array elements from
starttoendindex to a staticvalueand returns the modified arrayParameters
- value: number
value to fill array section with
Optionalstart: numberindex to start filling the array at. If start is negative, it is treated as length+start where length is the length of the array.
Optionalend: numberindex to stop filling the array at. If end is negative, it is treated as length+end.
Returns this
- value: number
filter
- filter(predicate, thisArg?): Float32Array
Returns the elements of an array that meet the condition specified in a callback function.
Parameters
- predicate: ((value: number, index: number, array: Float32Array) => any)
A function that accepts up to three arguments. The filter method calls the predicate function one time for each element in the array.
- (value, index, array): any
Parameters
- value: number
- index: number
- array: Float32Array
Returns any
OptionalthisArg: anyAn object to which the this keyword can refer in the predicate function. If thisArg is omitted, undefined is used as the this value.
Returns Float32Array
- predicate: ((value: number, index: number, array: Float32Array) => any)
find
- find(predicate, thisArg?): number
Returns the value of the first element in the array where predicate is true, and undefined otherwise.
Parameters
- predicate: ((value: number, index: number, obj: Float32Array) => boolean)
find calls predicate once for each element of the array, in ascending order, until it finds one where predicate returns true. If such an element is found, find immediately returns that element value. Otherwise, find returns undefined.
- (value, index, obj): boolean
Parameters
- value: number
- index: number
- obj: Float32Array
Returns boolean
OptionalthisArg: anyIf provided, it will be used as the this value for each invocation of predicate. If it is not provided, undefined is used instead.
Returns number
- predicate: ((value: number, index: number, obj: Float32Array) => boolean)
findIndex
- find
Index (predicate, thisArg?): number Returns the index of the first element in the array where predicate is true, and -1 otherwise.
Parameters
- predicate: ((value: number, index: number, obj: Float32Array) => boolean)
find calls predicate once for each element of the array, in ascending order, until it finds one where predicate returns true. If such an element is found, findIndex immediately returns that element index. Otherwise, findIndex returns -1.
- (value, index, obj): boolean
Parameters
- value: number
- index: number
- obj: Float32Array
Returns boolean
OptionalthisArg: anyIf provided, it will be used as the this value for each invocation of predicate. If it is not provided, undefined is used instead.
Returns number
- predicate: ((value: number, index: number, obj: Float32Array) => boolean)
forEach
- for
Each (callbackfn, thisArg?): void Performs the specified action for each element in an array.
Parameters
- callbackfn: ((value: number, index: number, array: Float32Array) => void)
A function that accepts up to three arguments. forEach calls the callbackfn function one time for each element in the array.
- (value, index, array): void
Parameters
- value: number
- index: number
- array: Float32Array
Returns void
OptionalthisArg: anyAn object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.
Returns void
- callbackfn: ((value: number, index: number, array: Float32Array) => void)
includes
- includes(searchElement, fromIndex?): boolean
Determines whether an array includes a certain element, returning true or false as appropriate.
Parameters
- searchElement: number
The element to search for.
OptionalfromIndex: numberThe position in this array at which to begin searching for searchElement.
Returns boolean
- searchElement: number
indexOf
- index
Of (searchElement, fromIndex?): number Returns the index of the first occurrence of a value in an array.
Parameters
- searchElement: number
The value to locate in the array.
OptionalfromIndex: numberThe array index at which to begin the search. If fromIndex is omitted, the search starts at index 0.
Returns number
- searchElement: number
join
- join(separator?): string
Adds all the elements of an array separated by the specified separator string.
Parameters
Optionalseparator: stringA string used to separate one element of an array from the next in the resulting String. If omitted, the array elements are separated with a comma.
Returns string
keys
- keys(): ArrayIterator<number>
Returns an list of keys in the array
Returns ArrayIterator<number>
lastIndexOf
- last
Index (searchElement, fromIndex?): numberOf Returns the index of the last occurrence of a value in an array.
Parameters
- searchElement: number
The value to locate in the array.
OptionalfromIndex: numberThe array index at which to begin the search. If fromIndex is omitted, the search starts at index 0.
Returns number
- searchElement: number
map
- map(callbackfn, thisArg?): Float32Array
Calls a defined callback function on each element of an array, and returns an array that contains the results.
Parameters
- callbackfn: ((value: number, index: number, array: Float32Array) => number)
A function that accepts up to three arguments. The map method calls the callbackfn function one time for each element in the array.
- (value, index, array): number
Parameters
- value: number
- index: number
- array: Float32Array
Returns number
OptionalthisArg: anyAn object to which the this keyword can refer in the callbackfn function. If thisArg is omitted, undefined is used as the this value.
Returns Float32Array
- callbackfn: ((value: number, index: number, array: Float32Array) => number)
reduce
- reduce(callbackfn): number
Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
Parameters
- callbackfn: ((previousValue: number, currentValue: number, currentIndex: number, array: Float32Array) => number)
A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the array.
- (previousValue, currentValue, currentIndex, array): number
Parameters
- previousValue: number
- currentValue: number
- currentIndex: number
- array: Float32Array
Returns number
Returns number
- callbackfn: ((previousValue: number, currentValue: number, currentIndex: number, array: Float32Array) => number)
- reduce(callbackfn, initialValue): number
Parameters
- callbackfn: ((previousValue: number, currentValue: number, currentIndex: number, array: Float32Array) => number)
- (previousValue, currentValue, currentIndex, array): number
Parameters
- previousValue: number
- currentValue: number
- currentIndex: number
- array: Float32Array
Returns number
- initialValue: number
Returns number
- callbackfn: ((previousValue: number, currentValue: number, currentIndex: number, array: Float32Array) => number)
- reduce<U>(callbackfn, initialValue): U
Calls the specified callback function for all the elements in an array. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
Type Parameters
Parameters
- callbackfn: ((previousValue: U, currentValue: number, currentIndex: number, array: Float32Array) => U)
A function that accepts up to four arguments. The reduce method calls the callbackfn function one time for each element in the array.
- (previousValue, currentValue, currentIndex, array): U
Parameters
- previousValue: U
- currentValue: number
- currentIndex: number
- array: Float32Array
Returns U
- initialValue: U
If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an array value.
Returns U
- callbackfn: ((previousValue: U, currentValue: number, currentIndex: number, array: Float32Array) => U)
reduceRight
- reduce
Right (callbackfn): number Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
Parameters
- callbackfn: ((previousValue: number, currentValue: number, currentIndex: number, array: Float32Array) => number)
A function that accepts up to four arguments. The reduceRight method calls the callbackfn function one time for each element in the array.
- (previousValue, currentValue, currentIndex, array): number
Parameters
- previousValue: number
- currentValue: number
- currentIndex: number
- array: Float32Array
Returns number
Returns number
- callbackfn: ((previousValue: number, currentValue: number, currentIndex: number, array: Float32Array) => number)
- reduce
Right (callbackfn, initialValue): number Parameters
- callbackfn: ((previousValue: number, currentValue: number, currentIndex: number, array: Float32Array) => number)
- (previousValue, currentValue, currentIndex, array): number
Parameters
- previousValue: number
- currentValue: number
- currentIndex: number
- array: Float32Array
Returns number
- initialValue: number
Returns number
- callbackfn: ((previousValue: number, currentValue: number, currentIndex: number, array: Float32Array) => number)
- reduce
Right <U>(callbackfn, initialValue): U Calls the specified callback function for all the elements in an array, in descending order. The return value of the callback function is the accumulated result, and is provided as an argument in the next call to the callback function.
Type Parameters
Parameters
- callbackfn: ((previousValue: U, currentValue: number, currentIndex: number, array: Float32Array) => U)
A function that accepts up to four arguments. The reduceRight method calls the callbackfn function one time for each element in the array.
- (previousValue, currentValue, currentIndex, array): U
Parameters
- previousValue: U
- currentValue: number
- currentIndex: number
- array: Float32Array
Returns U
- initialValue: U
If initialValue is specified, it is used as the initial value to start the accumulation. The first call to the callbackfn function provides this value as an argument instead of an array value.
Returns U
- callbackfn: ((previousValue: U, currentValue: number, currentIndex: number, array: Float32Array) => U)
reverse
- reverse(): Float32Array
Reverses the elements in an Array.
Returns Float32Array
set
- set(array, offset?): void
Sets a value or an array of values.
Parameters
- array: ArrayLike<number>
A typed or untyped array of values to set.
Optionaloffset: numberThe index in the current array at which the values are to be written.
Returns void
- array: ArrayLike<number>
slice
- slice(start?, end?): Float32Array
Returns a section of an array.
Parameters
Optionalstart: numberThe beginning of the specified portion of the array.
Optionalend: numberThe end of the specified portion of the array. This is exclusive of the element at the index 'end'.
Returns Float32Array
some
- some(predicate, thisArg?): boolean
Determines whether the specified callback function returns true for any element of an array.
Parameters
- predicate: ((value: number, index: number, array: Float32Array) => unknown)
A function that accepts up to three arguments. The some method calls the predicate function for each element in the array until the predicate returns a value which is coercible to the Boolean value true, or until the end of the array.
- (value, index, array): unknown
Parameters
- value: number
- index: number
- array: Float32Array
Returns unknown
OptionalthisArg: anyAn object to which the this keyword can refer in the predicate function. If thisArg is omitted, undefined is used as the this value.
Returns boolean
- predicate: ((value: number, index: number, array: Float32Array) => unknown)
sort
- sort(compareFn?): this
Sorts an array.
Parameters
OptionalcompareFn: ((a: number, b: number) => number)Function used to determine the order of the elements. It is expected to return a negative value if first argument is less than second argument, zero if they're equal and a positive value otherwise. If omitted, the elements are sorted in ascending order.
[11,2,22,1].sort((a, b) => a - b)- (a, b): number
Parameters
- a: number
- b: number
Returns number
Returns this
subarray
- subarray(begin?, end?): Float32Array
Gets a new Float32Array view of the ArrayBuffer store for this array, referencing the elements at begin, inclusive, up to end, exclusive.
Parameters
Optionalbegin: numberThe index of the beginning of the array.
Optionalend: numberThe index of the end of the array.
Returns Float32Array
toLocaleString
- to
Locale (): stringString Converts a number to a string by using the current locale.
Returns string
- to
Locale (locales, options?): stringString Parameters
- locales: string | string[]
Optionaloptions: NumberFormatOptions
Returns string
toString
valueOf
- value
Of (): Float32Array Returns the primitive value of the specified object.
Returns Float32Array
values
- values(): ArrayIterator<number>
Returns an list of values in the array
Returns ArrayIterator<number>
Staticfrom
- from(arrayLike): Float32Array
Creates an array from an array-like or iterable object.
Parameters
- arrayLike: ArrayLike<number>
An array-like or iterable object to convert to an array.
Returns Float32Array
- arrayLike: ArrayLike<number>
- from<T>(arrayLike, mapfn, thisArg?): Float32Array
Creates an array from an array-like or iterable object.
Type Parameters
Parameters
Returns Float32Array
- from(arrayLike, mapfn?, thisArg?): Float32Array
Creates an array from an array-like or iterable object.
Parameters
- arrayLike: Iterable<number, any, any>
An array-like or iterable object to convert to an array.
Optionalmapfn: ((v: number, k: number) => number)A mapping function to call on every element of the array.
- (v, k): number
Parameters
- v: number
- k: number
Returns number
OptionalthisArg: anyValue of 'this' used to invoke the mapfn.
Returns Float32Array
- arrayLike: Iterable<number, any, any>
Staticof
- of(...items): Float32Array
Returns a new array from a set of elements.
Parameters
Rest...items: number[]A set of elements to include in the new array object.
Returns Float32Array
Static
StaticBYTE_LENGTH
- get BYTE_LENGTH(): number
Returns number
The number of bytes in a Vec3.
Staticabs
Staticadd
Staticangle
Staticbezier
Staticceil
Staticclone
Staticcopy
Staticcreate
Staticcross
Staticdist
- dist(a, b): number
Alias for Vec3.distance
Returns number
Staticdistance
Staticdiv
- div(out, a, b): Vec3Like
Alias for Vec3.divide
Returns Vec3Like
Staticdivide
Staticdot
Staticequals
StaticexactEquals
Staticfloor
StaticfromValues
Statichermite
Staticinverse
Staticlen
- len(a): number
Alias for Vec3.magnitude
Returns number
Deprecated
Use Vec3.mag
Staticlength
- length(a): number
Alias for Vec3.magnitude
Returns number
length of a
Deprecated
Use Vec3.magnitude to avoid conflicts with builtin
lengthmethods/attribs
Staticlerp
Staticmag
- mag(a): number
Alias for Vec3.magnitude
Returns number
Staticmagnitude
- magnitude(a): number
Calculates the magnitude (length) of a Vec3
Returns number
Magnitude of a
Staticmax
Staticmin
Staticmul
- mul(out, a, b): Vec3Like
Alias for Vec3.multiply
Returns Vec3Like
Staticmultiply
Staticnegate
Staticnormalize
StaticrotateX
StaticrotateY
StaticrotateZ
Staticscale
StaticscaleAndAdd
Staticset
Staticslerp
StaticsqrDist
- sqr
Dist (a, b): number Alias for Vec3.squaredDistance
Returns number
StaticsqrLen
- sqr
Len (a, b): number Alias for Vec3.squaredLength
Returns number
StaticsquaredDistance
StaticsquaredLength
Staticstr
Staticsub
- sub(out, a, b): Vec3Like
Alias for Vec3.subtract
Returns Vec3Like
Staticsubtract
StatictransformMat3
StatictransformMat4
StatictransformQuat
Staticzero
Vector Components
x
- get x(): number
The x component of the vector. Equivalent to
this[0];Returns number
- set x(value): void
Parameters
- value: number
Returns void
y
- get y(): number
The y component of the vector. Equivalent to
this[1];Returns number
- set y(value): void
Parameters
- value: number
Returns void
z
- get z(): number
The z component of the vector. Equivalent to
this[2];Returns number
- set z(value): void
Parameters
- value: number
Returns void
3 Dimensional Vector