#include <vpRect.h>

Public Member Functions
	vpRect ()

	vpRect (double left, double top, double width, double height)

	vpRect (const vpImagePoint &topLeft, double width, double height)

	vpRect (const vpImagePoint &topLeft, const vpImagePoint &bottomRight)

	vpRect (const vpRect &r)

	vpRect (const std::vector< vpImagePoint > &ip)

vpRect &	operator= (const vpRect &r)

double	getBottom () const

vpImagePoint	getBottomRight () const

void	getCenter (double &x, double &y) const

vpImagePoint	getCenter () const

double	getHeight () const

double	getLeft () const

double	getRight () const

double	getTop () const

vpImagePoint	getTopLeft () const

double	getWidth () const

void	set (const std::vector< vpImagePoint > &ip)

void	setBottom (double pos)

void	setBottomRight (const vpImagePoint &bottomRight)

void	setHeight (double h)

void	setLeft (double pos)

void	setRect (double l, double t, double w, double h)

void	setRight (double pos)

void	setTop (double pos)

void	setTopLeft (const vpImagePoint &topLeft)

void	setWidth (double w)

void	moveCenter (double x, double y)

Friends
VISP_EXPORT bool	inRectangle (const vpImagePoint &ip, const vpRect &rect)

VISP_EXPORT std::ostream &	operator<< (std::ostream &os, const vpRect &r)

Detailed Description

Defines a rectangle in the plane.

A rectangle is internally represented as an upper-left corner and a width and height, but it is normally expressed as an upper-left corner and bottom-right corner.

Note that the size (width and height) of a rectangle might be different from what you are used to. If the top-left corner and the bottom-right corner are the same, the height and the width of the rectangle will both be 1.

Generally, width = right - left + 1 and height = bottom - top +

We designed it this way to make it correspond to rectangular spaces used by drawing functions in which the width and height denote a number of pixels. For example, drawing a rectangle with width and height 1 draws a single pixel.

The default coordinate system has origin (0, 0) in the top-left corner. The positive direction of the y axis is down, and the positive x axis is from left to right.

A vpRect can be constructed with a set of left, top, width and height double. After creation the dimensions can be changed, e.g. with setLeft(), setRight(), setTop() and setBottom(), or by setting sizes, e.g. setWidth(), setHeight()

Examples:: fernClassifier.cpp, planarObjectDetector.cpp, testCreateSubImage.cpp, and testDisplays.cpp.

Definition at line 85 of file vpRect.h.

Constructor & Destructor Documentation

vpRect::vpRect ( )

Constructs a default rectangle with the top, left corner set to (0,0) and width and height set to 1.

Definition at line 59 of file vpRect.cpp.

vpRect::vpRect	(	double	l,
		double	t,
		double	w,
		double	h
	)

Constructs a rectangle with the top, left corner and width and height.

Definition at line 67 of file vpRect.cpp.

vpRect::vpRect	(	const vpImagePoint &	topLeft,
		double	w,
		double	h
	)

Constructs a rectangle with topLeft the top-left corner location and width and height the rectangle size.

Definition at line 78 of file vpRect.cpp.

vpRect::vpRect	(	const vpImagePoint &	topLeft,
		const vpImagePoint &	bottomRight
	)

Constructs a rectangle with topLeft the top-left corner location and bottomRight the bottom-right corner.

Definition at line 89 of file vpRect.cpp.

References vpImagePoint::get_u(), vpImagePoint::get_v(), setBottom(), and setRight().

vpRect::vpRect ( const vpRect & r )

Constructs a rectangle that is a copy of r.

Definition at line 104 of file vpRect.cpp.

vpRect::vpRect ( const std::vector< vpImagePoint > & ip )

Create a rectangle as the bounding box of a vector of image points.

Parameters

ip	: Vector of image points. At least 1 points is mandatory, otherwise an exception is thrown.

Definition at line 129 of file vpRect.cpp.

References set().

Member Function Documentation

double vpRect::getBottom ( ) const

