📐 Vector
A Vector composed of components (X, Y, Z) with floating point precision. Used mainly for entity position.
Les vecteurs sont compressés en interne et automatiquement, ce qui réduit leur taille dans le réseau jusqu'à 90 %. Des détails intéressants :
- Les paramètres des vecteurs dans les méthodes des classes sont généralement compressés avec une précision de 1 décimale (avec quelques exceptions où nous avons besoin de plus de précision).
- Les vecteurs transmis dans les événements distants sont compressés avec une précision de 2 décimales. If you need more precision, we recommend passing them as raw number instead.
🎒 Examples
local new_vector = Vector(1452.5, 512, 943.1)
🛠 Constructors
Default Constructor
local my_vector = Vector(X?, Y?, Z?)
🧽 Properties
🦠 Functions
This structure supports +, -, *, /, ^, ==, and tostring operations.
| Returns | Name | Description | |
|---|---|---|---|
| boolean | Equals | Check against another vector for equality, within specified error limits | |
| number | Distance | Distance between two points | |
| number | DistanceSquared | Squared distance between two points | |
| Vector | GetUnsafeNormal | Calculates normalized version of vector without checking for zero length | |
| Vector | GetSafeNormal | Gets a normalized copy of the vector, checking it is safe to do so based on the length | |
| boolean | IsNearlyZero | Checks whether vector is near to zero within a specified tolerance | |
| boolean | IsZero | Checks whether all components of the vector are exactly zero | |
| boolean | Normalize | Normalize this vector in-place if it is larger than a given tolerance. Leaves it unchanged if not | |
| number | Size | Get the length (magnitude) of this vector | |
| number | SizeSquared | Get the squared length of this vector | |
| Rotator | Rotation | Returns the orientation corresponding to the direction in which the vector points |
Equals
Check if the vector is equal to another vector, within specified error limits
— Returns boolean (Are the vectors equal or not).
local ret = my_vector:Equals(other, tolerance?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Vector | other | Required parameter | The vector to compare to |
| number | tolerance? | 0.000001 | The error limits |
Distance
Returns the distance of 2 vectors
— Returns number (The distance betweem the vectors).
local ret = my_vector:Distance(other)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Vector | other | Required parameter | The vector to get the distance to |
DistanceSquared
Return the squared distance of 2 vectors
— Returns number (The squared distance betweem the vectors).
local ret = my_vector:DistanceSquared(other)
| Type | Parameter | Default | Description |
|---|---|---|---|
| Vector | other | Required parameter | The vector to get the squared distance to |
GetUnsafeNormal
Returns the normalized version of vector without checking for zero length
— Returns Vector (The unsafe normal).
local ret = my_vector:GetUnsafeNormal()
GetSafeNormal
Returns a normalized copy of the vector, checking it is safe to do so based on the length
— Returns Vector (The safe normal).
local ret = my_vector:GetSafeNormal()
IsNearlyZero
Checks whether vector is near to zero within a specified tolerance
— Returns boolean (If the bool is near to zero).
local ret = my_vector:IsNearlyZero(tolerance?)
| Type | Parameter | Default | Description |
|---|---|---|---|
| number | tolerance? | 0.000001 | The error limits |
IsZero
Checks whether all components of the vector are exactly zero
— Returns boolean (If all components of the vector are exactly zero).
local ret = my_vector:IsZero()
Normalize
Normalize this vector in-place if it is larger than a given tolerance. Leaves it unchanged if not
— Returns boolean (If the vector has been modified).
local ret = my_vector:Normalize()
Size
Get the length (magnitude) of this vector
— Returns number (The lenght of the vector).
local ret = my_vector:Size()
SizeSquared
Get the squared length of this vector
— Returns number (The squared length of the vector).
local ret = my_vector:SizeSquared()
Rotation
Returns the orientation corresponding to the direction in which the vector points
— Returns Rotator (The orientation of the vector).
local ret = my_vector:Rotation()