Visual Servoing Platform version 3.7.0
Loading...
Searching...
No Matches
vpMeterPixelConversion Class Reference
core: Core module » Camera model

#include <vpMeterPixelConversion.h>

Static Public Member Functions

Using ViSP camera parameters
static void convertEllipse (const vpCameraParameters &cam, const vpSphere &sphere, vpImagePoint &center_p, double &n20_p, double &n11_p, double &n02_p)
static void convertEllipse (const vpCameraParameters &cam, const vpCircle &circle, vpImagePoint &center_p, double &n20_p, double &n11_p, double &n02_p)
static void convertEllipse (const vpCameraParameters &cam, double xc_m, double yc_m, double n20_m, double n11_m, double n02_m, vpImagePoint &center_p, double &n20_p, double &n11_p, double &n02_p)
static void convertLine (const vpCameraParameters &cam, const double &rho_m, const double &theta_m, double &rho_p, double &theta_p)
static void convertPoint (const vpCameraParameters &cam, const double &x, const double &y, double &u, double &v)
static void convertPoint (const vpCameraParameters &cam, const double &x, const double &y, vpImagePoint &iP)
Using OpenCV camera parameters
static void convertEllipse (const cv::Mat &cameraMatrix, const vpCircle &circle, vpImagePoint &center, double &n20_p, double &n11_p, double &n02_p)
static void convertEllipse (const cv::Mat &cameraMatrix, const vpSphere &sphere, vpImagePoint &center, double &n20_p, double &n11_p, double &n02_p)
static void convertEllipse (const cv::Mat &cameraMatrix, double xc_m, double yc_m, double n20_m, double n11_m, double n02_m, vpImagePoint &center_p, double &n20_p, double &n11_p, double &n02_p)
static void convertLine (const cv::Mat &cameraMatrix, const double &rho_m, const double &theta_m, double &rho_p, double &theta_p)
static void convertPoint (const cv::Mat &cameraMatrix, const cv::Mat &distCoeffs, const double &x, const double &y, double &u, double &v)
static void convertPoint (const cv::Mat &cameraMatrix, const cv::Mat &distCoeffs, const double &x, const double &y, vpImagePoint &iP)

Detailed Description

Various conversion functions to transform primitives (2D ellipse, 2D line, 2D point) from normalized coordinates in meter in the image plane into pixel coordinates.

Transformation relies either on ViSP camera parameters implemented in vpCameraParameters or on OpenCV camera parameters that are set from a projection matrix and a distortion coefficients vector.

Definition at line 66 of file vpMeterPixelConversion.h.

Member Function Documentation

◆ convertEllipse() [1/6]

void vpMeterPixelConversion::convertEllipse ( const cv::Mat & cameraMatrix,
const vpCircle & circle,
vpImagePoint & center,
double & n20_p,
double & n11_p,
double & n02_p )
static

Noting that the perspective projection of a 3D circle is usually an ellipse, using the camera intrinsic parameters converts the parameters of the 3D circle expressed in the image plane (these parameters are obtained after perspective projection of the 3D circle) in the image with values in pixels using OpenCV camera parameters.

The ellipse resulting from the conversion is here represented by its parameters $u_c,v_c,n_{20}, n_{11}, n_{02}$ corresponding to its center coordinates in pixel and the centered moments normalized by its area.

Parameters
[in]cameraMatrix: Camera Matrix $\begin{bmatrix} f_x & 0 & c_x \\ 0 & f_y & c_y \\ 0 & 0 & 1\end{bmatrix}$
[in]circle: 3D circle with internal vector circle.p[] that contains the ellipse parameters expressed in the image plane. These parameters are internally updated after perspective projection of the sphere.
[out]center: Center of the corresponding ellipse in the image with coordinates expressed in pixels.
[out]n20_p: Second order $ n_{20} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n11_p: Second order $ n_{11} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n02_p: Second order $ n_{02} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.

The following code shows how to use this function:

