shz_vec3_normalize_safe
SHZ_INLINE shz_vec3_t shz_vec3_normalize_safe(shz_vec3_t vec) SHZ_NOEXCEPT;SAFELY returns a normalized unit vector from the given 3D vector.
Parameters
Section titled “Parameters”| Name | Type | Description |
|---|---|---|
vec | shz_vec3_t |
Returns
Section titled “Returns”shz_vec3_t
Details
Section titled “Details”If the vector's magnitude is not > 0.0f, safely returns a zero vector.
Naming and requirements
Section titled “Naming and requirements”_safe: Guards degenerate input (zero-length vectors, zero denominators) at a small cost. (Naming and Suffixes)
Availability
Section titled “Availability”- C++ equivalent:
shz::vec3::direction_safe,shz::vec3::normalize_safe,shz::vec3::normalized_safe - Type-generic form:
shz_vec_normalize_safe() - Back-ends: SH4: shared C implementation · SW: portable C · SPU: shared C implementation
- Defined in:
sh4zam/shz_vector.h:450 - Module: Vector, section "Magnitude"