PK_TRANSF_classify

PK_ERROR_code_t               PK_TRANSF_classify
(
--- received arguments ---
PK_TRANSF_t                   transf,      --- transformation to be classified
const PK_TRANSF_classify_o_t *options,     --- options structure

--- returned arguments ---
PK_TRANSF_classify_r_t *const results      --- results
)


This function classifies a supplied transform and optionally returns
diagnostic information in the form of numerical data.


This function classifies a supplied 4 X 4 transform by its components.
In particular the upper left 3 X 3 matrix is classified by returning an
instance of PK_matrix_type_t which can take on the following values:

PK_matrix_type_identity_c
PK_matrix_type_rotation_c
PK_matrix_type_reflection_c
PK_matrix_type_general_c

Diagnostic information will be returned if the 'diagnostics' option is
selected to be PK_TRANSF_diagnostics_all_c. In the case that
PK_TRANSF_diagnostics_none_c is selected as the function option, which is
the default, only the classification will be calculated and all other fields
set to 0.0.