# shz_vec3_rotate_y

Source: https://sh4zam.com/api/vector/shz_vec3_rotate_y/

```c
SHZ_INLINE shz_vec3_t shz_vec3_rotate_y(shz_vec3_t vec, float radians) SHZ_NOEXCEPT;
```

Rotates the given 3D vector about the Y axis by the given angle in radians.

## Parameters

| Name | Type | Description |
| --- | --- | --- |
| `vec` | `shz_vec3_t` |  |
| `radians` | `float` |  |

## Returns

`shz_vec3_t`

## Warnings

- This routine should only be used for one-off rotations of a single vector. To rotate multiple vectors in a batch, use the XMTRX API.

## Availability

- **C++ equivalent:** [`shz::vec3::rotate_y`](https://sh4zam.com/api/cpp/vec3/#rotate_y)
- **Type-generic form:** none
- **Back-ends:** SH4: shared C implementation · SW: portable C · SPU: shared C implementation
- **Defined in:** [`sh4zam/shz_vector.h:671`](https://github.com/gyrovorbis/sh4zam/blob/ba1e30c88d49df0311870b229e1dd860ef26c477/include/sh4zam/shz_vector.h#L671)
- **Module:** [Vector](https://sh4zam.com/api/vector/), section "Angles"

## See also

[`shz_xmtrx_apply_rotation_y`](https://sh4zam.com/api/xmtrx/shz_xmtrx_apply_rotation_y/)
