vpgl_lens_distortion.h

Go to the documentation of this file.

// This is core/vpgl/vpgl_lens_distortion.h
#ifndef vpgl_lens_distortion_h_
#define vpgl_lens_distortion_h_
//:
// \file
// \brief An abstract base class for all lens distortions.
// \author Matt Leotta
// \date August 19, 2005
//
//   A lens distortion is a 2D warping of the image plane to account for lens effects
//   not accounted for by the simple camera models.  It is assumed that the map is
//   bijective, though a closed form solution for the inverse may not exist in general.
//   A default iterative solver is provided to solve for the inverse mapping.
//   Currently the iterative solver has only been implemented for the specialized
//   radial symmetric case in derived class vpgl_radial_distortion.

//: forward declare vgl_homg_point_2d<T> and vgl_vector_2d<T>
#include <vgl/vgl_fwd.h>
#include "vcl_compiler_detection.h"

//: A base class for lens distortions
template <class T>
class vpgl_lens_distortion
{
 public:

  virtual ~vpgl_lens_distortion()= default;

  //: Distort a projected point on the image plane
  virtual vgl_homg_point_2d<T> distort( const vgl_homg_point_2d<T>& point ) const = 0;

  //: Return the original point that was distorted to this location (inverse of distort)
  // \param init is an initial guess at the solution for the iterative solver
  // if \p init is NULL then \p point is used as the initial guess
  virtual vgl_homg_point_2d<T> undistort( const vgl_homg_point_2d<T>& point,
                                          const vgl_homg_point_2d<T>* init=nullptr) const;

  //: Set a translation to apply before of after distortion
  // This is needed when distorting an image to translate the resulting image
  // such that all points have positive indices
  virtual void set_translation(const vgl_vector_2d<T>& offset, bool after = true) = 0;
};


#endif // vpgl_lens_distortion_h_