Template:Main:Vector/Methods

Math operations

Mathematical operations that apply to all vectors, such as computing their length

length

---

Mathematical definition

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

---

Mathematical definition

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

---

Mathematical definition

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

---

Mathematical definition

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:

• Vector2:transform(Matrix2)
• Vector3:transform(Matrix3)
• Vector4:transform(Matrix4)

Arguments	Return Type
transform(Matrix mat)	self 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()	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

Operators

Lua operators, such as +, -, and *, apply to vectors and have different results.

+ (operator)

With two vectors

---

Mathematical definition

Performs vector addition with another vector, and creates a new vector from the result.

Adds the values from this vector and another vector of the same size. The result is a new vector of the same size which holds the sum.

Left	Right	Result
Vector	Vector	Vector

local a = vec(1, 2, 3)
local b = vec(4, 4, 6)
print(a + b, a, b) -- {5, 6, 9}  {1, 2, 3}  {4, 4, 6}

With a vector and number

Operator is commutative and has the same result regardless of order.

---

The result is a new vector of the same size which holds the result of adding the number to all components of this vector.

Left	Right	Result
Vector	number	Vector
number	Vector	Vector

- (operator)

With two vectors

---

Mathematical definition

Performs vector subtraction with another vector, and creates a new vector from the result.

Subtracts the right vector from the left vector. The result is a new vector of the same size which holds the difference.

Left	Right	Result
Vector	Vector	Vector

local a = vec(1, 2, 3)
local b = vec(4, 4, 6)
print(b - a, a, b) -- {3, 2, 3}  {1, 2, 3}  {4, 4, 6}

With a vector and a number

Only applies when the number is on the right side of the operator.

---

Returns a new vector of the same size containing the result of subtracting the number from all components of the vector.

Left	Right	Result
Vector	number	Vector

With a number and a vector

Only applies when the number is on the left side of the operator.

---

Returns a new vector of the same size containing the result of negating all of the components of the vector, then adding the number. In effect, number - vector == (-vector) + number.

Left	Right	Result
number	Vector	Vector