![]() |
Visual Servoing Platform
version 3.3.0
|
#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) | |
double | getArea () const |
double | getBottom () const |
vpImagePoint | getBottomLeft () const |
vpImagePoint | getBottomRight () const |
void | getCenter (double &x, double &y) const |
vpImagePoint | getCenter () const |
double | getHeight () const |
double | getLeft () const |
double | getRight () const |
double | getSize () const |
double | getTop () const |
vpImagePoint | getTopLeft () const |
vpImagePoint | getTopRight () const |
double | getWidth () const |
bool | isInside (const vpImagePoint &ip) const |
bool | operator== (const vpRect &r) const |
bool | operator!= (const vpRect &r) const |
vpRect & | operator&= (const vpRect &r) |
vpRect & | operator= (const vpRect &r) |
vpRect | operator& (const vpRect &r) const |
void | set (double left, double top, double width, double height) |
void | set (const vpImagePoint &topLeft, double width, double height) |
void | set (const vpImagePoint &topLeft, const vpImagePoint &bottomRight) |
void | set (const vpRect &r) |
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) |
void | moveCenter (const vpImagePoint ¢er) |
Friends | |
VISP_EXPORT bool | inRectangle (const vpImagePoint &ip, const vpRect &rect) |
VISP_EXPORT std::ostream & | operator<< (std::ostream &os, const vpRect &r) |
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 +
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()
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 52 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.
l | : coordinate of the top/left corner along the horizontal axis. |
t | : coordinate of the top/left corner along the vertical axis. |
w | : rectangle width. |
h | : rectangle height. |
Definition at line 63 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.
topLeft | : coordinates of the top/left corner. |
w | : rectangle width. |
h | : rectangle height. |
Definition at line 73 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 82 of file vpRect.cpp.
vpRect::vpRect | ( | const vpRect & | r | ) |
Constructs a rectangle that is a copy of r.
Definition at line 95 of file vpRect.cpp.
|
explicit |
Create a rectangle as the bounding box of a vector of image points.
ip | : Vector of image points. At least 1 points is mandatory, otherwise an exception is thrown. |
Definition at line 115 of file vpRect.cpp.
|
inline |
|
inline |
Returns the bottom coordinate of the rectangle.
Definition at line 96 of file vpRect.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), and vpMbtFaceDepthNormal::computeDesiredFeatures().
|
inline |
Returns the bottom-left position of the rectangle.
|
inline |
Returns the bottom-right coordinate of the rectangle.
|
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.
|
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.
|
inline |
Returns the height of the rectangle. The height includes both the top and bottom edges, i.e. height = bottom - top + 1.
Definition at line 165 of file vpRect.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), vpMbtFaceDepthNormal::computeDesiredFeatures(), and vpImageTools::crop().
|
inline |
Returns the left coordinate of the rectangle.
Definition at line 172 of file vpRect.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), vpMbtFaceDepthNormal::computeDesiredFeatures(), and vpImageTools::crop().
|
inline |
Returns the right coordinate of the rectangle.
Definition at line 178 of file vpRect.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), and vpMbtFaceDepthNormal::computeDesiredFeatures().
|
inline |
Returns the size of the rectangle.
|
inline |
Returns the top coordinate of the rectangle.
Definition at line 191 of file vpRect.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), vpMbtFaceDepthNormal::computeDesiredFeatures(), and vpImageTools::crop().
|
inline |
Returns the top-left position of the rectangle.
|
inline |
Returns the top-right position of the rectangle.
|
inline |
Returns the width of the rectangle. The width includes both the left and right edges, i.e. width = right - left + 1.
Definition at line 226 of file vpRect.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), vpMbtFaceDepthNormal::computeDesiredFeatures(), and vpImageTools::crop().
bool vpRect::isInside | ( | const vpImagePoint & | ip | ) | const |
Returns true if the point belongs to the rectangle.
Check if an image point belongs to the rectangle.
ip | : the image point. |
Definition at line 124 of file vpRect.cpp.
|
inline |
Center the rectangle to the image point given as parameter, leaving the size unchanged.
|
inline |
Sets the center point of the rectangle to (x, y), leaving the size unchanged.
bool vpRect::operator!= | ( | const vpRect & | r | ) | const |
Operator to compare two rectangles.
Definition at line 234 of file vpRect.cpp.
Intersection operator.
Definition at line 276 of file vpRect.cpp.
Intersection operator.
r | : Rectangle to insert. |
Definition at line 255 of file vpRect.cpp.
Assign r to this rectangle and return a reference to this rectangle.
Definition at line 101 of file vpRect.cpp.
bool vpRect::operator== | ( | const vpRect & | r | ) | const |
Operator to compare two rectangles.
Definition at line 220 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.
ip | : Vector of image points. At least 1 points is mandatory, otherwise an exception is thrown. |
Definition at line 167 of file vpRect.cpp.
void vpRect::set | ( | const vpImagePoint & | topLeft, |
const vpImagePoint & | bottomRight | ||
) |
Set the rectangle with topLeft the top-left corner location and bottomRight the bottom-right corner.
topLeft | : coordinates of the top-left corner. |
bottomRight | : coordinates of the bottom-right corner. |
Definition at line 202 of file vpRect.cpp.
void vpRect::set | ( | const vpImagePoint & | topLeft, |
double | w, | ||
double | h | ||
) |
Set the rectangle with topLeft the top-left corner location and width and height the rectangle size.
topLeft | : coordinates of the top-left corner. |
w | : rectangle width. |
h | : rectangle height. |
Definition at line 154 of file vpRect.cpp.
void vpRect::set | ( | const vpRect & | r | ) |
Set the rectangle from r.
Definition at line 214 of file vpRect.cpp.
void vpRect::set | ( | double | l, |
double | t, | ||
double | w, | ||
double | h | ||
) |
Set the rectangle with the top, left corner and width and height.
l | : coordinate of the top/left corner along the horizontal axis. |
t | : coordinate of the top/left corner along the vertical axis. |
w | : rectangle width. |
h | : rectangle height. |
Definition at line 138 of file vpRect.cpp.
|
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.
Definition at line 255 of file vpRect.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), and vpMbtFaceDepthNormal::computeDesiredFeatures().
|
inline |
Sets the bottom-right position of the rectangle. Will never change the top-left position the rectangle.
|
inline |
Sets the height of the rectangle to h. The top edge is not moved, but the bottom edge may be moved.
|
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.
Definition at line 288 of file vpRect.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), and vpMbtFaceDepthNormal::computeDesiredFeatures().
|
inline |
Sets the coordinates of the rectangle's top left corner to (left, top), and its size to (width, height).
l | : horizontal position of the rectangle upper/left corner position. |
t | : vertical position of the rectangle upper/left corner position. |
w | : rectangle width. |
h | : rectangle height. |
|
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.
Definition at line 315 of file vpRect.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), and vpMbtFaceDepthNormal::computeDesiredFeatures().
|
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.
Definition at line 324 of file vpRect.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), and vpMbtFaceDepthNormal::computeDesiredFeatures().
|
inline |
Sets the top-left position of the rectangle. May change the bottom edge position of the rectangle, but will never change the height of the rectangle.
|
inline |
Sets the width of the rectangle to w. The right edge is changed, but not the left edge.
|
friend |
Check if an image point belongs to a rectangle.
ip | : the image point. |
rect | : the rectangle. |
Definition at line 290 of file vpRect.cpp.
|
friend |
Definition at line 296 of file vpRect.cpp.