vpCircle circle;
double n20_p, n11_p, n02_p;
circle.changeFrame(cMo);
circle.projection();
cv::Mat cameraMatrix = (cv::Mat_<double>(3,3) << px, 0, u0,
0, py, v0,
0, 0, 1);
vpMeterPixelConversion::convertEllipse(cameraMatrix, circle, center_p, n20_p, n11_p, n02_p);
vpDisplay::displayEllipse(I, center_p, n20_p, n11_p, n02_p, true, vpColor::red);
vpCircle
Class that defines a 3D circle in the object frame and allows forward projection of a 3D circle in th...
Definition vpCircle.h:87
vpCircle::changeFrame
void changeFrame(const vpHomogeneousMatrix &noMo, vpColVector &noP) const VP_OVERRIDE
Definition vpCircle.cpp:273
vpCircle::projection
void projection() VP_OVERRIDE
Definition vpCircle.cpp:151
vpColor::red
static const vpColor red
Definition vpColor.h:198
vpDisplay::displayEllipse
static void displayEllipse(const vpImage< unsigned char > &I, const vpImagePoint &center, const double &coef1, const double &coef2, const double &coef3, bool use_normalized_centered_moments, const vpColor &color, unsigned int thickness=1, bool display_center=false, bool display_arc=false)
Definition vpDisplay_uchar.cpp:359
vpMeterPixelConversion::convertEllipse
static void convertEllipse(const vpCameraParameters &cam, const vpSphere &sphere, vpImagePoint &center_p, double &n20_p, double &n11_p, double &n02_p)
Definition vpMeterPixelConversion.cpp:162

Definition at line 293 of file vpMeterPixelConversion.cpp.

References convertPoint(), vpTracker::p, and vpMath::sqr().

◆ convertEllipse() [2/6]

void vpMeterPixelConversion::convertEllipse ( const cv::Mat & cameraMatrix,
const vpSphere & sphere,
vpImagePoint & center,
double & n20_p,
double & n11_p,
double & n02_p )
static

Noting that the perspective projection of a 3D sphere is usually an ellipse, using the camera intrinsic parameters converts the parameters of the 3D sphere expressed in the image plane (these parameters are obtained after perspective projection of the 3D sphere) in the image with values in pixels using OpenCV camera parameters.

The ellipse resulting from the conversion is here represented by its parameters $u_c,v_c,n_{20}, n_{11}, n_{02}$ corresponding to its center coordinates in pixel and the centered moments normalized by its area.

Parameters
[in]cameraMatrix: Camera Matrix $\begin{bmatrix} f_x & 0 & c_x \\ 0 & f_y & c_y \\ 0 & 0 & 1\end{bmatrix}$
[in]sphere: 3D sphere with internal vector circle.p[] that contains the ellipse parameters expressed in the image plane. These parameters are internally updated after perspective projection of the sphere.
[out]center: Center of the corresponding ellipse in the image with coordinates expressed in pixels.
[out]n20_p: Second order $ n_{20} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n11_p: Second order $ n_{11} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n02_p: Second order $ n_{02} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.

The following code shows how to use this function:

vpSphere sphere;
double n20_p, n11_p, n02_p;
sphere.changeFrame(cMo);
sphere.projection();
cv::Mat cameraMatrix = (cv::Mat_<double>(3,3) << px, 0, u0,
0, py, v0,
0, 0, 1);
vpMeterPixelConversion::convertEllipse(cameraMatrix, sphere, center_p, n20_p, n11_p, n02_p);
vpDisplay::displayEllipse(I, center_p, n20_p, n11_p, n02_p, true, vpColor::red);
vpSphere
Class that defines a 3D sphere in the object frame and allows forward projection of a 3D sphere in th...
Definition vpSphere.h:80
vpSphere::projection
void projection() VP_OVERRIDE
Definition vpSphere.cpp:124
vpSphere::changeFrame
void changeFrame(const vpHomogeneousMatrix &cMo, vpColVector &cP) const VP_OVERRIDE
Definition vpSphere.cpp:220

