project_hom_point_hom_mat3dproject_hom_point_hom_mat3dProjectHomPointHomMat3dProjectHomPointHomMat3dproject_hom_point_hom_mat3dT_project_hom_point_hom_mat3d
Short description
project_hom_point_hom_mat3dproject_hom_point_hom_mat3dProjectHomPointHomMat3dProjectHomPointHomMat3dproject_hom_point_hom_mat3dT_project_hom_point_hom_mat3d — Project a homogeneous 3D point using a 3×4 projection matrix.
Signature
project_hom_point_hom_mat3d( hom_mat3d HomMat3D, number Px, number Py, number Pz, number Pw, out real Qx, out real Qy, out real Qw )project_hom_point_hom_mat3d( : : HomMat3D, Px, Py, Pz, Pw : Qx, Qy, Qw )void ProjectHomPointHomMat3d( const HTuple& HomMat3D, const HTuple& Px, const HTuple& Py, const HTuple& Pz, const HTuple& Pw, HTuple* Qx, HTuple* Qy, HTuple* Qw )static void HOperatorSet.ProjectHomPointHomMat3d( HTuple homMat3D, HTuple px, HTuple py, HTuple pz, HTuple pw, out HTuple qx, out HTuple qy, out HTuple qw )def project_hom_point_hom_mat3d( hom_mat_3d: Sequence[float], px: MaybeSequence[Union[float, int]], py: MaybeSequence[Union[float, int]], pz: MaybeSequence[Union[float, int]], pw: MaybeSequence[Union[float, int]] ) -> Tuple[Sequence[float], Sequence[float], Sequence[float]]
def project_hom_point_hom_mat3d_s( hom_mat_3d: Sequence[float], px: MaybeSequence[Union[float, int]], py: MaybeSequence[Union[float, int]], pz: MaybeSequence[Union[float, int]], pw: MaybeSequence[Union[float, int]] ) -> Tuple[float, float, float]Herror T_project_hom_point_hom_mat3d( const Htuple HomMat3D, const Htuple Px, const Htuple Py, const Htuple Pz, const Htuple Pw, Htuple* Qx, Htuple* Qy, Htuple* Qw )
HTuple HHomMat3D::ProjectHomPointHomMat3d( const HTuple& Px, const HTuple& Py, const HTuple& Pz, const HTuple& Pw, HTuple* Qy, HTuple* Qw ) const
double HHomMat3D::ProjectHomPointHomMat3d( double Px, double Py, double Pz, double Pw, double* Qy, double* Qw ) const
HTuple HHomMat3D.ProjectHomPointHomMat3d( HTuple px, HTuple py, HTuple pz, HTuple pw, out HTuple qy, out HTuple qw )
double HHomMat3D.ProjectHomPointHomMat3d( double px, double py, double pz, double pw, out double qy, out double qw )
Description
projective_trans_hom_point_3dProjectiveTransHomPoint3d applies the 3×4 projection
matrix HomMat3DhomMat3Dhom_mat_3d to all homogeneous input points
(Pxpxpx,Pypypy,Pzpzpz,Pwpwpw) and returns an
array of homogeneous output points
(Qxqxqx,Qyqyqy,Qwqwqw). The transformation is
described by the homogeneous transformation matrix given in
HomMat3DhomMat3Dhom_mat_3d. This corresponds to the following equation (input
and output points as homogeneous vectors):
\[\begin{eqnarray*}
\left( \begin{array}{c}
\textrm{Qx} \\
\textrm{Qy} \\
\textrm{Qw}
\end{array} \right) =
\textrm{HomMat3D} \cdot
\left( \begin{array}{c}
\textrm{Px} \\
\textrm{Py} \\
\textrm{Pz} \\
\textrm{Pw}
\end{array} \right)
\end{eqnarray*}\]
To transform the homogeneous coordinates to Euclidean coordinates,
they must be divided by Qwqwqw:
\[\begin{eqnarray*}
\left( \begin{array}{c}
Ex \\
Ey
\end{array} \right) =
\left( \begin{array}{c}
\frac{Qx}{Qw} \\
\frac{Qy}{Qw}
\end{array} \right)
\end{eqnarray*}\]
This can be achieved directly by calling
project_point_hom_mat3dProjectPointHomMat3d. Thus,
project_hom_point_hom_mat3dProjectHomPointHomMat3d is primarily useful for
transforming points or point sets for which the resulting points
might lie on the line at infinity, i.e., points that potentially
have \(\textrm{Qw} = 0\), for which the above division cannot be
performed.
Note that, consistent with the conventions used by the projection in
calibrate_camerasCalibrateCameras, Qxqxqx corresponds to the column
coordinate of an image and Qyqyqy corresponds to the row
coordinate.
Execution information
-
Multithreading type: reentrant (runs in parallel with non-exclusive operators).
-
Multithreading scope: global (may be called from any thread).
-
Automatically parallelized on internal data level.
Parameters
HomMat3DhomMat3Dhom_mat_3d (input_control) hom_mat3d → (real)(real)HTuple (double)HHomMat3D, HTuple (double)Sequence[float]Htuple (double)
3×4 projection matrix.
Pxpxpx (input_control) number(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)
Input point (x coordinate).
Pypypy (input_control) number(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)
Input point (y coordinate).
Pzpzpz (input_control) number(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)
Input point (z coordinate).
Pwpwpw (input_control) number(-array) → (real / integer)(real / integer)HTuple (double / Hlong)HTuple (double / int / long)MaybeSequence[Union[float, int]]Htuple (double / Hlong)
Input point (w coordinate).
Qxqxqx (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Output point (x coordinate).
Qyqyqy (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Output point (y coordinate).
Qwqwqw (output_control) real(-array) → (real)(real)HTuple (double)HTuple (double)Sequence[float]Htuple (double)
Output point (w coordinate).
Combinations with other operators
Combinations
Possible predecessors
cam_par_pose_to_hom_mat3dCamParPoseToHomMat3d
Alternatives
project_point_hom_mat3dProjectPointHomMat3d, project_3d_pointProject3dPoint
Module
Foundation