Affine2d.h

// Affine2d.h:
// -----------
//

#ifndef __IPSDKMATH_AFFINE2D_H__
#define __IPSDKMATH_AFFINE2D_H__

// suppression warnings
// warning C4251: 'ipsdk::math::transform::Affine2d::g_registrator' : struct 'ipsdk::math::transform::Affine2d::Registrator' needs to have dll-interface to be used by clients of class 'ipsdk::math::transform::Affine2d'
#pragma warning (push)
#pragma warning (disable : 4251)

#include <IPSDKMath/Geometry/2d/Transform/BaseLinearGeometricTransform2d.h>

namespace ipsdk {
namespace math {
namespace transform {


class IPSDKMATH_API Affine2d : public BaseLinearGeometricTransform2d
{
// predefined public type
public:
    IPSDK_ENUM(eTransformParams,

        (eTP_Axx)       
        (eTP_Axy)       
        (eTP_Ayx)       
        (eTP_Ayy)       
        (eTP_Tx)        
        (eTP_Ty)        
    );

    // declare geometric transformation 2d
    IPSDK_DECLARE_TRANSFORM2D(Affine2d);

public:
    Affine2d() :
        _axx(1), _axy(0), _ayx(0), _ayy(1), _tx(0), _ty(0)
    {
    }
    Affine2d(const ipReal64 axx, const ipReal64 axy,
             const ipReal64 ayx, const ipReal64 ayy,
             const ipReal64 tx, const ipReal64 ty) :
        _axx(axx), _axy(axy), _ayx(ayx), _ayy(ayy), _tx(tx), _ty(ty)
    {
    }
    ~Affine2d() {}

// methods
public:
    static void             transform(const ipReal64 axx, const ipReal64 axy,
                                      const ipReal64 ayx, const ipReal64 ayy,
                                      const ipReal64 tx, const ipReal64 ty,
                                      ipReal64& x, ipReal64& y)
    {
        const ipReal64 xTmp = axx*x + axy*y + tx;
        const ipReal64 yTmp = ayx*x + ayy*y + ty;
        x = xTmp;
        y = yTmp;
    }

    static Matrix3d         getHomogenousMatrix(const ipReal64 axx, const ipReal64 axy,
                                                const ipReal64 ayx, const ipReal64 ayy,
                                                const ipReal64 tx, const ipReal64 ty)
    {
        Matrix3d transform;
        transform(0, 0) = axx; transform(0, 1) = axy; transform(0, 2) = tx;
        transform(1, 0) = ayx; transform(1, 1) = ayy; transform(1, 2) = ty;
        transform(2, 0) = 0;   transform(2, 1) = 0;   transform(2, 2) = 1;

        return transform;
    }

    static Matrix3d         getInvHomogenousMatrix(const ipReal64 axx, const ipReal64 axy,
                                                   const ipReal64 ayx, const ipReal64 ayy,
                                                   const ipReal64 tx, const ipReal64 ty)
    {
        // invert input parameters
        ipReal64 invAxx = axx;
        ipReal64 invAxy = axy;
        ipReal64 invAyx = ayx;
        ipReal64 invAyy = ayy;
        ipReal64 invTx = tx;
        ipReal64 invTy = ty;
        getInvParams(invAxx, invAxy, invAyx, invAyy, invTx, invTy);

        return getHomogenousMatrix(invAxx, invAxy, invAyx, invAyy, invTx, invTy);
    }

    static void             getInvParams(ipReal64& axx, ipReal64& axy,
                                         ipReal64& ayx, ipReal64& ayy,
                                         ipReal64& tx, ipReal64& ty);

    static Vector           getIdentityParams();

    void                    setParams(const ipReal64 axx, const ipReal64 axy,
                                      const ipReal64 ayx, const ipReal64 ayy,
                                      const ipReal64 tx, const ipReal64 ty)
    {
        _axx = axx;
        _axy = axy;
        _ayx = ayx;
        _ayy = ayy;
        _tx = tx;
        _ty = ty;
    }

    void                    setParams(const Vector& params);

    void                    setIdentity();

    void                    apply(ipReal64& x, ipReal64& y) const;

    Matrix3d                getHomogenousMatrix() const;

    Vector                  getParams() const;

    Matrix3d                getInvHomogenousMatrix() const;

    Vector                  getInvParams() const;

// attributes
protected:
    ipReal64        _axx;
    ipReal64        _axy;
    ipReal64        _ayx;
    ipReal64        _ayy;

    ipReal64        _tx;

    ipReal64        _ty;
};


inline void
Affine2d::setIdentity()
{
    setParams(getIdentityParams());
}


} // end of namespace transform
} // end of namespace math
} // end of namespace ipsdk

#pragma warning (pop)

#endif // __IPSDKMATH_AFFINE2D_H__