xyz_to_object_model_3dT_xyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d (Operator)


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


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

Herror T_xyz_to_object_model_3d(const Hobject X, const Hobject Y, const Hobject Z, Htuple* ObjectModel3D)

void XyzToObjectModel3d(const HObject& X, const HObject& Y, const HObject& Z, HTuple* ObjectModel3D)

void HObjectModel3D::HObjectModel3D(const HImage& X, const HImage& Y, const HImage& Z)

void HObjectModel3D::XyzToObjectModel3d(const HImage& X, const HImage& Y, const HImage& Z)

static void HOperatorSet.XyzToObjectModel3d(HObject x, HObject y, HObject z, out HTuple objectModel3D)

public HObjectModel3D(HImage x, HImage y, HImage z)

void HObjectModel3D.XyzToObjectModel3d(HImage x, HImage y, HImage z)


The operator xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3dXyzToObjectModel3d 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_paramsget_object_model_3d_paramsGetObjectModel3dParamsGetObjectModel3dParamsGetObjectModel3dParams with 'mapping_size'"mapping_size""mapping_size""mapping_size""mapping_size". The handle of the created 3D object model is returned in ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D. 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.

Execution Information

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.


XXXXx (input_object)  singlechannelimage objectHImageHImageHobject (real)

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

YYYYy (input_object)  singlechannelimage objectHImageHImageHobject (real)

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

ZZZZz (input_object)  singlechannelimage objectHImageHImageHobject (real)

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

ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D (output_control)  object_model_3d HObjectModel3D, HTupleHTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the 3D object model.


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

Possible Predecessors

disparity_image_to_xyzdisparity_image_to_xyzDisparityImageToXyzDisparityImageToXyzDisparityImageToXyz, get_sheet_of_light_resultget_sheet_of_light_resultGetSheetOfLightResultGetSheetOfLightResultGetSheetOfLightResult


gen_object_model_3d_from_pointsgen_object_model_3d_from_pointsGenObjectModel3dFromPointsGenObjectModel3dFromPointsGenObjectModel3dFromPoints, get_sheet_of_light_result_object_model_3dget_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3dGetSheetOfLightResultObjectModel3d

See also



3D Metrology