ViSP  2.9.0
Public Member Functions | Public Attributes | Friends | List of all members
vpPlane Class Reference
ViSP capabilities » Mathematics » Geometry » Plane

#include <vpPlane.h>

Public Member Functions

 vpPlane ()
 
 vpPlane (const vpPlane &P)
 
 vpPlane (const double A, const double B, const double C, const double D)
 
 vpPlane (const vpPoint &P, const vpColVector &n)
 
 vpPlane (const vpPoint &P, const vpPoint &Q, const vpPoint &R)
 
void init (const vpPoint &P, const vpPoint &Q, const vpPoint &R)
 
void init (const vpColVector &P, const vpColVector &n)
 
void init (const vpPlane &P)
 
void setA (const double a)
 
void setB (const double b)
 
void setC (const double c)
 
void setD (const double d)
 
void setABCD (const double a, const double b, const double c, const double d)
 
vpPlane & operator= (const vpPlane &f)
 
double getA () const
 
double getB () const
 
double getC () const
 
double getD () const
 
vpColVector getABCD () const
 
vpColVector abcd () const
 
vpColVector getNormal () const
 
void getNormal (vpColVector &n) const
 
void projectionPointOnPlan (const vpPoint &P, vpPoint &Pproj) const
 
double rayIntersection (const vpPoint &M0, const vpPoint &M1, vpColVector &H) const
 
double getIntersection (const vpColVector &M1, vpColVector &H) const
 
void changeFrame (const vpHomogeneousMatrix &cMo)
 

Public Attributes

double A
 
double B
 
double C
 
double D
 

Friends

VISP_EXPORT std::ostream & operator<< (std::ostream &os, vpPlane &p)
 

Detailed Description

This class defines the container for a plane geometrical structure.

A plane is given by the equation $Ax + By + Cz + D = 0$ where (x,y,z) are the coordinates of a point and where $[A,B,C]^T$ is a normal vector of the plane.

Examples:
homographyHartleyDLT2DObject.cpp, homographyHLM2DObject.cpp, homographyHLM3DObject.cpp, homographyRansac2DObject.cpp, manServoMomentsSimple.cpp, servoMomentImage.cpp, servoMomentPoints.cpp, servoMomentPolygon.cpp, and testDisplacement.cpp.

Definition at line 67 of file vpPlane.h.

Constructor & Destructor Documentation

vpPlane::vpPlane ( )

Basic constructor that set the plane parameters A, B, C, D to zero.

Definition at line 71 of file vpPlane.cpp.

vpPlane::vpPlane ( const vpPlane &  P)

Copy constructor.

Definition at line 89 of file vpPlane.cpp.

References getA(), getB(), getC(), getD(), setA(), setB(), setC(), and setD().

vpPlane::vpPlane ( const double  a,
const double  b,
const double  c,
const double  d 
)

Plane constructor from A, B, C, D parameters.

A plane is given by the equation $Ax + By + Cz + D = 0$ where (x,y,z) are the coordinates of a point and $[A,B,C]^T$ is the normal vector of the plane.

Parameters
a,b,c,d: Parameters of the plane.

Definition at line 83 of file vpPlane.cpp.

vpPlane::vpPlane ( const vpPoint &  P,
const vpColVector &  n 
)

Plane constructor from a point P on the plane and the normal n to the plane.

A plane is given by the equation $Ax + By + Cz + D = 0$ where (x,y,z) are the coordinates of a point and $[A,B,C]^T$ is the normal vector of the plane.

Parameters
P: A point with coordinates (x,y,z) on the plane.
n: The normal to the plane.

Definition at line 112 of file vpPlane.cpp.

References A, B, C, D, vpPoint::get_X(), vpPoint::get_Y(), and vpPoint::get_Z().

vpPlane::vpPlane ( const vpPoint &  P,
const vpPoint &  Q,
const vpPoint &  R 
)

Compute the equation of a plane given three point P, Q, R.

The normal to the plane is given by n = PQ x PR

