shz_mat4x4_init_rotation

SHZ_INLINE void shz_mat4x4_init_rotation(shz_mat4x4_t* mat, float radians, float xAxis, float yAxis, float zAxis) SHZ_NOEXCEPT;

Initializes the given 4x4 matrix to a 3D rotation matrix of angle radians about the vector with the given components.

Parameters

Name	Type	Description
mat	shz_mat4x4_t *
radians	float
xAxis	float
yAxis	float
zAxis	float

Returns

Nothing (void).

Notes

• This routine works similarly to glRotatef() applied to an identitiy matrix. The given axis will automatically be normalized internally.

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:187
• Module: Matrix, section "Initialization"

See also

shz_mat4x4_init_rotation_dir