NanosMath

A table containing useful and aux Math functions.

🗿Static Class👐Open Source🧑‍💻API Source

---

🎒 Examples

(NanosMath.ClampAxis) Clamping an angle

local axis = NanosMath.ClampAxis(720)

(NanosMath.FInterpTo) Interpolating a number until it reaches 100 with speed 3

local my_value = 0
Client.Subscribe("Tick", function(delta_time)
	my_value = NanosMath.FInterpTo(my_value, 100, delta_time, 3)
end)

(NanosMath.VInterpTo) Interpolating a Vector until it reaches Vector(1000, 200, 100) with speed 5

local my_value = Vector(0, 0, 0)
Client.Subscribe("Tick", function(delta_time)
	my_value = NanosMath.VInterpTo(my_value, Vector(1000, 200, 100), delta_time, 5)
end)

🗿 Static Functions

	Returns	Name	Description
	float	Round	Rounds a number to the nearest value with the given decimal places
	float	Clamp	Clamps a number
	float	ClampAxis	Clamps an angle to the range of [0, 360]
	float	NormalizeAxis	Clamps an angle to the range of [-180, 180]
	Vector, Rotator	RelativeTo	Calculates the location and rotation relative to an actor
	Vector, Rotator	LocalToWorld	Converts a local location and rotation to world coordinates based on an actor's transform
	float	RandomFloat	Returns a random float value
	float	FInterpTo	Interpolate number from Current to Target
	Rotator	RInterpTo	Interpolate Rotator from Current to Target
	Rotator	RInterpConstantTo	Interpolate Rotator from Current to Target with a constant step
	Vector	VInterpTo	Interpolate Vector from Current to Target
	Vector	VInterpConstantTo	Interpolate Vector from Current to Target with a constant step

---

Optimal

Round

Rounds a number to the nearest value with the given decimal places

local ret = NanosMath.Round(value, decimals?)

Parameters

Type	Parameter	Default	Description
float	value	Required parameter	The number to be rounded
integer	decimals?	0	How many decimal places to keep

Returns

Type	Description
float	the rounded number

---

Optimal

Clamp

Clamps a number

local ret = NanosMath.Clamp(value, min, max)

Parameters

Type	Parameter	Default	Description
float	value	Required parameter	The number to be clamped
float	min	Required parameter	The min value
float	max	Required parameter	The max value

Returns

Type	Description
float	the number clamped

---

Optimal

ClampAxis

Clamps an angle to the range of [0, 360]

local ret = NanosMath.ClampAxis(value)

Parameters

Type	Parameter	Default	Description
float	value	Required parameter	The number to be clamped

Returns

Type	Description
float	the number clamped

NanosMath.ClampAxis Examples

Clamping an angle

local axis = NanosMath.ClampAxis(720)

---

Optimal

NormalizeAxis

Clamps an angle to the range of [-180, 180]

local ret = NanosMath.NormalizeAxis(value)

Parameters

Type	Parameter	Default	Description
float	value	Required parameter	The number to be clamped

Returns

Type	Description
float	the number clamped

---

Optimal

RelativeTo

Calculates the location and rotation relative to an actor

local ret_1, ret_2 = NanosMath.RelativeTo(location, rotation, actor)

Parameters

Type	Parameter	Default	Description
Vector	location	Required parameter	The location of the new system
Rotator	rotation	Required parameter	The rotation of the new system
Base Actor	actor	Required parameter	The actor to be translated to the new system

Returns

Type	Description
Vector	the location relative to the actor
Rotator	the rotation relative to the actor

---

Optimal

LocalToWorld

Takes a local position and rotation relative to an actor, applies the actor's location, rotation, and scale to compute world-space location and rotation.

local ret_1, ret_2 = NanosMath.LocalToWorld(local_location, local_rotation, actor)

Parameters

Type	Parameter	Default	Description
Vector	local_location	Required parameter	The local location to convert
Rotator	local_rotation	Required parameter	The local rotation to convert
Base Actor	actor	Required parameter	The actor whose transform defines the local space

Returns

Type	Description
Vector	the location in world coordinates
Rotator	the rotation in world coordinates

---

Optimal

RandomFloat

Returns a random float value

local ret = NanosMath.RandomFloat(min, max)

Parameters

Type	Parameter	Default	Description
float	min	Required parameter	Minimum value
float	max	Required parameter	Maximum value

Returns

Type	Description
float	the random value

---

Optimal

FInterpTo

Interpolate number from Current to Target

local ret = NanosMath.FInterpTo(current, target, delta_time, interp_speed)

Parameters

Type	Parameter	Default	Description
float	current	Required parameter	The current value
float	target	Required parameter	The target value
float	delta_time	Required parameter	Time since the last call, usually the Tick delta time
float	interp_speed	Required parameter	Interpolation speed, 0 jumps straight to the target

Returns

Type	Description
float	The interpolated value

NanosMath.FInterpTo Examples

Interpolating a number until it reaches 100 with speed 3

local my_value = 0
Client.Subscribe("Tick", function(delta_time)
	my_value = NanosMath.FInterpTo(my_value, 100, delta_time, 3)
end)

---

Optimal

RInterpTo

Interpolate Rotator from Current to Target

local ret = NanosMath.RInterpTo(current, target, delta_time, interp_speed)

Parameters

Type	Parameter	Default	Description
Rotator	current	Required parameter	The current value
Rotator	target	Required parameter	The target value
float	delta_time	Required parameter	Time since the last call, usually the Tick delta time
float	interp_speed	Required parameter	Interpolation speed, 0 jumps straight to the target

Returns

Type	Description
Rotator	The interpolated Rotator

---

Optimal

RInterpConstantTo

Interpolate Rotator from Current to Target with a constant step

local ret = NanosMath.RInterpConstantTo(current, target, delta_time, interp_speed)

Parameters

Type	Parameter	Default	Description
Rotator	current	Required parameter	The current value
Rotator	target	Required parameter	The target value
float	delta_time	Required parameter	Time since the last call, usually the Tick delta time
float	interp_speed	Required parameter	Interpolation speed, 0 jumps straight to the target

Returns

Type	Description
Rotator	The interpolated Rotator

---

Optimal

VInterpTo

Interpolate Vector from Current to Target

local ret = NanosMath.VInterpTo(current, target, delta_time, interp_speed)

Parameters

Type	Parameter	Default	Description
Vector	current	Required parameter	The current value
Vector	target	Required parameter	The target value
float	delta_time	Required parameter	Time since the last call, usually the Tick delta time
float	interp_speed	Required parameter	Interpolation speed, 0 jumps straight to the target

Returns

Type	Description
Vector	The interpolated Vector

NanosMath.VInterpTo Examples

Interpolating a Vector until it reaches Vector(1000, 200, 100) with speed 5

local my_value = Vector(0, 0, 0)
Client.Subscribe("Tick", function(delta_time)
	my_value = NanosMath.VInterpTo(my_value, Vector(1000, 200, 100), delta_time, 5)
end)

---

Optimal

VInterpConstantTo

Interpolate Vector from Current to Target with a constant step

local ret = NanosMath.VInterpConstantTo(current, target, delta_time, interp_speed)

Parameters

Type	Parameter	Default	Description
Vector	current	Required parameter	The current value
Vector	target	Required parameter	The target value
float	delta_time	Required parameter	Time since the last call, usually the Tick delta time
float	interp_speed	Required parameter	Interpolation speed, 0 jumps straight to the target

Returns

Type	Description
Vector	The interpolated Vector