cairo:matrix-invert (matrix)

matrix -- a cairo:matrix-t instance

The inversed cairo:matrix-t instance if matrix has an inverse, otherwise nil.

Changes the matrix to be the inverse of its original value. Not all transformation matrices have inverses. If the matrix collapses points together, it is degenerate, then it has no inverse and this function will fail.