vpTemplateTrackerWarpAffine.cpp

/*
 * ViSP, open source Visual Servoing Platform software.
 * Copyright (C) 2005 - 2025 by Inria. All rights reserved.
 *
 * This software is free software; you can redistribute it and/or modify
 * it under the terms of the GNU General Public License as published by
 * the Free Software Foundation; either version 2 of the License, or
 * (at your option) any later version.
 * See the file LICENSE.txt at the root directory of this source
 * distribution for additional information about the GNU GPL.
 *
 * For using ViSP with software that can not be combined with the GNU
 * GPL, please contact Inria about acquiring a ViSP Professional
 * Edition License.
 *
 * See https://visp.inria.fr for more information.
 *
 * This software was developed at:
 * Inria Rennes - Bretagne Atlantique
 * Campus Universitaire de Beaulieu
 * 35042 Rennes Cedex
 * France
 *
 * If you have questions regarding the use of this file, please contact
 * Inria at visp@inria.fr
 *
 * This file is provided AS IS with NO WARRANTY OF ANY KIND, INCLUDING THE
 * WARRANTY OF DESIGN, MERCHANTABILITY AND FITNESS FOR A PARTICULAR PURPOSE.
 *
 * Description:
 * Template tracker.
 *
 * Authors:
 * Amaury Dame
 * Aurelien Yol
 */
#include <visp3/tt/vpTemplateTrackerWarpAffine.h>
 
BEGIN_VISP_NAMESPACE
  vpTemplateTrackerWarpAffine::vpTemplateTrackerWarpAffine() { nbParam = 6; }

void vpTemplateTrackerWarpAffine::getParamPyramidDown(const vpColVector &p, vpColVector &p_down)
{
  p_down[0] = p[0];
  p_down[1] = p[1];
  p_down[2] = p[2];
  p_down[3] = p[3];
  p_down[4] = p[4] / 2.;
  p_down[5] = p[5] / 2.;
}

void vpTemplateTrackerWarpAffine::getParamPyramidUp(const vpColVector &p, vpColVector &p_up)
{
  p_up[0] = p[0];
  p_up[1] = p[1];
  p_up[2] = p[2];
  p_up[3] = p[3];
  p_up[4] = p[4] * 2.;
  p_up[5] = p[5] * 2.;
}

void vpTemplateTrackerWarpAffine::getdW0(const int &v, const int &u, const double &dv, const double &du, double *dIdW)
{
  dIdW[0] = u * du;
  dIdW[1] = u * dv;
  dIdW[2] = v * du;
  dIdW[3] = v * dv;
  dIdW[4] = du;
  dIdW[5] = dv;
}

void vpTemplateTrackerWarpAffine::getdWdp0(const int &v, const int &u, double *dIdW)
{
  dIdW[0] = u;
  dIdW[1] = 0;
  dIdW[2] = v;
  dIdW[3] = 0;
  dIdW[4] = 1.;
  dIdW[5] = 0;
 
  dIdW[6] = 0;
  dIdW[7] = u;
  dIdW[8] = 0;
  dIdW[9] = v;
  dIdW[10] = 0;
  dIdW[11] = 1.;
}

void vpTemplateTrackerWarpAffine::warpX(const int &v1, const int &u1, double &v2, double &u2, const vpColVector &p)
{
  u2 = (1 + p[0]) * u1 + p[2] * v1 + p[4];
  v2 = p[1] * u1 + (1 + p[3]) * v1 + p[5];
}

void vpTemplateTrackerWarpAffine::warpX(const vpColVector &X1, vpColVector &X2, const vpColVector &p)
{
  X2[0] = (1.0 + p[0]) * X1[0] + p[2] * X1[1] + p[4];
  X2[1] = p[1] * X1[0] + (1.0 + p[3]) * X1[1] + p[5];
}

void vpTemplateTrackerWarpAffine::dWarp(const vpColVector &X, const vpColVector &, const vpColVector &, vpMatrix &dM)
{
  double u = X[0];
  double v = X[1];
 
  dM[0][0] = u;
  dM[0][1] = 0;
  dM[0][2] = v;
  dM[0][3] = 0;
  dM[0][4] = 1;
  dM[0][5] = 0;
  dM[1][0] = 0;
  dM[1][1] = u;
  dM[1][2] = 0;
  dM[1][3] = v;
  dM[1][4] = 0;
  dM[1][5] = 1;
}

void vpTemplateTrackerWarpAffine::dWarpCompo(const vpColVector &, const vpColVector &, const vpColVector &p,
                                             const double *dwdp0, vpMatrix &dM)
{
  for (unsigned int i = 0; i < nbParam; i++) {
    dM[0][i] = (1. + p[0]) * dwdp0[i] + p[2] * dwdp0[i + nbParam];
    dM[1][i] = p[1] * dwdp0[i] + (1. + p[3]) * dwdp0[i + nbParam];
  }
}

void vpTemplateTrackerWarpAffine::warpXInv(const vpColVector &X1, vpColVector &X2, const vpColVector &p)
{
  X2[0] = (1 + p[0]) * X1[0] + p[2] * X1[1] + p[4];
  X2[1] = p[1] * X1[0] + (1 + p[3]) * X1[1] + p[5];
}

void vpTemplateTrackerWarpAffine::getParamInverse(const vpColVector &p, vpColVector &p_inv) const
{
  double u = p[4];
  double v = p[5];
  double r_00 = 1 + p[0], r_01 = p[2];
  double r_10 = p[1], r_11 = 1 + p[3];
  double det = r_00 * r_11 - r_01 * r_10;
  if (std::fabs(det) < std::numeric_limits<double>::epsilon()) {
    throw(vpException(vpException::fatalError, "In vpTemplateTrackerWarpAffine::getParamInverse() "
                      "cannot inverse 2-by-2 matrix. Matrix determinant is 0."));
  }
 
  double ri_11 = r_00 / det;
  double ri_00 = r_11 / det;
  double ri_01 = -r_01 / det;
  double ri_10 = -r_10 / det;
 
  p_inv[0] = ri_00 - 1;
  p_inv[1] = ri_10;
  p_inv[2] = ri_01;
  p_inv[3] = ri_11 - 1;
  p_inv[4] = -(ri_00 * u + ri_01 * v);
  p_inv[5] = -(ri_10 * u + ri_11 * v);
}

void vpTemplateTrackerWarpAffine::pRondp(const vpColVector &p1, const vpColVector &p2, vpColVector &p12) const
{
  double r1_00 = 1 + p1[0], r1_01 = p1[2];
  double r1_10 = p1[1], r1_11 = 1 + p1[3];
  double r2_00 = 1 + p2[0], r2_01 = p2[2];
  double r2_10 = p2[1], r2_11 = 1 + p2[3];
  double u1 = p1[4];
  double v1 = p1[5];
  double u2 = p2[4];
  double v2 = p2[5];
 
  p12[0] = r1_00 * r2_00 + r1_01 * r2_10 - 1.;
  p12[1] = r1_10 * r2_00 + r1_11 * r2_10;
  p12[2] = r1_00 * r2_01 + r1_01 * r2_11;
  p12[3] = r1_10 * r2_01 + r1_11 * r2_11 - 1.;
  p12[4] = r1_00 * u2 + r1_01 * v2 + u1;
  p12[5] = r1_10 * u2 + r1_11 * v2 + v1;
}
END_VISP_NAMESPACE