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)

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.