Definition at line 351 of file vpMeterPixelConversion.cpp.

References convertPoint(), vpTracker::p, and vpMath::sqr().

◆ convertEllipse() [3/6]

void vpMeterPixelConversion::convertEllipse ( const cv::Mat & cameraMatrix,
double xc_m,
double yc_m,
double n20_m,
double n11_m,
double n02_m,
vpImagePoint & center_p,
double & n20_p,
double & n11_p,
double & n02_p )
static

Convert parameters of an ellipse expressed in the image plane (these parameters are obtained after perspective projection of the 3D sphere) in the image with values in pixels using ViSP intrinsic camera parameters.

The ellipse resulting from the conversion is here represented by its parameters $u_c,v_c,n_{20}, n_{11}, n_{02}$ corresponding to its center coordinates in pixel and the centered moments normalized by its area.

Parameters
[in]cameraMatrix: Camera Matrix $\begin{bmatrix} f_x & 0 & c_x \\ 0 & f_y & c_y \\ 0 & 0 & 1\end{bmatrix}$
[in]xc_m: Coordinate along x-axis of the center of the ellipse in the image plane with normalized coordinates expressed in meters.
[in]yc_m: Coordinate along y-axis of the center of the ellipse in the image plane with normalized coordinates expressed in meters.
[in]n20_m: Second order $ n_{20} $ centered moment of the ellipse normalized by its area (i.e., such that $n_{ij} = \mu_{ij}/a$ where $\mu_{ij}$ are the centered moments and a the area) expressed in meter.
[in]n11_m: Second order $ n_{11} $ centered moment of the ellipse normalized by its area (i.e., such that $n_{ij} = \mu_{ij}/a$ where $\mu_{ij}$ are the centered moments and a the area) expressed in meter.
[in]n02_m: Second order $ n_{02} $ centered moment of the ellipse normalized by its area (i.e., such that $n_{ij} = \mu_{ij}/a$ where $\mu_{ij}$ are the centered moments and a the area) expressed in meter.
[out]center_p: Center $(u_c, v_c)$ of the corresponding ellipse in the image with coordinates expressed in pixels.
[out]n20_p: Second order $ n_{20} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n11_p: Second order $ n_{11} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n02_p: Second order $ n_{02} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.

Definition at line 407 of file vpMeterPixelConversion.cpp.

References convertPoint(), and vpMath::sqr().

◆ convertEllipse() [4/6]

void vpMeterPixelConversion::convertEllipse ( const vpCameraParameters & cam,
const vpCircle & circle,
vpImagePoint & center_p,
double & n20_p,
double & n11_p,
double & n02_p )
static

Noting that the perspective projection of a 3D circle is usually an ellipse, using the camera intrinsic parameters converts the parameters of the 3D circle expressed in the image plane (these parameters are obtained after perspective projection of the 3D circle) in the image with values in pixels using ViSP camera parameters.

The ellipse resulting from the conversion is here represented by its parameters $u_c,v_c,n_{20}, n_{11}, n_{02}$ corresponding to its center coordinates in pixel and the centered moments normalized by its area.

Parameters
[in]cam: Intrinsic camera parameters.
[in]circle: 3D circle with internal vector circle.p[] that contains the ellipse parameters expressed in the image plane. These parameters are internally updated after perspective projection of the sphere.
[out]center_p: Center $(u_c, v_c)$ of the corresponding ellipse in the image with coordinates expressed in pixels.
[out]n20_p: Second order $ n_{20} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n11_p: Second order $ n_{11} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n02_p: Second order $ n_{02} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.

The following code shows how to use this function:

vpCircle circle;
double n20_p, n11_p, n02_p;
circle.changeFrame(cMo);
circle.projection();
vpMeterPixelConversion::convertEllipse(cam, circle, center_p, n20_p, n11_p, n02_p);
vpDisplay::displayEllipse(I, center_p, n20_p, n11_p, n02_p, true, vpColor::red);

