vpPoint Class Reference

#include <visp3/core/vpPoint.h>

Inheritance diagram for vpPoint:

Public Types
enum	vpForwardProjectionDeallocatorType { user, vpDisplayForwardProjection }

Public Member Functions
	vpPoint ()
	vpPoint (double oX, double oY, double oZ)
	vpPoint (const vpColVector &P)
	vpPoint (const std::vector< double > &P)
virtual	~vpPoint ()
void	changeFrame (const vpHomogeneousMatrix &cMo, vpColVector &_cP)
void	changeFrame (const vpHomogeneousMatrix &cMo)
void	display (const vpImage< unsigned char > &I, const vpCameraParameters &cam, const vpColor &color=vpColor::green, unsigned int thickness=1)
void	display (const vpImage< unsigned char > &I, const vpHomogeneousMatrix &cMo, 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)
vpPoint *	duplicate () const
double	get_X () const
double	get_Y () const
double	get_Z () const
double	get_W () const
double	get_oX () const
double	get_oY () const
double	get_oZ () const
double	get_oW () const
double	get_x () const
double	get_y () const
double	get_w () const
void	getWorldCoordinates (double &oX, double &oY, double &oZ)
void	getWorldCoordinates (vpColVector &P)
vpColVector	getWorldCoordinates (void)
void	getWorldCoordinates (std::vector< double > &P)
void	init ()
vpPoint &	operator= (const vpPoint &vpp)=default
void	projection (const vpColVector &_cP, vpColVector &_p)
void	projection ()
void	set_X (double X)
void	set_Y (double Y)
void	set_Z (double Z)
void	set_W (double W)
void	set_oX (double oX)
void	set_oY (double oY)
void	set_oZ (double oZ)
void	set_oW (double oW)
void	set_x (double x)
void	set_y (double y)
void	set_w (double w)
void	setWorldCoordinates (double oX, double oY, double oZ)
void	setWorldCoordinates (const vpColVector &P)
void	setWorldCoordinates (const std::vector< double > &P)
void	project ()
void	project (const vpHomogeneousMatrix &cMo)
void	track (const vpHomogeneousMatrix &cMo)
virtual void	print () const
void	setDeallocate (vpForwardProjectionDeallocatorType d)
vpForwardProjectionDeallocatorType	getDeallocate ()

Public Attributes
vpColVector	oP
vpColVector	p
vpColVector	cP
bool	cPAvailable

Friends
VISP_EXPORT std::ostream &	operator<< (std::ostream &os, const vpPoint &vpp)

Detailed Description

Class that defines what is a point.

Examples:

AROgre.cpp, AROgreBasic.cpp, homographyHartleyDLT2DObject.cpp, homographyHLM2DObject.cpp, homographyHLM3DObject.cpp, manGeometricFeatures.cpp, manServo4PointsDisplay.cpp, manServoMomentsSimple.cpp, manSimu4Dots.cpp, manSimu4Points.cpp, mbot-apriltag-ibvs.cpp, poseVirtualVS.cpp, servoAfma62DhalfCamVelocity.cpp, servoAfma6FourPoints2DCamVelocityLs_cur.cpp, servoAfma6FourPoints2DCamVelocityLs_des.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoBebop2.cpp, servoMomentPoints.cpp, servoMomentPolygon.cpp, servoPioneerPanSegment3D.cpp, servoSimu4Points.cpp, servoSimuAfma6FourPoints2DCamVelocity.cpp, servoSimuFourPoints2DCamVelocity.cpp, servoSimuFourPoints2DCamVelocityDisplay.cpp, servoSimuFourPoints2DPolarCamVelocityDisplay.cpp, servoSimuPoint2DCamVelocity1.cpp, servoSimuPoint2DCamVelocity2.cpp, servoSimuPoint2DCamVelocity3.cpp, servoSimuPoint2DhalfCamVelocity1.cpp, servoSimuPoint2DhalfCamVelocity2.cpp, servoSimuPoint2DhalfCamVelocity3.cpp, servoSimuPoint3DCamVelocity.cpp, servoSimuViper850FourPoints2DCamVelocity.cpp, servoViper850FourPoints2DArtVelocityLs_cur.cpp, servoViper850FourPoints2DCamVelocityLs_cur.cpp, servoViper850FourPointsKinect.cpp, simulateFourPoints2DCartesianCamVelocity.cpp, simulateFourPoints2DPolarCamVelocity.cpp, testAprilTag.cpp, testConvert.cpp, testFeatureSegment.cpp, testFindMatch.cpp, testKeyPoint-4.cpp, testPoseFeatures.cpp, testPoseRansac.cpp, testRobotAfma6Pose.cpp, testRobotViper850Pose.cpp, tutorial-chessboard-pose.cpp, tutorial-count-coins.cpp, tutorial-homography-from-points.cpp, tutorial-ibvs-4pts-display.cpp, tutorial-ibvs-4pts-image-tracking.cpp, tutorial-ibvs-4pts-ogre-tracking.cpp, tutorial-ibvs-4pts-ogre.cpp, tutorial-ibvs-4pts-plotter-continuous-gain-adaptive.cpp, tutorial-ibvs-4pts-plotter-gain-adaptive.cpp, tutorial-ibvs-4pts-plotter.cpp, tutorial-ibvs-4pts-wireframe-robot-afma6.cpp, tutorial-ibvs-4pts-wireframe-robot-viper.cpp, tutorial-ibvs-4pts.cpp, tutorial-pose-from-points-image.cpp, tutorial-pose-from-points-live.cpp, tutorial-pose-from-qrcode-image.cpp, tutorial-simu-pioneer-continuous-gain-adaptive.cpp, tutorial-simu-pioneer-continuous-gain-constant.cpp, tutorial-simu-pioneer-pan.cpp, and tutorial-simu-pioneer.cpp.

