Operator Reference

HALCON Operator Reference / 3D Object Model / Transformations
ClassesClasses | | Operators

convex_hull_object_model_3dT_convex_hull_object_model_3dConvexHullObjectModel3dConvexHullObjectModel3dconvex_hull_object_model_3d (Operator)

convex_hull_object_model_3dT_convex_hull_object_model_3dConvexHullObjectModel3dConvexHullObjectModel3dconvex_hull_object_model_3d — Calculate the convex hull of a 3D object model.

Signature

convex_hull_object_model_3d( : : ObjectModel3D : ObjectModel3DConvexHull)

Herror T_convex_hull_object_model_3d(const Htuple ObjectModel3D, Htuple* ObjectModel3DConvexHull)

void ConvexHullObjectModel3d(const HTuple& ObjectModel3D, HTuple* ObjectModel3DConvexHull)

static HObjectModel3DArray HObjectModel3D::ConvexHullObjectModel3d(const HObjectModel3DArray& ObjectModel3D)

HObjectModel3D HObjectModel3D::ConvexHullObjectModel3d() const

static void HOperatorSet.ConvexHullObjectModel3d(HTuple objectModel3D, out HTuple objectModel3DConvexHull)

static HObjectModel3D[] HObjectModel3D.ConvexHullObjectModel3d(HObjectModel3D[] objectModel3D)

HObjectModel3D HObjectModel3D.ConvexHullObjectModel3d()

def convex_hull_object_model_3d(object_model_3d: MaybeSequence[HHandle]) -> Sequence[HHandle]

def convex_hull_object_model_3d_s(object_model_3d: MaybeSequence[HHandle]) -> HHandle

Description

convex_hull_object_model_3dconvex_hull_object_model_3dConvexHullObjectModel3dConvexHullObjectModel3dconvex_hull_object_model_3d calculates the convex hull of the 3D object model given in ObjectModel3DObjectModel3DObjectModel3DobjectModel3Dobject_model_3d. The operator returns the convex hull as a 3D object model with the handle ObjectModel3DConvexHullObjectModel3DConvexHullObjectModel3DConvexHullobjectModel3DConvexHullobject_model_3dconvex_hull.

If one of the dimensions of the input points has no deviation at all, the result will consist of lines and not triangles.

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

ObjectModel3DObjectModel3DObjectModel3DobjectModel3Dobject_model_3d (input_control)  object_model_3d(-array) → HObjectModel3D, HTupleMaybeSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the 3D object model.

ObjectModel3DConvexHullObjectModel3DConvexHullObjectModel3DConvexHullobjectModel3DConvexHullobject_model_3dconvex_hull (output_control)  object_model_3d(-array) → HObjectModel3D, HTupleSequence[HHandle]HTupleHtuple (handle) (IntPtr) (HHandle) (handle)

Handle of the 3D object model that describes the convex hull.

Number of elements: ObjectModel3DConvexHull == ObjectModel3D

Example (HDevelop)

gen_object_model_3d_from_points (rand(20)-0.5, rand(20)-0.5,\
                                 rand(20)-0.5, ObjectModel3D)
convex_hull_object_model_3d (ObjectModel3D, ObjectModel3DConvexHull)
dev_get_window (WindowHandle)
visualize_object_model_3d (WindowHandle, [ObjectModel3DConvexHull], \
                           [], [], [], [], [], [], [], PoseOut)

Result

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

Possible Predecessors

read_object_model_3dread_object_model_3dReadObjectModel3dReadObjectModel3dread_object_model_3d, connection_object_model_3dconnection_object_model_3dConnectionObjectModel3dConnectionObjectModel3dconnection_object_model_3d, select_points_object_model_3dselect_points_object_model_3dSelectPointsObjectModel3dSelectPointsObjectModel3dselect_points_object_model_3d

Possible Successors

project_object_model_3dproject_object_model_3dProjectObjectModel3dProjectObjectModel3dproject_object_model_3d

Module

3D Metrology

ClassesClasses | | Operators