Shared

lib.math

Extends the standard Lua math table with extra functions.

math = lib.math

math.toscalars

Takes a string and returns a set of scalar values.

math.toscalars(input, min, max, round)

• input: string
• min?: number
• max?: number
• round?: boolean

Return:

• ...: number

math.tovector

Takes a string or table and returns a vector value, or a number if only one value was found.

math.tovector(input, min, max, round)

• input: string or table
• min?: number
• max?: number
• round?: boolean

Return:

• value: number or vector2 or vector3 or vector4

math.normaltorotation

Takes a surface normal and tries to convert it to a vector3 rotation.

math.normaltorotation(input)

• input: vector3

Return:

• value: vector3

math.torgba

Takes a string or table and returns a vector value, or a number if only one value was found.
Values are rounded and must be within the range of 0-255.

math.torgba(input)

• input: string or table

Return:

• value: number or vector2 or vector3 or vector4

math.hextorgb

Takes a hexadecimal string and returns three integers.

math.hextorgb(input)

• input: string
  • A hexadecimal value, e.g. 'eb4034'.

Return:

• r: number
• g: number
• b: number

math.tohex

Takes a number or string and formats it as a hexadecimal string.

math.tohex(n, upper)

• n: number or string
• upper?: boolean

Return:

• hex: string

math.groupdigits

Takes a number and formats it into grouped digits.

math.groupdigits(number, seperator)

• number: number
• seperator?: string
  • Default: ,

Return:

• groupedDigits: string

math.clamp

Clamps a number between a lower and upper limit.

math.clamp(number, lower, upper)

• number: number
• lower: number
• upper: number

Return:

• number: number