Definition at line 110 of file vpMeterPixelConversion.cpp.

References convertPoint(), vpTracker::p, and vpMath::sqr().

◆ convertEllipse() [5/6]

void vpMeterPixelConversion::convertEllipse ( const vpCameraParameters & cam,
const vpSphere & sphere,
vpImagePoint & center_p,
double & n20_p,
double & n11_p,
double & n02_p )
static

Noting that the perspective projection of a 3D sphere is usually an ellipse, using the camera intrinsic parameters converts the parameters of the 3D sphere expressed in the image plane (these parameters are obtained after perspective projection of the 3D sphere) in the image with values in pixels.

The ellipse resulting from the conversion is here represented by its parameters $u_c,v_c,n_{20}, n_{11}, n_{02}$ corresponding to its center coordinates in pixel and the centered moments normalized by its area.

Parameters
[in]cam: Intrinsic camera parameters.
[in]sphere: 3D sphere with internal vector circle.p[] that contains the ellipse parameters expressed in the image plane. These parameters are internally updated after perspective projection of the sphere.
[out]center_p: Center $(u_c, v_c)$ of the corresponding ellipse in the image with coordinates expressed in pixels.
[out]n20_p: Second order $ n_{20} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n11_p: Second order $ n_{11} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n02_p: Second order $ n_{02} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.

The following code shows how to use this function:

vpSphere sphere;
double n20_p, n11_p, n02_p;
sphere.changeFrame(cMo);
sphere.projection();
vpMeterPixelConversion::convertEllipse(cam, sphere, center_p, n20_p, n11_p, n02_p);
vpDisplay::displayEllipse(I, center_p, n20_p, n11_p, n02_p, true, vpColor::red);
Examples
testCameraParametersConversion.cpp.

Definition at line 162 of file vpMeterPixelConversion.cpp.

References convertPoint(), vpTracker::p, and vpMath::sqr().

Referenced by vpFeatureDisplay::displayEllipse(), vpFeatureDisplay::displayEllipse(), vpMbtDistanceCircle::getModelForDisplay(), vpMbtDistanceCircle::initMovingEdge(), and vpMbtDistanceCircle::updateMovingEdge().

◆ convertEllipse() [6/6]

void vpMeterPixelConversion::convertEllipse ( const vpCameraParameters & cam,
double xc_m,
double yc_m,
double n20_m,
double n11_m,
double n02_m,
vpImagePoint & center_p,
double & n20_p,
double & n11_p,
double & n02_p )
static

Convert parameters of an ellipse expressed in the image plane (these parameters are obtained after perspective projection of the 3D sphere) in the image with values in pixels using ViSP intrinsic camera parameters.

The ellipse resulting from the conversion is here represented by its parameters $u_c,v_c,n_{20}, n_{11}, n_{02}$ corresponding to its center coordinates in pixel and the centered moments normalized by its area.

Parameters
[in]cam: Intrinsic camera parameters.
[in]xc_m: Coordinate along x-axis of the center of the ellipse in the image plane with normalized coordinates expressed in meters.
[in]yc_m: Coordinate along y-axis of the center of the ellipse in the image plane with normalized coordinates expressed in meters.
[in]n20_m: Second order $ n_{20} $ centered moment of the ellipse normalized by its area (i.e., such that $n_{ij} = \mu_{ij}/a$ where $\mu_{ij}$ are the centered moments and a the area) expressed in meter.
[in]n11_m: Second order $ n_{11} $ centered moment of the ellipse normalized by its area (i.e., such that $n_{ij} = \mu_{ij}/a$ where $\mu_{ij}$ are the centered moments and a the area) expressed in meter.
[in]n02_m: Second order $ n_{02} $ centered moment of the ellipse normalized by its area (i.e., such that $n_{ij} = \mu_{ij}/a$ where $\mu_{ij}$ are the centered moments and a the area) expressed in meter.
[out]center_p: Center $(u_c, v_c)$ of the corresponding ellipse in the image with coordinates expressed in pixels.
[out]n20_p: Second order $ n_{20} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n11_p: Second order $ n_{11} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.
[out]n02_p: Second order $ n_{02} $ centered moment of the ellipse normalized by its area (i.e., such that $ n_{ij} = \mu_{ij}/a$ where $\mu_{ij} $ are the centered moments and a the area) expressed in pixels.

