# shz_mat4x4_inverse

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

```c
void shz_mat4x4_inverse(const shz_mat4x4_t* SHZ_RESTRICT mtrx, shz_mat4x4_t* SHZ_RESTRICT out) SHZ_NOEXCEPT;
```

Computes the inverse of a 4x4 matrix.

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `mtrx` | `const shz_mat4x4_t *SHZ_RESTRICT` | Pointer to the 4x4 matrix to invert. |
| `out` | `shz_mat4x4_t *SHZ_RESTRICT` | Pointer to the resulting inverted matrix. |

## Returns

Nothing (`void`).

## Notes

- In-place inversion (mtrx == out) is not supported.

## 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:** [`shz::mat4x4::inverse`](https://sh4zam.com/api/cpp/mat4x4/#inverse)
- **Type-generic form:** none
- **Back-ends:** SH4: shared C implementation · SW: portable C · SPU: shared C implementation
- **Defined in:** [`sh4zam/shz_matrix.h:824`](https://github.com/gyrovorbis/sh4zam/blob/ba1e30c88d49df0311870b229e1dd860ef26c477/include/sh4zam/shz_matrix.h#L824)
- **Module:** [Matrix](https://sh4zam.com/api/matrix/), section "Miscellaneous"