Skip to content

contour_to_world_plane_xldcontour_to_world_plane_xldContourToWorldPlaneXldContourToWorldPlaneXldcontour_to_world_plane_xldT_contour_to_world_plane_xldπŸ”—

Short descriptionπŸ”—

contour_to_world_plane_xldcontour_to_world_plane_xldContourToWorldPlaneXldContourToWorldPlaneXldcontour_to_world_plane_xldT_contour_to_world_plane_xld β€” Transform an XLD contour into the plane z=0 of a world coordinate system.

SignatureπŸ”—

contour_to_world_plane_xld( xld_cont Contours, out xld_cont ContoursTrans, number CameraParam, pose WorldPose, number Scale )contour_to_world_plane_xld( Contours : ContoursTrans : CameraParam, WorldPose, Scale : )void ContourToWorldPlaneXld( const HObject& Contours, HObject* ContoursTrans, const HTuple& CameraParam, const HTuple& WorldPose, const HTuple& Scale )static void HOperatorSet.ContourToWorldPlaneXld( HObject contours, out HObject contoursTrans, HTuple cameraParam, HTuple worldPose, HTuple scale )def contour_to_world_plane_xld( contours: HObject, camera_param: Sequence[Union[int, float, str]], world_pose: Sequence[Union[int, float]], scale: Union[int, float, str] ) -> HObject

Herror T_contour_to_world_plane_xld( const Hobject Contours, Hobject* ContoursTrans, const Htuple CameraParam, const Htuple WorldPose, const Htuple Scale )

HXLDCont HXLDCont::ContourToWorldPlaneXld( const HTuple& CameraParam, const HPose& WorldPose, const HTuple& Scale ) const

HXLDCont HXLDCont::ContourToWorldPlaneXld( const HTuple& CameraParam, const HPose& WorldPose, const HString& Scale ) const

HXLDCont HXLDCont::ContourToWorldPlaneXld( const HTuple& CameraParam, const HPose& WorldPose, const char* Scale ) const

HXLDCont HXLDCont::ContourToWorldPlaneXld( const HTuple& CameraParam, const HPose& WorldPose, const wchar_t* Scale ) const (Windows only)

HXLDCont HPose::ContourToWorldPlaneXld( const HXLDCont& Contours, const HTuple& CameraParam, const HTuple& Scale ) const

HXLDCont HPose::ContourToWorldPlaneXld( const HXLDCont& Contours, const HTuple& CameraParam, const HString& Scale ) const

HXLDCont HPose::ContourToWorldPlaneXld( const HXLDCont& Contours, const HTuple& CameraParam, const char* Scale ) const

HXLDCont HPose::ContourToWorldPlaneXld( const HXLDCont& Contours, const HTuple& CameraParam, const wchar_t* Scale ) const (Windows only)

HXLDCont HXLDCont.ContourToWorldPlaneXld( HTuple cameraParam, HPose worldPose, HTuple scale )

HXLDCont HXLDCont.ContourToWorldPlaneXld( HTuple cameraParam, HPose worldPose, string scale )

HXLDCont HPose.ContourToWorldPlaneXld( HXLDCont contours, HTuple cameraParam, HTuple scale )

HXLDCont HPose.ContourToWorldPlaneXld( HXLDCont contours, HTuple cameraParam, string scale )

DescriptionπŸ”—