Definition at line 216 of file vpMeterPixelConversion.cpp.

References convertPoint(), and vpMath::sqr().

◆ convertLine() [1/2]

void vpMeterPixelConversion::convertLine ( const cv::Mat & cameraMatrix,
const double & rho_m,
const double & theta_m,
double & rho_p,
double & theta_p )
static

Line parameters conversion from normalized coordinates $(\rho_m,\theta_m)$ expressed in the image plane to pixel coordinates $(\rho_p,\theta_p)$ using OpenCV camera parameters. This function doesn't use distortion coefficients.

Parameters
[in]cameraMatrix: Camera Matrix $\begin{bmatrix} f_x & 0 & c_x \\ 0 & f_y & c_y \\ 0 & 0 & 1\end{bmatrix}$
[in]rho_p: Line $ \rho $ parameter expressed in pixels.
[in]theta_p: Line $ \theta $ parameter expressed in pixels.
[out]rho_m: Line $ \rho $ parameter expressed in meters in the image plane.
[out]theta_m: Line $ \theta $ parameter expressed in meters in the image plane.

Definition at line 241 of file vpMeterPixelConversion.cpp.

References vpException::divideByZeroError, and vpMath::sqr().

◆ convertLine() [2/2]

BEGIN_VISP_NAMESPACE void vpMeterPixelConversion::convertLine ( const vpCameraParameters & cam,
const double & rho_m,
const double & theta_m,
double & rho_p,
double & theta_p )
static

Line parameters conversion from normalized coordinates $(\rho_m,\theta_m)$ expressed in the image plane to pixel coordinates $(\rho_p,\theta_p)$ using ViSP camera parameters. This function doesn't use distortion coefficients.

Parameters
[in]cam: camera parameters.
[out]rho_p: Line $ \rho_p $ parameter expressed in pixels.
[out]theta_p: Line $ \theta_p $ parameter expressed in pixels.
[in]rho_m: Line $ \rho_m $ parameter expressed in meters in the image plane.
[in]theta_m: Line $ \theta_m $ parameter expressed in meters in the image plane.
Examples
testCameraParametersConversion.cpp.

Definition at line 64 of file vpMeterPixelConversion.cpp.

References vpException::divideByZeroError, and vpMath::sqr().

Referenced by vpFeatureDisplay::displayLine(), vpFeatureDisplay::displayLine(), vpMbtDistanceCylinder::getModelForDisplay(), vpMbtDistanceKltCylinder::getModelForDisplay(), vpMbtDistanceCylinder::initMovingEdge(), vpMbtDistanceLine::initMovingEdge(), vpMbtDistanceCylinder::updateMovingEdge(), and vpMbtDistanceLine::updateMovingEdge().

◆ convertPoint() [1/4]

void vpMeterPixelConversion::convertPoint ( const cv::Mat & cameraMatrix,
const cv::Mat & distCoeffs,
const double & x,
const double & y,
double & u,
double & v )
static

Point coordinates conversion from normalized coordinates $(x,y)$ in meter in the image plane to pixel coordinates $(u,v)$ in the image using OpenCV camera parameters.

Parameters
[in]cameraMatrix: Camera Matrix $\begin{bmatrix} f_x & 0 & c_x \\ 0 & f_y & c_y \\ 0 & 0 & 1\end{bmatrix}$
[in]distCoeffs: Input vector of distortion coefficients $(k_1, k_2, p_1, p_2[, k_3[, k_4, k_5, k_6 [, s_1, s_2, s_3, s_4[, \tau_x, \tau_y]]]])$ of 4, 5, 8, 12 or 14 elements. If the vector is nullptr/empty, the zero distortion coefficients are assumed.
[in]x: input coordinate in meter along image plane x-axis.
[in]y: input coordinate in meter along image plane y-axis.
[out]u: output coordinate in pixels along image horizontal axis.
[out]v: output coordinate in pixels along image vertical axis.

