Math operations
Mathematical operations that apply to all vectors, such as computing their length
length
Computes the Euclidean norm of the vector.
Computes the length of a vector.
| Arguments | Return Type |
|---|---|
length()
|
number |
lengthSquared
Computes the length of a vector, squared. Due to the nature of the length calculation, this is a little bit faster than length.
| Arguments | Return Type |
|---|---|
lengthSquared()
|
number |
dot
Computes the dot product between two vectors. The argument must be the same type as the target vector.
| Arguments | Return Type |
|---|---|
dot(Vector other)
|
number |
add
Performs vector addition with another vector, storing the result in this vector.
Adds the values from this vector and another vector of the same size, and writes them to this vector. To create a new instance from the sum, see + (operator).
| Arguments | Return Type |
|---|---|
add(Vector other)
|
self Vector |
subtract
Performs vector subtraction with another vector (in the order this - other), storing the result in this vector.
Subtracts the passed vector of the same size from this vector, and writes the result to this vector. To create a new instance from the difference, see - (operator).
| Arguments | Return Type |
|---|---|
subtract(Vector other)
|
self Vector |
offset
Adds factor to all components of this vector. To create a new instance from the result, see + (operator) or - (operator).
| Arguments | Return Type |
|---|---|
offset(number factor)
|
self Vector |
multiply
Multiplies vectors of the same size by multiplying their components. The result is written to this vector.
| Arguments | Return Type |
|---|---|
multiply(Vector other)
|
self Vector |
transform
Multiplies the provided matrix with this vector, in the order M * V, and writes the resulting vector to this vector.
Applies a matrix transformation to this vector. Equivalent to multiplying the matrix by the vector. The matrix must be the same size as the vector; the following are valid:
| Arguments | Return Type |
|---|---|
transform(Matrix mat)
|
self Vector |
divide
Divides vectors of the same size by dividing their components. The result is written to this vector.
| Arguments | Return Type |
|---|---|
divide(Vector other)
|
self Vector |
reduce
For each component in this vector, perform the positive modulo operation on it and the equivalent component in the other vector.
| Arguments | Return Type |
|---|---|
reduce(Vector other)
|
self Vector |
scale
Multiplies each component in this vector by factor.
| Arguments | Return Type |
|---|---|
scale(number factor)
|
self Vector |
normalize
Normalizes this vector in-place. After this operation, the length of the vector will be 1, unless the length is currently 0. If this vector's length is 0, then no normalization will occur.
| Arguments | Return Type |
|---|---|
normalize()
|
self Vector |
clampLength
Scales this vector such that its length is within the bounds specified by minLength and maxLength. If this vector's length is 0, no scaling will be performed, even if minLength is greater than 0. If this vector's length is already within the specified bounds, no scaling will be performed.
Both minLength and maxLength can be omitted or set to nil, resulting in no lower or upper bound on the length of the vector.
| Arguments | Return Type |
|---|---|
clampLength(number | nil minLength, number | nil maxLength)
|
self Vector |
clamped
Copies this vector, then clamps its length. See clampLength for details.
| Arguments | Return Type |
|---|---|
clamped(number | nil minLength, number | nil maxLength)
|
new Vector |
normalized
Copies this vector, then normalizes it. See normalize for details.
| Arguments | Return Type |
|---|---|
normalized()
|
new Vector |
toRad
Returns a copy of this vector, scaled by a factor of (pi / 180). If this vector represents a rotation in degrees, the result will be a rotation in radians.
See also toDeg.
| Arguments | Return Type |
|---|---|
toRad()
|
new Vector |
toDeg
Returns a copy of this vector, scaled by a factor of (180 / pi). If this vector represents a rotation in radians, the result will be a rotation in degrees.
See also toRad.
| Arguments | Return Type |
|---|---|
toDeg()
|
new Vector |
floor
Returns a copy of this vector with every component floored.
| Arguments | Return Type |
|---|---|
floor()
|
new Vector |
ceil
Returns a copy of this vector with every component ceiling-ed.
| Arguments | Return Type |
|---|---|
ceil()
|
new Vector |
Utility methods
copy
Creates a copy of this vector. Creating a copy will make a new Vector with the same size and values, but which is disconnected from the original. This means that methods like set or add which modify the vector they are called with will not modify copies.
| Arguments | Return Type |
|---|---|
copy()
|
new Vector |
set
Assigns the values from another vector of the same size to this vector in place. To create a new instance, see copy.
| Arguments | Return Type |
|---|---|
set(Vector other)
|
self Vector |
reset
Sets all the components of this vector to 0.
| Arguments | Return Type |
|---|---|
reset()
|
self Vector |
applyFunc
Calls the provided function f on every component, and sets this vector's components to the return values of the function.
The function receives the following values as arguments: first, the value as a number, then the index (integer, 1 is x, 2 is y, etc.) The function is expected to return a number.
| Arguments | Return Type |
|---|---|
applyFunc(function f)
|
self Vector |
local A = vec(1, 2, 3)
-- cube the values
A:applyFunc(function(value, index) return value*value*value end)
print(A) -- {1, 8, 27}