xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d (Operator)

Name

xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d — Transform 3D points from images to a 3D object model.

Signature

xyz_to_object_model_3d(X, Y, Z : : : ObjectModel3D)

The operator xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d transforms an image triple that contains the X, Y, and Z-coordinates of 3D points to a 3D object model. Only points in the intersecting domains of all three images are used. The handle of the created 3D object model is returned in ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D. 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_3dclear_object_model_3dClearObjectModel3dclear_object_model_3dClearObjectModel3dClearObjectModel3d.

Parallelization

Multithreading type: reentrant (runs in parallel with non-exclusive operators).
Multithreading scope: global (may be called from any thread).
Processed without parallelization.

Parameters

XXXXXx (input_object) singlechannelimage → object (real)

Image with the X-Coordinates and the ROI of the 3D points.

YYYYYy (input_object) singlechannelimage → object (real)

Image with the Y-Coordinates of the 3D points.

ZZZZZz (input_object) singlechannelimage → object (real)

Image with the Z-Coordinates of the 3D points.

ObjectModel3DObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D (output_control) object_model_3d → (integer)

Handle of the 3D object model.

Result

The operator xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d returns the value 2 (H_MSG_TRUE) if the given parameters are correct. Otherwise, an exception will be raised.