image_to_world_plane — Rectify an image by transforming it into the plane z=0 of a world coordinate system.
image_to_world_plane rectifies an image Image by transforming it into the plane z=0 (plane of measurements) in a world coordinate system. The resulting rectified image ImageWorld shows neither radial nor perspective distortions; it corresponds to an image acquired by a distortion-free camera that looks perpendicularly onto the plane of measurements. The world coordinate system is chosen by passing its 3D pose relative to the camera coordinate system in WorldPose. In CameraParam you must pass the internal camera parameters (see calibrate_cameras for the sequence of the parameters and the underlying camera model).
In many cases CameraParam and WorldPose are the result of calibrating the camera with the operator calibrate_cameras. See below for an example.
The pixel position of the upper left corner of the output image ImageWorld is determined by the origin of the world coordinate system. The size of the output image ImageWorld can be chosen by the parameters Width, Height, and Scale. Width and Height must be given in pixels.
With the parameter Scale you can specify the size of a pixel in the transformed image. There are two typical scenarios: First, you can scale the image such that pixel coordinates in the transformed image directly correspond to metric units, e.g., that one pixel corresponds to one micron. This is useful if you want to perform measurements in the transformed image which will then directly result in metric results. The second scenario is to scale the image such that its content appears in a size similar to the original image. This is useful, e.g., if you want to perform shape-based matching in the transformed image.
Scale must be specified as the ratio desired pixel size/original unit. A pixel size of 1um means that a pixel in the transformed image corresponds to the area 1um x 1um in the plane of measurements. 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 use the parameter values 'm', 'cm', 'mm', 'microns', or 'um' to directly set the unit of pixel coordinates in the transformed image.
The parameter Interpolation specifies, whether bilinear interpolation ('bilinear') should be applied between the pixels in the input image or whether the gray value of the nearest neighboring pixel ('nearest_neighbor') should be used.
If several images have to be rectified using the same parameters, gen_image_to_world_plane_map in combination with map_image is much more efficient than the operator image_to_world_plane because the mapping function needs to be computed only once.
image_to_world_plane can be executed on OpenCL devices if the input image does not exceed the maximum size of image objects of the selected device. There can be slight differences in the output compared to the execution on the CPU.
Internal camera parameters.
Number of elements: CameraParam == 8 || CameraParam == 10 || CameraParam == 11 || CameraParam == 12 || CameraParam == 14
3D pose of the world coordinate system in camera coordinates.
Number of elements: 7
Width of the resulting image in pixels.
Height of the resulting image in pixels.
Scale or unit
Default value: 'm'
Suggested values: 'm', 'cm', 'mm', 'microns', 'um', 1.0, 0.01, 0.001, 1.0e-6, 0.0254, 0.3048, 0.9144
Type of interpolation.
Default value: 'bilinear'
List of values: 'bilinear', 'nearest_neighbor'
* Calibrate camera calibrate_cameras (CalibDataID, Error) * Obtain camera parameters. get_calib_data (CalibDataID, 'camera', 0, 'params', CamParam) * Example values, if no calibration data is available: CamParam:=[0.0087, -1859, 8.65e-006, 8.6e-006, 362.5, 291.6, 768, 576] * Get reference pose (pose 4 of calibration object 0) get_calib_data (CalibDataID, 'calib_obj_pose',\ [0,4], 'pose', Pose) * Example values, if no calibration data is available: Pose := [-0.11, -0.21, 2.51, 352.73, 346.73, 336.48, 0] * Compensate thickness of plate set_origin_pose (Pose, -1.125, -1.0, 0, PoseNewOrigin) * Transform the image into the world plane. read_image (Image, 'calib/calib-3d-coord-04') image_to_world_plane (Image, ImageWorld, CamParam, PoseNewOrigin,\ 900, 800, 0.0025, 'bilinear') * Cleanup clear_calib_data (CalibDataID)
image_to_world_plane returns 2 (H_MSG_TRUE) if all parameter values are correct. If necessary, an exception is raised.
create_pose, hom_mat3d_to_pose, camera_calibration, hand_eye_calibration, set_origin_pose