xyz_to_object_model_3dT_xyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d (Operator)
Name
xyz_to_object_model_3dT_xyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3d — Transform 3D points from images to a 3D object model.
Signature
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)
Description
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
- Multithreading type: reentrant (runs in parallel with non-exclusive operators).
- Multithreading scope: global (may be called from any thread).
- Processed without parallelization.
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.
Parameters
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.
Result
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
Alternatives
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
read_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3dReadObjectModel3d
Module
3D Metrology