mrpt::utils::CMappedImage Class Reference

Detailed Description

This class encapsulates a MRPT Image and allows the sampling of individual pixels with sub-pixel accuracy and with a change of coordinates (eg, meters).

Only work with graylevels (for convenience), so if a color image is passed it'll be passed first to grayscale.

See also

CImage

Definition at line 24 of file CMappedImage.h.

#include <mrpt/utils/CMappedImage.h>

Public Member Functions
	CMappedImage (CImagePtr img, double x0=0, double x1=-1, double y0=0, double y1=-1, TInterpolationMethod method=IMG_INTERP_LINEAR)
	Constructor: Must pass an image (as a smart pointer) and the coordinates of the border. More...
void	changeCoordinates (double x0, double x1, double y0, double y1)
	Changes the coordinates of the image (see constructor for the meaning) More...
double	getPixel (double x, double y) const
	Returns the interpolated pixel at the coordinates (x,y), in the range [0,255] (grayscale) If the point is out of the image, 0 is returned. More...

Protected Attributes
CImagePtr	m_img
double	m_x0
double	m_x1
double	m_y0
double	m_y1
double	m_pixel_size
	width * pixel_size = (x1-x0) More...
TInterpolationMethod	m_method

Constructor & Destructor Documentation

CMappedImage()

CMappedImage::CMappedImage	(	CImagePtr	img,
		double	x0 = 0,
		double	x1 = -1,
		double	y0 = 0,
		double	y1 = -1,
		TInterpolationMethod	method = IMG_INTERP_LINEAR
	)

Constructor: Must pass an image (as a smart pointer) and the coordinates of the border.

Parameters

img	The image. A copy of the smart pointer is kept internally to this object.
x0	Coordinate X of the left side (default: 0)
x1	Coordinate X of the right side (or -1 to IMAGE_WIDTH-1)
y0	Coordinate Y of the top side (default: 0)
y1	Coordinate Y of the bottom side (or -1 to IMAGE_HEIGHT-1)
method	The interpolation method: It can be imNEAREST, imBILINEAR or imBICUBIC.

Definition at line 23 of file CMappedImage.cpp.

References changeCoordinates(), and m_img.

Member Function Documentation

changeCoordinates()

void CMappedImage::changeCoordinates	(	double	x0,
		double	x1,
		double	y0,
		double	y1
	)

Changes the coordinates of the image (see constructor for the meaning)

Definition at line 45 of file CMappedImage.cpp.

References ASSERT_, m_img, m_pixel_size, m_x0, m_x1, m_y0, m_y1, MRPT_END, and MRPT_START.

Referenced by CMappedImage().

getPixel()

double CMappedImage::getPixel	(	double	x,
		double	y
	)		const

Returns the interpolated pixel at the coordinates (x,y), in the range [0,255] (grayscale) If the point is out of the image, 0 is returned.

Definition at line 70 of file CMappedImage.cpp.

References mrpt::utils::IMG_INTERP_AREA, mrpt::utils::IMG_INTERP_CUBIC, mrpt::utils::IMG_INTERP_LINEAR, mrpt::utils::IMG_INTERP_NN, m_img, m_method, m_pixel_size, m_x0, m_y0, mrpt::utils::round(), and THROW_EXCEPTION.

Member Data Documentation

m_img

CImagePtr mrpt::utils::CMappedImage::m_img

protected

Definition at line 27 of file CMappedImage.h.

Referenced by changeCoordinates(), CMappedImage(), and getPixel().

m_method

TInterpolationMethod mrpt::utils::CMappedImage::m_method

protected

Definition at line 30 of file CMappedImage.h.

Referenced by getPixel().

m_pixel_size

double mrpt::utils::CMappedImage::m_pixel_size

protected

width * pixel_size = (x1-x0)

Definition at line 29 of file CMappedImage.h.

Referenced by changeCoordinates(), and getPixel().

m_x0

double mrpt::utils::CMappedImage::m_x0

protected

Definition at line 28 of file CMappedImage.h.

Referenced by changeCoordinates(), and getPixel().

m_x1

double mrpt::utils::CMappedImage::m_x1

protected

Definition at line 28 of file CMappedImage.h.

Referenced by changeCoordinates().

m_y0

double mrpt::utils::CMappedImage::m_y0

protected

Definition at line 28 of file CMappedImage.h.

Referenced by changeCoordinates(), and getPixel().

m_y1

double mrpt::utils::CMappedImage::m_y1

protected

Definition at line 28 of file CMappedImage.h.

Referenced by changeCoordinates().