xyz_to_object_model_3d — Transform 3D points from images to a 3D object model.
The operator xyz_to_object_model_3d transforms an image triple that contains the X, Y, and Z-coordinates of 3D points to a 3D object model. Thereby, only points in the intersecting domains of all three images are used and the images need to be of same size. The size of these images can be queried from the model by get_object_model_3d_params with 'mapping_size'. The handle of the created 3D object model is returned in ObjectModel3D. The created 3D object model contains the coordinates of the points, as well as a mapping attribute that contains the original row and column of each 3D point. Points where one of the coordinates is infinity or "Not a Number" (NaN) are ignored and not added to the 3D object model.
Note that if a 3D object model is no longer needed or should be overwritten, the memory has to be freed first by calling the operator clear_object_model_3d.
This operator returns a handle. Note that the state of an instance of this handle type may be changed by specific operators even though the handle is used as an input parameter by those operators.
Image with the X-Coordinates and the ROI of the 3D points.
Image with the Y-Coordinates of the 3D points.
Image with the Z-Coordinates of the 3D points.
Handle of the 3D object model.
The operator xyz_to_object_model_3d returns the value 2 (H_MSG_TRUE) if the given parameters are correct. Otherwise, an exception will be raised.