inline

Returns the bottom coordinate of the rectangle.

See also: getRight()

Definition at line 103 of file vpRect.h.

Referenced by vpImageTools::createSubImage(), vpDisplayOpenCV::displayRectangle(), vpImageSimulator::getImage(), vpImagePoint::inRectangle(), and vpDot2::searchDotsInArea().

vpImagePoint vpRect::getBottomRight ( ) const

inline

Returns the bottom-right coordinate of the rectangle.

See also: getTopLeft(), getBottom(), getRight()

Definition at line 108 of file vpRect.h.

References vpImagePoint::set_u(), and vpImagePoint::set_v().

void vpRect::getCenter	(	double &	x,
		double &	y
	)		const

inline

Returns the center point of the rectangle. The center point coordinates are (x, y)

The default coordinate system has origin (0, 0) in the top-left corner. The positive direction of the y axis is down, and the positive x axis is from left to right.

See also: moveCenter()

Definition at line 126 of file vpRect.h.

vpImagePoint vpRect::getCenter ( ) const

inline

Returns the center point of the rectangle. The center point coordinates are (x, y)

The default coordinate system has origin (0, 0) in the top-left corner. The positive direction of the y axis is down, and the positive x axis is from left to right.

See also: moveCenter()

Definition at line 141 of file vpRect.h.

References vpImagePoint::set_u(), and vpImagePoint::set_v().

double vpRect::getHeight ( ) const

inline

Returns the height of the rectangle. The height includes both the top and bottom edges, i.e. height = bottom - top + 1.

See also: getWidth()

Definition at line 155 of file vpRect.h.

Referenced by vpPlanarObjectDetector::buildReference(), vpKeyPointSurf::buildReference(), vpFernClassifier::buildReference(), vpDisplayWin32::displayRectangle(), vpDisplayX::displayRectangle(), vpDisplayGTK::displayRectangle(), vpDisplay::displayROI(), vpDisplay::flushROI(), vpPlanarObjectDetector::matchPoint(), vpKeyPointSurf::matchPoint(), and vpFernClassifier::matchPoint().

double vpRect::getLeft ( ) const

inline

Returns the left coordinate of the rectangle.

See also: getTopLeft(), getRight()

Definition at line 161 of file vpRect.h.

Referenced by vpKeyPointSurf::buildReference(), vpFernClassifier::buildReference(), vpImageTools::createSubImage(), vpDisplayWin32::displayRectangle(), vpDisplayOpenCV::displayRectangle(), vpDisplayX::displayRectangle(), vpDisplayGTK::displayRectangle(), vpDisplay::displayROI(), vpImageSimulator::getImage(), vpImagePoint::inRectangle(), vpPlanarObjectDetector::matchPoint(), vpKeyPointSurf::matchPoint(), vpFernClassifier::matchPoint(), and vpDot2::searchDotsInArea().

double vpRect::getRight ( ) const

inline

Returns the right coordinate of the rectangle.

See also: getLeft()

Definition at line 167 of file vpRect.h.

Referenced by vpImageTools::createSubImage(), vpDisplayOpenCV::displayRectangle(), vpImageSimulator::getImage(), vpImagePoint::inRectangle(), and vpDot2::searchDotsInArea().

double vpRect::getTop ( ) const

inline

Returns the top coordinate of the rectangle.

See also: getTopLeft(), getBottom()

Definition at line 174 of file vpRect.h.

Referenced by vpKeyPointSurf::buildReference(), vpFernClassifier::buildReference(), vpImageTools::createSubImage(), vpDisplayWin32::displayRectangle(), vpDisplayOpenCV::displayRectangle(), vpDisplayX::displayRectangle(), vpDisplayGTK::displayRectangle(), vpDisplay::displayROI(), vpImageSimulator::getImage(), vpImagePoint::inRectangle(), vpPlanarObjectDetector::matchPoint(), vpKeyPointSurf::matchPoint(), vpFernClassifier::matchPoint(), and vpDot2::searchDotsInArea().

