shz_vec3_project_safe

SHZ_INLINE shz_vec3_t shz_vec3_project_safe(shz_vec3_t vec, shz_vec3_t onto) SHZ_NOEXCEPT;

Returns the resulting vector from projecting the given 3D vector along the given (unit) axis.

Parameters

Name	Type	Description
vec	shz_vec3_t
onto	shz_vec3_t

Returns

shz_vec3_t

Notes

• This routine should safely return the zero vector when vec has a magnitude of 0.0f.

Naming and requirements

• _safe: Guards degenerate input (zero-length vectors, zero denominators) at a small cost. (Naming and Suffixes)

Availability

• C++ equivalent: shz::vec3::project_safe
• Type-generic form: shz_vec_project_safe()
• Back-ends: SH4: shared C implementation · SW: portable C · SPU: shared C implementation
• Defined in: sh4zam/shz_vector.h:579
• Module: Vector, section "Binary Operations"