The operator contour_to_world_plane_xldContourToWorldPlaneXld transforms contour points given in Contourscontourscontours into the plane z=0 in a world coordinate system and returns the 3D contour points in ContoursTranscontoursTranscontours_trans. The world coordinate system is chosen by passing its 3D pose relative to the camera coordinate system in WorldPoseworldPoseworld_pose. Hence, latter one is expected in the form \(\mvPoseVar{{ccs}}{wcs}\), where ccs denotes the camera coordinate system and wcs the world coordinate system (see [``Solving machine vision tasks > Machine vision basics

Transformations > 3D Transformationsβ€™β€˜](https://docs.mvtec.com/hdevelopevo/26.11/content/mvtasks/machine_vision_basics/transformations/3d/index.html)). In CameraParamcameraParamcamera_param you must pass the internal camera parameters (see Calibration for the sequence of the parameters and the underlying camera model).

In many cases CameraParamcameraParamcamera_param and WorldPoseworldPoseworld_pose are the result of calibrating the camera with the operator calibrate_camerasCalibrateCameras. See below for an example.

With the parameter Scalescalescale you can scale the resulting 3D coordinates. The parameter Scalescalescale must be specified as the ratio desired unit/original unit. The original unit is determined by the coordinates of the calibration object. If the original unit is meters (which is the case if you use the standard calibration plate), you can set the desired unit directly by selecting 'm'"m", 'cm'"cm", 'mm'"mm" or 'um'"um" for the parameter Scalescalescale.

Internally, the operator first computes the line of sight between the projection center and the image point in the camera coordinate system, taking into account the radial distortions. The line of sight is then transformed into the world coordinate system specified in WorldPoseworldPoseworld_pose. By intersecting the plane z=0 with the line of sight the 3D coordinates of the transformed contour ContoursTranscontoursTranscontours_trans are obtained.

Execution informationπŸ”—

Execution information
  • Multithreading type: reentrant (runs in parallel with non-exclusive operators).

  • Multithreading scope: global (may be called from any thread).

  • Processed without parallelization.

ParametersπŸ”—

Contourscontourscontours (input_object) xld_cont(-array) β†’ objectobjectHObjectHXLDContHObjectHobject

Input XLD contours to be transformed in image coordinates.

ContoursTranscontoursTranscontours_trans (output_object) xld_cont(-array) β†’ objectobjectHObjectHXLDContHObjectHobject *

Transformed XLD contours in world coordinates.

CameraParamcameraParamcamera_param (input_control) number-array β†’ (real / integer / string)(real / integer / string)HTuple (double / Hlong / HString)HTuple (double / int / long / string)Sequence[Union[int, float, str]]Htuple (double / Hlong / char*)

Internal camera parameters.

WorldPoseworldPoseworld_pose (input_control) pose β†’ (real / integer)(real / integer)HTuple (double / Hlong)HPose, HTuple (double / int / long)Sequence[Union[int, float]]Htuple (double / Hlong)

3D pose of the world coordinate system in camera coordinates.

Number of elements: 7

Scalescalescale (input_control) number β†’ (string / integer / real)(string / integer / real)HTuple (HString / Hlong / double)HTuple (string / int / long / double)Union[int, float, str]Htuple (char* / Hlong / double)

Scale or dimension

Default: 'm'"m"
Suggested values: 'm', 'cm', 'mm', 'microns', 'um', 1.0, 0.01, 0.001, 1.0e-6, 0.0254, 0.3048, 0.9144"m", "cm", "mm", "microns", "um", 1.0, 0.01, 0.001, 1.0e-6, 0.0254, 0.3048, 0.9144
Restriction: Scale > 0

ExampleπŸ”—

(HDevelop)


*  Perform camera calibration (with standard calibration plate).
calibrate_cameras (CalibDataID, Error)
get_calib_data (CalibDataID, 'camera', 0, 'params', CamParam)
* Get reference pose (pose 2 of calibration object 0).
get_calib_data (CalibDataID, 'calib_obj_pose', [0,2], 'pose', WorldPose)
*  Compensate thickness of plate.
set_origin_pose(ObjInCameraPose, 0, 0, 0.0006, WorldPose)
*  Transform contours into world coordinate system (unit mm).
contour_to_world_plane_xld(Contours, ContoursTrans, CamParam, \
                           WorldPose, 'mm')

ResultπŸ”—

contour_to_world_plane_xldContourToWorldPlaneXld returns 2 (H_MSG_TRUE) if all parameter values are correct. If necessary, an exception is raised.

Combinations with other operatorsπŸ”—

Combinations

Possible predecessors

create_poseCreatePose, hom_mat3d_to_poseHomMat3dToPose, camera_calibrationCameraCalibration, hand_eye_calibrationHandEyeCalibration, set_origin_poseSetOriginPose

See also

image_points_to_world_planeImagePointsToWorldPlane

ModuleπŸ”—

Calibration