1*b1cdbd2cSJim Jagielski /************************************************************** 2*b1cdbd2cSJim Jagielski * 3*b1cdbd2cSJim Jagielski * Licensed to the Apache Software Foundation (ASF) under one 4*b1cdbd2cSJim Jagielski * or more contributor license agreements. See the NOTICE file 5*b1cdbd2cSJim Jagielski * distributed with this work for additional information 6*b1cdbd2cSJim Jagielski * regarding copyright ownership. The ASF licenses this file 7*b1cdbd2cSJim Jagielski * to you under the Apache License, Version 2.0 (the 8*b1cdbd2cSJim Jagielski * "License"); you may not use this file except in compliance 9*b1cdbd2cSJim Jagielski * with the License. You may obtain a copy of the License at 10*b1cdbd2cSJim Jagielski * 11*b1cdbd2cSJim Jagielski * http://www.apache.org/licenses/LICENSE-2.0 12*b1cdbd2cSJim Jagielski * 13*b1cdbd2cSJim Jagielski * Unless required by applicable law or agreed to in writing, 14*b1cdbd2cSJim Jagielski * software distributed under the License is distributed on an 15*b1cdbd2cSJim Jagielski * "AS IS" BASIS, WITHOUT WARRANTIES OR CONDITIONS OF ANY 16*b1cdbd2cSJim Jagielski * KIND, either express or implied. See the License for the 17*b1cdbd2cSJim Jagielski * specific language governing permissions and limitations 18*b1cdbd2cSJim Jagielski * under the License. 19*b1cdbd2cSJim Jagielski * 20*b1cdbd2cSJim Jagielski *************************************************************/ 21*b1cdbd2cSJim Jagielski 22*b1cdbd2cSJim Jagielski 23*b1cdbd2cSJim Jagielski 24*b1cdbd2cSJim Jagielski #ifndef _BGFX_MATRIX_B2DHOMMATRIXTOOLS_HXX 25*b1cdbd2cSJim Jagielski #define _BGFX_MATRIX_B2DHOMMATRIXTOOLS_HXX 26*b1cdbd2cSJim Jagielski 27*b1cdbd2cSJim Jagielski #include <sal/types.h> 28*b1cdbd2cSJim Jagielski #include <basegfx/matrix/b2dhommatrix.hxx> 29*b1cdbd2cSJim Jagielski #include <basegfx/vector/b2dvector.hxx> 30*b1cdbd2cSJim Jagielski #include <basegfx/range/b2drange.hxx> 31*b1cdbd2cSJim Jagielski 32*b1cdbd2cSJim Jagielski namespace rtl { class OUString; } 33*b1cdbd2cSJim Jagielski 34*b1cdbd2cSJim Jagielski /////////////////////////////////////////////////////////////////////////////// 35*b1cdbd2cSJim Jagielski 36*b1cdbd2cSJim Jagielski namespace basegfx 37*b1cdbd2cSJim Jagielski { 38*b1cdbd2cSJim Jagielski namespace tools 39*b1cdbd2cSJim Jagielski { 40*b1cdbd2cSJim Jagielski /** If the rotation angle is an approximate multiple of pi/2, 41*b1cdbd2cSJim Jagielski force fSin/fCos to -1/0/1, to maintain orthogonality (which 42*b1cdbd2cSJim Jagielski might also be advantageous for the other cases, but: for 43*b1cdbd2cSJim Jagielski multiples of pi/2, the exact values _can_ be attained. It 44*b1cdbd2cSJim Jagielski would be largely unintuitive, if a 180 degrees rotation 45*b1cdbd2cSJim Jagielski would introduce slight roundoff errors, instead of exactly 46*b1cdbd2cSJim Jagielski mirroring the coordinate system) 47*b1cdbd2cSJim Jagielski */ 48*b1cdbd2cSJim Jagielski void createSinCosOrthogonal(double& o_rSin, double& rCos, double fRadiant); 49*b1cdbd2cSJim Jagielski 50*b1cdbd2cSJim Jagielski /** Tooling methods for on-the-fly matrix generation e.g. for inline 51*b1cdbd2cSJim Jagielski multiplications 52*b1cdbd2cSJim Jagielski */ 53*b1cdbd2cSJim Jagielski B2DHomMatrix createScaleB2DHomMatrix(double fScaleX, double fScaleY); 54*b1cdbd2cSJim Jagielski B2DHomMatrix createShearXB2DHomMatrix(double fShearX); 55*b1cdbd2cSJim Jagielski B2DHomMatrix createShearYB2DHomMatrix(double fShearY); 56*b1cdbd2cSJim Jagielski B2DHomMatrix createRotateB2DHomMatrix(double fRadiant); 57*b1cdbd2cSJim Jagielski B2DHomMatrix createTranslateB2DHomMatrix(double fTranslateX, double fTranslateY); 58*b1cdbd2cSJim Jagielski 59*b1cdbd2cSJim Jagielski /// inline versions for parameters as tuples createScaleB2DHomMatrix(const B2DTuple & rScale)60*b1cdbd2cSJim Jagielski inline B2DHomMatrix createScaleB2DHomMatrix(const B2DTuple& rScale) 61*b1cdbd2cSJim Jagielski { 62*b1cdbd2cSJim Jagielski return createScaleB2DHomMatrix(rScale.getX(), rScale.getY()); 63*b1cdbd2cSJim Jagielski } 64*b1cdbd2cSJim Jagielski createTranslateB2DHomMatrix(const B2DTuple & rTranslate)65*b1cdbd2cSJim Jagielski inline B2DHomMatrix createTranslateB2DHomMatrix(const B2DTuple& rTranslate) 66*b1cdbd2cSJim Jagielski { 67*b1cdbd2cSJim Jagielski return createTranslateB2DHomMatrix(rTranslate.getX(), rTranslate.getY()); 68*b1cdbd2cSJim Jagielski } 69*b1cdbd2cSJim Jagielski 70*b1cdbd2cSJim Jagielski /** Tooling methods for faster completely combined matrix creation 71*b1cdbd2cSJim Jagielski when scale, shearX, rotation and translation needs to be done in 72*b1cdbd2cSJim Jagielski exactly that order. It's faster since it direcly calculates 73*b1cdbd2cSJim Jagielski each matrix value based on a symbolic calculation of the three 74*b1cdbd2cSJim Jagielski matrix multiplications. 75*b1cdbd2cSJim Jagielski Inline versions for parameters as tuples added, too. 76*b1cdbd2cSJim Jagielski */ 77*b1cdbd2cSJim Jagielski B2DHomMatrix createScaleShearXRotateTranslateB2DHomMatrix( 78*b1cdbd2cSJim Jagielski double fScaleX, double fScaleY, 79*b1cdbd2cSJim Jagielski double fShearX, 80*b1cdbd2cSJim Jagielski double fRadiant, 81*b1cdbd2cSJim Jagielski double fTranslateX, double fTranslateY); createScaleShearXRotateTranslateB2DHomMatrix(const B2DTuple & rScale,double fShearX,double fRadiant,const B2DTuple & rTranslate)82*b1cdbd2cSJim Jagielski inline B2DHomMatrix createScaleShearXRotateTranslateB2DHomMatrix( 83*b1cdbd2cSJim Jagielski const B2DTuple& rScale, 84*b1cdbd2cSJim Jagielski double fShearX, 85*b1cdbd2cSJim Jagielski double fRadiant, 86*b1cdbd2cSJim Jagielski const B2DTuple& rTranslate) 87*b1cdbd2cSJim Jagielski { 88*b1cdbd2cSJim Jagielski return createScaleShearXRotateTranslateB2DHomMatrix( 89*b1cdbd2cSJim Jagielski rScale.getX(), rScale.getY(), 90*b1cdbd2cSJim Jagielski fShearX, 91*b1cdbd2cSJim Jagielski fRadiant, 92*b1cdbd2cSJim Jagielski rTranslate.getX(), rTranslate.getY()); 93*b1cdbd2cSJim Jagielski } 94*b1cdbd2cSJim Jagielski 95*b1cdbd2cSJim Jagielski B2DHomMatrix createShearXRotateTranslateB2DHomMatrix( 96*b1cdbd2cSJim Jagielski double fShearX, 97*b1cdbd2cSJim Jagielski double fRadiant, 98*b1cdbd2cSJim Jagielski double fTranslateX, double fTranslateY); createShearXRotateTranslateB2DHomMatrix(double fShearX,double fRadiant,const B2DTuple & rTranslate)99*b1cdbd2cSJim Jagielski inline B2DHomMatrix createShearXRotateTranslateB2DHomMatrix( 100*b1cdbd2cSJim Jagielski double fShearX, 101*b1cdbd2cSJim Jagielski double fRadiant, 102*b1cdbd2cSJim Jagielski const B2DTuple& rTranslate) 103*b1cdbd2cSJim Jagielski { 104*b1cdbd2cSJim Jagielski return createShearXRotateTranslateB2DHomMatrix( 105*b1cdbd2cSJim Jagielski fShearX, 106*b1cdbd2cSJim Jagielski fRadiant, 107*b1cdbd2cSJim Jagielski rTranslate.getX(), rTranslate.getY()); 108*b1cdbd2cSJim Jagielski } 109*b1cdbd2cSJim Jagielski 110*b1cdbd2cSJim Jagielski B2DHomMatrix createScaleTranslateB2DHomMatrix( 111*b1cdbd2cSJim Jagielski double fScaleX, double fScaleY, 112*b1cdbd2cSJim Jagielski double fTranslateX, double fTranslateY); createScaleTranslateB2DHomMatrix(const B2DTuple & rScale,const B2DTuple & rTranslate)113*b1cdbd2cSJim Jagielski inline B2DHomMatrix createScaleTranslateB2DHomMatrix( 114*b1cdbd2cSJim Jagielski const B2DTuple& rScale, 115*b1cdbd2cSJim Jagielski const B2DTuple& rTranslate) 116*b1cdbd2cSJim Jagielski { 117*b1cdbd2cSJim Jagielski return createScaleTranslateB2DHomMatrix( 118*b1cdbd2cSJim Jagielski rScale.getX(), rScale.getY(), 119*b1cdbd2cSJim Jagielski rTranslate.getX(), rTranslate.getY()); 120*b1cdbd2cSJim Jagielski } 121*b1cdbd2cSJim Jagielski 122*b1cdbd2cSJim Jagielski /// special for the often used case of rotation around a point 123*b1cdbd2cSJim Jagielski B2DHomMatrix createRotateAroundPoint( 124*b1cdbd2cSJim Jagielski double fPointX, double fPointY, 125*b1cdbd2cSJim Jagielski double fRadiant); createRotateAroundPoint(const B2DTuple & rPoint,double fRadiant)126*b1cdbd2cSJim Jagielski inline B2DHomMatrix createRotateAroundPoint( 127*b1cdbd2cSJim Jagielski const B2DTuple& rPoint, 128*b1cdbd2cSJim Jagielski double fRadiant) 129*b1cdbd2cSJim Jagielski { 130*b1cdbd2cSJim Jagielski return createRotateAroundPoint( 131*b1cdbd2cSJim Jagielski rPoint.getX(), rPoint.getY(), 132*b1cdbd2cSJim Jagielski fRadiant); 133*b1cdbd2cSJim Jagielski } 134*b1cdbd2cSJim Jagielski 135*b1cdbd2cSJim Jagielski /// special for the case to map from source range to target range 136*b1cdbd2cSJim Jagielski B2DHomMatrix createSourceRangeTargetRangeTransform( 137*b1cdbd2cSJim Jagielski const B2DRange& rSourceRange, 138*b1cdbd2cSJim Jagielski const B2DRange& rTargetRange); 139*b1cdbd2cSJim Jagielski 140*b1cdbd2cSJim Jagielski } // end of namespace tools 141*b1cdbd2cSJim Jagielski } // end of namespace basegfx 142*b1cdbd2cSJim Jagielski 143*b1cdbd2cSJim Jagielski /////////////////////////////////////////////////////////////////////////////// 144*b1cdbd2cSJim Jagielski 145*b1cdbd2cSJim Jagielski namespace basegfx 146*b1cdbd2cSJim Jagielski { 147*b1cdbd2cSJim Jagielski namespace tools 148*b1cdbd2cSJim Jagielski { 149*b1cdbd2cSJim Jagielski class B2DHomMatrixBufferedDecompose 150*b1cdbd2cSJim Jagielski { 151*b1cdbd2cSJim Jagielski private: 152*b1cdbd2cSJim Jagielski B2DVector maScale; 153*b1cdbd2cSJim Jagielski B2DVector maTranslate; 154*b1cdbd2cSJim Jagielski double mfRotate; 155*b1cdbd2cSJim Jagielski double mfShearX; 156*b1cdbd2cSJim Jagielski 157*b1cdbd2cSJim Jagielski public: B2DHomMatrixBufferedDecompose(const B2DHomMatrix & rB2DHomMatrix=B2DHomMatrix ())158*b1cdbd2cSJim Jagielski B2DHomMatrixBufferedDecompose(const B2DHomMatrix& rB2DHomMatrix = B2DHomMatrix()) 159*b1cdbd2cSJim Jagielski : maScale(), 160*b1cdbd2cSJim Jagielski maTranslate(), 161*b1cdbd2cSJim Jagielski mfRotate(0.0), 162*b1cdbd2cSJim Jagielski mfShearX(0.0) 163*b1cdbd2cSJim Jagielski { 164*b1cdbd2cSJim Jagielski rB2DHomMatrix.decompose(maScale, maTranslate, mfRotate, mfShearX); 165*b1cdbd2cSJim Jagielski } 166*b1cdbd2cSJim Jagielski 167*b1cdbd2cSJim Jagielski // data access getB2DHomMatrix() const168*b1cdbd2cSJim Jagielski B2DHomMatrix getB2DHomMatrix() const 169*b1cdbd2cSJim Jagielski { 170*b1cdbd2cSJim Jagielski return createScaleShearXRotateTranslateB2DHomMatrix( 171*b1cdbd2cSJim Jagielski maScale, mfShearX, mfRotate, maTranslate); 172*b1cdbd2cSJim Jagielski } 173*b1cdbd2cSJim Jagielski getScale() const174*b1cdbd2cSJim Jagielski const B2DVector& getScale() const { return maScale; } getTranslate() const175*b1cdbd2cSJim Jagielski const B2DVector& getTranslate() const { return maTranslate; } getRotate() const176*b1cdbd2cSJim Jagielski double getRotate() const { return mfRotate; } getShearX() const177*b1cdbd2cSJim Jagielski double getShearX() const { return mfShearX; } 178*b1cdbd2cSJim Jagielski }; 179*b1cdbd2cSJim Jagielski } // end of namespace tools 180*b1cdbd2cSJim Jagielski } // end of namespace basegfx 181*b1cdbd2cSJim Jagielski 182*b1cdbd2cSJim Jagielski /////////////////////////////////////////////////////////////////////////////// 183*b1cdbd2cSJim Jagielski 184*b1cdbd2cSJim Jagielski namespace basegfx 185*b1cdbd2cSJim Jagielski { 186*b1cdbd2cSJim Jagielski namespace tools 187*b1cdbd2cSJim Jagielski { 188*b1cdbd2cSJim Jagielski class B2DHomMatrixBufferedOnDemandDecompose 189*b1cdbd2cSJim Jagielski { 190*b1cdbd2cSJim Jagielski private: 191*b1cdbd2cSJim Jagielski B2DHomMatrix maB2DHomMatrix; 192*b1cdbd2cSJim Jagielski B2DVector maScale; 193*b1cdbd2cSJim Jagielski B2DVector maTranslate; 194*b1cdbd2cSJim Jagielski double mfRotate; 195*b1cdbd2cSJim Jagielski double mfShearX; 196*b1cdbd2cSJim Jagielski 197*b1cdbd2cSJim Jagielski // bitfield 198*b1cdbd2cSJim Jagielski unsigned mbDecomposed : 1; 199*b1cdbd2cSJim Jagielski impCheckDecompose()200*b1cdbd2cSJim Jagielski void impCheckDecompose() 201*b1cdbd2cSJim Jagielski { 202*b1cdbd2cSJim Jagielski if(!mbDecomposed) 203*b1cdbd2cSJim Jagielski { 204*b1cdbd2cSJim Jagielski maB2DHomMatrix.decompose(maScale, maTranslate, mfRotate, mfShearX); 205*b1cdbd2cSJim Jagielski mbDecomposed = true; 206*b1cdbd2cSJim Jagielski } 207*b1cdbd2cSJim Jagielski } 208*b1cdbd2cSJim Jagielski 209*b1cdbd2cSJim Jagielski public: B2DHomMatrixBufferedOnDemandDecompose(const B2DHomMatrix & rB2DHomMatrix=B2DHomMatrix ())210*b1cdbd2cSJim Jagielski B2DHomMatrixBufferedOnDemandDecompose(const B2DHomMatrix& rB2DHomMatrix = B2DHomMatrix()) 211*b1cdbd2cSJim Jagielski : maB2DHomMatrix(rB2DHomMatrix), 212*b1cdbd2cSJim Jagielski maScale(), 213*b1cdbd2cSJim Jagielski maTranslate(), 214*b1cdbd2cSJim Jagielski mfRotate(0.0), 215*b1cdbd2cSJim Jagielski mfShearX(0.0), 216*b1cdbd2cSJim Jagielski mbDecomposed(false) 217*b1cdbd2cSJim Jagielski { 218*b1cdbd2cSJim Jagielski } 219*b1cdbd2cSJim Jagielski 220*b1cdbd2cSJim Jagielski // data access getB2DHomMatrix() const221*b1cdbd2cSJim Jagielski const B2DHomMatrix& getB2DHomMatrix() const { return maB2DHomMatrix; } getScale() const222*b1cdbd2cSJim Jagielski const B2DVector& getScale() const { const_cast< B2DHomMatrixBufferedOnDemandDecompose* >(this)->impCheckDecompose(); return maScale; } getTranslate() const223*b1cdbd2cSJim Jagielski const B2DVector& getTranslate() const { const_cast< B2DHomMatrixBufferedOnDemandDecompose* >(this)->impCheckDecompose(); return maTranslate; } getRotate() const224*b1cdbd2cSJim Jagielski double getRotate() const { const_cast< B2DHomMatrixBufferedOnDemandDecompose* >(this)->impCheckDecompose(); return mfRotate; } getShearX() const225*b1cdbd2cSJim Jagielski double getShearX() const { const_cast< B2DHomMatrixBufferedOnDemandDecompose* >(this)->impCheckDecompose(); return mfShearX; } 226*b1cdbd2cSJim Jagielski }; 227*b1cdbd2cSJim Jagielski } // end of namespace tools 228*b1cdbd2cSJim Jagielski 229*b1cdbd2cSJim Jagielski /// Returns a string with svg's "matrix(m00,m10,m01,m11,m02,m12)" representation 230*b1cdbd2cSJim Jagielski ::rtl::OUString exportToSvg( const B2DHomMatrix& rMatrix ); 231*b1cdbd2cSJim Jagielski 232*b1cdbd2cSJim Jagielski } // end of namespace basegfx 233*b1cdbd2cSJim Jagielski 234*b1cdbd2cSJim Jagielski /////////////////////////////////////////////////////////////////////////////// 235*b1cdbd2cSJim Jagielski 236*b1cdbd2cSJim Jagielski #endif /* _BGFX_MATRIX_B2DHOMMATRIXTOOLS_HXX */ 237