Definition at line 58 of file vpPoint.h.

Member Enumeration Documentation

vpForwardProjectionDeallocatorType

enum vpForwardProjection::vpForwardProjectionDeallocatorType

inherited

Used for memory issue especially in the vpServo class.

Enumerator
user
vpDisplayForwardProjection

Definition at line 211 of file vpForwardProjection.h.

Constructor & Destructor Documentation

vpPoint() [1/4]

vpPoint::vpPoint

(

)

Basic constructor.

Definition at line 64 of file vpPoint.cpp.

References init().

Referenced by changeFrame().

vpPoint() [2/4]

vpPoint::vpPoint	(	double	oX,
		double	oY,
		double	oZ
	)

Construction from 3D coordinates in the object frame.

Parameters

oX,oY,oZ

Coordinates of a 3D point in the object frame.

Definition at line 70 of file vpPoint.cpp.

References init(), and setWorldCoordinates().

vpPoint() [3/4]

vpPoint::vpPoint ( const vpColVector &  P )

explicit

Construction from 3D point world coordinates. We mean here the coordinates of the point in the object frame.

Parameters

P

Vector containing the coordinates of the 3D point in the object frame. This vector could be of dimension 3 or 4. If dimension is 3, P corresponds to the normalized coordinates P = (X, Y, Z, 1) where P[0]=X, P[1]=Y, P[2]=Z. If dimension is 4, P corresponds to the normalized coordinates P = (X, Y, Z, W) where P[0]=X, P[1]=Y, P[2]=Z and P[3]=W.

Definition at line 86 of file vpPoint.cpp.

References init(), and setWorldCoordinates().

vpPoint() [4/4]

vpPoint::vpPoint ( const std::vector< double > &  P )

explicit

Construction from 3D point world coordinates. We mean here the coordinates of the point in the object frame.

Parameters

P

Vector containing the coordinates of the 3D point in the object frame. This vector could be of dimension 3 or 4. If dimension is 3, P corresponds to the normalized coordinates P = (X, Y, Z, 1) where P[0]=X, P[1]=Y, P[2]=Z. If dimension is 4, P corresponds to the normalized coordinates P = (X, Y, Z, W) where P[0]=X, P[1]=Y, P[2]=Z and P[3]=W.

Definition at line 102 of file vpPoint.cpp.

References init(), and setWorldCoordinates().

~vpPoint()

virtual vpPoint::~vpPoint ( )

inlinevirtual

Destructor.

Definition at line 68 of file vpPoint.h.

References vpForwardProjection::changeFrame(), vpForwardProjection::display(), vpForwardProjection::duplicate(), vpColor::green, vpForwardProjection::init(), vpTracker::operator=(), vpForwardProjection::projection(), and vpForwardProjection::setWorldCoordinates().

Member Function Documentation

changeFrame() [1/2]

void vpPoint::changeFrame ( const vpHomogeneousMatrix &  cMo, vpColVector &  _cP  )

virtual

From the 3D coordinates of the point in the object frame set using for example setWorldCoordinates() or set_oX(), set_oY(), set_oZ(), compute the 3D coordinates of the point in the camera frame.

Parameters

cMo	: Transformation from camera to object frame.
_cP	: 3D coordinates of the point in the camera frame.

Implements vpForwardProjection.

Examples:

servoAfma6FourPoints2DCamVelocityLs_cur.cpp, servoAfma6FourPoints2DCamVelocityLs_des.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoPioneerPanSegment3D.cpp, servoViper850FourPoints2DArtVelocityLs_cur.cpp, servoViper850FourPoints2DCamVelocityLs_cur.cpp, servoViper850FourPointsKinect.cpp, and simulateFourPoints2DPolarCamVelocity.cpp.

Definition at line 233 of file vpPoint.cpp.

References vpForwardProjection::oP, and vpColVector::resize().