vpImagePoint vpRect::getTopLeft ( ) const

inline

Returns the top-left position of the rectangle.

See also: getBottomRight(), getTop(), getLeft()

Definition at line 180 of file vpRect.h.

References vpImagePoint::set_u(), and vpImagePoint::set_v().

Referenced by vpPlanarObjectDetector::buildReference(), and vpDisplay::flushROI().

double vpRect::getWidth ( ) const

inline

Returns the width of the rectangle. The width includes both the left and right edges, i.e. width = right - left + 1.

See also: getHeight()

Definition at line 193 of file vpRect.h.

Referenced by vpPlanarObjectDetector::buildReference(), vpKeyPointSurf::buildReference(), vpFernClassifier::buildReference(), vpDisplayWin32::displayRectangle(), vpDisplayX::displayRectangle(), vpDisplayGTK::displayRectangle(), vpDisplay::displayROI(), vpDisplay::flushROI(), vpPlanarObjectDetector::matchPoint(), vpKeyPointSurf::matchPoint(), and vpFernClassifier::matchPoint().

void vpRect::moveCenter	(	double	x,
		double	y
	)

inline

Sets the center point of the rectangle to (x, y), leaving the size unchanged.

See also: getCenter()

Definition at line 300 of file vpRect.h.

vpRect & vpRect::operator= ( const vpRect & r )

Assign r to this rectangle and return a reference to this rectangle.

Definition at line 114 of file vpRect.cpp.

void vpRect::set ( const std::vector< vpImagePoint > & ip )

Set the rectangle as the bounding box of a vector of image points.

Parameters

ip	: Vector of image points. At least 1 points is mandatory, otherwise an exception is thrown.

Definition at line 141 of file vpRect.cpp.

References vpException::dimensionError, setBottom(), setLeft(), setRight(), and setTop().

Referenced by vpRect().

void vpRect::setBottom ( double pos )

inline

Sets the bottom edge position of the rectangle to pos. May change the height of the rectangle, but will never change the top edge position the rectangle.

See also: setTop()

Definition at line 207 of file vpRect.h.

Referenced by set(), and vpRect().

void vpRect::setBottomRight ( const vpImagePoint & bottomRight )

inline

Sets the bottom-right position of the rectangle. Will never change the top-left position the rectangle.

See also: setTopLeft()

Definition at line 215 of file vpRect.h.

References vpImagePoint::get_u(), and vpImagePoint::get_v().

Referenced by vpTemplateTrackerZone::getBoundingBox(), and vpPolygon::updateBoundingBox().

void vpRect::setHeight ( double h )

inline

Sets the height of the rectangle to h. The top edge is not moved, but the bottom edge may be moved.

See also: setWidth()

Examples:: testCreateSubImage.cpp.

Definition at line 226 of file vpRect.h.

void vpRect::setLeft ( double pos )

inline

Sets the left edge position of the rectangle to pos. May change the right edge position of the rectangle, but will never change the width of the rectangle.

See also: setRight()

Examples:: testCreateSubImage.cpp.

Definition at line 236 of file vpRect.h.

Referenced by set().

void vpRect::setRect	(	double	l,
		double	t,
		double	w,
		double	h
	)

inline

Sets the coordinates of the rectangle's top left corner to (left, top), and its size to (width, height).

Parameters

l,t	: (left, top) corner position.
w,h	: (width, height) rectangle size.

Definition at line 246 of file vpRect.h.

Referenced by vpDot2::getBBox(), and vpDot::getBBox().

void vpRect::setRight ( double pos )

inline

Sets the right edge position of the rectangle to pos. May change the width of the rectangle, but will never change the left edge position of the rectangle.

See also: setLeft()

Definition at line 261 of file vpRect.h.

Referenced by set(), and vpRect().

void vpRect::setTop ( double pos )

inline

Sets the top edge position of the rectangle to pos. May change the bottom edge position of the rectangle, but will never change the height of the rectangle.