Definition at line 437 of file vpMeterPixelConversion.cpp.

◆ convertPoint() [2/4]

void vpMeterPixelConversion::convertPoint ( const cv::Mat & cameraMatrix,
const cv::Mat & distCoeffs,
const double & x,
const double & y,
vpImagePoint & iP )
static

Point coordinates conversion from normalized coordinates $(x,y)$ in meter in the image plane to pixel coordinates $(u,v)$ in the image using OpenCV camera parameters.

Parameters
[in]cameraMatrix: Camera Matrix $\begin{bmatrix} f_x & 0 & c_x \\ 0 & f_y & c_y \\ 0 & 0 & 1\end{bmatrix}$
[in]distCoeffs: Input vector of distortion coefficients $(k_1, k_2, p_1, p_2[, k_3[, k_4, k_5, k_6 [, s_1, s_2, s_3, s_4[, \tau_x, \tau_y]]]])$ of 4, 5, 8, 12 or 14 elements. If the vector is nullptr/empty, the zero distortion coefficients are assumed.
[in]x: input coordinate in meter along image plane x-axis.
[in]y: input coordinate in meter along image plane y-axis.
[out]iP: output coordinates in pixels.

Definition at line 463 of file vpMeterPixelConversion.cpp.

References vpImagePoint::set_u(), and vpImagePoint::set_v().

◆ convertPoint() [3/4]

void vpMeterPixelConversion::convertPoint ( const vpCameraParameters & cam,
const double & x,
const double & y,
double & u,
double & v )
inlinestatic

Point coordinates conversion from normalized coordinates $(x,y)$ in meter in the image plane to pixel coordinates $(u,v)$ in the image using ViSP camera parameters.

The used formula depends on the projection model of the camera. To know the currently used projection model use vpCameraParameter::get_projModel()

Parameters
[in]cam: camera parameters.
[in]x: input coordinate in meter along image plane x-axis.
[in]y: input coordinate in meter along image plane y-axis.
[out]u: output coordinate in pixels along image horizontal axis.
[out]v: output coordinate in pixels along image vertical axis.

$ u = x*p_x + u_0 $ and $ v = y*p_y + v_0 $ in the case of perspective projection without distortion.

$ u = x*p_x*(1+k_{ud}*r^2)+u_0 $ and $ v = y*p_y*(1+k_{ud}*r^2)+v_0 $ with $ r^2 = x^2+y^2 $ in the case of perspective projection with distortion.

In the case of a projection with Kannala-Brandt distortion, refer to [23].

Examples
grabRealSense2_T265.cpp, servoAfma6AprilTagIBVS.cpp, servoFrankaIBVS-EyeToHand-Lcur_cVe_eJe.cpp, servoFrankaIBVS-EyeToHand-Lcur_cVf_fVe_eJe.cpp, servoFrankaIBVS-EyeToHand-Ldes_cVf_fVe_eJe.cpp, servoFrankaIBVS.cpp, servoUniversalRobotsIBVS.cpp, testCameraParametersConversion.cpp, testPose.cpp, testRealSense2_D435_align.cpp, testRealSense2_D435_opencv.cpp, testRealSense2_T265_images_odometry.cpp, testRealSense2_T265_images_odometry_async.cpp, testRealSense2_T265_odometry.cpp, testVirtuoseWithGlove.cpp, tutorial-homography-from-points.cpp, tutorial-ibvs-4pts-display.cpp, tutorial-ibvs-4pts-wireframe-camera.cpp, tutorial-ibvs-4pts-wireframe-robot-afma6.cpp, tutorial-ibvs-4pts-wireframe-robot-viper.cpp, tutorial-pf.cpp, tutorial-pose-from-planar-object.cpp, tutorial-ukf.cpp, and visp-calibrate-camera.cpp.

