Main MRPT website > C++ reference for MRPT 1.5.6
List of all members | Public Member Functions | Private Attributes
mrpt::vision::CUndistortMap Class Reference

Detailed Description

Use this class to undistort monocular images if the same distortion map is used over and over again.

Using this class is much more efficient that calling mrpt::utils::CImage::rectifyImage or OpenCV's cvUndistort2(), since the remapping data is computed only once for the camera parameters (typical times: 640x480 image -> 70% build map / 30% actual undistort).

Works with grayscale or color images.

Example of usage:

unmap.setFromCamParams( cam_params );
while (true) {
unmap.undistort(img, img_out); // or:
unmap.undistort(img); // output in place
}
See also
CStereoRectifyMap, mrpt::utils::TCamera, the application camera-calib for calibrating a camera.

Definition at line 46 of file CUndistortMap.h.

#include <mrpt/vision/CUndistortMap.h>

Public Member Functions

 CUndistortMap ()
 Default ctor. More...
 
void setFromCamParams (const mrpt::utils::TCamera &params)
 Prepares the mapping from the distortion parameters of a camera. More...
 
void undistort (const mrpt::utils::CImage &in_img, mrpt::utils::CImage &out_img) const
 Undistort the input image and saves the result in the output one - setFromCamParams() must have been set prior to calling this. More...
 
void undistort (mrpt::utils::CImage &in_out_img) const
 Undistort the input image and saves the result in-place- setFromCamParams() must have been set prior to calling this. More...
 
const mrpt::utils::TCameragetCameraParams () const
 Returns the camera parameters which were used to generate the distortion map, as passed by the user to setFromCamParams. More...
 
bool isSet () const
 Returns true if setFromCamParams() has been already called, false otherwise. More...
 

Private Attributes

std::vector< int16_tm_dat_mapx
 
std::vector< uint16_tm_dat_mapy
 
mrpt::utils::TCamera m_camera_params
 A copy of the data provided by the user. More...
 

Constructor & Destructor Documentation

◆ CUndistortMap()

CUndistortMap::CUndistortMap ( )

Default ctor.

Definition at line 21 of file CUndistortMap.cpp.

Member Function Documentation

◆ getCameraParams()

const mrpt::utils::TCamera& mrpt::vision::CUndistortMap::getCameraParams ( ) const
inline

Returns the camera parameters which were used to generate the distortion map, as passed by the user to setFromCamParams.

Definition at line 65 of file CUndistortMap.h.

◆ isSet()

bool mrpt::vision::CUndistortMap::isSet ( ) const
inline

Returns true if setFromCamParams() has been already called, false otherwise.

Can be used within loops to determine the first usage of the object and when it needs to be initialized.

Definition at line 70 of file CUndistortMap.h.

◆ setFromCamParams()

void CUndistortMap::setFromCamParams ( const mrpt::utils::TCamera campar)

Prepares the mapping from the distortion parameters of a camera.

Must be called before invoking undistort().

Definition at line 29 of file CUndistortMap.cpp.

References mrpt::utils::TCamera::dist, mrpt::utils::TCamera::intrinsicParams, m_camera_params, m_dat_mapx, m_dat_mapy, MRPT_END, MRPT_START, mrpt::utils::TCamera::ncols, mrpt::utils::TCamera::nrows, and THROW_EXCEPTION.

◆ undistort() [1/2]

void CUndistortMap::undistort ( const mrpt::utils::CImage in_img,
mrpt::utils::CImage out_img 
) const

Undistort the input image and saves the result in the output one - setFromCamParams() must have been set prior to calling this.

Undistort the input image and saves the result in-place- setFromCamParams() must have been set prior to calling this.

Definition at line 64 of file CUndistortMap.cpp.

References mrpt::utils::CImage::getAs(), m_camera_params, m_dat_mapx, m_dat_mapy, MRPT_END, MRPT_START, mrpt::utils::TCamera::ncols, mrpt::utils::TCamera::nrows, mrpt::utils::CImage::setFromIplImage(), and THROW_EXCEPTION.

◆ undistort() [2/2]

void CUndistortMap::undistort ( mrpt::utils::CImage in_out_img) const

Undistort the input image and saves the result in-place- setFromCamParams() must have been set prior to calling this.

Definition at line 84 of file CUndistortMap.cpp.

References mrpt::utils::CImage::getAs(), m_camera_params, m_dat_mapx, m_dat_mapy, MRPT_END, MRPT_START, mrpt::utils::TCamera::ncols, mrpt::utils::TCamera::nrows, mrpt::utils::CImage::setFromIplImage(), and THROW_EXCEPTION.

Member Data Documentation

◆ m_camera_params

mrpt::utils::TCamera mrpt::vision::CUndistortMap::m_camera_params
private

A copy of the data provided by the user.

Definition at line 76 of file CUndistortMap.h.

Referenced by setFromCamParams(), and undistort().

◆ m_dat_mapx

std::vector<int16_t> mrpt::vision::CUndistortMap::m_dat_mapx
private

Definition at line 73 of file CUndistortMap.h.

Referenced by setFromCamParams(), and undistort().

◆ m_dat_mapy

std::vector<uint16_t> mrpt::vision::CUndistortMap::m_dat_mapy
private

Definition at line 74 of file CUndistortMap.h.

Referenced by setFromCamParams(), and undistort().




Page generated by Doxygen 1.8.14 for MRPT 1.5.6 Git: 4c65e8431 Tue Apr 24 08:18:17 2018 +0200 at lun oct 28 01:35:26 CET 2019