rotateYByDegrees

@JvmStatic
fun rotateYByDegrees(degrees: Float): Matrix4

Creates and returns a 4x4 matrix representing a rotation around the Y-axis. The input angle is specified in degrees.

This transformation rotates points counter-clockwise around the Y-axis when viewed from the positive Y-axis towards the origin (standard right-handed coordinate system convention). The function internally converts the angle from degrees to radians using EulerAngles.degreeToRadian() before applying trigonometric functions.

The input degrees must be a finite floating-point number.

The resulting matrix structure is:

|  cos(rad)  0.0  sin(rad)  0.0 |
| 0.0 1.0 0.0 0.0 |
| -sin(rad) 0.0 cos(rad) 0.0 |
| 0.0 0.0 0.0 1.0 |

where rad is the input angle converted to radians.

Return

A new Matrix4 instance representing the specified counter-clockwise rotation around the Y-axis.

Parameters

degrees

The rotation angle in degrees. Must be a finite number.

Throws

IllegalArgumentException

if degrees is not a finite number (NaN or Infinity).