Definition at line 105 of file vpMeterPixelConversion.h.

References vpException::fatalError, vpCameraParameters::perspectiveProjWithDistortion, vpCameraParameters::perspectiveProjWithoutDistortion, and vpCameraParameters::ProjWithKannalaBrandtDistortion.

Referenced by vpPolygon::buildFrom(), vpObjectCentricRenderer::computeBoundingBox(), vpPose::computeResidual(), vpMbtFaceDepthDense::computeROI(), vpMbtFaceDepthNormal::computeROI(), convertEllipse(), convertEllipse(), convertEllipse(), convertEllipse(), convertEllipse(), convertEllipse(), vpFeatureBuilder::create(), vpFeatureBuilder::create(), vpFeatureSegment::display(), vpFeatureSegment::display(), vpProjectionDisplay::display(), vpProjectionDisplay::displayCamera(), vpMbtFaceDepthNormal::displayFeature(), vpMbtFaceDepthNormal::displayFeature(), vpPose::displayModel(), vpPose::displayModel(), vpFeatureDisplay::displayPoint(), vpFeatureDisplay::displayPoint(), vpImageDraw::drawFrame(), vpImageDraw::drawFrame(), vpOccipitalStructure::getColoredPointcloud(), vpMbtFaceDepthNormal::getFeaturesForDisplay(), vpMbtDistanceKltPoints::getModelForDisplay(), vpMbtDistanceLine::getModelForDisplay(), vpPolygon3D::getNbCornerInsideImage(), vpPolygon3D::getRoi(), vpPolygon3D::getRoiClipped(), vpPolygon3D::getRoiClipped(), vpSilhouettePointsExtractionSettings::getSilhouetteCandidates(), vpMbtDistanceLine::initMovingEdge(), vpMarkersMeasurements::likelihood(), vpKeyPoint::matchPointAndDetect(), vpMarkersMeasurements::measureGT(), vpWireFrameSimulator::projectCameraTrajectory(), vpWireFrameSimulator::projectCameraTrajectory(), vpWireFrameSimulator::projectCameraTrajectory(), vpWireFrameSimulator::projectCameraTrajectory(), vpMarkersMeasurements::state_to_measurement(), vpRBProbabilistic3DDriftDetector::update(), vpSimulatorAfma6::updateArticularPosition(), vpSimulatorViper850::updateArticularPosition(), vpMbtDistanceLine::updateMovingEdge(), and vpKinect::warpRGBFrame().

◆ convertPoint() [4/4]

void vpMeterPixelConversion::convertPoint ( const vpCameraParameters & cam,
const double & x,
const double & y,
vpImagePoint & iP )
inlinestatic

Point coordinates conversion from normalized coordinates $(x,y)$ in meter in the image plane to pixel coordinates in the image using ViSP camera parameters.

The used formula depends on the projection model of the camera. To know the currently used projection model use vpCameraParameter::get_projModel()

Parameters
[in]cam: camera parameters.
[in]x: input coordinate in meter along image plane x-axis.
[in]y: input coordinate in meter along image plane y-axis.
[out]iP: output coordinates in pixels.

In the frame (u,v) the result is given by:

$ u = x*p_x + u_0 $ and $ v = y*p_y + v_0 $ in the case of perspective projection without distortion.

$ u = x*p_x*(1+k_{ud}*r^2)+u_0 $ and $ v = y*p_y*(1+k_{ud}*r^2)+v_0 $ with $ r^2 = x^2+y^2 $ in the case of perspective projection with distortion.

In the case of a projection with Kannala-Brandt distortion, refer to [23].

Definition at line 150 of file vpMeterPixelConversion.h.

References vpException::fatalError, vpCameraParameters::perspectiveProjWithDistortion, vpCameraParameters::perspectiveProjWithoutDistortion, and vpCameraParameters::ProjWithKannalaBrandtDistortion.