hom_mat2d_invert🔗
Short description🔗
hom_mat2d_invert — Invert a homogeneous 2D transformation matrix.
Signature🔗
hom_mat2d_invert( hom_mat2d HomMat2D, out hom_mat2d HomMat2DInvert )
Description🔗
hom_mat2d_invert inverts the homogeneous 2D transformation
matrix given by HomMat2D. The resulting matrix is returned in
HomMat2DInvert.
Attention🔗
Note that homogeneous matrices are stored row-by-row as a tuple; the last row is usually not stored because it is identical for all homogeneous matrices that describe an affine transformation. For example, the homogeneous matrix \(\mvHomMatrixTwoDElements{ra & rb & tc \\ rd & re & tf}\) is stored as the tuple [ra, rb, tc, rd, re, tf]. However, it is also possible to process full 3×3 matrices, which represent a projective 2D transformation.
Execution information🔗
Execution information
-
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
-
Multithreading scope: global (may be called from any thread).
-
Processed without parallelization.
Parameters🔗
HomMat2D (input_control) hom_mat2d → (real)
Input transformation matrix.
HomMat2DInvert (output_control) hom_mat2d → (real)
Output transformation matrix.
Result🔗
hom_mat2d_invert returns 2 (H_MSG_TRUE) if the parameters are valid and the
input matrix is invertible. Otherwise, an exception is raised.
Combinations with other operators🔗
Combinations
Possible predecessors
hom_mat2d_translate, hom_mat2d_translate_local, hom_mat2d_scale, hom_mat2d_scale_local, hom_mat2d_rotate, hom_mat2d_rotate_local, hom_mat2d_slant, hom_mat2d_slant_local, hom_mat2d_reflect, hom_mat2d_reflect_local
Possible successors
hom_mat2d_translate, hom_mat2d_translate_local, hom_mat2d_scale, hom_mat2d_scale_local, hom_mat2d_rotate, hom_mat2d_rotate_local, hom_mat2d_slant, hom_mat2d_slant_local, hom_mat2d_reflect, hom_mat2d_reflect_local
Module🔗
Foundation