Referenced by vpPolygon3D::changeFrame(), vpMbtDistanceKltCylinder::computeInteractionMatrixAndResidu(), display(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpMbtDistanceLine::getModelForDisplay(), vpMbtDistanceCylinder::getModelForDisplay(), vpMbtDistanceLine::initMovingEdge(), vpMbtDistanceCylinder::initMovingEdge(), vpMbtDistanceLine::updateMovingEdge(), and vpMbtDistanceCylinder::updateMovingEdge().

changeFrame() [2/2]

void vpPoint::changeFrame ( const vpHomogeneousMatrix &  cMo )

virtual

From the 3D coordinates of the point in the object frame set using for example setWorldCoordinates() or set_oX(), set_oY(), set_oZ(), compute the 3D coordinates of the point in the camera frame.

Parameters

cMo	: Transformation from camera to object frame.

Implements vpForwardProjection.

Definition at line 259 of file vpPoint.cpp.

References vpTracker::cP, duplicate(), get_W(), get_w(), get_X(), get_x(), get_Y(), get_y(), get_Z(), vpForwardProjection::oP, operator*(), set_oW(), set_oX(), set_oY(), set_oZ(), set_W(), set_w(), set_X(), set_x(), set_Y(), set_y(), set_Z(), and vpPoint().

display() [1/3]

void vpPoint::display ( const vpImage< unsigned char > &  I, const vpCameraParameters &  cam, const vpColor &  color = vpColor::green, unsigned int  thickness = 1  )

virtual

Display the point in the image.

Implements vpForwardProjection.

Examples:

manGeometricFeatures.cpp, and servoAfma6Points2DCamVelocityEyeToHand.cpp.

Definition at line 405 of file vpPoint.cpp.

References vpFeatureDisplay::displayPoint(), and vpTracker::p.

display() [2/3]

void vpPoint::display ( const vpImage< unsigned char > &  I, const vpHomogeneousMatrix &  cMo, const vpCameraParameters &  cam, const vpColor &  color = vpColor::green, unsigned int  thickness = 1  )

virtual

Display the point in the image.

Implements vpForwardProjection.

Definition at line 358 of file vpPoint.cpp.

References changeFrame(), vpFeatureDisplay::displayPoint(), and projection().

display() [3/3]

void vpPoint::display	(	const vpImage< vpRGBa > &	I,
		const vpHomogeneousMatrix &	cMo,
		const vpCameraParameters &	cam,
		const vpColor &	color = vpColor::green,
		unsigned int	thickness = 1
	)

Display the point in the image.

Definition at line 375 of file vpPoint.cpp.

References changeFrame(), vpFeatureDisplay::displayPoint(), and projection().

duplicate()

vpPoint * vpPoint::duplicate ( ) const

virtual

For memory issue (used by the vpServo class only).

Implements vpForwardProjection.

Definition at line 349 of file vpPoint.cpp.

Referenced by changeFrame().

get_oW()

double vpPoint::get_oW

(

)

const

Get the point W coordinate in the object frame.

Definition at line 428 of file vpPoint.cpp.

References vpForwardProjection::oP.

get_oX()

double vpPoint::get_oX

(

)

const

Get the point X coordinate in the object frame.

Examples:

testConvert.cpp.

Definition at line 422 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by vpMbTracker::addPolygon(), vpMbTracker::addProjectionErrorPolygon(), vpMbtDistanceCircle::buildFrom(), vpMbtDistanceKltCylinder::buildFrom(), vpMbtDistanceLine::buildFrom(), vpMbtDistanceCylinder::buildFrom(), vpKeyPoint::compute3DForPointsOnCylinders(), vpPose::coplanar(), vpMbTracker::createCylinderBBox(), vpMbTracker::extractCylinders(), vpMbTracker::getGravityCenter(), vpPlane::init(), vpPose::poseDementhonNonPlan(), vpPose::poseDementhonPlan(), vpPose::poseLagrangeNonPlan(), vpPose::poseLagrangePlan(), vpPose::poseLowe(), vpMbtFaceDepthDense::samePoint(), vpMbtFaceDepthNormal::samePoint(), vpMbTracker::samePoint(), vpPlane::vpPlane(), and vpMbtDistanceLine::~vpMbtDistanceLine().

get_oY()

double vpPoint::get_oY

(

)

const

Get the point Y coordinate in the object frame.

Examples:

testConvert.cpp.

Definition at line 424 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by vpMbTracker::addPolygon(), vpMbTracker::addProjectionErrorPolygon(), vpMbtDistanceCircle::buildFrom(), vpMbtDistanceKltCylinder::buildFrom(), vpMbtDistanceLine::buildFrom(), vpMbtDistanceCylinder::buildFrom(), vpKeyPoint::compute3DForPointsOnCylinders(), vpPose::coplanar(), vpMbTracker::createCylinderBBox(), vpMbTracker::extractCylinders(), vpPlane::init(), vpPose::poseDementhonNonPlan(), vpPose::poseDementhonPlan(), vpPose::poseLagrangeNonPlan(), vpPose::poseLagrangePlan(), vpPose::poseLowe(), vpMbtFaceDepthDense::samePoint(), vpMbtFaceDepthNormal::samePoint(), vpMbTracker::samePoint(), vpPlane::vpPlane(), and vpMbtDistanceLine::~vpMbtDistanceLine().

get_oZ()

double vpPoint::get_oZ

(

)

const

Get the point Z coordinate in the object frame.

Examples:

testConvert.cpp.

Definition at line 426 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by vpMbTracker::addPolygon(), vpMbTracker::addProjectionErrorPolygon(), vpMbtDistanceCircle::buildFrom(), vpMbtDistanceKltCylinder::buildFrom(), vpMbtDistanceLine::buildFrom(), vpMbtDistanceCylinder::buildFrom(), vpKeyPoint::compute3DForPointsOnCylinders(), vpPose::coplanar(), vpMbTracker::createCylinderBBox(), vpMbTracker::extractCylinders(), vpPlane::init(), vpPose::poseDementhonNonPlan(), vpPose::poseDementhonPlan(), vpPose::poseLagrangeNonPlan(), vpPose::poseLagrangePlan(), vpPose::poseLowe(), vpMbtFaceDepthDense::samePoint(), vpMbtFaceDepthNormal::samePoint(), vpMbTracker::samePoint(), vpPlane::vpPlane(), and vpMbtDistanceLine::~vpMbtDistanceLine().

get_W()

double vpPoint::get_W

(

)

const

Get the point W coordinate in the camera frame.

Definition at line 419 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpHomogeneousMatrix::operator*(), and vpPlane::projectionPointOnPlan().

get_w()

double vpPoint::get_w

(

)

const

Get the point w coordinate in the image plane.

Examples:

homographyHartleyDLT2DObject.cpp, homographyHLM2DObject.cpp, and homographyHLM3DObject.cpp.

Definition at line 435 of file vpPoint.cpp.

References vpTracker::p.

Referenced by changeFrame(), and vpHomography::operator*().

get_X()

double vpPoint::get_X

(

)

const

Get the point X coordinate in the camera frame.

Definition at line 413 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpMbtFaceDepthNormal::computePolygonCentroid(), vpPolygon3D::computePolygonClipped(), vpMbtFaceDepthDense::computeROI(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpPlane::init(), vpMbtPolygon::isVisible(), vpHomogeneousMatrix::operator*(), vpPlane::projectionPointOnPlan(), vpPlane::rayIntersection(), and vpPlane::vpPlane().

get_x()

double vpPoint::get_x

(

)

const

Get the point x coordinate in the image plane.

Examples:

homographyHartleyDLT2DObject.cpp, homographyHLM2DObject.cpp, homographyHLM3DObject.cpp, servoAfma62DhalfCamVelocity.cpp, servoSimuFourPoints2DPolarCamVelocityDisplay.cpp, and testFindMatch.cpp.

Definition at line 431 of file vpPoint.cpp.

References vpTracker::p.

Referenced by changeFrame(), vpMbtDistanceKltCylinder::computeInteractionMatrixAndResidu(), vpKeyPoint::computePose(), vpPose::computeResidual(), vpFeatureBuilder::create(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpKeyPoint::matchPointAndDetect(), vpHomography::operator*(), vpPose::poseFromRectangle(), vpPose::poseLagrangeNonPlan(), vpPose::poseLagrangePlan(), vpPose::poseLowe(), vpPose::poseVirtualVS(), vpPose::poseVirtualVSrobust(), vpHomography::project(), vpWireFrameSimulator::projectCameraTrajectory(), vpSimulatorAfma6::updateArticularPosition(), and vpSimulatorViper850::updateArticularPosition().

get_Y()

double vpPoint::get_Y

(

)

const

Get the point Y coordinate in the camera frame.

Definition at line 415 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpPolygon3D::computePolygonClipped(), vpMbtFaceDepthDense::computeROI(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpPlane::init(), vpMbtPolygon::isVisible(), vpHomogeneousMatrix::operator*(), vpPlane::projectionPointOnPlan(), vpPlane::rayIntersection(), and vpPlane::vpPlane().

get_y()

double vpPoint::get_y

(

)

const

Get the point y coordinate in the image plane.

Examples:

homographyHartleyDLT2DObject.cpp, homographyHLM2DObject.cpp, homographyHLM3DObject.cpp, servoAfma62DhalfCamVelocity.cpp, servoSimuFourPoints2DPolarCamVelocityDisplay.cpp, and testFindMatch.cpp.

Definition at line 433 of file vpPoint.cpp.

References vpTracker::p.

Referenced by changeFrame(), vpMbtDistanceKltCylinder::computeInteractionMatrixAndResidu(), vpKeyPoint::computePose(), vpPose::computeResidual(), vpFeatureBuilder::create(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpKeyPoint::matchPointAndDetect(), vpHomography::operator*(), vpPose::poseFromRectangle(), vpPose::poseLagrangeNonPlan(), vpPose::poseLagrangePlan(), vpPose::poseLowe(), vpPose::poseVirtualVS(), vpPose::poseVirtualVSrobust(), vpHomography::project(), vpWireFrameSimulator::projectCameraTrajectory(), vpSimulatorAfma6::updateArticularPosition(), and vpSimulatorViper850::updateArticularPosition().

get_Z()

double vpPoint::get_Z

(

)

const

Get the point Z coordinate in the camera frame.

Examples:

servoAfma62DhalfCamVelocity.cpp, tutorial-simu-pioneer-continuous-gain-adaptive.cpp, tutorial-simu-pioneer-continuous-gain-constant.cpp, tutorial-simu-pioneer-pan.cpp, and tutorial-simu-pioneer.cpp.

Definition at line 417 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpPolygon3D::computePolygonClipped(), vpMbtFaceDepthDense::computeROI(), vpFeatureBuilder::create(), vpProjectionDisplay::displayCamera(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpPlane::init(), vpMbtPolygon::isVisible(), vpHomogeneousMatrix::operator*(), vpPose::poseVirtualVS(), vpPose::poseVirtualVSrobust(), vpPlane::projectionPointOnPlan(), vpPlane::rayIntersection(), and vpPlane::vpPlane().

getDeallocate()

vpForwardProjectionDeallocatorType vpForwardProjection::getDeallocate ( )

inlineinherited

Definition at line 220 of file vpForwardProjection.h.

getWorldCoordinates() [1/4]

void vpPoint::getWorldCoordinates	(	double &	oX,
		double &	oY,
		double &	oZ
	)

Get the point world coordinates. We mean here the coordinates of the point in the object frame.

Definition at line 177 of file vpPoint.cpp.

References vpForwardProjection::oP.

getWorldCoordinates() [2/4]

void vpPoint::getWorldCoordinates

(

vpColVector &

P

)

Get the point world coordinates. We mean here the coordinates of the point in the object frame.

Parameters

P	Normalized coordinates of the point in the object frame P = (X, Y, Z, 1)

Definition at line 189 of file vpPoint.cpp.

References vpForwardProjection::oP.

getWorldCoordinates() [3/4]

vpColVector vpPoint::getWorldCoordinates

(

void

)

Return the point world coordinates. We mean here the coordinates of the point in the object frame.

Returns

Normalized coordinates of the point in the object frame P = (X, Y, Z, 1)

Definition at line 207 of file vpPoint.cpp.

References vpForwardProjection::oP.

getWorldCoordinates() [4/4]

void vpPoint::getWorldCoordinates

(

std::vector< double > &

P

)

Get the point world coordinates. We mean here the coordinates of the point in the object frame.

Parameters

P	Normalized coordinates of the point in the object frame P = (X, Y, Z, 1)

Definition at line 195 of file vpPoint.cpp.

References vpForwardProjection::oP, vpColVector::resize(), and vpArray2D< Type >::size().

init()

void vpPoint::init ( )

virtual

Basic construction.

Implements vpForwardProjection.

Definition at line 48 of file vpPoint.cpp.

References vpTracker::cP, vpForwardProjection::oP, vpTracker::p, vpColVector::resize(), and set_Z().

Referenced by vpPoint().

operator=()

vpPoint& vpPoint::operator= ( const vpPoint &  vpp )

default

print()

void vpForwardProjection::print ( ) const

virtualinherited

Print to stdout the feature parameters in:

• the object frame
• the camera frame
• the image plane.

Examples:

servoSimuCircle2DCamVelocityDisplay.cpp, servoSimuLine2DCamVelocityDisplay.cpp, and servoSimuSquareLine2DCamVelocityDisplay.cpp.

Definition at line 53 of file vpForwardProjection.cpp.

References vpTracker::cP, vpForwardProjection::oP, vpTracker::p, and vpColVector::t().

project() [1/2]

void vpForwardProjection::project ( )

inherited

Compute the feature parameters in the image plane (vpTracker::p) from the parameters in the camera frame (vpTracker::cP).

Warning

Be careful to update vpTracker::p and vpTracker::cP public attributes before the call of this method.

Examples:

homographyHartleyDLT2DObject.cpp, homographyHLM2DObject.cpp, homographyHLM3DObject.cpp, manGeometricFeatures.cpp, manServo4PointsDisplay.cpp, manSimu4Points.cpp, servoAfma62DhalfCamVelocity.cpp, servoAfma6Cylinder2DCamVelocity.cpp, servoAfma6Cylinder2DCamVelocitySecondaryTask.cpp, servoAfma6Line2DCamVelocity.cpp, servoAfma6SquareLines2DCamVelocity.cpp, servoAfma6TwoLines2DCamVelocity.cpp, servoPioneerPanSegment3D.cpp, simulateFourPoints2DPolarCamVelocity.cpp, testFeatureSegment.cpp, testFindMatch.cpp, and testPoseFeatures.cpp.

Definition at line 68 of file vpForwardProjection.cpp.

References vpTracker::cP, vpTracker::p, and vpForwardProjection::projection().

Referenced by vpMbtDistanceKltCylinder::computeInteractionMatrixAndResidu(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpKeyPoint::computePose(), vpMbtFaceDepthDense::computeROI(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpKeyPoint::matchPointAndDetect(), vpForwardProjection::track(), vpMbtDistanceCircle::~vpMbtDistanceCircle(), vpMbtDistanceCylinder::~vpMbtDistanceCylinder(), and vpMbtDistanceLine::~vpMbtDistanceLine().

project() [2/2]

void vpForwardProjection::project ( const vpHomogeneousMatrix &  cMo )

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).

Warning

The feature parameters in the object frame (vpForwardProjection:oP) need to be set prior the use of this method. To initialize these parameters see setWorldCoordinates().

Parameters

cMo	: The homogeneous matrix corresponding to the pose between the camera frame and the object frame.

Definition at line 84 of file vpForwardProjection.cpp.

References vpForwardProjection::changeFrame(), vpForwardProjection::projection(), and vpERROR_TRACE.

projection() [1/2]

void vpPoint::projection ( const vpColVector &  _cP, vpColVector &  _p  )

virtual

Projection onto the image plane of a point. Input: the 3D coordinates in the camera frame _cP, output : the 2D coordinates _p.

Compute the perspective projection of a point _cP.

Parameters

_cP	: Three dimension vector that corresponds to the coordinates of the point in the camera frame.
_p	: Coordinates of the point in the image plane obtained by perspective projection.

Implements vpForwardProjection.

Examples:

servoAfma6FourPoints2DCamVelocityLs_cur.cpp, servoAfma6FourPoints2DCamVelocityLs_des.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoViper850FourPoints2DArtVelocityLs_cur.cpp, servoViper850FourPoints2DCamVelocityLs_cur.cpp, and servoViper850FourPointsKinect.cpp.

Definition at line 216 of file vpPoint.cpp.

References vpColVector::resize().

Referenced by vpPolygon3D::changeFrame(), vpPolygon3D::computePolygonClipped(), vpMbtDistanceCylinder::getModelForDisplay(), vpMbtDistanceCylinder::initMovingEdge(), and vpMbtDistanceCylinder::updateMovingEdge().

projection() [2/2]

void vpPoint::projection ( )

virtual

Perspective projection of the point.

Projection onto the //image plane of the point. Update the object attribute p (2D //homogeneous coordinates) according to object attribute cP (current //3D coordinates in the camera frame).

Implements vpForwardProjection.

Definition at line 445 of file vpPoint.cpp.

References vpTracker::cP, and vpTracker::p.

Referenced by display().

set_oW()

void vpPoint::set_oW

(

double

oW

)

Set the point W coordinate in the object frame.

Definition at line 469 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by changeFrame(), and vpHomogeneousMatrix::operator*().

set_oX()

void vpPoint::set_oX

(

double

oX

)

Set the point X coordinate in the object frame.

Examples:

testConvert.cpp, and tutorial-chessboard-pose.cpp.

Definition at line 463 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by changeFrame(), vpKeyPoint::computePose(), vpHomogeneousMatrix::operator*(), vpPose::poseDementhonNonPlan(), and vpPose::poseDementhonPlan().

set_oY()

void vpPoint::set_oY

(

double

oY

)

Set the point Y coordinate in the object frame.

Examples:

testConvert.cpp, and tutorial-chessboard-pose.cpp.

Definition at line 465 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by changeFrame(), vpKeyPoint::computePose(), vpHomogeneousMatrix::operator*(), vpPose::poseDementhonNonPlan(), and vpPose::poseDementhonPlan().

set_oZ()

void vpPoint::set_oZ

(

double

oZ

)

Set the point Z coordinate in the object frame.

Examples:

testConvert.cpp, and tutorial-chessboard-pose.cpp.

Definition at line 467 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by changeFrame(), vpKeyPoint::computePose(), vpHomogeneousMatrix::operator*(), vpPose::poseDementhonNonPlan(), and vpPose::poseDementhonPlan().

set_W()

void vpPoint::set_W

(

double

W

)

Set the point W coordinate in the camera frame.

Definition at line 460 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpHomogeneousMatrix::operator*(), and vpPlane::projectionPointOnPlan().

set_w()

void vpPoint::set_w

(

double

w

)

Set the point w coordinate in the image plane.

Definition at line 476 of file vpPoint.cpp.

References vpTracker::p.

Referenced by changeFrame(), and vpHomography::operator*().

set_X()

void vpPoint::set_X

(

double

X

)

Set the point X coordinate in the camera frame.

Definition at line 454 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpMbtFaceDepthNormal::computePolygonCentroid(), vpPolygon3D::computePolygonClipped(), vpMbtFaceDepthDense::computeROI(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpMbtPolygon::isVisible(), vpHomogeneousMatrix::operator*(), and vpPlane::projectionPointOnPlan().

set_x()

void vpPoint::set_x

(

double

x

)

Set the point x coordinate in the image plane.

Examples:

AROgre.cpp, AROgreBasic.cpp, mbot-apriltag-ibvs.cpp, poseVirtualVS.cpp, servoAfma62DhalfCamVelocity.cpp, servoAfma6FourPoints2DCamVelocityLs_cur.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoBebop2.cpp, servoViper850FourPoints2DArtVelocityLs_cur.cpp, servoViper850FourPoints2DCamVelocityLs_cur.cpp, servoViper850FourPointsKinect.cpp, testAprilTag.cpp, testRobotAfma6Pose.cpp, testRobotViper850Pose.cpp, and tutorial-count-coins.cpp.

Definition at line 472 of file vpPoint.cpp.

References vpTracker::p.

Referenced by vpCalibration::addPoint(), changeFrame(), vpPose::findMatch(), vpMbTracker::initFromPoints(), vpKeyPoint::matchPoint(), vpHomography::operator*(), and vpHomography::project().

set_Y()

void vpPoint::set_Y

(

double

Y

)

Set the point Y coordinate in the camera frame.

Definition at line 456 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpMbtFaceDepthNormal::computePolygonCentroid(), vpPolygon3D::computePolygonClipped(), vpMbtFaceDepthDense::computeROI(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpMbtPolygon::isVisible(), vpHomogeneousMatrix::operator*(), and vpPlane::projectionPointOnPlan().

set_y()

void vpPoint::set_y

(

double

y

)

Set the point y coordinate in the image plane.

Examples:

AROgre.cpp, AROgreBasic.cpp, mbot-apriltag-ibvs.cpp, poseVirtualVS.cpp, servoAfma62DhalfCamVelocity.cpp, servoAfma6FourPoints2DCamVelocityLs_cur.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoBebop2.cpp, servoViper850FourPoints2DArtVelocityLs_cur.cpp, servoViper850FourPoints2DCamVelocityLs_cur.cpp, servoViper850FourPointsKinect.cpp, testAprilTag.cpp, testRobotAfma6Pose.cpp, testRobotViper850Pose.cpp, and tutorial-count-coins.cpp.

Definition at line 474 of file vpPoint.cpp.

References vpTracker::p.

Referenced by vpCalibration::addPoint(), changeFrame(), vpPose::findMatch(), vpMbTracker::initFromPoints(), vpKeyPoint::matchPoint(), vpHomography::operator*(), and vpHomography::project().

set_Z()

void vpPoint::set_Z

(

double

Z

)

Set the point Z coordinate in the camera frame.

Definition at line 458 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpMbtFaceDepthNormal::computePolygonCentroid(), vpPolygon3D::computePolygonClipped(), vpMbtFaceDepthDense::computeROI(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), init(), vpMbtPolygon::isVisible(), vpHomogeneousMatrix::operator*(), and vpPlane::projectionPointOnPlan().

setDeallocate()

void vpForwardProjection::setDeallocate ( vpForwardProjectionDeallocatorType  d )

inlineinherited

Definition at line 219 of file vpForwardProjection.h.

setWorldCoordinates() [1/3]

void vpPoint::setWorldCoordinates	(	double	oX,
		double	oY,
		double	oZ
	)

Set the 3D point world coordinates. We mean here the coordinates of the point in the object frame.

Parameters

oX,oY,oZ

Coordinates of a 3D point in the object frame.

Examples:

AROgre.cpp, AROgreBasic.cpp, homographyHartleyDLT2DObject.cpp, homographyHLM2DObject.cpp, homographyHLM3DObject.cpp, manGeometricFeatures.cpp, manServo4PointsDisplay.cpp, manSimu4Dots.cpp, manSimu4Points.cpp, poseVirtualVS.cpp, servoAfma62DhalfCamVelocity.cpp, servoAfma6FourPoints2DCamVelocityLs_cur.cpp, servoAfma6FourPoints2DCamVelocityLs_des.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoPioneerPanSegment3D.cpp, servoSimu4Points.cpp, servoSimuAfma6FourPoints2DCamVelocity.cpp, servoSimuFourPoints2DCamVelocity.cpp, servoSimuFourPoints2DCamVelocityDisplay.cpp, servoSimuFourPoints2DPolarCamVelocityDisplay.cpp, servoSimuViper850FourPoints2DCamVelocity.cpp, servoViper850FourPoints2DArtVelocityLs_cur.cpp, servoViper850FourPoints2DCamVelocityLs_cur.cpp, servoViper850FourPointsKinect.cpp, simulateFourPoints2DCartesianCamVelocity.cpp, simulateFourPoints2DPolarCamVelocity.cpp, testFeatureSegment.cpp, testRobotAfma6Pose.cpp, testRobotViper850Pose.cpp, tutorial-ibvs-4pts-ogre.cpp, tutorial-ibvs-4pts-plotter-continuous-gain-adaptive.cpp, tutorial-ibvs-4pts-plotter-gain-adaptive.cpp, tutorial-ibvs-4pts-plotter.cpp, and tutorial-ibvs-4pts.cpp.

Definition at line 113 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by vpMbTracker::addPolygon(), vpMbTracker::addProjectionErrorPolygon(), vpKeyPoint::compute3D(), vpKeyPoint::compute3DForPointsOnCylinders(), vpMbtFaceDepthNormal::computeDesiredNormalAndCentroid(), vpMbTracker::extractCylinders(), vpMbTracker::extractFaces(), vpMbTracker::extractLines(), vpMbTracker::getGravityCenter(), vpProjectionDisplay::init(), vpMbtDistanceKltCylinder::init(), vpMbTracker::initFromPoints(), vpMbTracker::loadCAOModel(), vpKeyPoint::matchPoint(), vpPose::poseFromRectangle(), vpWireFrameSimulator::projectCameraTrajectory(), and vpPoint().

setWorldCoordinates() [2/3]

void vpPoint::setWorldCoordinates ( const vpColVector &  P )

virtual

Set the 3D point world coordinates. We mean here the coordinates of the point in the object frame.

Parameters

P

Vector containing the coordinates of the 3D point in the object frame. This vector could be of dimension 3 or 4. If dimension is 3, P corresponds to the normalized coordinates P = (X, Y, Z, 1) where P[0]=X, P[1]=Y, P[2]=Z. If dimension is 4, P corresponds to the normalized coordinates P = (X, Y, Z, W) where P[0]=X, P[1]=Y, P[2]=Z and P[3]=W.

Implements vpForwardProjection.

Definition at line 130 of file vpPoint.cpp.

References vpException::dimensionError, vpForwardProjection::oP, and vpArray2D< Type >::size().

setWorldCoordinates() [3/3]

void vpPoint::setWorldCoordinates

(

const std::vector< double > &

P

)

Set the 3D point world coordinates. We mean here the coordinates of the point in the object frame.

Parameters

P

Vector containing the coordinates of the 3D point in the object frame. This vector could be of dimension 3 or 4. If dimension is 3, P corresponds to the normalized coordinates P = (X, Y, Z, 1) where P[0]=X, P[1]=Y, P[2]=Z. If dimension is 4, P corresponds to the normalized coordinates P = (X, Y, Z, W) where P[0]=X, P[1]=Y, P[2]=Z and P[3]=W.

Definition at line 157 of file vpPoint.cpp.

References vpException::dimensionError, and vpForwardProjection::oP.

track()

void vpForwardProjection::track ( const vpHomogeneousMatrix &  cMo )

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 &).

Warning

The feature parameters in the object frame (vpForwardProjection:oP) need to be set prior the use of this method. To initialize these parameters see setWorldCoordinates().

Parameters

cMo	: The homogeneous matrix corresponding to the pose between the camera frame and the object frame.

Examples:

mbot-apriltag-ibvs.cpp, servoBebop2.cpp, servoMomentPoints.cpp, servoMomentPolygon.cpp, servoSimu4Points.cpp, servoSimuAfma6FourPoints2DCamVelocity.cpp, servoSimuCircle2DCamVelocity.cpp, servoSimuCircle2DCamVelocityDisplay.cpp, servoSimuFourPoints2DCamVelocity.cpp, servoSimuFourPoints2DCamVelocityDisplay.cpp, servoSimuFourPoints2DPolarCamVelocityDisplay.cpp, servoSimuLine2DCamVelocityDisplay.cpp, servoSimuSphere.cpp, servoSimuSphere2DCamVelocity.cpp, servoSimuSphere2DCamVelocityDisplay.cpp, servoSimuSphere2DCamVelocityDisplaySecondaryTask.cpp, servoSimuSquareLine2DCamVelocityDisplay.cpp, servoSimuViper850FourPoints2DCamVelocity.cpp, simulateCircle2DCamVelocity.cpp, simulateFourPoints2DCartesianCamVelocity.cpp, simulateFourPoints2DPolarCamVelocity.cpp, tutorial-ibvs-4pts-ogre.cpp, tutorial-ibvs-4pts-plotter-continuous-gain-adaptive.cpp, tutorial-ibvs-4pts-plotter-gain-adaptive.cpp, tutorial-ibvs-4pts-plotter.cpp, tutorial-ibvs-4pts.cpp, tutorial-simu-pioneer-continuous-gain-adaptive.cpp, tutorial-simu-pioneer-continuous-gain-constant.cpp, tutorial-simu-pioneer-pan.cpp, and tutorial-simu-pioneer.cpp.

Definition at line 111 of file vpForwardProjection.cpp.

References vpForwardProjection::project(), and vpERROR_TRACE.

Referenced by vpPoseFeatures::addFeatureSegment(), vpPose::computeResidual(), vpProjectionDisplay::displayCamera(), ImageDisplay(withContext)::displayFrameWithContext:::::, vpImageDraw::drawFrame(), vpPose::poseVirtualVS(), vpPose::poseVirtualVSrobust(), vpWireFrameSimulator::projectCameraTrajectory(), vpSimulatorAfma6::updateArticularPosition(), and vpSimulatorViper850::updateArticularPosition().

Friends And Related Function Documentation

operator<<

VISP_EXPORT std::ostream& operator<< ( std::ostream &  os, const vpPoint &  vpp  )

friend

Definition at line 388 of file vpPoint.cpp.

Member Data Documentation

cP

vpColVector vpTracker::cP

inherited

Feature coordinates expressed in the camera frame cP.

Definition at line 75 of file vpTracker.h.

Referenced by vpFeaturePoint3D::buildFrom(), changeFrame(), vpCircle::changeFrame(), vpSphere::changeFrame(), vpCylinder::changeFrame(), vpLine::changeFrame(), vpFeatureBuilder::create(), get_W(), get_X(), get_Y(), get_Z(), vpCircle::init(), vpSphere::init(), init(), vpLine::init(), vpCylinder::init(), vpMbtPolygon::isVisible(), vpTracker::operator=(), vpForwardProjection::print(), vpPose::printPoint(), vpForwardProjection::project(), vpCircle::projection(), vpSphere::projection(), projection(), vpLine::projection(), vpCylinder::projection(), set_W(), set_X(), set_Y(), and set_Z().

cPAvailable

bool vpTracker::cPAvailable

inherited

Flag used to indicate if the feature parameters cP expressed in the camera frame are available.

Definition at line 81 of file vpTracker.h.

Referenced by vpTracker::init(), and vpTracker::operator=().

oP

vpColVector vpForwardProjection::oP

inherited

Feature coordinates expressed in the object frame, also called world frame.

Definition at line 74 of file vpForwardProjection.h.

Referenced by changeFrame(), vpCircle::changeFrame(), vpSphere::changeFrame(), vpCylinder::changeFrame(), vpLine::changeFrame(), get_oW(), get_oX(), get_oY(), get_oZ(), getWorldCoordinates(), vpCircle::init(), vpSphere::init(), init(), vpLine::init(), vpCylinder::init(), vpForwardProjection::print(), vpPose::printPoint(), set_oW(), set_oX(), set_oY(), set_oZ(), vpCircle::setWorldCoordinates(), vpSphere::setWorldCoordinates(), setWorldCoordinates(), vpLine::setWorldCoordinates(), and vpCylinder::setWorldCoordinates().

p

vpColVector vpTracker::p

inherited

Feature coordinates expressed in the image plane p. They correspond to 2D normalized coordinates expressed in meters.

Definition at line 71 of file vpTracker.h.

Referenced by vpMbtDistanceCircle::computeInteractionMatrixError(), vpCircle::computeIntersectionPoint(), vpMeterPixelConversion::convertEllipse(), vpFeatureBuilder::create(), display(), vpCircle::display(), vpSphere::display(), vpCylinder::display(), vpProjectionDisplay::display(), vpLine::display(), vpProjectionDisplay::displayCamera(), vpFeatureDisplay::displayEllipse(), ImageDisplay(withContext)::displayFrameWithContext:::::, vpPose::displayModel(), vpImageDraw::drawFrame(), get_w(), get_x(), get_y(), vpCircle::init(), vpSphere::init(), vpMeTracker::init(), init(), vpLine::init(), vpCylinder::init(), vpTracker::operator=(), vpForwardProjection::print(), vpPose::printPoint(), vpForwardProjection::project(), vpCircle::projection(), vpSphere::projection(), projection(), vpLine::projection(), vpCylinder::projection(), set_w(), set_x(), and set_y().