basegfx: extend basegfx::B2DHomMatrix::decompose() documentation

decompose() on basegfx::B2DHomMatrix is easier to remember than the
opposite direction.

Change-Id: Ied534ad2fd00d23bde5caa16cfc22e0d06c6b984
Reviewed-on: https://gerrit.libreoffice.org/c/core/+/136199
Tested-by: Jenkins
Reviewed-by: Miklos Vajna <vmiklos@collabora.com>

1 files changed, 7 insertions, 2 deletions

diff --git a/include/basegfx/matrix/b2dhommatrix.hxx b/include/basegfx/matrix/b2dhommatrix.hxx
index d7fa5b4421ef..e1fc6126c1e1 100644
--- a/include/basegfx/matrix/b2dhommatrix.hxx
+++ b/include/basegfx/matrix/b2dhommatrix.hxx
@@ -125,8 +125,13 @@ namespace basegfx
         B2DHomMatrix& operator=(const B2DHomMatrix& rMat);
         B2DHomMatrix& operator=(B2DHomMatrix&& rMat);
 
-        // Help routine to decompose given homogen 3x3 matrix to components. A correction of
-        // the components is done to avoid inaccuracies.
+        /**
+         * Help routine to decompose given homogen 3x3 matrix to components. A correction of the
+         * components is done to avoid inaccuracies.
+         *
+         * See basegfx::utils::createScaleShearXRotateTranslateB2DHomMatrix() for the opposite, to
+         * compose a homogen 3x3 matrix from components.
+         */
         bool decompose(B2DTuple& rScale, B2DTuple& rTranslate, double& rRotate, double& rShearX) const;
     };