#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, const unsigned int thickness=1)

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

void	display (const vpImage< vpRGBa > &I, const vpHomogeneousMatrix &cMo, const vpCameraParameters &cam, const vpColor &color=vpColor::green, const 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)

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

void	projection ()

void	set_X (const double X)

void	set_Y (const double Y)

void	set_Z (const double Z)

void	set_W (const double W)

void	set_oX (const double oX)

void	set_oY (const double oY)

void	set_oZ (const double oZ)

void	set_oW (const double oW)

void	set_x (const double x)

void	set_y (const double y)

void	set_w (const double w)

void	setWorldCoordinates (const double oX, const double oY, const 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, poseVirtualVS.cpp, servoAfma62DhalfCamVelocity.cpp, servoAfma6FourPoints2DCamVelocityInteractionCurrent.cpp, servoAfma6FourPoints2DCamVelocityInteractionDesired.cpp, servoAfma6Points2DCamVelocityEyeToHand.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, servoViper850FourPoints2DArtVelocityInteractionCurrent.cpp, servoViper850FourPoints2DCamVelocityInteractionCurrent.cpp, servoViper850FourPointsKinect.cpp, simulateFourPoints2DCartesianCamVelocity.cpp, simulateFourPoints2DPolarCamVelocity.cpp, testConvert.cpp, testFeatureSegment.cpp, testFindMatch.cpp, testKeyPoint-4.cpp, testPose.cpp, testPoseFeatures.cpp, testPoseRansac.cpp, testPoseRansac2.cpp, testRobotAfma6Pose.cpp, testRobotViper850Pose.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-tracking.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:: servoAfma6FourPoints2DCamVelocityInteractionCurrent.cpp, servoAfma6FourPoints2DCamVelocityInteractionDesired.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoPioneerPanSegment3D.cpp, servoViper850FourPoints2DArtVelocityInteractionCurrent.cpp, servoViper850FourPoints2DCamVelocityInteractionCurrent.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(), vpMbtDistanceLine::display(), vpMbtDistanceCylinder::display(), vpMbtFaceDepthNormal::displayFeature(), 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`,
		const unsigned int	thickness = `1`
	)

virtual

Display the point in the image.

Implements vpForwardProjection.

Examples:: manGeometricFeatures.cpp, and servoAfma6Points2DCamVelocityEyeToHand.cpp.

Definition at line 403 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`,
		const 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`,
		const 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 426 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, and testPoseRansac2.cpp.

Definition at line 420 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by vpMbTracker::addPolygon(), vpMbtDistanceCircle::buildFrom(), vpMbtDistanceLine::buildFrom(), vpMbtDistanceKltCylinder::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(), vpMbEdgeTracker::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, and testPoseRansac2.cpp.

Definition at line 422 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by vpMbTracker::addPolygon(), vpMbtDistanceCircle::buildFrom(), vpMbtDistanceLine::buildFrom(), vpMbtDistanceKltCylinder::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(), vpMbEdgeTracker::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, and testPoseRansac2.cpp.

Definition at line 424 of file vpPoint.cpp.

References vpForwardProjection::oP.

Referenced by vpMbTracker::addPolygon(), vpMbtDistanceCircle::buildFrom(), vpMbtDistanceLine::buildFrom(), vpMbtDistanceKltCylinder::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(), vpMbEdgeTracker::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 417 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 433 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 411 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpMbtFaceDepthNormal::computePolygonCentroid(), vpPolygon3D::computePolygonClipped(), vpMbtFaceDepthDense::computeROI(), vpMbtFaceDepthNormal::displayFeature(), 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, testFindMatch.cpp, and testPoseRansac2.cpp.

Definition at line 429 of file vpPoint.cpp.

References vpTracker::p.

Referenced by changeFrame(), vpMbtDistanceKltCylinder::computeInteractionMatrixAndResidu(), vpKeyPoint::computePose(), vpPose::computeResidual(), vpFeatureBuilder::create(), vpMbtFaceDepthNormal::displayFeature(), vpKeyPoint::matchPointAndDetect(), vpHomography::operator*(), vpPose::poseFromRectangle(), vpPose::poseLagrangeNonPlan(), vpPose::poseLagrangePlan(), vpPose::poseLowe(), vpPose::poseRansac(), 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 413 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpPolygon3D::computePolygonClipped(), vpMbtFaceDepthDense::computeROI(), vpMbtFaceDepthNormal::displayFeature(), 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, testFindMatch.cpp, and testPoseRansac2.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(), vpKeyPoint::matchPointAndDetect(), vpHomography::operator*(), vpPose::poseFromRectangle(), vpPose::poseLagrangeNonPlan(), vpPose::poseLagrangePlan(), vpPose::poseLowe(), vpPose::poseRansac(), 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 415 of file vpPoint.cpp.

References vpTracker::cP.

Referenced by changeFrame(), vpMbtFaceDepthNormal::computeNormalVisibility(), vpPolygon3D::computePolygonClipped(), vpMbtFaceDepthDense::computeROI(), vpFeatureBuilder::create(), vpProjectionDisplay::displayCamera(), vpMbtFaceDepthNormal::displayFeature(), 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 )

Definition at line 390 of file vpPoint.cpp.

References vpTracker::cP, vpTracker::cPAvailable, vpForwardProjection::oP, and vpTracker::p.

◆ 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, testPose.cpp, testPoseFeatures.cpp, and testPoseRansac2.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(), 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:: servoAfma6FourPoints2DCamVelocityInteractionCurrent.cpp, servoAfma6FourPoints2DCamVelocityInteractionDesired.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoViper850FourPoints2DArtVelocityInteractionCurrent.cpp, servoViper850FourPoints2DCamVelocityInteractionCurrent.cpp, and servoViper850FourPointsKinect.cpp.

Definition at line 216 of file vpPoint.cpp.

References vpColVector::resize().

Referenced by vpPolygon3D::changeFrame(), vpPolygon3D::computePolygonClipped(), vpMbtDistanceCylinder::display(), 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 443 of file vpPoint.cpp.

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

Referenced by display().

◆ set_oW()

void vpPoint::set_oW ( const double oW )

Set the point W coordinate in the object frame.

Definition at line 467 of file vpPoint.cpp.

References vpForwardProjection::oP.

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

◆ set_oX()

void vpPoint::set_oX ( const double oX )

Set the point X coordinate in the object frame.

Examples:: testConvert.cpp, and testPoseRansac2.cpp.

Definition at line 461 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 ( const double oY )

Set the point Y coordinate in the object frame.

Examples:: testConvert.cpp, and testPoseRansac2.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_oZ()

void vpPoint::set_oZ ( const double oZ )

Set the point Z coordinate in the object frame.

Examples:: testConvert.cpp, and testPoseRansac2.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_W()

void vpPoint::set_W ( const double W )

Set the point W coordinate in the camera frame.

Definition at line 458 of file vpPoint.cpp.

References vpTracker::cP.

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

◆ set_w()

void vpPoint::set_w ( const double w )

Set the point w coordinate in the image plane.

Definition at line 474 of file vpPoint.cpp.

References vpTracker::p.

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

◆ set_X()

void vpPoint::set_X ( const double X )

Set the point X coordinate in the camera frame.

Definition at line 452 of file vpPoint.cpp.

References vpTracker::cP.

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

◆ set_x()

void vpPoint::set_x ( const double x )

Set the point x coordinate in the image plane.

Examples:: AROgre.cpp, AROgreBasic.cpp, poseVirtualVS.cpp, servoAfma62DhalfCamVelocity.cpp, servoAfma6FourPoints2DCamVelocityInteractionCurrent.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoViper850FourPoints2DArtVelocityInteractionCurrent.cpp, servoViper850FourPoints2DCamVelocityInteractionCurrent.cpp, servoViper850FourPointsKinect.cpp, testPoseRansac2.cpp, testRobotAfma6Pose.cpp, testRobotViper850Pose.cpp, and tutorial-count-coins.cpp.

Definition at line 470 of file vpPoint.cpp.

References vpTracker::p.

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

◆ set_Y()

void vpPoint::set_Y ( const double Y )

Set the point Y 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(), vpMbtPolygon::isVisible(), vpHomogeneousMatrix::operator*(), and vpPlane::projectionPointOnPlan().

◆ set_y()

void vpPoint::set_y ( const double y )

Set the point y coordinate in the image plane.

Examples:: AROgre.cpp, AROgreBasic.cpp, poseVirtualVS.cpp, servoAfma62DhalfCamVelocity.cpp, servoAfma6FourPoints2DCamVelocityInteractionCurrent.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoViper850FourPoints2DArtVelocityInteractionCurrent.cpp, servoViper850FourPoints2DCamVelocityInteractionCurrent.cpp, servoViper850FourPointsKinect.cpp, testPoseRansac2.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::initClick(), vpMbTracker::initFromPoints(), vpKeyPoint::matchPoint(), vpHomography::operator*(), and vpHomography::project().

◆ set_Z()

void vpPoint::set_Z ( const double Z )

Set the point Z 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(), 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	(	const double	oX,
		const double	oY,
		const 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, servoAfma6FourPoints2DCamVelocityInteractionCurrent.cpp, servoAfma6FourPoints2DCamVelocityInteractionDesired.cpp, servoAfma6Points2DCamVelocityEyeToHand.cpp, servoPioneerPanSegment3D.cpp, servoSimu4Points.cpp, servoSimuAfma6FourPoints2DCamVelocity.cpp, servoSimuFourPoints2DCamVelocity.cpp, servoSimuFourPoints2DCamVelocityDisplay.cpp, servoSimuFourPoints2DPolarCamVelocityDisplay.cpp, servoSimuViper850FourPoints2DCamVelocity.cpp, servoViper850FourPoints2DArtVelocityInteractionCurrent.cpp, servoViper850FourPoints2DCamVelocityInteractionCurrent.cpp, servoViper850FourPointsKinect.cpp, simulateFourPoints2DCartesianCamVelocity.cpp, simulateFourPoints2DPolarCamVelocity.cpp, testFeatureSegment.cpp, testPose.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(), vpKeyPoint::compute3D(), vpKeyPoint::compute3DForPointsOnCylinders(), vpMbtFaceDepthNormal::computeDesiredNormalAndCentroid(), vpMbTracker::extractCylinders(), vpMbTracker::extractFaces(), vpMbTracker::extractLines(), vpMbTracker::getGravityCenter(), vpProjectionDisplay::init(), vpMbtDistanceKltCylinder::init(), vpMbTracker::initClick(), vpMbTracker::initFromPoints(), vpMbTracker::loadCAOModel(), vpKeyPoint::matchPoint(), vpPose::poseFromRectangle(), vpPose::poseRansac(), 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:: servoMomentPoints.cpp, servoMomentPolygon.cpp, servoSimu4Points.cpp, servoSimuAfma6FourPoints2DCamVelocity.cpp, servoSimuCircle2DCamVelocity.cpp, servoSimuCircle2DCamVelocityDisplay.cpp, servoSimuFourPoints2DCamVelocity.cpp, servoSimuFourPoints2DCamVelocityDisplay.cpp, servoSimuFourPoints2DPolarCamVelocityDisplay.cpp, servoSimuLine2DCamVelocityDisplay.cpp, servoSimuSphere.cpp, servoSimuSphere2DCamVelocity.cpp, servoSimuSphere2DCamVelocitySecondaryTask.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(), vpPose::poseRansac(), 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=(), 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(), vpTracker::operator=(), and 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(), operator=(), 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(), vpPose::displayModel(), get_w(), get_x(), get_y(), vpCircle::init(), vpSphere::init(), vpMeTracker::init(), init(), vpLine::init(), vpCylinder::init(), vpTracker::operator=(), operator=(), vpForwardProjection::print(), vpPose::printPoint(), vpForwardProjection::project(), vpCircle::projection(), vpSphere::projection(), projection(), vpLine::projection(), vpCylinder::projection(), set_w(), set_x(), and set_y().

Public Types

Public Member Functions

Public Attributes

Friends

Detailed Description

Member Enumeration Documentation

◆ vpForwardProjectionDeallocatorType

Constructor & Destructor Documentation

◆ vpPoint() [1/4]

◆ vpPoint() [2/4]

◆ vpPoint() [3/4]

◆ vpPoint() [4/4]

◆ ~vpPoint()

Member Function Documentation

◆ changeFrame() [1/2]

◆ changeFrame() [2/2]

◆ display() [1/3]

◆ display() [2/3]

◆ display() [3/3]

◆ duplicate()

◆ get_oW()

◆ get_oX()

◆ get_oY()

◆ get_oZ()

◆ get_W()

◆ get_w()

◆ get_X()

◆ get_x()

◆ get_Y()

◆ get_y()

◆ get_Z()

◆ getDeallocate()

◆ getWorldCoordinates() [1/4]

◆ getWorldCoordinates() [2/4]

◆ getWorldCoordinates() [3/4]

◆ getWorldCoordinates() [4/4]

◆ init()

◆ operator=()

◆ print()

◆ project() [1/2]

◆ project() [2/2]

◆ projection() [1/2]

◆ projection() [2/2]

◆ set_oW()

◆ set_oX()

◆ set_oY()

◆ set_oZ()

◆ set_W()

◆ set_w()

◆ set_X()

◆ set_x()

◆ set_Y()

◆ set_y()

◆ set_Z()

◆ setDeallocate()

◆ setWorldCoordinates() [1/3]

◆ setWorldCoordinates() [2/3]

◆ setWorldCoordinates() [3/3]

◆ track()

Friends And Related Function Documentation

◆ operator<<

Member Data Documentation

◆ cP

◆ cPAvailable

◆ oP

◆ p