See also
init(const vpPoint &, const vpPoint &, const vpPoint &)

Definition at line 204 of file vpPlane.cpp.

References init().

Member Function Documentation

vpColVector vpPlane::abcd ( ) const
inline
Warning
This method is provided for compatibility with the previous versions. Users should now use getABCD().
Returns
Return the four dimension vector $[A,B,C,D]^T$ corresponding to the plane parameters.
See also
getABCD()

Definition at line 144 of file vpPlane.h.

void vpPlane::changeFrame ( const vpHomogeneousMatrix &  cMo)

Considering the plane in the Ro frame computes the equation of the plane in the Rc frame.

Parameters
cMo: Homogeneous transformation from Rc to Ro frames.
Examples:
manServoMomentsSimple.cpp, servoMomentImage.cpp, servoMomentPoints.cpp, and servoMomentPolygon.cpp.

Definition at line 344 of file vpPlane.cpp.

References A, B, C, and D.

Referenced by vpMbKltTracker::setPose().

double vpPlane::getA ( ) const
inline
Returns
The value of the plane parameter A.
Examples:
manServoMomentsSimple.cpp, servoMomentImage.cpp, servoMomentPoints.cpp, and servoMomentPolygon.cpp.

Definition at line 111 of file vpPlane.h.

Referenced by init(), rayIntersection(), and vpPlane().

vpColVector vpPlane::getABCD ( ) const
inline
Returns
Return the four dimension vector $[A,B,C,D]^T$ corresponding to the plane parameters.

Definition at line 125 of file vpPlane.h.

double vpPlane::getB ( ) const
inline
Returns
The value of the plane parameter B.
Examples:
manServoMomentsSimple.cpp, servoMomentImage.cpp, servoMomentPoints.cpp, and servoMomentPolygon.cpp.

Definition at line 113 of file vpPlane.h.

Referenced by init(), rayIntersection(), and vpPlane().

double vpPlane::getC ( ) const
inline
Returns
The value of the plane parameter C.
Examples:
manServoMomentsSimple.cpp, servoMomentImage.cpp, servoMomentPoints.cpp, and servoMomentPolygon.cpp.

Definition at line 115 of file vpPlane.h.

Referenced by init(), rayIntersection(), and vpPlane().

double vpPlane::getD ( ) const
inline
Returns
The value of the plane parameter D.
Examples:
manServoMomentsSimple.cpp, servoMomentImage.cpp, servoMomentPoints.cpp, and servoMomentPolygon.cpp.

Definition at line 117 of file vpPlane.h.

Referenced by getIntersection(), init(), vpMbtKltPolygon::init(), rayIntersection(), vpMbKltTracker::setPose(), and vpPlane().

double vpPlane::getIntersection ( const vpColVector &  M1,
vpColVector &  H 
) const

Definition at line 317 of file vpPlane.cpp.

References A, B, C, and getD().

vpColVector vpPlane::getNormal ( ) const

Return the normal to the plane.

A plane is given by the equation $Ax + By + Cz + D = 0$ where (x,y,z) is a point of R^3 and (A,B,C) are the coordinates of the normal.

See also
getNormal(vpColVector &n)

Definition at line 218 of file vpPlane.cpp.

References A, B, and C.

Referenced by vpMbtKltPolygon::init(), and vpMbKltTracker::setPose().

void vpPlane::getNormal ( vpColVector &  n) const

Return the normal to the plane.

A plane is given by the equation $Ax + By + Cz + D = 0$ where (x,y,z) are the coordinates of a point and $[A,B,C]^T$ is normal vector of the plane.

See also
getNormal()

Definition at line 238 of file vpPlane.cpp.

References A, B, C, and vpColVector::resize().

void vpPlane::init ( const vpPoint &  P,
const vpPoint &  Q,
const vpPoint &  R 
)

Compute the equation of a plane given three point P, Q, R.

The normal to the plane is given by n = PQ x PR

Definition at line 164 of file vpPlane.cpp.

