# shz_xmtrx_load_apply_store_3x3

Source: https://sh4zam.com/api/xmtrx/shz_xmtrx_load_apply_store_3x3/

> Loads XMTRX with the 3x3 result of applying matrix2 onto matrix1, storing the result

```c
SHZ_INLINE void shz_xmtrx_load_apply_store_3x3(shz_mat3x3_t* out, const shz_mat3x3_t* matrix1, const shz_mat3x3_t* matrix2) SHZ_NOEXCEPT;
```

Loads XMTRX with the 3x3 result of applying `matrix2` onto `matrix1`, storing the result.

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `out` | `shz_mat3x3_t *` |  |
| `matrix1` | `const shz_mat3x3_t *` |  |
| `matrix2` | `const shz_mat3x3_t *` |  |

## Returns

Nothing (`void`).

## Details

This operation is equivalent to: [`shz_xmtrx_load_3x3`](https://sh4zam.com/api/xmtrx/shz_xmtrx_load_3x3/)(matrix1); [`shz_xmtrx_apply_3x3`](https://sh4zam.com/api/xmtrx/shz_xmtrx_apply_3x3/)(matrix2); [`shz_xmtrx_store_3x3`](https://sh4zam.com/api/xmtrx/shz_xmtrx_store_3x3/)(out);

However, it has been optimized and pipelined for performing the loads, multiplies, and stores in parallel.

## Notes

- The resulting matrix does not get stored within XMTRX, despite it getting clobbered.

## Availability

- **C++ equivalent:** none (call the C function from C++)
- **Type-generic form:** none
- **Back-ends:** SH4: dedicated SH4 implementation · SW: portable C · SPU: shared C implementation
- **Defined in:** [`sh4zam/shz_xmtrx.h:756`](https://github.com/gyrovorbis/sh4zam/blob/ba1e30c88d49df0311870b229e1dd860ef26c477/include/sh4zam/shz_xmtrx.h#L756)
- **Module:** [XMTRX](https://sh4zam.com/api/xmtrx/), section "Compound Operations"

## See also

[`shz_xmtrx_load_3x3`](https://sh4zam.com/api/xmtrx/shz_xmtrx_load_3x3/), [`shz_xmtrx_apply_3x3`](https://sh4zam.com/api/xmtrx/shz_xmtrx_apply_3x3/), [`shz_xmtrx_store_3x3`](https://sh4zam.com/api/xmtrx/shz_xmtrx_store_3x3/)