![]() |
Visual Servoing Platform
version 3.3.0
|
#include <vpPolygon.h>
Public Types | |
enum | PointInPolygonMethod { PnPolySegmentIntersection, PnPolyRayCasting } |
Public Member Functions | |
vpPolygon () | |
vpPolygon (const std::vector< vpImagePoint > &corners) | |
vpPolygon (const std::list< vpImagePoint > &corners) | |
vpPolygon (const vpPolygon &poly) | |
virtual | ~vpPolygon () |
vpPolygon & | operator= (const vpPolygon &poly) |
void | buildFrom (const std::vector< vpImagePoint > &corners) |
void | buildFrom (const std::list< vpImagePoint > &corners) |
void | buildFrom (const std::vector< vpPoint > &corners, const vpCameraParameters &cam) |
unsigned int | getSize () const |
void | initClick (const vpImage< unsigned char > &I, unsigned int size=5, const vpColor &color=vpColor::red, unsigned int thickness=1) |
void | initClick (const vpImage< vpRGBa > &I, unsigned int size=5, const vpColor &color=vpColor::red, unsigned int thickness=1) |
bool | isInside (const vpImagePoint &iP, const PointInPolygonMethod &method=PnPolyRayCasting) const |
void | display (const vpImage< unsigned char > &I, const vpColor &color, unsigned int thickness=1) const |
const std::vector< vpImagePoint > & | getCorners () const |
double | getArea () const |
vpImagePoint | getCenter () const |
vpRect | getBoundingBox () const |
Static Public Member Functions | |
static bool | isInside (const std::vector< vpImagePoint > &roi, const double &i, const double &j, const PointInPolygonMethod &method=PnPolyRayCasting) |
Protected Member Functions | |
void | init (const std::vector< vpImagePoint > &corners) |
void | init (const std::list< vpImagePoint > &corners) |
void | updateArea () |
void | updateCenter () |
void | updateBoundingBox () |
Protected Attributes | |
std::vector< vpImagePoint > | _corners |
vpImagePoint | _center |
double | _area |
bool | _goodPoly |
vpRect | _bbox |
Defines a generic 2D polygon.
A polygon is internally represented by N 2D points.
By default three coordinates in the frame (see vpImagePoint class documentation for more details about the frame) are used
,
and
.
The code bellow shows how to manipulate a polygon.
Definition at line 102 of file vpPolygon.h.
Enumerator | |
---|---|
PnPolySegmentIntersection | Legacy Point In Polygon test. |
PnPolyRayCasting | Point In Polygon test using ray casting method (faster). |
Definition at line 119 of file vpPolygon.h.
vpPolygon::vpPolygon | ( | ) |
Default constructor that creates an empty polygon.
Definition at line 50 of file vpPolygon.cpp.
|
explicit |
Constructor which initialises the polygon thanks to the given corners.
corners | : The Points defining the corners. |
Definition at line 63 of file vpPolygon.cpp.
|
explicit |
Constructor which initialises the polygon thanks to the given corners.
corners | : The Points defining the corners. |
Definition at line 80 of file vpPolygon.cpp.
vpPolygon::vpPolygon | ( | const vpPolygon & | poly | ) |
Copy constructor
poly | : The polygon used for the initialisation. |
Definition at line 94 of file vpPolygon.cpp.
|
virtual |
Basic destructor
Definition at line 103 of file vpPolygon.cpp.
void vpPolygon::buildFrom | ( | const std::list< vpImagePoint > & | corners | ) |
Initialises the polygon thanks to the collection of 2D points (in pixel).
corners | : The corners of the polyon. |
Definition at line 140 of file vpPolygon.cpp.
void vpPolygon::buildFrom | ( | const std::vector< vpImagePoint > & | corners | ) |
Initialises the triangle thanks to the collection of 2D points (in pixel).
corners | : The corners of the polyon. |
Definition at line 130 of file vpPolygon.cpp.
void vpPolygon::buildFrom | ( | const std::vector< vpPoint > & | corners, |
const vpCameraParameters & | cam | ||
) |
Initialises the triangle thanks to the collection of 2D points (in meter). The fields x and y are used to compute the corresponding coordinates in pixel thanks to the camera parameters cam.
corners | : The corners of the polyon. |
cam | : The camera parameters used to convert the coordinates from meter to pixel. |
Definition at line 154 of file vpPolygon.cpp.
void vpPolygon::display | ( | const vpImage< unsigned char > & | I, |
const vpColor & | color, | ||
unsigned int | thickness = 1 |
||
) | const |
Display the polygon in the image (overlay, so the image is not modified). A call to the flush() method is necessary.
I | : The image where the polygon is displayed. |
color | : The color of the polygon's lines. |
thickness | : The thickness of the polygon's lines. |
Definition at line 514 of file vpPolygon.cpp.
|
inline |
Return the area of the polygon. The area is computed when the polygon is built from the corners.
Definition at line 160 of file vpPolygon.h.
|
inline |
Return the bounding box. The bounding box is the smallest rectangle containing all the polygon.
Definition at line 176 of file vpPolygon.h.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), and vpMbtFaceDepthNormal::computeDesiredFeatures().
|
inline |
Return the center of the polygon. The center is computed when the polygon is built from the corners.
Definition at line 168 of file vpPolygon.h.
|
inline |
Get the corners of the polygon.
Definition at line 152 of file vpPolygon.h.
unsigned int vpPolygon::getSize | ( | ) | const |
Return number of corners belonging to the polygon.
Definition at line 543 of file vpPolygon.cpp.
|
protected |
Intialises the polygon using the collection of image points. This method computes some internal variables such as center, area, ...
corners | : The corners of the polygon. |
Definition at line 250 of file vpPolygon.cpp.
|
protected |
Intialises the polygon using the collection of image points. This method computes some internal variables such as center, area, ...
corners | : The corners of the polygon. |
Definition at line 230 of file vpPolygon.cpp.
void vpPolygon::initClick | ( | const vpImage< unsigned char > & | I, |
unsigned int | size = 5 , |
||
const vpColor & | color = vpColor::red , |
||
unsigned int | thickness = 1 |
||
) |
Initialises the polygon by (left-)clicking to add a corners to the polygon. A right click is used to stop the addition of new corners.
I | : The image where to click to initialise the corners. |
size | : Cross size in terms of number of pixels that is displayed over a polygon corner. |
color | : Color used to display the cross over the polygon corner. |
thickness | : Thickness used to display the cross. |
Definition at line 172 of file vpPolygon.cpp.
void vpPolygon::initClick | ( | const vpImage< vpRGBa > & | I, |
unsigned int | size = 5 , |
||
const vpColor & | color = vpColor::red , |
||
unsigned int | thickness = 1 |
||
) |
Initialises the polygon by (left-)clicking to add a corners to the polygon. A right click is used to stop the addition of new corners.
I | : The image where to click to initialise the corners. |
size | : Size of the cross in terms of number of pixels that is displayed over a polygon corner. |
color | : Color used to display the cross over the polygon corner. |
thickness | : Thickness used to display the cross. |
Definition at line 202 of file vpPolygon.cpp.
|
static |
Test if an image point is inside a 2D polygon.
roi | : List of the polygon corners. |
i | : i-coordinate of the image point to test. |
j | : j-coordinate of the image point to test. |
method | : Method to use for Point In Polygon test. |
Definition at line 533 of file vpPolygon.cpp.
bool vpPolygon::isInside | ( | const vpImagePoint & | ip, |
const PointInPolygonMethod & | method = PnPolyRayCasting |
||
) | const |
Check if the 2D point is inside the polygon.
ip | : The point which have to be tested. |
method | : Method to use for Point In Polygon test. |
Definition at line 308 of file vpPolygon.cpp.
Referenced by vpMbtFaceDepthDense::computeDesiredFeatures(), and vpMbtFaceDepthNormal::computeDesiredFeatures().
Equal operator.
Assign poly to this polygon and return a reference to it.
Definition at line 110 of file vpPolygon.cpp.
|
protected |
Update the _area
attribute of the polygon using the corners.
The area is computed using the formula:
Definition at line 404 of file vpPolygon.cpp.
|
protected |
Update bounding box of the polygon.
Definition at line 477 of file vpPolygon.cpp.
|
protected |
Update the _center
attribute of the polygon using the corners.
The i coordinate is computed using:
The computation of the j coordinate is similar.
Definition at line 435 of file vpPolygon.cpp.
|
protected |
Area of the polygon.
Definition at line 111 of file vpPolygon.h.
|
protected |
Bounding box containing the polygon.
Definition at line 116 of file vpPolygon.h.
|
protected |
Center of the polygon. It is automatically computed when the corners are set.
Definition at line 109 of file vpPolygon.h.
|
protected |
Collection of image points containing the corners.
Definition at line 106 of file vpPolygon.h.
|
protected |
Flag set to true when the polygon is a good polygon (ie. it has more than two corners) or false otherwise.
Definition at line 114 of file vpPolygon.h.