# shz_mat4x4_apply_rotation

Source: https://sh4zam.com/api/matrix/shz_mat4x4_apply_rotation/

```c
SHZ_INLINE void shz_mat4x4_apply_rotation(shz_mat4x4_t* mat, float angle, float xAxis, float yAxis, float zAxis) SHZ_NOEXCEPT;
```

Rotates the given transform matrix about the arbitrary axis given by a 3D direction vector and angle of rotation in radians.

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `mat` | `shz_mat4x4_t *` |  |
| `angle` | `float` |  |
| `xAxis` | `float` |  |
| `yAxis` | `float` |  |
| `zAxis` | `float` |  |

## Returns

Nothing (`void`).

## Details

Multiplies and accumulates the given matrix with the 3D rotation matrix formed from the intrinsic rotation created by the given Tait-Bryan Z-Y-X angles.

## Warnings

- This routine clobbers XMTRX.

## Naming and requirements

- `shz_mat4x4_t` and `shz_mat2x2_t` arguments must be 8-byte aligned. Unaligned data goes through the `float[16]` parameters of the `_unaligned` routines.

## Availability

- **C++ equivalent:** none (call the C function from C++)
- **Type-generic form:** none
- **Back-ends:** SH4: shared C implementation · SW: portable C · SPU: shared C implementation
- **Defined in:** [`sh4zam/shz_matrix.h:471`](https://github.com/gyrovorbis/sh4zam/blob/ba1e30c88d49df0311870b229e1dd860ef26c477/include/sh4zam/shz_matrix.h#L471)
- **Module:** [Matrix](https://sh4zam.com/api/matrix/), section "Applying"