References A, B, C, vpColVector::cross(), D, vpPoint::get_X(), vpPoint::get_Y(), and vpPoint::get_Z().

Referenced by vpPlane().

void vpPlane::init ( const vpColVector &  P,
const vpColVector &  n 
)

Initialize the plane from a point P on the plane and the normal n to the plane.

Parameters
P: A point with coordinates (x,y,z) on the plane.
n: The normal to the plane.
See also
vpPlane(const vpPoint&, const vpColVector &)

Definition at line 146 of file vpPlane.cpp.

References A, B, C, and D.

void vpPlane::init ( const vpPlane &  P)

Initialize the plane with the parameters of an other plane P.

Parameters
P: Plane used as initializer.

Definition at line 128 of file vpPlane.cpp.

References getA(), getB(), getC(), getD(), setA(), setB(), setC(), and setD().

vpPlane & vpPlane::operator= ( const vpPlane &  p)

Copy operator.

Definition at line 58 of file vpPlane.cpp.

References A, B, C, and D.

void vpPlane::projectionPointOnPlan ( const vpPoint &  P,
vpPoint &  Pproj 
) const

Compute the coordinates of the projection of a point on the plane.

Parameters
P: point to be projected on the plane
Pproj: result of the projection (pproj belongs to the plane)

Definition at line 253 of file vpPlane.cpp.

References A, B, C, D, vpPoint::get_W(), vpPoint::get_X(), vpPoint::get_Y(), vpPoint::get_Z(), vpPoint::set_W(), vpPoint::set_X(), vpPoint::set_Y(), and vpPoint::set_Z().

double vpPlane::rayIntersection ( const vpPoint &  M0,
const vpPoint &  M1,
vpColVector &  H 
) const

Definition at line 272 of file vpPlane.cpp.

References vpPoint::get_X(), vpPoint::get_Y(), vpPoint::get_Z(), getA(), getB(), getC(), and getD().

void vpPlane::setA ( const double  a)
inline

Set plane parameter A.

Definition at line 90 of file vpPlane.h.

Referenced by init(), and vpPlane().

void vpPlane::setABCD ( const double  a,
const double  b,
const double  c,
const double  d 
)
inline

Set plane parameters A, B, C, D.

Examples:
manServoMomentsSimple.cpp, servoMomentImage.cpp, servoMomentPoints.cpp, and servoMomentPolygon.cpp.

Definition at line 98 of file vpPlane.h.

void vpPlane::setB ( const double  b)
inline

Set plane parameter B.

Definition at line 92 of file vpPlane.h.

Referenced by init(), and vpPlane().

void vpPlane::setC ( const double  c)
inline

Set plane parameter C.

Definition at line 94 of file vpPlane.h.

Referenced by init(), and vpPlane().

void vpPlane::setD ( const double  d)
inline

Set plane parameter D.

Definition at line 96 of file vpPlane.h.

Referenced by init(), and vpPlane().

Friends And Related Function Documentation

VISP_EXPORT std::ostream& operator<< ( std::ostream &  os,
vpPlane &  p 
)
friend

Print the plane parameters as a stream like "(A,B,C,D) " where A,B,C and D correspond to the parameters of the plane.

Definition at line 360 of file vpPlane.cpp.

Member Data Documentation

double vpPlane::A

Definition at line 76 of file vpPlane.h.

Referenced by changeFrame(), getIntersection(), getNormal(), init(), operator=(), projectionPointOnPlan(), and vpPlane().

double vpPlane::B

Definition at line 76 of file vpPlane.h.

Referenced by changeFrame(), getIntersection(), getNormal(), init(), operator=(), projectionPointOnPlan(), and vpPlane().

double vpPlane::C

Definition at line 76 of file vpPlane.h.

Referenced by changeFrame(), getIntersection(), getNormal(), init(), operator=(), projectionPointOnPlan(), and vpPlane().

double vpPlane::D

Definition at line 76 of file vpPlane.h.

Referenced by changeFrame(), init(), operator=(), projectionPointOnPlan(), and vpPlane().