HALCON Website / HALCON Operator Reference / Transformations / Poses
ClassesClassesClassesClasses | | | | Operators

proj_hom_mat2d_to_poseT_proj_hom_mat2d_to_poseProjHomMat2dToPoseproj_hom_mat2d_to_poseProjHomMat2dToPoseProjHomMat2dToPose (Operator)

Name

proj_hom_mat2d_to_poseT_proj_hom_mat2d_to_poseProjHomMat2dToPoseproj_hom_mat2d_to_poseProjHomMat2dToPoseProjHomMat2dToPose — Compute a pose out of a homography describing the relation between world and image coordinates.

Signature

proj_hom_mat2d_to_pose( : : Homography, CameraMatrix, Method : Pose)

Herror T_proj_hom_mat2d_to_pose(const Htuple Homography, const Htuple CameraMatrix, const Htuple Method, Htuple* Pose)

Herror proj_hom_mat2d_to_pose(const HTuple& Homography, const HTuple& CameraMatrix, const HTuple& Method, HTuple* Pose)

void ProjHomMat2dToPose(const HTuple& Homography, const HTuple& CameraMatrix, const HTuple& Method, HTuple* Pose)

static HPose HImage::ProjHomMat2dToPose(const HHomMat2D& Homography, const HHomMat2D& CameraMatrix, const HString& Method)

static HPose HImage::ProjHomMat2dToPose(const HHomMat2D& Homography, const HHomMat2D& CameraMatrix, const char* Method)

void HOperatorSetX.ProjHomMat2dToPose(
[in] VARIANT Homography, [in] VARIANT CameraMatrix, [in] VARIANT Method, [out] VARIANT* Pose)

VARIANT HImageX.ProjHomMat2dToPose(
[in] IHHomMat2DX* Homography, [in] IHHomMat2DX* CameraMatrix, [in] BSTR Method)

static void HOperatorSet.ProjHomMat2dToPose(HTuple homography, HTuple cameraMatrix, HTuple method, out HTuple pose)

static HPose HImage.ProjHomMat2dToPose(HHomMat2D homography, HHomMat2D cameraMatrix, string method)

Description

proj_hom_mat2d_to_poseproj_hom_mat2d_to_poseProjHomMat2dToPoseproj_hom_mat2d_to_poseProjHomMat2dToPoseProjHomMat2dToPose computes a pose out of a homography HomographyHomographyHomographyHomographyHomographyhomography that describes the relation between 2D world- (unit meters) and 2D image coordinates. The homography can be obtained by the use of vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2d. To compute a pose, a camera matrix (obtained by cam_par_to_cam_matcam_par_to_cam_matCamParToCamMatcam_par_to_cam_matCamParToCamMatCamParToCamMat, for example) has to be passed in CameraMatrixCameraMatrixCameraMatrixCameraMatrixCameraMatrixcameraMatrix. By setting the Parameter MethodMethodMethodMethodMethodmethod, it is possible to choose which computation algorithm is used. Currently a direct decomposition (MethodMethodMethodMethodMethodmethod = 'decomposition') and a singular value decomposition based method (MethodMethodMethodMethodMethodmethod = 'decomposition_svd') are supported. In general due to numeric reasons, the direct decomposition method returns more stable results.

The subsequent calls of vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2d and proj_hom_mat2d_to_poseproj_hom_mat2d_to_poseProjHomMat2dToPoseproj_hom_mat2d_to_poseProjHomMat2dToPoseProjHomMat2dToPose are similar to vector_to_posevector_to_poseVectorToPosevector_to_poseVectorToPoseVectorToPose for 2D objects, whereas no refinement due to redundance is possible.

Parallelization

Parameters

HomographyHomographyHomographyHomographyHomographyhomography (input_control)  hom_mat2d → HHomMat2D, HTupleHTupleHTupleHHomMat2DX, VARIANTHtuple (real) (double) (double) (double) (double) (double)

The homography from world- to image coordinates.

CameraMatrixCameraMatrixCameraMatrixCameraMatrixCameraMatrixcameraMatrix (input_control)  hom_mat2d → HHomMat2D, HTupleHTupleHTupleHHomMat2DX, VARIANTHtuple (real) (double) (double) (double) (double) (double)

The camera calibration matrix K.

MethodMethodMethodMethodMethodmethod (input_control)  string → HTupleHTupleHTupleVARIANTHtuple (string) (string) (HString) (char*) (BSTR) (char*)

Type of pose computation.

Default value: 'decomposition' "decomposition" "decomposition" "decomposition" "decomposition" "decomposition"

List of values: 'decomposition'"decomposition""decomposition""decomposition""decomposition""decomposition", 'decomposition_svd'"decomposition_svd""decomposition_svd""decomposition_svd""decomposition_svd""decomposition_svd"

PosePosePosePosePosepose (output_control)  pose → HPose, HTupleHTupleHTupleHPoseX, VARIANTHtuple (real / integer) (double / int / long) (double / Hlong) (double / Hlong) (double / Hlong) (double / Hlong)

Pose of the 2D object.

Result

proj_hom_mat2d_to_poseproj_hom_mat2d_to_poseProjHomMat2dToPoseproj_hom_mat2d_to_poseProjHomMat2dToPoseProjHomMat2dToPose returns 2 (H_MSG_TRUE) if all parameter values are correct.

Possible Predecessors

image_points_to_world_planeimage_points_to_world_planeImagePointsToWorldPlaneimage_points_to_world_planeImagePointsToWorldPlaneImagePointsToWorldPlane, vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2d

See also

vector_to_proj_hom_mat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dvector_to_proj_hom_mat2dVectorToProjHomMat2dVectorToProjHomMat2d, image_points_to_world_planeimage_points_to_world_planeImagePointsToWorldPlaneimage_points_to_world_planeImagePointsToWorldPlaneImagePointsToWorldPlane, vector_to_posevector_to_poseVectorToPosevector_to_poseVectorToPoseVectorToPose, camera_calibrationcamera_calibrationCameraCalibrationcamera_calibrationCameraCalibrationCameraCalibration

Module

Calibration

ClassesClassesClassesClasses | | | | Operators
HALCON Operator Reference 11.0.5 Copyright © 1996-2015 MVTec Software GmbH