218 lines
9 KiB
C++
218 lines
9 KiB
C++
/* -*- Mode: C++; tab-width: 4; indent-tabs-mode: nil; c-basic-offset: 4 -*- */
|
|
/*
|
|
* This file is part of the LibreOffice project.
|
|
*
|
|
* This Source Code Form is subject to the terms of the Mozilla Public
|
|
* License, v. 2.0. If a copy of the MPL was not distributed with this
|
|
* file, You can obtain one at http://mozilla.org/MPL/2.0/.
|
|
*
|
|
* This file incorporates work covered by the following license notice:
|
|
*
|
|
* Licensed to the Apache Software Foundation (ASF) under one or more
|
|
* contributor license agreements. See the NOTICE file distributed
|
|
* with this work for additional information regarding copyright
|
|
* ownership. The ASF licenses this file to you under the Apache
|
|
* License, Version 2.0 (the "License"); you may not use this file
|
|
* except in compliance with the License. You may obtain a copy of
|
|
* the License at http://www.apache.org/licenses/LICENSE-2.0 .
|
|
*/
|
|
|
|
#pragma once
|
|
|
|
#include <sal/types.h>
|
|
#include <basegfx/matrix/b2dhommatrix.hxx>
|
|
#include <basegfx/vector/b2dvector.hxx>
|
|
#include <basegfx/point/b2dpoint.hxx>
|
|
#include <basegfx/tuple/b2dtuple.hxx>
|
|
#include <utility>
|
|
#include <basegfx/basegfxdllapi.h>
|
|
|
|
namespace basegfx { class B2DRange; }
|
|
|
|
namespace basegfx::utils
|
|
{
|
|
/** If the rotation angle is an approximate multiple of pi/2,
|
|
force fSin/fCos to -1/0/1, to maintain orthogonality (which
|
|
might also be advantageous for the other cases, but: for
|
|
multiples of pi/2, the exact values _can_ be attained. It
|
|
would be largely unintuitive, if a 180 degrees rotation
|
|
would introduce slight roundoff errors, instead of exactly
|
|
mirroring the coordinate system)
|
|
*/
|
|
void createSinCosOrthogonal(double& o_rSin, double& rCos, double fRadiant);
|
|
|
|
/** Tooling methods for on-the-fly matrix generation e.g. for inline
|
|
multiplications
|
|
*/
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createScaleB2DHomMatrix(double fScaleX, double fScaleY);
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createShearXB2DHomMatrix(double fShearX);
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createShearYB2DHomMatrix(double fShearY);
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createRotateB2DHomMatrix(double fRadiant);
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createTranslateB2DHomMatrix(double fTranslateX, double fTranslateY);
|
|
|
|
/// inline versions for parameters as tuples
|
|
inline B2DHomMatrix createScaleB2DHomMatrix(const B2DTuple& rScale)
|
|
{
|
|
return createScaleB2DHomMatrix(rScale.getX(), rScale.getY());
|
|
}
|
|
|
|
inline B2DHomMatrix createTranslateB2DHomMatrix(const B2DTuple& rTranslate)
|
|
{
|
|
return createTranslateB2DHomMatrix(rTranslate.getX(), rTranslate.getY());
|
|
}
|
|
|
|
/** Tooling methods for faster completely combined matrix creation
|
|
when scale, shearX, rotation and translation needs to be done in
|
|
exactly that order. It's faster since it directly calculates
|
|
each matrix value based on a symbolic calculation of the three
|
|
matrix multiplications.
|
|
Inline versions for parameters as tuples added, too.
|
|
*/
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createScaleShearXRotateTranslateB2DHomMatrix(
|
|
double fScaleX, double fScaleY,
|
|
double fShearX,
|
|
double fRadiant,
|
|
double fTranslateX, double fTranslateY);
|
|
inline B2DHomMatrix createScaleShearXRotateTranslateB2DHomMatrix(
|
|
const B2DTuple& rScale,
|
|
double fShearX,
|
|
double fRadiant,
|
|
const B2DTuple& rTranslate)
|
|
{
|
|
return createScaleShearXRotateTranslateB2DHomMatrix(
|
|
rScale.getX(), rScale.getY(),
|
|
fShearX,
|
|
fRadiant,
|
|
rTranslate.getX(), rTranslate.getY());
|
|
}
|
|
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createShearXRotateTranslateB2DHomMatrix(
|
|
double fShearX,
|
|
double fRadiant,
|
|
double fTranslateX, double fTranslateY);
|
|
inline B2DHomMatrix createShearXRotateTranslateB2DHomMatrix(
|
|
double fShearX,
|
|
double fRadiant,
|
|
const B2DTuple& rTranslate)
|
|
{
|
|
return createShearXRotateTranslateB2DHomMatrix(
|
|
fShearX,
|
|
fRadiant,
|
|
rTranslate.getX(), rTranslate.getY());
|
|
}
|
|
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createScaleTranslateB2DHomMatrix(
|
|
double fScaleX, double fScaleY,
|
|
double fTranslateX, double fTranslateY);
|
|
inline B2DHomMatrix createScaleTranslateB2DHomMatrix(
|
|
const B2DTuple& rScale,
|
|
const B2DTuple& rTranslate)
|
|
{
|
|
return createScaleTranslateB2DHomMatrix(
|
|
rScale.getX(), rScale.getY(),
|
|
rTranslate.getX(), rTranslate.getY());
|
|
}
|
|
|
|
/// special for the often used case of rotation around a point
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createRotateAroundPoint(
|
|
double fPointX, double fPointY,
|
|
double fRadiant);
|
|
inline B2DHomMatrix createRotateAroundPoint(
|
|
const B2DTuple& rPoint,
|
|
double fRadiant)
|
|
{
|
|
return createRotateAroundPoint(
|
|
rPoint.getX(), rPoint.getY(),
|
|
fRadiant);
|
|
}
|
|
|
|
/// special for creating a mapping for a Range rotated around it's center
|
|
/// while keeping AspectRatio unchanged and staying inside the given Range
|
|
/// by optimally using the available space (no overlap or outside allowed)
|
|
B2DHomMatrix createRotateAroundCenterKeepAspectRatioStayInsideRange(
|
|
const basegfx::B2DRange& rTargetRange,
|
|
double fRotate);
|
|
|
|
/// special for the case to map from source range to target range
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createSourceRangeTargetRangeTransform(
|
|
const B2DRange& rSourceRange,
|
|
const B2DRange& rTargetRange);
|
|
|
|
/// create based on given CoordinateSystem which is defined by origin and x/yaxis
|
|
BASEGFX_DLLPUBLIC B2DHomMatrix createCoordinateSystemTransform(
|
|
const B2DPoint& rOrigin,
|
|
const B2DVector& rX,
|
|
const B2DVector& rY);
|
|
|
|
/// get column vector from B2dHomMatrix, e.g. to extract coordinate system origin and x/yaxis
|
|
BASEGFX_DLLPUBLIC B2DTuple getColumn(const B2DHomMatrix& rMatrix, sal_uInt16 nCol);
|
|
|
|
|
|
class BASEGFX_DLLPUBLIC B2DHomMatrixBufferedDecompose
|
|
{
|
|
private:
|
|
B2DVector maScale;
|
|
B2DVector maTranslate;
|
|
double mfRotate;
|
|
double mfShearX;
|
|
|
|
public:
|
|
B2DHomMatrixBufferedDecompose(const B2DHomMatrix& rB2DHomMatrix = B2DHomMatrix())
|
|
: mfRotate(0.0),
|
|
mfShearX(0.0)
|
|
{
|
|
rB2DHomMatrix.decompose(maScale, maTranslate, mfRotate, mfShearX);
|
|
}
|
|
|
|
// data access
|
|
B2DHomMatrix getB2DHomMatrix() const
|
|
{
|
|
return createScaleShearXRotateTranslateB2DHomMatrix(
|
|
maScale, mfShearX, mfRotate, maTranslate);
|
|
}
|
|
|
|
const B2DVector& getScale() const { return maScale; }
|
|
const B2DVector& getTranslate() const { return maTranslate; }
|
|
double getRotate() const { return mfRotate; }
|
|
double getShearX() const { return mfShearX; }
|
|
};
|
|
|
|
class BASEGFX_DLLPUBLIC B2DHomMatrixBufferedOnDemandDecompose
|
|
{
|
|
private:
|
|
B2DHomMatrix maB2DHomMatrix;
|
|
B2DVector maScale;
|
|
B2DVector maTranslate;
|
|
double mfRotate;
|
|
double mfShearX;
|
|
|
|
bool mbDecomposed : 1;
|
|
|
|
void impCheckDecompose()
|
|
{
|
|
if(!mbDecomposed)
|
|
{
|
|
maB2DHomMatrix.decompose(maScale, maTranslate, mfRotate, mfShearX);
|
|
mbDecomposed = true;
|
|
}
|
|
}
|
|
|
|
public:
|
|
B2DHomMatrixBufferedOnDemandDecompose(B2DHomMatrix aB2DHomMatrix = B2DHomMatrix())
|
|
: maB2DHomMatrix(std::move(aB2DHomMatrix)),
|
|
mfRotate(0.0),
|
|
mfShearX(0.0),
|
|
mbDecomposed(false)
|
|
{
|
|
}
|
|
|
|
// data access
|
|
const B2DHomMatrix& getB2DHomMatrix() const { return maB2DHomMatrix; }
|
|
const B2DVector& getScale() const { const_cast< B2DHomMatrixBufferedOnDemandDecompose* >(this)->impCheckDecompose(); return maScale; }
|
|
const B2DVector& getTranslate() const { const_cast< B2DHomMatrixBufferedOnDemandDecompose* >(this)->impCheckDecompose(); return maTranslate; }
|
|
double getRotate() const { const_cast< B2DHomMatrixBufferedOnDemandDecompose* >(this)->impCheckDecompose(); return mfRotate; }
|
|
double getShearX() const { const_cast< B2DHomMatrixBufferedOnDemandDecompose* >(this)->impCheckDecompose(); return mfShearX; }
|
|
};
|
|
} // end of namespace basegfx::utils
|
|
|
|
/* vim:set shiftwidth=4 softtabstop=4 expandtab: */
|