max_diameter_object_model_3dT_max_diameter_object_model_3dMaxDiameterObjectModel3dMaxDiameterObjectModel3d (Operator)

Name

max_diameter_object_model_3dT_max_diameter_object_model_3dMaxDiameterObjectModel3dMaxDiameterObjectModel3d — Calculate the maximal diameter of a 3D object model.

Signature

max_diameter_object_model_3d( : : ObjectModel3D : Diameter)

Description

max_diameter_object_model_3dmax_diameter_object_model_3dMaxDiameterObjectModel3dMaxDiameterObjectModel3dMaxDiameterObjectModel3d calculates the maximal diameter of the 3D object model by calculating the convex hull of the object and searching for the pair of points on the convex hull with the largest distance.

Execution Information

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

Parameters

ObjectModel3DObjectModel3DObjectModel3DObjectModel3DobjectModel3D (input_control) object_model_3d(-array) → (handle)

Handle of the 3D object model.

DiameterDiameterDiameterDiameterdiameter (output_control) number(-array) → (real)

Calculated diameter.

Number of elements: Diameter == ObjectModel3D

Example (HDevelop)

gen_object_model_3d_from_points (rand(200), rand(200),\
                                    rand(200), ObjectModel3D)
max_diameter_object_model_3d (ObjectModel3D, Diameter)

Result

max_diameter_object_model_3dmax_diameter_object_model_3dMaxDiameterObjectModel3dMaxDiameterObjectModel3dMaxDiameterObjectModel3d returns 2 (H_MSG_TRUE) if all parameters are correct. If necessary, an exception is raised.

Possible Predecessors

read_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3dReadObjectModel3d, connection_object_model_3dconnection_object_model_3dConnectionObjectModel3dConnectionObjectModel3dConnectionObjectModel3d

Possible Successors

select_object_model_3dselect_object_model_3dSelectObjectModel3dSelectObjectModel3dSelectObjectModel3d

Module

3D Metrology

Operators