Skip to content

xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3dxyz_to_object_model_3dT_xyz_to_object_model_3dπŸ”—

Short descriptionπŸ”—

xyz_to_object_model_3dxyz_to_object_model_3dXyzToObjectModel3dXyzToObjectModel3dxyz_to_object_model_3dT_xyz_to_object_model_3d β€” Transform 3D points from images to a 3D object model.

SignatureπŸ”—

xyz_to_object_model_3d( image X, image Y, image Z, out object_model_3d ObjectModel3D )xyz_to_object_model_3d( X, Y, Z : : : ObjectModel3D )void XyzToObjectModel3d( const HObject& X, const HObject& Y, const HObject& Z, HTuple* ObjectModel3D )static void HOperatorSet.XyzToObjectModel3d( HObject x, HObject y, HObject z, out HTuple objectModel3D )def xyz_to_object_model_3d( x: HObject, y: HObject, z: HObject ) -> HHandle

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

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

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

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

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

DescriptionπŸ”—

The operator xyz_to_object_model_3dXyzToObjectModel3d 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_paramsGetObjectModel3dParams with 'mapping_size'"mapping_size". The handle of the created 3D object model is returned in ObjectModel3DobjectModel3Dobject_model_3d. 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πŸ”—

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πŸ”—

Xxx (input_object) singlechannelimage β†’ object (real)object (real)HObject (real)HImage (real)HObject (real)Hobject (real)

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

Yyy (input_object) singlechannelimage β†’ object (real)object (real)HObject (real)HImage (real)HObject (real)Hobject (real)

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

Zzz (input_object) singlechannelimage β†’ object (real)object (real)HObject (real)HImage (real)HObject (real)Hobject (real)

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

ObjectModel3DobjectModel3Dobject_model_3d (output_control) object_model_3d β†’ (handle)(handle)HTuple (HHandle)HObjectModel3D, HTuple (IntPtr)HHandleHtuple (handle)

Handle of the 3D object model.

ResultπŸ”—

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

Combinations with other operatorsπŸ”—

Combinations

Possible predecessors

disparity_image_to_xyzDisparityImageToXyz, get_sheet_of_light_resultGetSheetOfLightResult

Alternatives

gen_object_model_3d_from_pointsGenObjectModel3dFromPoints, get_sheet_of_light_result_object_model_3dGetSheetOfLightResultObjectModel3d

See also

read_object_model_3dReadObjectModel3d

ModuleπŸ”—

3D Metrology