> For the complete documentation index, see [llms.txt](https://golua.fatality.win/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://golua.fatality.win/documentation/namespaces/math.md).

# Math

math namespace

## Functions

### vec3

```lua
local new_vec = math.vec3(10, 0, 0)
```

<table data-header-hidden><thead><tr><th width="256.86123677320234" align="center"> </th><th width="286.4109048265438" align="center"> </th><th align="center"> </th></tr></thead><tbody><tr><td align="center"><a href="/documentation/namespaces/math.md">Parameter</a></td><td align="center"><a href="/documentation/namespaces/math.md">Datatype</a></td><td align="center"><a href="/documentation/namespaces/math.md">Default</a></td></tr><tr><td align="center">x</td><td align="center">number</td><td align="center">❌</td></tr><tr><td align="center">y</td><td align="center">number</td><td align="center">parameter x</td></tr><tr><td align="center">z</td><td align="center">number</td><td align="center">parameter x</td></tr></tbody></table>

#### Returns:

<table data-header-hidden><thead><tr><th width="256.86123677320234" align="center"> </th><th width="286.4109048265438" align="center"> </th></tr></thead><tbody><tr><td align="center"><a href="/documentation/namespaces/math.md">Value</a></td><td align="center"><a href="/documentation/namespaces/math.md">Datatype</a></td></tr><tr><td align="center">vector object</td><td align="center"><a href="/documentation/datatypes/vec3.md">math.vec3</a></td></tr></tbody></table>

### vector\_angles

```lua
math.vector_angles(math.vec3(0.5, 0.2, 0.8))
```

<table data-header-hidden><thead><tr><th width="256.86123677320234" align="center"> </th><th width="286.4109048265438" align="center"> </th><th align="center"></th></tr></thead><tbody><tr><td align="center"><a href="/documentation/namespaces/math.md">Parameter</a></td><td align="center"><a href="/documentation/namespaces/math.md">Datatype</a></td><td align="center"><a href="/documentation/namespaces/math.md">Description</a></td></tr><tr><td align="center">forward</td><td align="center"><a href="/documentation/datatypes/vec3.md">math.vec3</a></td><td align="center">the forward vector to convert to angles</td></tr></tbody></table>

#### Returns:

<table data-header-hidden><thead><tr><th width="256.86123677320234" align="center"> </th><th width="286.4109048265438" align="center"> </th></tr></thead><tbody><tr><td align="center"><a href="/documentation/namespaces/math.md">Value</a></td><td align="center"><a href="/documentation/namespaces/math.md">Datatype</a></td></tr><tr><td align="center">angles</td><td align="center"><a href="/documentation/datatypes/vec3.md">math.vec3</a></td></tr></tbody></table>

### angle\_vectors

```lua
math.angle_vectors(math.vec3(0, 90, 0))
```

<table data-header-hidden><thead><tr><th width="256.86123677320234" align="center"> </th><th width="286.4109048265438" align="center"> </th><th align="center"></th></tr></thead><tbody><tr><td align="center"><a href="/documentation/namespaces/math.md">Parameter</a></td><td align="center"><a href="/documentation/namespaces/math.md">Datatype</a></td><td align="center"><a href="/documentation/namespaces/math.md">Description</a></td></tr><tr><td align="center">angle</td><td align="center"><a href="/documentation/datatypes/vec3.md">math.vec3</a></td><td align="center">the angle to convert to directions</td></tr></tbody></table>

#### Returns:

<table data-header-hidden><thead><tr><th width="256.86123677320234" align="center"> </th><th width="286.4109048265438" align="center"> </th></tr></thead><tbody><tr><td align="center"><a href="/documentation/namespaces/math.md">Value</a></td><td align="center"><a href="/documentation/namespaces/math.md">Datatype</a></td></tr><tr><td align="center">forward</td><td align="center"><a href="/documentation/datatypes/vec3.md">math.vec3</a></td></tr><tr><td align="center">right</td><td align="center"><a href="/documentation/datatypes/vec3.md">math.vec3</a></td></tr><tr><td align="center">up</td><td align="center"><a href="/documentation/datatypes/vec3.md">math.vec3</a></td></tr></tbody></table>
