PK_VECTOR_normalise

PK_ERROR_code_t     PK_VECTOR_normalise
(
--- received arguments ---
PK_VECTOR_t         vec,    --- direction vector

--- returned arguments ---
PK_VECTOR1_t *const uvec    --- unit-magnitude result, or {0,0,0}
)


The argument vector is normalised, unless the magnitude of the vector
is strictly equal to 0.0 (ie, | vec | == 0.0). In the latter case the
zero vector {0,0,0} is returned.