![]() |
Visual Servoing Platform version 3.7.0
|
#include <vpLine.h>
Public Types | |
| enum | vpForwardProjectionDeallocatorType { user , vpDisplayForwardProjection } |
Public Member Functions | |
| vpLine () | |
| void | changeFrame (const vpHomogeneousMatrix &cMo, vpColVector &cP) const VP_OVERRIDE |
| void | changeFrame (const vpHomogeneousMatrix &cMo) VP_OVERRIDE |
| void | display (const vpImage< unsigned char > &I, const vpCameraParameters &cam, const vpColor &color=vpColor::green, unsigned int thickness=1) VP_OVERRIDE |
| void | display (const vpImage< unsigned char > &I, const vpHomogeneousMatrix &cMo, const vpCameraParameters &cam, const vpColor &color=vpColor::green, unsigned int thickness=1) VP_OVERRIDE |
| void | display (const vpImage< vpRGBa > &I, const vpCameraParameters &cam, const vpColor &color=vpColor::green, unsigned int thickness=1) |
| void | display (const vpImage< vpRGBa > &I, const vpHomogeneousMatrix &cMo, const vpCameraParameters &cam, const vpColor &color=vpColor::green, unsigned int thickness=1) |
| vpLine * | duplicate () const VP_OVERRIDE |
| double | getRho () const |
| double | getTheta () const |
| void | setRho (double rho) |
| void | setTheta (double theta) |
| void | setWorldCoordinates (const double &oA1, const double &oB1, const double &oC1, const double &oD1, const double &oA2, const double &oB2, const double &oC2, const double &oD2) |
| void | setWorldCoordinates (const vpColVector &oP1, const vpColVector &oP2) |
| void | setWorldCoordinates (const vpColVector &oP) VP_OVERRIDE |
| void | projection () VP_OVERRIDE |
| void | projection (const vpColVector &cP, vpColVector &p) const VP_OVERRIDE |
Public Member Functions Inherited from vpForwardProjection | |
| vpColVector | get_oP () const |
| vpForwardProjectionDeallocatorType | getDeallocate () |
| virtual void | print () const |
| void | project () |
| void | project (const vpHomogeneousMatrix &cMo) |
| void | setDeallocate (vpForwardProjectionDeallocatorType d) |
| void | track (const vpHomogeneousMatrix &cMo) |
Public Member Functions Inherited from vpTracker | |
| vpColVector | get_p () const |
| vpColVector | get_cP () const |
Public Attributes | |
Public Attributes Inherited from vpForwardProjection | |
| vpColVector | oP |
Public Attributes Inherited from vpTracker | |
| vpColVector | p |
| vpColVector | cP |
| bool | cPAvailable |
Protected Member Functions | |
| void | init () VP_OVERRIDE |
Class that defines a 3D line in the object frame and allows forward projection of the line in the camera frame and in the 2D image plane by perspective projection. All the parameters must be set in meter.
Note that a 3D line is defined from the intersection between two 3D planes.
A 3D line has the followings parameters:
The line parameters corresponding to the image frame are located in the vpTracker::p public attribute, where p is a vector defined as:
To compute these parameters use projection(). To get the corresponding values use get_p().
|
inherited |
Used for memory issue especially in the vpServo class.
| Enumerator | |
|---|---|
| user | |
| vpDisplayForwardProjection | |
Definition at line 70 of file vpForwardProjection.h.
| vpLine::vpLine | ( | ) |
Default constructor.
Definition at line 63 of file vpLine.cpp.
References init().
Referenced by duplicate().
|
virtual |
Computes the line parameters cP in the camera frame thanks to the line parameters oP given in the object frame and the homogeneous matrix relative to the pose cMo between the object frame and the camera frame. Thus the computation gives the equations of the two planes needed to define the line in the camera frame thanks to the equations of the same two planes in the object frame.
In input of this method, the line parameters oP in the object frame are those from the vpForwardProjection::oP public attribute.
As a result of this method, line parameters cP in the camera frame are updated in the vpTracker::cP public attribute.
| cMo | : The homogeneous matrix corresponding to the pose between the camera frame and the object frame. |
The code below shows how to use this method.
Implements vpForwardProjection.
Definition at line 310 of file vpLine.cpp.
References changeFrame(), and vpTracker::cP.
|
virtual |
Computes the line parameters cP in the camera frame thanks to the line parameters oP given in the object frame and the homogeneous matrix relative to the pose between the camera frame and the object frame. Thus the computation gives the equations of the two planes needed to define the line in the desired frame thanks to the equations of the same two planes in the object frame.
In input of this method, the line parameters oP in the object frame are those from the vpForwardProjection::oP public attribute.
| cMo | : The homogeneous matrix relative to the pose between the desired frame and the object frame. |
| cP_ | : The vector which will contain the parameters of the two planes in the camera frame.
|
The code below shows how to use this method.
Implements vpForwardProjection.
Definition at line 352 of file vpLine.cpp.
References vpForwardProjection::oP, and vpColVector::resize().
Referenced by changeFrame(), display(), and display().
|
virtual |
Displays the line in the image I thanks to the 2D parameters of the line p in the image plane (vpTracker::p) and the camera parameters which enable to convert the parameters from meter to pixel.
| I | : The image where the line must be displayed. |
| cam | : The camera parameters to enable the conversion from meter to pixel. |
| color | : The desired color to display the line in the image. |
| thickness | : Thickness of the feature representation. |
Implements vpForwardProjection.
Definition at line 470 of file vpLine.cpp.
References vpFeatureDisplay::displayLine(), and vpTracker::p.
|
virtual |
Displays the line in the image I thanks to the parameters in the object frame (vpForwardProjection::oP), the homogeneous matrix relative to the pose between the camera frame and the object frame and the camera parameters which enable to convert the features from meter to pixel.
This method is non destructive wrt. cP and p internal line parameters.
| I | : The image where the line must be displayed in overlay. |
| cMo | : The homogeneous matrix corresponding to the pose between the camera frame and the object frame. |
| cam | : The camera parameters to enable the conversion from meter to pixel. |
| color | : The desired color to display the line in the image. |
| thickness | : Thickness of the feature representation. |
Implements vpForwardProjection.
Definition at line 519 of file vpLine.cpp.
References changeFrame(), vpFeatureDisplay::displayLine(), and projection().
| void vpLine::display | ( | const vpImage< vpRGBa > & | I, |
| const vpCameraParameters & | cam, | ||
| const vpColor & | color = vpColor::green, | ||
| unsigned int | thickness = 1 ) |
Displays the line in the image I thanks to the 2D parameters of the line p in the image plane (vpTracker::p) and the camera parameters which enable to convert the parameters from meter to pixel.
| I | : The image where the line must be displayed. |
| cam | : The camera parameters to enable the conversion from meter to pixel. |
| color | : The desired color to display the line in the image. |
| thickness | : Thickness of the feature representation. |
Definition at line 491 of file vpLine.cpp.
References vpFeatureDisplay::displayLine(), and vpTracker::p.
| void vpLine::display | ( | const vpImage< vpRGBa > & | I, |
| const vpHomogeneousMatrix & | cMo, | ||
| const vpCameraParameters & | cam, | ||
| const vpColor & | color = vpColor::green, | ||
| unsigned int | thickness = 1 ) |
Displays the line in the image I thanks to the parameters in the object frame (vpForwardProjection::oP), the homogeneous matrix relative to the pose between the camera frame and the object frame and the camera parameters which enable to convert the features from meter to pixel.
This method is non destructive wrt. cP and p internal line parameters.
| I | : The image where the line must be displayed in overlay. |
| cMo | : The homogeneous matrix corresponding to the pose between the camera frame and the object frame. |
| cam | : The camera parameters to enable the conversion from meter to pixel. |
| color | : The desired color to display the line in the image. |
| thickness | : Thickness of the feature representation. |
Definition at line 555 of file vpLine.cpp.
References changeFrame(), vpFeatureDisplay::displayLine(), and projection().
|
virtual |
Create an object with the same type.
Implements vpForwardProjection.
Definition at line 579 of file vpLine.cpp.
References vpLine().
|
inlineinherited |
Return object parameters expressed in the 3D camera frame.
Definition at line 95 of file vpTracker.h.
References cP.
|
inlineinherited |
Return object parameters expressed in the 3D object frame.
Definition at line 155 of file vpForwardProjection.h.
References oP.
|
inlineinherited |
Return object parameters expressed in the 2D image plane computed by perspective projection.
Definition at line 93 of file vpTracker.h.
References p.
|
inlineinherited |
Definition at line 157 of file vpForwardProjection.h.
|
inline |
Gets the
value corresponding to one of the two parameters used to define the line parametrization in the image plane.
Definition at line 132 of file vpLine.h.
References vpTracker::p.
|
inline |
Gets the
angle value corresponding to one of the two parameters used to define the line parametrization in the image plane.
Definition at line 143 of file vpLine.h.
References vpTracker::p.
|
protectedvirtual |
Initialize the memory space requested for the 2D line parameters (p) in the image plane and for 3D line parameters (oP and cP) respectively in the object frame and the camera frame.
Implements vpForwardProjection.
Definition at line 51 of file vpLine.cpp.
References vpTracker::cP, vpForwardProjection::oP, and vpTracker::p.
Referenced by vpLine().
|
virtualinherited |
Print to stdout the feature parameters in:
Definition at line 48 of file vpForwardProjection.cpp.
References vpTracker::cP, oP, and vpTracker::p.
|
inherited |
Compute the feature parameters in the image plane (vpTracker::p) from the parameters in the camera frame (vpTracker::cP).
Definition at line 63 of file vpForwardProjection.cpp.
References vpTracker::cP, vpTracker::p, and projection().
Referenced by vpMbtDistanceKltCylinder::computeInteractionMatrixAndResidu(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpKeyPoint::matchPointAndDetect(), vpMbtFaceDepthNormal::planeIsInvalid(), projection(), and track().
|
inherited |
Compute the feature parameters in the camera frame (vpTracker::cP) and than compute the projection of these parameters in the image plane (vpTracker::p).
| cMo | : The homogeneous matrix corresponding to the pose between the camera frame and the object frame. |
Definition at line 79 of file vpForwardProjection.cpp.
References changeFrame(), and projection().
|
virtual |
Computes the 2D parameters p of the line in the image plane thanks to the 3D line parameters cP in the camera frame located in the vpTracker::cP public attribute. The parameters
are updated in the vpTracker::p public attribute.
The code below shows how to use this method.
Implements vpForwardProjection.
Definition at line 205 of file vpLine.cpp.
References vpTracker::cP, vpTracker::p, and projection().
Referenced by display(), display(), and projection().
|
virtual |
Computes the 2D parameters p of the line in the image plane thanks to the 3D line parameters cP expressed in the camera frame. The image plane parameters
are updated in output.
| [in] | cP_ | : The vector containing the line parameters relative to the camera frame.
|
| [out] | p_ | : The vector which contains the 2D line features expressed in the image plane.
|
| vpException::fatalError | : Degenerate case, the image of the straight line is a point. |
Implements vpForwardProjection.
Definition at line 225 of file vpLine.cpp.
References vpTracker::cP, vpException::dimensionError, vpException::fatalError, and vpColVector::resize().
|
inlineinherited |
Definition at line 185 of file vpForwardProjection.h.
|
inline |
Sets the
parameter used to define the line in the image plane.
| rho | : The desired value for |
Definition at line 153 of file vpLine.h.
References vpTracker::p.
|
inline |
Sets the
angle value used to define the line in the image plane.
| theta | : The desired value for |
Definition at line 163 of file vpLine.h.
References vpTracker::p.
| void vpLine::setWorldCoordinates | ( | const double & | oA1, |
| const double & | oB1, | ||
| const double & | oC1, | ||
| const double & | oD1, | ||
| const double & | oA2, | ||
| const double & | oB2, | ||
| const double & | oC2, | ||
| const double & | oD2 ) |
Sets the parameters oP which define the line in the object frame. As said in the class description, the line is defined as the intersection of two planes. The different parameters here define the equations of the two planes in the object frame. They are used to set the vpForwardProjection::oP public attribute.
Here
are the 3D coordinates of a point in the object frame.
| oA1 | : First plane coordinate along X-axis of the normal vector expressed in the object frame. |
| oB1 | : First plane coordinate along Y-axis of the normal vector expressed in the object frame. |
| oC1 | : First plane coordinate along Z-axis of the normal vector expressed in the object frame. |
| oD1 | : First plane D parameter in the object frame. |
| oA2 | : Second plane coordinate along X-axis of the normal vector expressed in the object frame. |
| oB2 | : Second plane coordinate along Y-axis of the normal vector expressed in the object frame. |
| oC2 | : Second plane coordinate along Z-axis of the normal vector expressed in the object frame. |
| oD2 | : Second plane D parameter in the object frame. |
Definition at line 87 of file vpLine.cpp.
References vpForwardProjection::oP.
|
virtual |
Sets the parameters oP which define the line in the object frame. As said in the class description, the line is defined as the intersection of two planes. Eight parameters are required to define the equations of the two planes in the object frame. They are used to set the vpForwardProjection::oP public attribute.
Here
are the 3D coordinates of a point in the object frame.
| oP_ | : The column vector which contains the eight parameters needed to define the equations of the two planes in the object frame.
|
Implements vpForwardProjection.
Definition at line 127 of file vpLine.cpp.
References vpException::dimensionError, vpArray2D< Type >::getRows(), and vpForwardProjection::oP.
| void vpLine::setWorldCoordinates | ( | const vpColVector & | oP1, |
| const vpColVector & | oP2 ) |
Sets the parameters oP which define the line in the object frame. As said in the class description, the line is defined as the intersection of two planes. Eight parameters are required to define the equations of the two planes in the object frame. They are used to set the vpForwardProjection::oP public attribute.
Here
are the 3D coordinates of a point in the object frame.
| oP1 | : The column vector which contains the four parameters needed to define the equations of the first plane in the object frame.
|
| oP2 | : The column vector which contains the four parameters needed to define the equations of the second plane in the object frame.
|
Definition at line 157 of file vpLine.cpp.
References vpException::dimensionError, vpArray2D< Type >::getRows(), and vpForwardProjection::oP.
|
inherited |
Track the feature parameters in the camera frame (vpTracker::cP) and than compute the projection of these parameters in the image plane (vpTracker::p).
This method is similar to project(const vpHomogeneousMatrix &).
| cMo | : The homogeneous matrix corresponding to the pose between the camera frame and the object frame. |
Definition at line 101 of file vpForwardProjection.cpp.
References project().
Referenced by vpPose::computeResidual(), vpPose::computeResidual(), vpImageDraw::drawFrame(), vpImageDraw::drawFrame(), vpPose::poseVirtualVS(), vpPose::poseVirtualVSrobust(), vpWireFrameSimulator::projectCameraTrajectory(), vpWireFrameSimulator::projectCameraTrajectory(), vpWireFrameSimulator::projectCameraTrajectory(), vpWireFrameSimulator::projectCameraTrajectory(), setWorldCoordinates(), vpSimulatorAfma6::updateArticularPosition(), and vpSimulatorViper850::updateArticularPosition().
|
inherited |
Feature coordinates expressed in the camera frame cP.
Definition at line 73 of file vpTracker.h.
Referenced by vpCircle::changeFrame(), vpCylinder::changeFrame(), vpForwardProjection::changeFrame(), vpLine::changeFrame(), vpPoint::changeFrame(), vpSphere::changeFrame(), vpFeatureBuilder::create(), get_cP(), vpPoint::get_W(), vpPoint::get_X(), vpPoint::get_Y(), vpPoint::get_Z(), vpCircle::getA(), vpCylinder::getA(), vpCircle::getB(), vpCylinder::getB(), vpCircle::getC(), vpCylinder::getC(), vpCircle::getR(), vpCylinder::getR(), vpSphere::getR(), vpCircle::getX(), vpCylinder::getX(), vpSphere::getX(), vpCircle::getY(), vpCylinder::getY(), vpSphere::getY(), vpCircle::getZ(), vpCylinder::getZ(), vpSphere::getZ(), vpCircle::init(), vpCylinder::init(), vpLine::init(), vpPoint::init(), vpSphere::init(), vpCircle::operator=(), operator=(), vpForwardProjection::print(), vpPose::printPoint(), vpForwardProjection::project(), vpCircle::projection(), vpCylinder::projection(), vpForwardProjection::projection(), vpLine::projection(), vpLine::projection(), vpPoint::projection(), vpSphere::projection(), vpPoint::set_W(), vpPoint::set_X(), vpPoint::set_Y(), vpPoint::set_Z(), vpTracker(), and vpTracker().
|
inherited |
Flag used to indicate if the feature parameters cP expressed in the camera frame are available.
Definition at line 79 of file vpTracker.h.
Referenced by init(), operator=(), vpTracker(), and vpTracker().
|
inherited |
Feature coordinates expressed in the object frame.
Definition at line 205 of file vpForwardProjection.h.
Referenced by vpCircle::changeFrame(), vpCircle::changeFrame(), vpCylinder::changeFrame(), vpLine::changeFrame(), vpPoint::changeFrame(), vpPoint::changeFrame(), vpSphere::changeFrame(), get_oP(), vpPoint::get_oW(), vpPoint::get_oX(), vpPoint::get_oY(), vpPoint::get_oZ(), vpPoint::getWorldCoordinates(), vpPoint::getWorldCoordinates(), vpPoint::getWorldCoordinates(), vpPoint::getWorldCoordinates(), vpCircle::init(), vpCylinder::init(), vpLine::init(), vpPoint::init(), vpSphere::init(), vpCircle::operator=(), print(), vpPose::printPoint(), vpPoint::set_oW(), vpPoint::set_oX(), vpPoint::set_oY(), vpPoint::set_oZ(), vpCircle::setWorldCoordinates(), vpCircle::setWorldCoordinates(), vpCylinder::setWorldCoordinates(), vpCylinder::setWorldCoordinates(), setWorldCoordinates(), vpLine::setWorldCoordinates(), vpLine::setWorldCoordinates(), vpLine::setWorldCoordinates(), vpPoint::setWorldCoordinates(), vpPoint::setWorldCoordinates(), vpPoint::setWorldCoordinates(), vpSphere::setWorldCoordinates(), vpSphere::setWorldCoordinates(), and vpForwardProjection().
|
inherited |
Feature coordinates expressed in the image plane p. They correspond to 2D normalized coordinates expressed in meters.
Definition at line 69 of file vpTracker.h.
Referenced by vpCircle::computeIntersectionPoint(), vpMeterPixelConversion::convertEllipse(), vpMeterPixelConversion::convertEllipse(), vpMeterPixelConversion::convertEllipse(), vpMeterPixelConversion::convertEllipse(), vpCircle::display(), vpCircle::display(), vpCylinder::display(), vpCylinder::display(), vpLine::display(), vpLine::display(), vpPoint::display(), vpPoint::display(), vpSphere::display(), vpSphere::display(), vpFeatureDisplay::displayEllipse(), vpFeatureDisplay::displayEllipse(), vpPose::displayModel(), vpPose::displayModel(), vpImageDraw::drawFrame(), vpImageDraw::drawFrame(), vpCircle::get_mu02(), vpSphere::get_mu02(), vpCircle::get_mu11(), vpSphere::get_mu11(), vpCircle::get_mu20(), vpSphere::get_mu20(), vpCircle::get_n02(), vpSphere::get_n02(), vpCircle::get_n11(), vpSphere::get_n11(), vpCircle::get_n20(), vpSphere::get_n20(), get_p(), vpPoint::get_w(), vpCircle::get_x(), vpPoint::get_x(), vpSphere::get_x(), vpCircle::get_y(), vpPoint::get_y(), vpSphere::get_y(), vpLine::getRho(), vpCylinder::getRho1(), vpCylinder::getRho2(), vpLine::getTheta(), vpCylinder::getTheta1(), vpCylinder::getTheta2(), vpCircle::init(), vpCylinder::init(), vpLine::init(), vpMeTracker::init(), vpPoint::init(), vpSphere::init(), vpCircle::operator=(), operator=(), vpForwardProjection::print(), vpPose::printPoint(), vpForwardProjection::project(), vpCircle::projection(), vpCylinder::projection(), vpForwardProjection::projection(), vpLine::projection(), vpPoint::projection(), vpSphere::projection(), vpPoint::set_w(), vpPoint::set_x(), vpPoint::set_y(), vpLine::setRho(), vpLine::setTheta(), vpTracker(), and vpTracker().